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

La descarga del binario de instalación para FXXOne está disponible con interfaz gráfica y sin ella.

DESCARGA DEL BINARIO DE INSTALACIÓN CON INTERFAZ GRÁFICA

BOTÓN PARA DESCARGAR FLEXXAGENT

En Portal -> Inicio, el botón Descargar el agente permitirá descargar FlexxAgent en el dispositivo. Esta opción está disponible para todos los usuarios Administradores de Organización de cualquier tipo de organización.

Si la organización tiene más de un grupo de reporte, al hacer clic en el botón Descargar el agente la interfaz cambiará hacia la sección Grupos de reporte para descargar FlexxAgent en el grupo de reporte elegido.

Pasados unos segundos después de finalizar la instalación, el dispositivo será visible en Workspaces. A partir de ese momento, se activarán todas las funcionalidades para controlar, monitorizar y automatizar tareas en tus dispositivos.

BOTÓN PARA GENERAR UN ENLACE MÁGICO

El botón Generar enlace mágico optimiza el acceso a la descarga de FlexxAgent en los dispositivos. Permite a los usuarios con rol Administrador de Organización dentro de una organización de tipo socio generar y enviar un enlace a los usuarios para que puedan descargar el agente en sus dispositivos sin estar logueados.

Crear un enlace mágico

El botón Generar un enlace mágico está ubicado en la página de inicio de Portal en las consolas de los usuarios con rol Administrador de Organización dentro de una organización de tipo socio.

Al hacer clic sobre el botón se abre un formulario donde se debe indicar a qué grupo de reporte se le asignará el enlace y durante cuánto tiempo este estará activo.

A continuación una ventana indicará que el enlace ha sido creado. Y permitirá copiarlo directamente para poder compartirlo.

Al hacer clic en Aceptar, de forma automática la consola irá a la vista de detalle del grupo de reporte elegido. Desde ahí se podrá consultar el enlace mágico que se acaba de crear, así como otros que se hayan creado con anterioridad.

Utilizar un enlace mágico

Para utilizar el enlace basta con copiarlo y pegarlo en la barra de dirección del navegador. En ese momento, FlexxAgent mostrará la siguiente pantalla, indicando que se ha descargado en el dispositivo.

Revocar un enlace mágico

Se puede revocar un Enlace mágico desde desde Portal -> Configuración -> Grupos de reporte. En la vista de lista se debe hacer clic sobre el grupo de reporte donde se encuentra en Enlace mágico que se desea revocar. Y, a continuación, en el campo Acción de la tabla, elegir la opción Revocar.

Aparecerá una ventana para confirmar la acción.

Al hacer clic en Aceptar, en la tabla del grupo de reporte aparecerá durante unos segundos un mensaje informando de la acción: "El enlace mágico se ha revocado correctamente".

No es posible volver a utilizar un Enlace mágico que ha sido revocado o que haya expirado.

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 %LOCALAPPDATA%\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.