> ## 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

O FlexxAgent para Linux permite incluir dispositivos que executam esse sistema operacional nos consoles do serviço da Flexxible, habilitando seu gerenciamento e monitoramento de forma centralizada. O agente foi projetado para funcionar em diferentes tipos de ambientes, incluindo dispositivos físicos, máquinas e desktops virtuais, o que o torna uma solução que se adapta a diversas infraestruturas.

São admitidos os seguintes tipos de dispositivos:

* Dispositivos físicos Linux
* Dispositivos virtuais sobre VMware como hypervisor
* VDIs publicados por meio de Citrix como broker

## Distribuições e versões suportadas

O FlexxAgent é compatível com as seguintes distribuições de Linux:

* Fedora 37 ou posterior
* Debian/GNU Linux 11 (Bullseye) ou posterior
* Ubuntu 22.04 e 24.04

Para solicitar a inclusão de uma nova distribuição, entre em contato com a equipe da Flexxible.

## Requisitos

Antes de instalar o agente, recomenda-se atualizar todos os pacotes do sistema operacional. Durante o processo de instalação, serão adicionados automaticamente os componentes necessários em função da distribuição detectada.

Dependências de pacotes requeridas no Fedora e Debian:

* dmidecode
* imvirt
* systemd

## Limitações

Algumas funcionalidades não estão disponíveis em sistemas Linux, como Flexxible Assist, microsserviços de usuário final, execução de fluxos ou coleta de dados de periféricos Plug and Play.

## Download e instalação

A instalação do FlexxAgent no Linux é realizada por meio de um script de instalação e um arquivo `deb` ou `rpm`, este último no caso de querer realizar uma instalação offline (sem download automático do pacote de instalação).

1. Clicar no botão **Baixar FlexxAgent**, localizado na parte inferior do menu.
2. Selecionar um grupo de relatório no dropdown correspondente.
3. Baixar o arquivo de licença/configuração (`.conf`) e o instalador para 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" />

### Tipos de instaladores disponíveis

As opções avançadas permitem selecionar o tipo de instalador de acordo com a distribuição:

* **Debian**
  * `sh` (opção recomendada): instalação padrão ou instalação offline.
  * `deb`: instalação offline.

* **Fedora**
  * `sh` (opção recomendada): instalação padrão ou instalação offline.
  * `rpm`: instalação 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âmetros do script de instalação

| Parâmetro                | Descrição                                                                                                                                                                                                                                       |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-v,--version <VERSION>` | Usa uma versão específica; por padrão **latest**.                                                                                                                                                                                               |
| `-d,--distro <DISTRO>`   | O script detecta automaticamente a distribuição do sistema em que é executado. Esse parâmetro permite forçar a instalação da versão do FlexxAgent para uma distribuição específica quando se trabalha com distribuições derivadas ou similares. |
| `--verbose,-Verbose`     | Mostra informações de diagnóstico.                                                                                                                                                                                                              |
| `-c,--config <CONFFILE>` | Aplica a configuração a partir de um arquivo de configuração; por padrão **settings.conf**.                                                                                                                                                     |
| `-o, --offline`          | Instala o FlexxAgent a partir de um pacote em vez de baixá-lo da internet.                                                                                                                                                                      |
| `-?,--?,-h,--help,-Help` | Mostra a ajuda.                                                                                                                                                                                                                                 |

##### Exemplos

* Instalar o FlexxAgent utilizando um arquivo de configuração:

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

* Instalar uma versão específica do FlexxAgent:

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

* Forçar a instalação do FlexxAgent para uma distribuição específica:

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

* Acessar a ajuda:

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

#### Instalação offline

O FlexxAgent pode ser instalado em ambientes com restrições de rede ou sem acesso à internet.

Passos para a instalação:

1. Colocar na mesma pasta o pacote de instalação do FlexxAgent, o arquivo de configuração e o script de instalação.

2. Conceder permissões ao script:

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

3. Executar o script com o parâmetro `-o` ou `--offline`, indicando o pacote a ser instalado:

`sudo ./flexxagent-install.sh -c [arquivo de configuração] -o [pacote do Flexxagent]`

4. Eliminar os arquivos utilizados se já não forem necessários.

## Desinstalação

O script de desinstalação pode ser baixado a partir da seguinte URL:

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

**Passos para a desinstalação**

1. Baixar o desinstalador a partir da URL.
2. Conceder permissões ao script.
   `sudo chmod +x ./flexxagent-uninstall.sh`
3. Executar o script.
   `sudo ./flexxagent-uninstall.sh`
4. Eliminar os arquivos utilizados, se for o caso.

### Parâmetros do script de desinstalação

| Parâmetro                | Descrição                                                                                                                                                                                                                                          |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-d,--distro <DISTRO>`   | O script detecta automaticamente a distribuição do sistema em que é executado. Esse parâmetro ajuda a forçar a desinstalação da versão do FlexxAgent para uma distribuição específica quando se trabalha com distribuições derivadas ou similares. |
| `-c,--cleanup <VERSION>` | Elimina configurações e logs; por padrão **false**.                                                                                                                                                                                                |
| `-?,--?,-h,--help,-Help` | Mostra a ajuda.                                                                                                                                                                                                                                    |

#### Exemplos

Desinstalar e eliminar configurações e logs:

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

Forçar a desinstalação para uma distribuição específica:

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

Acessar a ajuda:

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

## Configuração de proxy

A configuração do proxy deve ser realizada antes da instalação, modificando o arquivo de configuração baixado.

**Proxy não autenticado**

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

**Proxy autenticado**

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

## Atualização

O FlexxAgent pode ser atualizado para a última versão executando novamente o script de instalação para que ele baixe e instale a última versão.
