Linux

FlexxAgent para Linux permite incluir dispositivos com este sistema operacional nas consolas do serviço, habilitando assim a visibilidade completa para as equipes de suporte de todos os dispositivos em uso na organização.

O suporte a Linux inclui distribuições como Fedora, Debian e seu derivado Ubuntu. São suportados tanto dispositivos físicos quanto virtuais sobre VMware como hipervisor e também VDIs publicados com Citrix como broker.

FlexxAgent é composto por um processo do mesmo nome, que se executa a nível de sistema e obtém todas as informações do dispositivo: suas métricas de consumos, desempenhos e todas as informações visíveis nos consoles relativas ao dispositivo.

FlexxAgent Session inicia uma instância para cada sessão de usuário no dispositivo. Recolhe informações relativas à sessão, como os aplicativos utilizados e seus consumos, o uso de recursos por parte da sessão no sistema e tempos de entrega da sessão.

Versões suportadas

FlexxAgent suporta as seguintes distribuições e versões:

• Fedora 37 ou posterior
• Debian/GNU Linux 11 (bullseye) ou posterior
• Ubuntu 22.04, 24.04

Periodicamente, validam-se mais distribuições.

Para incluir alguma distribuição na lista de distribuições suportadas, por favor entre em contato com a Flexxible.

Requisitos

Antes de instalar, é recomendado atualizar todos os pacotes de sistema. Serão instalados os componentes necessários, dependendo da distribuição.

Dependências de pacotes para Fedora e Debian:

• dmidecode
• imvirt
• systemd

Limitações

Certas funcionalidades não estão disponíveis para Linux, como a assistência remota, os microsserviços de usuário ou a execução de flows, assim como a coleta de dados de periféricos plug and play.

A execução de microserviços sob demanda de Workspaces suporta Bash como linguagem de scripting.

Configurações de proxy

FlexxAgent para Linux suporta a comunicação através de proxies autenticados e não autenticados. As informações sobre o proxy devem ser fornecidas à Flexxible para incluí-las no arquivo de configuração mencionado no ponto seguinte.

Dados necessários:

• Para o caso de proxy não autenticado será necessário fornecer URL e Porta.
• Para proxy autenticado, deve-se adicionar Usuário e Senha ao mencionado anteriormente.

Download e instalação

Para instalar o FlexxAgent é necessário executar o script de instalação com um arquivo de configuração predefinido.

Scripts de instalação

Caminho para baixar o script de instalação em Ubuntu/Debian:

https://update.workspaces.flexxible.com/agents/FlexxAgent/latest/debian/x64/flexxagent-install.sh

Caminho para baixar o script de instalação em Fedora:

https://update.workspaces.flexxible.com/agents/FlexxAgent/latest/fedora/x64/flexxagent-install.sh

Ao executar o script, o FlexxAgent é baixado na sua última versão antes de instalá-lo.

É necessário o arquivo de configuração para a instalação. Pode ser obtido entrando em contato com a Flexxible.

Passos para a instalação

1. Baixar o instalador da URL.
2. Conceder permissões ao script.

   sudo chmod +x ./flexxagent-install.sh

3. Executar o script.

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

4. Limpar os arquivos utilizados.

Parâmetros do script de instalação

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

Exemplos

Instalar FlexxAgent com o 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

A instalação do FlexxAgent está disponível mesmo havendo restrições de rede no ambiente. Por favor, consulte com seu contato na Flexxible sobre como obter o pacote de instalação e o instalador para sua distribuição.

Pacotes de instalação fornecidos por distribuição

Debian: flexxagent.deb

Fedora: flexxagent.rpm

Passos para a instalação offline

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

2. Conceda permissões ao script:

sudo chmod +x ./flexxagent-install.sh

3. Execute o script com o parâmetro -o ou --offline, indicando o nome do pacote a ser instalado:

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

4. Limpe os arquivos utilizados.

Desinstalar

O script de desinstalação pode ser baixado de

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

