Windows

FlexxAgent soporta sistemas operativos Windows de 64 bits, no es posible instalarlo en sistemas de 32 bits. El binario de instalación está disponible con interfaz gráfica y sin ella, por lo que es perfectamente compatible con mecanismos de despliegue desatendido, así como utilizando el asistente de instalación.

FlexxAgent se compone de un servicio de Windows llamado FlexxAgent Service, el cual dirige dos procesos: FlexxAgent (proceso), que se ejecuta a nivel sistema, y FlexxAgent Analyzer (proceso), que se inicia para cada sesión de usuario.

Esta estructura habilita a FlexxAgent para abordar dispositivos de múltiples sesiones, como servidores de terminal, Citrix o AVD, y adquirir métricas detalladas para mejorar las capacidades de diagnóstico.

Por ejemplo, si una persona está trabajando en su portátil, se ejecutaría el proceso FlexxAgent a nivel de sistema y FlexxAgent Analyzer desde la identidad del usuario; y si el dispositivo hospeda múltiples sesiones de usuario, se ejecutaría, además de FlexxAgent a nivel de sistema, FlexxAgent Analyzer por cada sesión de usuario en dicho dispositivo.

En cuanto a requisitos de recursos, FlexxAgent tiene consumos muy optimizados, rondando los siguientes valores:

• Espacio en disco utilizado: < 200 MB
• CPU: < 0.5%
• RAM: 100-200 MB

FlexxAgent Service (sistema)

• Para la información de consumo de recursos, que incluye contadores de rendimiento, hardware, sesiones, perfiles, discos, particiones y servicios de Windows, el valor por defecto es de 60 segundos.
• Los eventos de error del registro de eventos se envían cada 10 minutos.
• La información de los perfiles de usuario se obtiene cada 15 minutos.

FlexxAgent Analyzer (usuario)

• Incluye el análisis de uso de las aplicaciones, datos de diagnóstico y experiencia de usuario.
• Los datos se recolectan de forma local cada 15 segundos.
• El reporte se envía al servicio cada 5 minutos, aunque esta métrica puede cambiar en funcionalidades específicas.

info

Estos valores se pueden adaptar en el apartado Settings en las diferentes consolas, lo que otorga flexibilidad para ajustarse a las necesidades específicas.

Versiones soportadas

Los sistemas operativos compatibles con FlexxAgent son aquellos que aún se encuentran en ciclo de soporte por su fabricante. Aunque se permite la instalación en versiones que no cuenten con ese soporte, se debe tener en cuenta que ciertas funcionalidades podrían no estar disponibles.

Los sistemas operativos Microsoft con soporte y compatibilidad completa son:

• Microsoft Windows 10 o posterior
• Microsoft Windows Server 2016 o posterior

FlexxAgent también puede instalarse en Windows 7 y 8.1 SP1, Windows Server 2008 R2 SP1 y Windows Server 2012, pero estará sujeto a algunas limitaciones.

Requisitos de software

FlexxAgent también requiere ciertos componentes de software:

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

Limitaciones

Cuando se utiliza FlexxAgent en sistemas operativos Windows antiguos que están fuera de soporte, no admite las siguientes características de Analyzer:

• Encuestas a usuarios
• Recopilación de métrica de consumo de GPU
• Ejecución de flows
• Ejecución de microservicios de usuario

Si FlexxAgent se instala en un sistema operativo Windows 7 o Windows Server 2008 R2, deben instalarse las siguientes KBs:

• KB4474419: SHA-2 code signing support update for Windows Server 2008 R2, Windows 7, and Windows Server 2008: September 23, 2019.
• KB3140245: Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows y seguir las instrucciones de la sección How to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows de la página de soporte de Microsoft.

Descarga

La descarga del binario de instalación está disponible sin interfaz gráfica.

Descarga del binario de instalación sin interfaz gráfica

La descarga de FlexxAgent sin interfaz gráfica se realiza desde Workspaces -> Level 2 -> Grupos de reporte.

En la tabla de la vista de lista se debe seleccionar el grupo de reporte sobre el que se desea descargar el agente y hacer clic sobre el botón Descargar FlexxAgent.

Se abrirá una ventana para descargar el instalador de FlexxAgent.

• Si se selecciona la opción Generate standalone installer (offline), durante la instalación, el binario no requerirá acceso a internet para la comprobación o descarga de binarios.

• Sí, por el contrario, no se selecciona la opción Generate standalone installer (offline), se descargará el paquete de instalación mínimo. De esta manera, el binario accederá a internet para comprobar y descargar los binarios más recientes.

Despliegue desatendido

El agente soporta ser lanzado mediante métodos de despliegue desatendido, tales como distribución por GPOs, Intune, SSCM y muchas más herramientas.

Instalación

La instalación de forma desatendida se realiza mediante PowerShell.

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

