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

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

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

BOTÃO PARA BAIXAR FLEXXAGENT

Em Portal -> Início, o botão Baixar o agente permitirá baixar o FlexxAgent no dispositivo. Essa opção está disponível para todos os usuários Administradores da Organização de qualquer tipo de organização.

Se a organização tiver mais de um grupo de relatórios, ao clicar no botão Baixar o agente a interface mudará para a seção Grupos de relatórios para baixar o FlexxAgent no grupo de relatórios escolhido.

Após alguns segundos após a conclusão da instalação, o dispositivo ficará visível nos espaços de trabalho. A partir desse momento, todas as funcionalidades para controlar, monitorar e automatizar tarefas em seus dispositivos serão ativadas.

BOTÃO PARA GERAR UM LINK MÁGICO

O botão Gerar link mágico otimiza o acesso ao download do FlexxAgent nos dispositivos. Permite aos usuários com o papel Administrador de Organização dentro de uma organização parceira gerar e enviar um link aos usuários para que possam baixar o agente em seus dispositivos sem estarem logados.

Criar um link mágico

O botão Gerar um link mágico está localizado na página inicial do Portal nas contas dos usuários com papel Administrador de Organização dentro de uma organização parceira.

Ao clicar no botão, um formulário se abrirá onde deve-se indicar a que grupo de relatórios o link será atribuído e por quanto tempo ele estará ativo.

Em seguida, uma janela indicará que o link foi criado. E permitirá copiá-lo diretamente para poder compartilhá-lo.

Ao clicar em Aceitar, a console automaticamente irá para a visualização de detalhes do grupo de relatórios escolhido. A partir daí, será possível consultar o link mágico que acabou de ser criado, assim como outros que foram criados anteriormente.

Utilizar um link mágico

Para utilizar o link, basta copiá-lo e colá-lo na barra de endereço do navegador. Nesse momento, FlexxAgent mostrará a seguinte tela, indicando que foi baixado no dispositivo.

Revogar um link mágico

É possível revogar um Link mágico a partir de Portal -> Configuração -> Grupos de relatório. Na visualização da lista, clique no grupo de relatórios onde está o Link mágico que se deseja revogar. E, em seguida, na coluna Ação da tabela, escolha a opção Revogar.

Uma janela aparecerá para confirmar a ação.

Ao clicar em Aceitar, na tabela do grupo de relatórios aparecerá por alguns segundos uma mensagem informando sobre a ação: "O link mágico foi revogado com sucesso".

Não é possível reutilizar um Link mágico que foi revogado ou que expirou.

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, a opção Generate standalone installer (offline) não for selecionada, será baixado o pacote mínimo de instalação. Dessa forma, o binário acessará a internet para verificar e baixar os binários mais recentes.

Implantação autônoma

O agente dá suporte à inicialização usando métodos de implantação autônomos, como distribuição de GPO, Intune, SSCM e muitas outras ferramentas.

Instalação

A instalação autônoma é feita usando o PowerShell.

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

Exemplo de instalação autônoma adicionando parâmetro de instalação:

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

aviso

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

Para solucionar isso, Flexxible recomenda executar os seguintes comandos:

Stop-Service winmgmt -Force

winmgmt /resetrepository

Start-Service winmgmt

Desinstalar

Para desinstalar a supervisão sem supervisão: '"C:\Arquivos de Programas\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Arquivos de Programas\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.

Archivos (clic para expandir)

• C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf – donde XXXXXXXX es una cadena de letras y números
• C:\Windows\Temp\FlexxAgentInstallation.log

Carpetas (clic para expandir)

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

aviso

Depois de desinstalar o FlexxAgent, pode acontecer que ele ainda apareça na lista de serviços, embora todos os arquivos tenham sido apagados. Isso provocaria que o FlexxAgent não possa ser reinstalado.

Para solucionar, Flexxible recomenda executar como administrador o seguinte comando na janela do CMD:

sc delete "FlexxAgent service"

A seguir, reinicie o dispositivo.

Parâmetros compatíveis

Parâmetro	Cara	Descrição
Agente de reparo	[bool]	Isso força o reparo. Falhará se o agente não estiver instalado.
proxyAbsoluteUri	[string]	URI e porta 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 archive FlexxAgent-Configuration.conf.
Modo de depuração	[switch]	Quando especificado, ele cria um arquivo de texto na mesma pasta com a transcrição da execução do script.

Configurações de proxy

O FlexxAgent oferece suporte a proxies configurados de forma transparente no nível do sistema, sem necessidade de configuração. Proxies com e sem autenticação também são suportados. A configuração do proxy pode ser feita por linha de comando ou modificando as chaves do Registro que controlam essa configuração.

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`

Configuração usando chaves do Registro

As chaves do Registro responsáveis por armazenar as configurações de proxy do FlexxAgent estão localizadas:

'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

Principais 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'

Proxy_User chave

• 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.

Principais 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

O FlexxAgent pode ser atualizado automaticamente ou manualmente pelo Workspaces.

Atualização automática

Essa funcionalidade é controlada por uma configuração no Workspaces que geralmente está ativada. O caminho para visualizar ou alterar as configurações desse recurso é 'Workspaces' -> 'Nível 3' -> 'Configurações' -> 'Atualização automática'. Selecionar 'True' permitirá que, quando uma nova versão do FlexxAgent for detectada, ela seja enviada automaticamente para todos os dispositivos ativos na organização. Essa ação deixará um 'Trabalho' no Workspaces com todos os detalhes da operação.

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 %LOCALAPPDATA%\Flexxible um log de texto é deixado com informações do processo de instalação ou atualização, bem como informações de dependências 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.