Passos para desinstalar:

1. Baixar o desinstalador da URL.

2. Conceder permissões ao script.

   sudo chmod +x ./flexxagent-uninstall.sh

3. Executar o script.

   sudo ./flexxagent-uninstall.sh

4. Limpar os arquivos utilizados.

Parâmetros do script de desinstalação

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

Exemplos

Desinstalar e limpar configurações e logs:

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

Forçar a desinstalação para uma DISTRO:

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

Acessar a ajuda:

sudo ./flexxagent-uninstall.sh --help

Atualização

Existem duas maneiras de atualizar o FlexxAgent para sua última versão:

• Pelo Workspaces, selecionando o dispositivo e clicando em Operações -> FlexxAgent -> Update to the latest version.
• Relançando o script de instalação para que baixe e instale a última versão.

Campos obtidos

FlexxAgent obtém localmente e envia para as consoles as seguintes informações gerais:

• Nome: nome do dispositivo
• Status do dispositivo: ligado ou desligado
• Versão: versão do FlexxAgent
• Status do FlexxAgent: em execução ou parado
• Último relatório do FlexxAgent: data e hora do último relatório recebido
• Conexão: LAN sem fio, rede móvel, ethernet, desconhecido
• Rede: endereçamento da rede do dispositivo e IP público de saída para a internet. Essas redes são criadas automaticamente quando há mais de quatro workspaces conectados à mesma rede.
• Sub-rede: segmento de rede do dispositivo
• Endereço MAC
• Rede sem fio: nome da rede
• Sinal de rede: percentual de recepção de rede
• Alterações na rede: última vez que a rede foi alterada
• Sessões: número de sessões de usuário
• Último usuário: último usuário que fez login
• Conectado desde: nome do dispositivo a partir do qual o usuário fez login
• Tempo de conexão: data e hora de início da sessão
• Código: permite identificar o dispositivo com um código pessoal. Esse código deve ser atribuído manualmente e de forma individual através da opção Editar, no menu de Operações do detalhe do dispositivo.
• RAM: capacidade total da RAM disponível
• Núcleos: número de núcleos do processador
• Endereço IP: endereço IP do dispositivo na rede local
• OS: nome do sistema operacional
• Sistema operacional: versão do sistema operacional
• Disco do sistema: capacidade total e uso do disco em percentual
• IP público e ISP: este ISP é obtido utilizando o IP público. Pode não ser preciso se estiver conectado a uma rede empresarial ou utilizando uma VPN.
• Região: se obtém utilizando o IP público. Pode não ser precisa se estiver conectado a uma rede empresarial ou utilizando uma VPN.
• Tipo de broker: se detectado, mostra o broker de sessões utilizado.
• Grupo de entrega: se detectado, coleção de máquinas selecionadas de um ou vários catálogos de máquinas.
• Assinatura: se detectado, assinatura em uso para serviços Citrix Cloud, Azure, etc.
• Hipervisor: se detectada virtualização, mostra o hipervisor utilizado.
• Session Analyzer: se está configurado ou não
• Versão do Session Analyzer: número de versão do Session Analyzer
• Grupo de relatório: grupo de relatório ao qual o dispositivo pertence

No nível de informações detalhadas na visualização do dispositivo em Workspaces, inclui-se:

• Lista de sessões com detalhes de consumo de recursos (CPU/RAM) de cada sessão
• Lista de discos do workspace com o espaço ocupado
• Contadores de desempenho gráficos para CPU, RAM, largura de banda e sinal de conexão sem fio

O módulo Analyzer recebe os dados gerais do dispositivo, bem como informações sobre o consumo de CPU e RAM, os aplicativos instalados e também os processos e aplicativos em execução.

Logs

FlexxAgent pode gerar dois tipos de logs:

• Log do FlexxAgent (sistema): localizado na pasta /var/log/flexx/
• Log do FlexxAgent Session (sessão de usuário): localizado na pasta /home/[user]/.config/flexx/logs/