Ejemplo instalación desatendida agregando parámetro de instalación:

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

Desinstalación

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	Descripción
RepairAgent	[bool]	Fuerza la reparación. Falla si el agente no está instalado.
proxyAbsoluteUri	[string]	URI y puerto del proxy.
proxyUser	[string]	User para proxy autenticado.
proxyPass	[string]	Password para proxy autenticado.
proxyPersistConfig	[switch]	Si se especifica, se persiste la configuración en el registro.
configFilePath	[string]	Directorio alternativo para el archive FlexxAgent-Configuration.conf.
DebugMode	[switch]	Cuando se especifica, crea un archivo de texto en la misma carpeta con la transcripción de la ejecución del script.

Configuración proxy

FlexxAgent admite proxies configurados de forma transparente a nivel de sistema, sin necesidad de configuración. También se soportan proxies con autenticación y sin ella. La configuración del proxy se puede realizar por línea de comandos o mediante modificación de claves de registro que controlan esta configuración.

Configuración proxy mediante línea de comandos

Instalación con parámetros: FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyPersistConfig:$True

Donde ip.ad.dre.ss:port es a la IP o DNS más el puerto del proxy, o incluyendo credenciales:

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

Configuración mediante claves de registro

Las claves de registro que se ocupan de almacenar la configuración del proxy para FlexxAgent se localizan:

Equipo\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications

Claves de registro relativas a la configuración proxy:

• Clave Proxy_URL
• Clave Proxy_User
• Clave Proxy_Pwd

Clave Proxy_URL

• Ruta de la clave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nombre de la clave: Proxy_URL
• Tipo de clave: REG_SZ
• Valores admitidos: la URL y el puerto; por ejemplo http://192.168.1.1:3128 o https://192.168.1.1:3128

Clave Proxy_User

• Ruta de la clave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nombre de la clave: Proxy_User
• Tipo de clave: REG_SZ
• Valores admitidos: el nombre de usuario para autenticarse en el proxy; por ejemplo Administrador. Puede omitirse para proxies no autenticados.

Clave Proxy_Pwd

• Ruta de la clave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
• Nombre de la clave: Proxy_Pwd
• Tipo de clave: REG_SZ
• Valores admitidos: La contraseña para autenticarse en el proxy. Puede omitirse para proxies no autenticados. El valor de la clave Proxy_Pwd puede establecerse en texto sin formato (no recomendado) o codificado en base64 y encerrado por «&&&». Por ejemplo: &&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&& para el valor “Proxy_Pwd”. En cualquiera de los dos casos, FlexxAgent cifra el valor en cuanto el FlexxAgent se inicia o intenta transmitir información. Puede utilizar un sitio como https://www.base64encode.org/ para crear la cadena de contraseña codificada en base64.

Actualización

FlexxAgent puede actualizarse de forma automática o manual desde Workspaces.

Actualización automática

Esta funcionalidad se controla con un ajuste en Workspaces que usualmente está activado. La ruta para ver o cambiar la configuración de esta funcionalidad es Workspaces -> Level 3 -> Settings -> Auto update. Seleccionar True permitirá que, cuando se detecte una nueva versión de FlexxAgent, esta se envíe de forma automática a todos los dispositivos activos de la organización. Esta acción dejará un Job en Workspaces con todos los detalles de la operación.

Actualización manual

La ruta para actualizar FlexxAgent de forma manual: Level 1 -> Workspaces -> Operations -> FlexxAgent -> Update to latest version.

Se pueden conocer las diferentes versiones instaladas en la opción desplegable My filters -> Predefined filters -> FlexxAgent version summary. Esto generará una vista de todos los dispositivos agrupados por versión de FlexxAgent.

Una vez ejecutada la operación de actualización, se generará un Job en la correspondiente sección con todos los detalles de la operación.

Logs

FlexxAgent puede generar tres tipos de logs:

• Logs de instalación y actualización
• Logs de FlexxAgent Analyzer
• Logs de FlexxAgent service

Estos registros permiten consultar información y diagnosticar problemas desde la instalación de FlexxAgent.

Logs de instalación y actualización

Dentro de la carpeta C:\Windows\Temp\Flexxible se deja un log de texto que contiene información del proceso de instalación o actualización, así como información de dependencias y detalles del proceso.

Logs de FlexxAgent Analyzer

Dentro del directorio %LOCALAPPDATA%\FAAgent\Logs se almacenan los logs de FlexxAgent Analyzer. Estos pueden ser configurados para incluir o no información por niveles de criticidad.

Cambiar nivel de logs para FlexxAgent Analyzer

Desde Workspaces, es posible cambiar el nivel de log para uno o varios dispositivos mediante las opciones disponibles en el botón Operaciones.

Logs de FlexxAgent service

Se pueden consultar los logs de FlexxAgent service en la rama Aplicación, dentro del Visor de eventos de Windows.