Windows

FlexxAgent suporta sistemas operacionais Windows de 64 bits, não é possível instalá-lo em sistemas de 32 bits. O binário de instalação está disponível com interface gráfica e sem ela, sendo perfeitamente compatível com mecanismos de implantação desatendida, bem como utilizando o assistente de instalação.

FlexxAgent é composto por um serviço do Windows chamado FlexxAgent Service, que dirige dois processos: FlexxAgent (processo), que é executado a nível de sistema, e FlexxAgent Analyzer (processo), que é iniciado para cada sessão de usuário.

Essa estrutura habilita o FlexxAgent a abordar dispositivos de múltiplas sessões, como servidores de terminal, Citrix ou AVD, e adquirir métricas detalhadas para melhorar as capacidades de diagnóstico.

Por exemplo, se uma pessoa está trabalhando em seu laptop, o processo FlexxAgent seria executado a nível de sistema e o FlexxAgent Analyzer a partir da identidade do usuário; e se o dispositivo hospedar múltiplas sessões de usuário, além do FlexxAgent a nível de sistema, o FlexxAgent Analyzer seria executado para cada sessão de usuário nesse dispositivo.

Em relação aos requisitos de recursos, o FlexxAgent tem consumos muito otimizados, rondando os seguintes valores:

• Espaço em disco utilizado: < 200 MB
• CPU: < 0.5%
• RAM: 100-200 MB

FlexxAgent Service (sistema)

• Para a informação de consumo de recursos, que inclui contadores de desempenho, hardware, sessões, perfis, discos, partições e serviços do Windows, o valor padrão é de 60 segundos.
• Os eventos de erro do registro de eventos são enviados a cada 10 minutos.
• A informação dos perfis de usuário é obtida a cada 15 minutos.

FlexxAgent Analyzer (usuário)

• Inclui a análise de uso das aplicações, dados de diagnóstico e experiência do usuário.
• Os dados são coletados de forma local a cada 15 segundos.
• O relatório é enviado ao serviço a cada 5 minutos.

Esses valores podem ser adaptados em Settings nas diferentes consolas, o que oferece flexibilidade para se ajustar às necessidades específicas.

Versões suportadas

Os sistemas operacionais compatíveis com FlexxAgent são aqueles que ainda estão em ciclo de suporte pelo fabricante. Embora seja permitida a instalação em versões que não contem com esse suporte, deve-se ter em mente que certas funcionalidades podem não estar disponíveis.

Os sistemas operacionais Microsoft com suporte e compatibilidade completa são:

• Microsoft Windows 10 ou posterior
• Microsoft Windows Server 2016 ou posterior

FlexxAgent também pode ser instalado no Windows 7 e 8.1 SP1, Windows Server 2008 R2 SP1 e Windows Server 2012, mas estará sujeito a algumas limitações.

Requisitos de software

FlexxAgent também requer certos componentes de software:

• .NET Framework 4.6.2 ou posterior
• Windows PowerShell 4.0 ou posterior (recomendado Windows PowerShell 5.1)

Limitações

Quando se utiliza o FlexxAgent em sistemas operacionais Windows antigos que estão fora de suporte, não são suportadas as seguintes características do Analyzer:

• Pesquisas com usuários
• Coleta de métrica de consumo de GPU
• Execução de flows
• Execução de microsserviços de usuário

Se o FlexxAgent for instalado em um sistema operacional Windows 7 ou Windows Server 2008 R2, devem ser instalados os seguintes KBs:

• KB4474419: Atualização de suporte a assinatura de código SHA-2 para Windows Server 2008 R2, Windows 7, e Windows Server 2008: 23 de setembro de 2019.
• KB3140245: Atualização para habilitar TLS 1.1 e TLS 1.2 como protocolos seguros padrão no WinHTTP em Windows e seguir as instruções da seção How to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows da página de suporte da Microsoft.

Download

O download do binário de instalação está disponível sem interface gráfica.

Download do binário de instalação sem interface gráfica

Para baixar o FlexxAgent sem interface gráfica é necessário fazê-lo de Workspaces -> Level 2 -> Grupos de reporte, na parte superior direita da tela há um botão que permite o download com duas opções:

• Pacote de instalação mínimo: durante a instalação, o binário acessará a internet para verificar e baixar os binários mais recentes.
• Pacote standalone: durante a instalação, o binário não necessitará de acesso à internet para verificação ou download de binários.

Desdobramento desatendido

O agente suporta ser iniciado por métodos de implantação desatendida, como distribuição por GPOs, Intune, SSCM e muitas outras ferramentas.

Instalação

A instalação de forma desatendida é realizada via PowerShell.

Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<adicionar parâmetro>" -WindowStyle Hidden -Wait

Exemplo de instalação desatendida adicionando parâmetro de instalação:

Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait

Desinstalação

Para desinstalar de forma desatendida: "C:\Program Files\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Program Files\Flexxible\FlexxAgent\FlexxAgent.exe" /quiet

