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, Flexxible recomienda instalar .NET Framework 4.8.
• Windows PowerShell 4.0 o posterior (recomendado Windows PowerShell 5.1)
  • Nota: La política de ejecución de Azure PowerShell debe establecerse como Sin restricciones.

Consideraciones para versiones de Windows en EOL

Las versiones de Windows en EOL (End of Life, es decir que están fuera de soporte) tienen ciertas limitaciones en la ejecución de FlexxAgent lo que puede ocasionar que ciertas funcionalidades no sean soportadas.

Limitaciones

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

• Encuestas a usuarios
• Recopilación de métrica de consumo de GPU
• Ejecución de flows
• Ejecución de microservicios de usuario
• No se muestra información de la unidades de almacenamiento.
• En el caso de maquinas virtuales, la detección de broker e hipervisor no esta disponible para todos los proveedores.
• No hay datos de UID (User Input Delay), ya que este contador no existe en Windows 7 o Windows Server 2008 R2.

La detección de intermediarios puede no funcionar para todos los intermediarios. No hay datos de rendimiento de retraso de entrada del usuario, ya que este contador no existe en Windows 7 o Windows Server 2008 R2.

Windows 7 y 2008

La instalación de FlexxAgent soporta el sistema operativo Windows 7 x64 o Windows Server 2008 R2 SP1, bajo las siguientes condiciones:

• Se debe instalar la actualización KB4474419: SHA-2 code signing support update for Windows Server 2008 R2, Windows 7, and Windows Server 2008: September 23, 2019.
• Se debe instalar la actualización 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.
• Para las URL de IoT Hub y Service Bus, los puertos TCP 5671 y 5672 del firewall de Windows deben abrirse desde el dispositivo. Nota: Windows 7 y Server 2008 R2 utilizan el protocolo de cola de mensajes avanzado (AMQP) en lugar de AMQP sobre WebSockets como protocolo de transporte.
• Requiere, al menos, .NET Framework 4.6, pero Flexxible recomienda instalar .NET Framework 4.8.
• PowerShell 2.0 con Windows 7 no es compatible con la versión TLS 1.2 necesaria para instalar FlexxAgent. Se requiere instalar Windows Management Framework 5.1, que instala PowerShell 5.1.

Windows 8 y 2012

La instalación de FlexxAgent soporta el sistema operativo Windows 8 bajo las siguientes condiciones:

• Se requiere .NET Framework 4.6.2, Microsoft bloquea la instalación de versiones posteriores de .NET Framework en Windows 8.0.
• Se requieren todas las actualizaciones de seguridad de Windows para garantizar la compatibilidad con TLS 1.2 y la firma de código SHA-2.

Descarga

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

El instalador de Windows de Microsoft que se utiliza para desinstalar FlexxAgent no elimina todos los archivos, carpetas, claves de registro o valores de registro creados durante la instalación de FlexxAgent. Si necesita una imagen limpia del sistema, puede eliminar de forma segura los siguientes archivos, carpetas, claves de registro y 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

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.