> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gorelo Agent no s'instal·la

> Resoleu problemes d'instal·lació de Gorelo Agent amb la comprovació prèvia de PowerShell, la llista de sistemes operatius admesos i solucions comunes per a endpoints Windows i macOS.

Ocasionalment, podeu trobar problemes a l'hora d'instal·lar Gorelo Agent. Aquí teniu algunes coses a considerar.

## Sistemes operatius admesos

Gorelo només admet sistemes operatius que actualment estan suportats pel mateix fabricant (Microsoft/Apple).

* [**<u>https://endoflife.date/windows</u>**](https://endoflife.date/windows)
* [**<u>https://endoflife.date/windows-server</u>**](https://endoflife.date/windows-server)
* [**<u>https://endoflife.date/macos</u>**](https://endoflife.date/macos)

## Comprovació de prerequisits via PowerShell

Gorelo proporciona una comprovació de prerequisits senzilla via PowerShell que podeu executar.

1. Obriu una finestra de PowerShell elevada a l'ordinador amb problemes d'agent.
2. Enganxeu l'ordre següent i premeu **Retorn**:

```text theme={null}
Invoke-Expression (Invoke-WebRequest -Uri "https://gist.githubusercontent.com/mikelgorelo/e5bcac91d2fddd165a2fd56a675ebb3a/raw/dd21bcf13480e366a569ae06fa43b9f3c57fa5d8/gorelo-check.ps1" -UseBasicParsing).Content
```

3. Resoleu qualsevol fallada, com s'indica a continuació, i assegureu-vos que això persisteixi a través de sessions de PowerShell i reinicis.

| Comprovació                                              | **❌ Missatge de fallada**                                                                                                                                                                                                                                                                                                                        | **✅ Resolució de problemes**                                                                                                                                                                                                                                                                                                                                         |
| :------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Comprovació de versió de PowerShell**                  | `FAIL: PowerShell version X.X is below the required version 5.1`                                                                                                                                                                                                                                                                                 | <ul><li>Descarregueu i instal·leu Windows Management Framework 5.1 des de Microsoft</li><li>Per a Windows 10/11, utilitzeu Windows Update per actualitzar PowerShell</li><li>Verifiqueu la instal·lació amb `$PSVersionTable.PSVersion`</li></ul>                                                                                                                    |
| **Comprovació d'espai del disc del sistema**             | <ul><li>`FAIL: Free space is less than 300 MB (Current: X MB)`</li><li>`FAIL: Unable to get drive info`</li><li>`FAIL: Unable to get System Drive`</li></ul>                                                                                                                                                                                     | <ul><li>Executeu Neteja de disc per alliberar espai</li><li>Comproveu i elimineu fitxers grans innecessaris</li><li>Verifiqueu que el disc del sistema sigui accessible i muntat correctament</li><li>Comproveu la salut del disc amb `chkdsk /f`</li></ul>                                                                                                          |
| **Comprovació d'arquitectura del processador**           | `FAIL: Non-64-bit processor architecture detected: X`                                                                                                                                                                                                                                                                                            | <ul><li>Verifiqueu que el sistema compleix els requisits de 64 bits</li><li>Comproveu si s'està executant Windows de 32 bits en maquinari compatible amb 64 bits</li></ul> ARM64 està admès, p. ex., Snapdragon                                                                                                                                                      |
| **Comprovació de permisos de registre**                  | `FAIL: Registry read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                            | <ul><li>Executeu l'script com a administrador</li><li>Comproveu els permisos a HKLM:\SOFTWARE\Gorelo</li><li>Verifiqueu que l'antivirus no bloquegi l'accés al registre</li><li>Utilitzeu RegEdit per comprovar l'accessibilitat de la clau de registre</li></ul>                                                                                                    |
| **Comprovacions d'accessibilitat d'URL**                 | `FAIL: URL check for [Description] ([URL]). Error: [specific error] `                                                                                                                                                                                                                                                                            | <ul><li>Comproveu la connectivitat a Internet</li><li>Verifiqueu la resolució DNS (`nslookup` el domini)</li><li>Comproveu la configuració del tallafocs</li><li>Verifiqueu la configuració del proxy si aplica</li></ul>                                                                                                                                            |
| **Comprovació de permisos del registre d'esdeveniments** | `FAIL: Event log read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                           | <ul><li>Executeu l'script com a administrador</li><li>Comproveu que el servei Event Log estigui en execució (`Get-Service EventLog`)</li><li>Verifiqueu els permisos al registre d'esdeveniments d'Aplicació</li><li>Comproveu la funcionalitat del Visualitzador d'esdeveniments manualment</li></ul>                                                               |
| **Comprovació de variables d'entorn**                    | <ul><li>`FAIL: The PATH environment variable contains 'system32' but not 'System32\WindowsPowerShell\v1.0'`</li><li>`FAIL: The PATH environment variable contains 'System32\WindowsPowerShell\v1.0' but not 'system32'`</li><li>`FAIL: The PATH environment variable does not contain 'system32' or 'System32\WindowsPowerShell\v1.0'`</li></ul> | <ul><li>Comproveu la variable PATH del sistema a Propietats del sistema</li><li>Verifiqueu l'estructura del directori de Windows</li><li>Repareu/restaureu el PATH del sistema si s'ha modificat</li><li>Compareu amb la variable PATH d'un sistema que funcioni</li></ul>                                                                                           |
| **Comprovació de sincronització horària**                | `FAIL: Time mismatch detected! [time details]`                                                                                                                                                                                                                                                                                                   | <ul><li>Comproveu que el servei Windows Time estigui en execució</li><li>Forceu la sincronització horària: `w32tm /resync`</li><li>Verifiqueu la configuració de la zona horària</li><li>Comproveu la connectivitat a [**time.windows.com**](http://time.windows.com)</li><li>Configureu la sincronització horària automàtica a la configuració de Windows</li></ul> |

## Registres

Gorelo registra tot a:

```text theme={null}
%programfiles%\Gorelo\LogFiles\ 
```

A mesura que la instal·lació progressa, l'instal·lador crea carpetes addicionals a cada etapa amb fitxers de registre dins:

**InstallerHandler** > **Installer** > **Shell > Agent**

No dubteu a investigar els registres següents: aquí és on apareixeran els problemes més comuns:

```text theme={null}
%programfiles%\Gorelo\LogFiles\Installer\diagnostics**.log
```

```text theme={null}
%programfiles%\Gorelo\LogFiles\Agent\diagnostics**.log
```

Si el suport de Gorelo us demana fitxers de registre, envieu tota la carpeta **LogFiles** com a .zip.

## Encara teniu problemes?

Si encara experimenteu problemes d'instal·lació després de resoldre totes les fallades a la **comprovació de Gorelo Agent**, contacteu directament amb el suport de Gorelo. Utilitzeu el xat de suport via la icona "?" al menú inferior esquerre.