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çãoHow 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 com interface gráfica.
Download do binário de instalação com interface gráfica
Na Home
há um botão para baixar o FlexxAgent com interface gráfica. Caso a assinatura tenha mais de um grupo de relatório, o botão redirecionará para a visão de grupos de relatório para permitir baixar o agente do grupo desejado.
Alguns segundos após finalizar a instalação, o dispositivo será visível no Workspaces. A partir desse momento, todas as funcionalidades serão ativadas para controlar, monitorar e automatizar tarefas nos seus dispositivos.
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
ouhttps://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.