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 e sem interface gráfica, portanto, é perfeitamente compatível com mecanismos de implantação autônoma, bem como com o uso do assistente de instalação.

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

Essa estrutura permite que o FlexxAgent lide com dispositivos de várias sessões, como servidores de terminal, Citrix ou AVD, e adquira métricas detalhadas para melhorar os recursos de diagnóstico.

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

Em termos de requisitos de recursos, o FlexxAgent tem consumos muito otimizados, em torno dos seguintes valores:

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

Serviço FlexxAgent (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 é 60 segundos.
• Os eventos de erro do log de eventos são enviados a cada 10 minutos.
• As informações do perfil do usuário são recuperadas a cada 15 minutos.

FlexxAgent Analyzer (usuário)

• Inclui análise do uso do aplicativo, 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, embora essa métrica possa mudar em funcionalidades específicas.

informação

Esses valores podem ser ajustados na seção Settings nas diferentes consoles, o que proporciona flexibilidade para se adequar às necessidades específicas.

Versões suportadas

Os sistemas operacionais suportados pelo FlexxAgent são aqueles que ainda estão no ciclo de suporte de seu fabricante. Embora a instalação seja permitida em versões que não possuem esse suporte, deve-se levar em consideração que certas funcionalidades podem não estar disponíveis.

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

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

O 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 requer certos componentes de software:

• .NET Framework 4.6.2 ou posterior, Flexxible recomenda instalar .NET Framework 4.8.
• Windows PowerShell 4.0 ou posterior (Windows PowerShell 5.1 recomendado)
  • Nota: A política de execução do Azure PowerShell deve ser configurada como Sem restrições.

Considerações para versões do Windows em EOL

As versões do Windows em End of Life (EOL), isto é, que estão fora de suporte, têm algumas limitações na execução do FlexxAgent, o que pode ocasionar que certas funcionalidades não sejam suportadas.

Limitações

Quando o FlexxAgent é utilizado em sistemas operacionais Windows antigos que estão fora de suporte, não são aceitas as seguintes características:

• Coletando métricas de consumo de GPU
• Execução de fluxo
• Execução de microsserviços pelo usuário final
• Não se exibe informação das unidades de armazenamento.
• No caso de máquinas virtuais, a detecção de broker e hypervisor não está disponível para todos os provedores.
• Não há dados de User Input Delay (UID) porque este contador só é compatível com Windows Server 2019 em diante e com Windows 10, versão 1809, em diante.

A detecção de intermediários pode não funcionar para todos os intermediários. Não há dados de desempenho de atraso de entrada do usuário, já que este contador não existe no Windows 7 ou Windows Server 2008 R2.

Windows 7 e 2008

A instalação do FlexxAgent suporta o sistema operacional Windows 7 x64 ou Windows Server 2008 R2 SP1, sob as seguintes condições:

• Deve ser instalada a atualização KB4474419: SHA-2 code signing support update for Windows Server 2008 R2, Windows 7, and Windows Server 2008: September 23, 2019.
• Deve ser instalada a atualização KB3140245: Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in 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.
• Requer, pelo menos, .NET Framework 4.6, mas a Flexxible recomenda instalar .NET Framework 4.8.
• PowerShell 2.0 com Windows 7 não é compatível com a versão TLS 1.2 necessária para instalar FlexxAgent. É necessário instalar Windows Management Framework 5.1, que instala PowerShell 5.1.

Windows 8 e 2012

A instalação do FlexxAgent suporta o sistema operacional Windows 8 sob as seguintes condições:

• É necessário .NET Framework 4.6.2, a Microsoft bloqueia a instalação de versões posteriores do .NET Framework no Windows 8.0.
• São necessárias todas as atualizações de segurança do Windows para garantir a compatibilidade com TLS 1.2 e a assinatura de código SHA-2.

Descarga

DOWNLOAD DO BINÁRIO DE INSTALAÇÃO SEM INTERFACE GRÁFICA

A descarga do FlexxAgent sem interface gráfica é feita a partir de Workspaces -> Level 2 -> Grupos de relatórios.

Na tabela da vista de lista deve-se selecionar o grupo de relatório sobre o qual deseja baixar o agente e clicar no botão Baixar FlexxAgent.

Uma janela será aberta para baixar o instalador do FlexxAgent.

• Se a opção Generate standalone installer (offline) for selecionada, durante a instalação, o binário não exigirá acesso à internet para verificação ou download dos binários.

• Se, por outro lado, não for selecionada a opção Generate standalone installer (offline), o pacote de instalação mínimo será baixado. Dessa forma, o binário acessará a internet para verificar e baixar os binários mais recentes.

Implantação autônoma

FlexxAgent suporta ser lançado por meio de métodos de implantação desatendidos, tais como distribuição por GPOs, Intune, SSCM e muitas outras ferramentas.

Instalação

A instalação do FlexxAgent de forma desatendida é realizada através do PowerShell.

Processo inicial'<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle oculto -Esperar

Desinstalar

Para desinstalar o FlexxAgent de forma desatendida:

"C:\Program Files\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Program Files\Flexxible\FlexxAgent\FlexxAgent.exe" /quiet

O instalador de Windows da Microsoft utilizado para desinstalar o FlexxAgent não remove todos os arquivos, pastas, chaves de registro ou valores de registro criados durante a instalação do FlexxAgent. Se precisar de uma imagem limpa do sistema, pode remover com segurança os seguintes arquivos, pastas, chaves de registro e valores de registro.

Arquivos

• C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf – onde XXXXXXXX é uma sequência de letras e números
• C:\Windows\Temp\FlexxAgentInstallation.log

Pastas

• C:\Program Files\Flexxible
• C:\ProgramData\Flexxible

Reinstalação

Para reinstalar o FlexxAgent em um dispositivo removendo sua configuração pré-existente deve-se executar:

FlexxAgent-Installer.exe -repairAgent

Por exemplo:

Processo inicial'<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait

Problemas conhecidos

Instalação do FlexxAgent (clique para expandir)

Problema 1 - Windows Management Instrumentation (WMI)

Durante a instalação e/ou reinstalação do FlexxAgent, se o equipamento tiver problemas gerados pelo serviço Windows Management Instrumentation (WMI), é possível que o processo reporte esses erros na janela do CMD:

Solução

Executar os seguintes comandos:

Stop-Service winmgmt -Force

winmgmt /resetrepository

Start-Service winmgmt

---

Problema 2 - Restrição de processos PowerShell

Algumas soluções de segurança não permitem que a instalação e/ou autoatualização do FlexxAgent seja realizada de forma eficaz. O instalador pode retornar a mensagem:

O processo foi terminado com erros. Uma instalação corrompida foi detectada devido a processos externos. Isso geralmente é causado pela atividade do antivírus. Por favor, verifique as configurações do seu antivírus.

Solução

Excluir os seguintes arquivos do dispositivo:

C:\Windows\Temp\FlexxibleIT

C:\Windows\Temp\UpdateFlexxAgent.ps1

Desinstalação do FlexxAgent (clique para expandir)

Problema - FlexxAgent continua na lista de serviços

Pode acontecer que o FlexxAgent continue aparecendo na lista de serviços, mesmo que tenha sido desinstalado e todos os arquivos tenham sido apagados. Isso faria com que o FlexxAgent não pudesse ser reinstalado.

Solução

Executar como administrador o seguinte comando na janela do CMD:

sc delete "FlexxAgent service"

Depois, reinicie o dispositivo.

Parâmetros compatíveis

Parâmetro	Cara	Descrição
proxyAbsoluteUri	[string]	URL e porta do proxy.
proxyUser	[string]	Usuário para proxy autenticado.
proxyPass	[string]	Senha para proxy autenticado.
proxyPersistConfig	[switch]	Se especificado, a configuração é mantida no registro.
configFilePath	[string]	Diretório alternativo para o arquivo FlexxAgent-Configuration.conf.
DebugMode	[switch]	Quando especificado, ele cria um arquivo de texto na mesma pasta com a transcrição da execução do script.
RepairAgent	[bool]	Remove a configuração pré-existente do FlexxAgent quando reinstalado em um dispositivo.
Help	[switch]	Lista os parâmetros suportados, com tipo e descrição.

Configurações de proxy

FlexxAgent suporta proxies configurados de forma transparente a nível de sistema. Proxies com e sem autenticação também são suportados. A configuração do proxy pode ser realizada por linha de comando ou através da modificação de chaves de registro.

Configuração de 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 é para o IP ou DNS mais a porta proxy, ou incluindo credenciais:

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

informação

Pode ser que o FlexxAgent não tenha acesso ao proxy configurado se estiver fora da rede corporativa. Para determinar a acessibilidade, o FlexxAgent tenta resolver o registro DNS e faz uma solicitação TCP para a porta correspondente. Se o proxy não for acessível, ele reportará diretamente (sem proxy).

Configuração usando chaves do Registro

Localização das chaves de registro que cuidam de armazenar a configuração do proxy para FlexxAgent:

'Equipe\HKEY_LOCAL_MACHINE\SOFTWARE\Políticas\Flexxible\FlexxAgent\Comunicações'

Chaves do Registro relacionadas às configurações de proxy:

• Chave Proxy_URL
• Chave Proxy_User
• Chave Proxy_Pwd

Chave Proxy_URL

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

Chave Proxy_User

• Rota da chave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nome da chave: Proxy_User
• Tipo de chave: REG_SZ
• Valores suportados: o nome de usuário para autenticar no proxy; por exemplo, 'Administrador'. Ele pode ser ignorado para proxies não autenticados.

Chave Proxy_Pwd

• Rota da chave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nome da chave: Proxy_Pwd
• Tipo de chave: REG_SZ
• Valores suportados: A senha para autenticar no proxy. Ele pode ser ignorado para proxies não autenticados. O valor da chave Proxy_Pwd pode ser definido como texto sem formatação (não recomendado) ou codificado em base64 e delimitado por "&&&". Por exemplo: '&&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&&' para o valor "Proxy_Pwd". Em ambos os casos, o FlexxAgent criptografa o valor assim que o FlexxAgent inicia ou tenta transmitir informações. Você pode usar um site como o https://www.base64encode.org/ para criar a string de senha codificada em base64.

informação

Levando em consideração que o FlexxAgent desencadeia um processo em nível de sistema (FlexxAgent.exe) e outro em nível de sessão (FlexxAgent Analyzer.exe) e dependendo de como o proxy age em um nível ou outro, pode ser necessário aplicar configurações diferentes para ambos os processos através da definição do Tipo de proxy. Isso pode ser feito nas Configurações do FlexxAgent, em Produtos.

Atualização manual

O caminho para atualizar o FlexxAgent manualmente: 'Nível 1' -> 'Espaços de trabalho' -> 'Operações' -> 'FlexxAgent' -> 'Atualizar para a versão mais recente'.

Você pode ver as diferentes versões instaladas na opção suspensa 'Meus filtros' -> 'Filtros predefinidos' -> 'Resumo da versão do FlexxAgent'. Isso gerará uma exibição de todos os dispositivos agrupados por versão do FlexxAgent.

Assim que a operação de atualização for executada, um 'Job' será gerado na seção correspondente com todos os detalhes da operação.

Logs

O 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 logs permitem que você consulte informações e diagnostique problemas a partir da instalação do FlexxAgent.

Logs de instalação e atualização

Dentro da pasta 'C:\Windows'\Temp\Flexxible' deixa um log de texto contendo informações sobre o processo de instalação ou atualização, bem como informações de dependência e detalhes do processo.

Logs de FlexxAgent Analyzer

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

Nível de log de alterações para o FlexxAgent Analyzer

A partir de Workspaces, é possível alterar o nível de log para um ou mais dispositivos usando as opções disponíveis no botão 'Operações'.

Logs de serviço do FlexxAgent

Os logs de serviço do FlexxAgent podem ser consultados na ramificação 'Aplicativo', dentro do 'Visualizador de Eventos' do Windows.