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

# Linux

FlexxAgent per a Linux permet incloure dispositius que executen aquest sistema operatiu a les consoles del servei de Flexxible, habilitant la seva gestió i monitoratge de forma centralitzada. L'agent està dissenyat per funcionar en diferents tipus d'entorns, incloent-hi dispositius físics, màquines i escriptoris virtuals, cosa que el converteix en una solució que s'adapta a diverses infraestructures.

S'admeten els tipus de dispositius següents:

* Dispositius físics Linux
* Dispositius virtuals sobre VMware com a hipervisor
* VDIs publicats mitjançant Citrix com a broker

## Distribucions i versions suportades

FlexxAgent és compatible amb les distribucions de Linux següents:

* Fedora 37 o posterior
* Debian/GNU Linux 11 (Bullseye) o posterior
* Ubuntu 22.04 i 24.04

Per sol·licitar la inclusió d'una nova distribució, contacta amb l'equip de Flexxible.

## Requisits

Abans d'instal·lar l'agent, es recomana actualitzar tots els paquets del sistema operatiu. Durant el procés d'instal·lació, s'afegiran automàticament els components necessaris en funció de la distribució detectada.

Dependències de paquets requerides a Fedora i Debian:

* dmidecode
* imvirt
* systemd

## Limitacions

Algunes funcionalitats no estan disponibles en sistemes Linux, com Flexxible Assist, microserveis d'usuari final, execució de fluxos o recopilació de dades de perifèrics Plug and Play.

## Descàrrega i instal·lació

La instal·lació de FlexxAgent a Linux es realitza mitjançant un script d'instal·lació i un fitxer `deb` o `rpm`, aquest últim en el cas de voler fer una instal·lació offline (sense descàrrega automàtica del paquet d'instal·lació).

1. Fer clic al botó **Descarregar FlexxAgent**, ubicat a la part inferior del menú.
2. Seleccionar un grup de report al desplegable corresponent.
3. Descarregar el fitxer de llicència/configuració (`.conf`) i l'instal·lador per a Linux.

<img src="https://mintcdn.com/flexxible/zA3m6tfe7aHVcynj/images/flexxagent/agent-download.png?fit=max&auto=format&n=zA3m6tfe7aHVcynj&q=85&s=8315a7776e8bd6bcabd1e4b479a0ab2f" alt="agent-download" width="750" height="553" data-path="images/flexxagent/agent-download.png" />

### Tipus d'instal·ladors disponibles

Les opcions avançades permeten seleccionar el tipus d'instal·lador segons la distribució:

* **Debian**
  * `sh` (opció recomanada): instal·lació estàndard o instal·lació offline.
  * `deb`: instal·lació offline.

* **Fedora**
  * `sh` (opció recomanada): instal·lació estàndard o instal·lació offline.
  * `rpm`: instal·lació offline.

<img src="https://mintcdn.com/flexxible/q1YxZnwjK9N0wP6Z/images/flexxagent/wizard4.png?fit=max&auto=format&n=q1YxZnwjK9N0wP6Z&q=85&s=27b5693bf40166147c784c3a7c5cf4d4" alt="wizard4" width="746" height="352" data-path="images/flexxagent/wizard4.png" />

#### Paràmetres del script d'instal·lació

| Paràmetre                | Descripció                                                                                                                                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-v,--version <VERSION>` | Usa una versió específica; per defecte **latest**.                                                                                                                                                                                                |
| `-d,--distro <DISTRO>`   | El script detecta automàticament la distribució del sistema en què s'executa. Aquest paràmetre permet forçar la instal·lació de la versió de FlexxAgent per a una distribució específica quan es treballa amb distribucions derivades o similars. |
| `--verbose,-Verbose`     | Mostra informació de diagnòstic.                                                                                                                                                                                                                  |
| `-c,--config <CONFFILE>` | Aplica la configuració des d'un fitxer de configuració; per defecte **settings.conf**.                                                                                                                                                            |
| `-o, --offline`          | Instal·la FlexxAgent des d'un paquet en lloc de descarregar-lo des d'internet.                                                                                                                                                                    |
| `-?,--?,-h,--help,-Help` | Mostra l'ajuda.                                                                                                                                                                                                                                   |

##### Exemples

* Instal·lar FlexxAgent utilitzant un fitxer de configuració:

`flexxagent-install.sh [-c|--config <path/file.conf>]`

* Instal·lar una versió específica de FlexxAgent:

`flexxagent-install.sh [-v|--version <VERSION>]`

* Forçar la instal·lació de FlexxAgent per a una distribució específica:

`flexxagent-install.sh [-d|--distro <DISTRO>]`

* Accedir a l'ajuda:

`flexxagent-install.sh -h|-?|--help`

#### Instal·lació offline

FlexxAgent es pot instal·lar en entorns amb restriccions de xarxa o sense accés a internet.

Passos per a la instal·lació:

1. Col·locar a la mateixa carpeta el paquet d'instal·lació de FlexxAgent, el fitxer de configuració i el script d'instal·lació.

2. Concedir permisos al script:

`sudo chmod +x ./flexxagent-install.sh`

3. Executar el script amb el paràmetre `-o` o `--offline`, indicant el paquet a instal·lar:

`sudo ./flexxagent-install.sh -c [fitxer de configuració] -o [paquet de Flexxagent]`

4. Eliminar els fitxers utilitzats si ja no són necessaris.

## Desinstal·lació

El script de desinstal·lació es pot descarregar des de la URL següent:

```
https://update.workspaces.flexxible.com/agents/Linux/FlexxAgent/latest/flexxagent-uninstall.sh
```

**Passos per a la desinstal·lació**

1. Descarregar el desinstal·lador de la URL.
2. Atorgar permisos al script.
   `sudo chmod +x ./flexxagent-uninstall.sh`
3. Executar el script.
   `sudo ./flexxagent-uninstall.sh`
4. Eliminar els fitxers utilitzats si escau.

### Paràmetres del script de desinstal·lació

| Paràmetre                | Descripció                                                                                                                                                                                                                                            |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-d,--distro <DISTRO>`   | El script detecta automàticament la distribució del sistema en què s'executa. Aquest paràmetre ajuda a forçar la desinstal·lació de la versió de FlexxAgent per a una distribució específica quan es treballa amb distribucions derivades o similars. |
| `-c,--cleanup <VERSION>` | Elimina configuracions i logs; per defecte **false**.                                                                                                                                                                                                 |
| `-?,--?,-h,--help,-Help` | Mostra l'ajuda.                                                                                                                                                                                                                                       |

#### Exemples

Desinstal·lar i eliminar configuracions i logs:

`flexxagent-uninstall.sh [-c|--cleanup]`

Forçar la desinstal·lació per a una distribució específica:

`flexxagent-uninstall.sh [-d|--distro <DISTRO>]`

Accedir a l'ajuda:

`sudo ./flexxagent-uninstall.sh --help`

## Configuració de proxy

La configuració del proxy s'ha de fer abans de la instal·lació, modificant el fitxer de configuració descarregat.

**Proxy no autenticat**

* `proxy = http://proxy_uri:port`
* Exemple: `proxy = http://192.168.0.100:443`

**Proxy autenticat**

* `proxy = http://user:password@proxy_uri:port`
* Exemple: `proxy = http://proxy_user:xxxxxxxx@192.168.0.100:443`

## Actualització

FlexxAgent es pot actualitzar a l'última versió executant novament el script d'instal·lació perquè descarregui i instal·li l'última versió.