Parâmetros admitidos

Parâmetro	Tipo	Descrição
RepairAgent	bool	Força a reparação. Falha se o agente não estiver instalado.
proxyAbsoluteUri	string	URI e porta do proxy.
proxyUser	string	User para proxy autenticado.
proxyPass	string	Password para proxy autenticado.
proxyPersistConfig	switch	Se especificado, persiste a configuração no registro.
DebugMode	switch	Quando especificado, cria um arquivo de texto na mesma pasta com a transcrição da execução do script.
configFilePath	string	Diretório alternativo para o arquivo FlexxAgent-Configuration.conf.

Configuração do proxy

FlexxAgent suporta proxies configurados de forma transparente a nível de sistema, sem necessidade de configuração. Também são suportados proxies com autenticação e sem autenticação. A configuração do proxy pode ser realizada por linha de comando ou por modificação de chaves de registro que controlam essa configuração.

Configuração do proxy via linha de comando

Instalação com parâmetros: FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyPersistConfig:$True

Onde ip.ad.dre.ss:port é o IP ou DNS mais a porta do proxy, ou incluindo credenciais:

FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyUser ProxyUserName -proxyPass ProxyUserPassword -proxyPersistConfig:$True

Configuração por meio de chaves de registro

As chaves de registro que armazenam a configuração do proxy para o FlexxAgent estão localizadas em:

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications

Chaves de registro relativas à configuração do proxy:

• Chave Proxy_URL
• Chave Proxy_User
• Chave Proxy_Pwd

Chave Proxy_URL

• Caminho da chave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nome da chave: Proxy_URL
• Tipo de chave: REG_SZ
• Valores aceitos: a URL e a porta; por exemplo http://192.168.1.1:3128 ou https://192.168.1.1:3128

Chave Proxy_User

• Caminho da chave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nome da chave: Proxy_User
• Tipo de chave: REG_SZ
• Valores aceitos: o nome de usuário para autenticação no proxy; por exemplo Administrador. Pode ser omitido para proxies não autenticados.

Chave Proxy_Pwd

• Caminho da chave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nome da chave: Proxy_Pwd
• Tipo de chave: REG_SZ
• Valores admitidos: A senha para autenticar no proxy. Pode ser omitido para proxies não autenticados. O valor da chave Proxy_Pwd pode ser estabelecido em texto claro (não recomendado) ou codificado em base64 e cercado por «&&&». Por exemplo: &&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&& para o valor “Proxy_Pwd”. Em ambos os casos, FlexxAgent cifra o valor assim que o FlexxAgent é iniciado ou tenta transmitir informação. Pode-se utilizar um site como https://www.base64encode.org/ para criar a cadeia de senha codificada em base64.

Atualização

FlexxAgent pode ser atualizado de forma automática ou manual a partir de Workspaces.

Atualização automática

Esta funcionalidade é controlada por uma configuração em Workspaces que, geralmente, está ativada. O caminho para ver ou alterar a configuração desta funcionalidade é Workspaces -> Level 3 -> Settings -> Auto update. Selecionar True permitirá que, quando for detectada uma nova versão do FlexxAgent, ela seja enviada automaticamente para todos os dispositivos ativos da organização. Esta ação deixará um Job em Workspaces com todos os detalhes da operação.

Atualização manual

O caminho para atualizar o FlexxAgent manualmente: Level 1 -> Workspaces -> Operations -> FlexxAgent -> Update to latest version.

Pode-se conhecer as diferentes versões instaladas na opção desdobrável Meus filtros -> Filtros predefinidos -> Resumo da versão do FlexxAgent. Isso gerará uma visualização de todos os dispositivos agrupados por versão do FlexxAgent.

Uma vez executada a operação de atualização, será gerado um Job na seção correspondente com todos os detalhes da operação.

Logs

FlexxAgent pode gerar três tipos de logs:

• Logs de instalação e atualização
• Logs do FlexxAgent Analyzer
• Logs do serviço FlexxAgent

Esses registros permitem consultar informações e diagnosticar problemas desde a instalação do FlexxAgent.

Logs de instalação e atualização

Dentro da pasta C:\Windows\Temp\Flexxible é deixado um log de texto que contém informações do processo de instalação ou atualização, bem como informações de dependências e detalhes do processo.

Logs do FlexxAgent Analyzer

Dentro do diretório %LOCALAPPDATA%\FAAgent\Logs são armazenados os logs do FlexxAgent Analyzer. Estes podem ser configurados para incluir ou não informações por níveis de criticidade.

Alterar nível de logs para o FlexxAgent Analyzer

A partir do Workspaces, é possível alterar o nível de log para um ou vários dispositivos através das opções disponíveis no botão Operações.

Logs do serviço FlexxAgent

Os logs do serviço FlexxAgent podem ser consultados no ramo Aplicação, dentro do Visualizador de eventos do Windows.