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 desassistida, 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 ao nível do sistema, e FlexxAgent Analyzer (processo), que é iniciado para cada sessão de usuário.

Esta estrutura habilita o FlexxAgent para 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 no seu laptop, o processo FlexxAgent seria executado em 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 em nível de sistema, o FlexxAgent Analyzer será executado para cada sessão de usuário no respectivo dispositivo.

Em relação aos requisitos de recursos, o FlexxAgent tem um consumo muito otimizado, 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.
• As informações dos perfis de usuário são obtidas a cada 15 minutos.

FlexxAgent Analyzer (usuário)

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

Esses valores podem ser adaptados em Configurações nas diferentes consoles, o que oferece flexibilidade para se ajustar às necessidades específicas.

Versões suportadas

Os sistemas operacionais compatíveis com o FlexxAgent são aqueles que ainda estão no ciclo de suporte do fabricante. Embora a instalação seja permitida em versões que não têm esse suporte, deve-se observar 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 o FlexxAgent é utilizado em sistemas operacionais Windows antigos que estão fora de suporte, não admite as seguintes características do Analyzer:

• Pesquisas aos 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, os seguintes KBs devem ser instalados:

• KB4474419: Atualização de suporte para 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 no Windows e seguir as instruções na seção How to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows na página de suporte da Microsoft.

Download

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

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

Em Home há um botão para baixar o FlexxAgent com interface gráfica. Caso a assinatura possua mais de um grupo de relatório, o botão redirecionará para a visualização dos grupos de relatório para permitir o download do agente do grupo desejado.

Alguns segundos após a instalação ser finalizada, o dispositivo será visível no Workspaces. A partir desse momento, todas as funcionalidades para controlar, monitorar e automatizar tarefas nos seus dispositivos serão ativadas.

Implantação desassistida

O agente suporta ser executado por métodos de implantação desassistida, tais como distribuição por GPOs, Intune, SSCM e muitas mais ferramentas.

Instalação

A instalação desassistida é realizada via PowerShell.

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

Exemplo de instalação desassistida 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 suportados

Parâmetro	Tipo	Descrição
RepairAgent	[bool]	Força o reparo. 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.
configFilePath	[string]	Diretório alternativo para o arquivo FlexxAgent-Configuration.conf.
DebugMode	[switch]	Quando especificado, cria um arquivo de texto na mesma pasta com a transcrição da execução do script.

Configuração de proxy

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

Configuração proxy através da 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 através de chaves de registro

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

Computador\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications

Chaves de registro relacionadas à 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 aceitos: A senha para autenticar no proxy. Pode ser omitido para proxies não autenticados. O valor da chave Proxy_Pwd pode ser configurado em texto sem formatação (não recomendado) ou codificado em base64 e entre «&&&». Por exemplo: &&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&& para o valor “Proxy_Pwd”. Em ambos os casos, o FlexxAgent criptografa o valor assim que o FlexxAgent é iniciado ou tenta transmitir informação. Você pode usar um site como https://www.base64encode.org/ para criar a cadeia de senha codificada em base64.

Atualização

FlexxAgent pode ser atualizado automaticamente ou manualmente a partir de Workspaces.

Atualização automática

Essa funcionalidade é controlada por uma configuração no Workspaces que geralmente está ativada. O caminho para ver ou alterar a configuração dessa funcionalidade é Workspaces -> Level 3 -> Settings -> Auto update. Selecionar True permitirá que, quando uma nova versão do FlexxAgent for detectada, ela seja enviada automaticamente para todos os dispositivos ativos da organização. Essa ação deixará um Job no 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.

É possível conhecer as diferentes versões instaladas na opção suspensa My filters -> Predefined filters -> FlexxAgent version summary. Isso gerará uma visã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 respectiva seção 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, assim como informações de dependências e detalhes do processo.

Logs de FlexxAgent Analyzer

Dentro do diretório %LOCALAPPDATA%\FAAgent\Logs são armazenados os logs do FlexxAgent Analyzer. Eles 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 usando as 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.