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, que se ejecuta a nivel sistema, y FlexxAgent Analyzer, 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. 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.
Consumos
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
Proceso FlexxAgent (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 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.
Proceso 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.
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 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
.
- Nota: La política de ejecución de Azure PowerShell debe establecerse como
Consideraciones para versiones de Windows en EOL
Las versiones de Windows en End of Life (EOL), es decir, que están fuera de soporte, tienen algunas 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 se admiten las siguientes características:
- Recopilación de métrica de consumo de GPU
- Ejecución de flujos
- Ejecución de microservicios por el usuario final
- Información de las unidades de almacenamiento
- En el caso de dispositivos virtuales, la detección de broker e hipervisor no está disponible para todos los proveedores.
- No hay datos de User Input Delay (UID) porque este contador solo es compatible con Windows Server 2019 en adelante y con Windows 10, versión 1809, en adelante.
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ónHow 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. - 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 Administrador 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.
Unos segundos después de finalizar la instalación, el dispositivo será visible en el módulo 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 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 para indicar a qué grupo de reporte se le asignará el enlace y durante cuánto tiempo 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 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
-> Nivel 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. -
Si, 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
FlexxAgent 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 FlexxAgent de forma desatendida se realiza mediante PowerShell.
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle Hidden -Wait
Desinstalación
Para desinstalar FlexxAgent 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
C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf
– donde XXXXXXXX es una cadena de letras y númerosC:\Windows\Temp\FlexxAgentInstallation.log
Carpetas
C:\Program Files\Flexxible
C:\ProgramData\Flexxible
Reinstalación
Para reinstalar FlexxAgent en un dispositivo eliminando su configuración preexistente se debe ejecutar:
FlexxAgent-Installer.exe -repairAgent
Por ejemplo:
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait
Protección contra la desinstalación
Esta funcionalidad permite proteger el proceso de desinstalación de FlexxAgent para evitar que un usuario pueda desinstalarlo de los dispositivos. La configuración se puede realizar a nivel Producto y Grupos de reporte.
Consideraciones
- La configuración solo puede realizarla un usuario Administrador de organización.
- Se requiere tener instalada la versión 25.4.2 de FlexxAgent.
- Por defecto, la funcionalidad está deshabilitada.
Configuración a nivel Producto
- Acceder a
Portal
->Configuración
->Productos
. - En la tabla, elegir el entorno sobre el que se desea ejecutar la funcionalidad, y en el campo
Acción
hacer clic sobreConfiguración del agente
. - En el formulario, habilitar o deshabilitar el botón
Protección de desinstalación de FlexxAgent
. - Hacer clic en
Guardar
.
Configuración a nivel Grupos de reporte
La ejecución de la funcionalidad puede hacerse sobre uno o varios grupos de reporte.
Habilitar la protección a un grupo de reporte
- Acceder a
Portal
->Configuración
->Grupos de reporte
. - En la tabla, elegir el grupo de reporte sobre el que se desea ejecutar la funcionalidad, y en el campo
Acción
hacer clic sobreConfiguración del agente
. - En el formulario, editar la funcionalidad
Protección de desinstalación de FlexxAgent
(botón con forma de lápiz) para poder elegir entre habilitarla o deshabilitarla. - Hacer clic en
Guardar
.
Los grupos de reporte heredan la configuración que se hace a nivel Producto; no obstante, pueden sobrescribir su propia configuración.
Habilitar la protección a varios grupos de reporte
- Acceder a
Portal
->Configuración
->Grupos de reporte
. - En la tabla, seleccionar los grupos de reporte sobre los que se desea ejecutar la funcionalidad.
- Hacer clic en
Editar protección de desinstalación
. Se desplegarán tres opciones:
- Habilitar protección de desinstalación. Protege a los grupos de reporte contra la desinstalación de FlexxAgent (esta opción no estará disponible si la funcionalidad ya está habilitada en Producto).
- Deshabilitar protección de desinstalación. Permite a los usuarios desinstalar FlexxAgent (esta opción no estará disponible si la funcionalidad ya está deshabilitada en Producto).
- Restablecer protección de desinstalación. Aplica la configuración que tenga el Producto al que pertenece el grupo de reporte, sea habilitada o deshabilitada.
Un dispositivo tendrá habilitada la Protección contra la desinstalación de FlexxAgent en los siguientes casos:
- La funcionalidad está habilitada en el grupo de reporte al que pertenece.
- La funcionalidad está desactivada en el grupo de reporte (no está habilitada ni deshabilitada), pero está habilitada a nivel Producto.
Formas de desinstalar FlexxAgent con la protección habilitada
Si un usuario tiene habilitada la funcionalidad, pero necesita desinstalar FlexxAgent, tendrá dos opciones:
- Mover el dispositivo a un grupo de reporte que no tenga la protección habilitada.
- A través de un token:
- Ir a
Portal
->Workspaces
y seleccionar el dispositivo. - Ejecutar la acción
Reveal uninstall token
que mostrará un token único para ese dispositivo y que será válido hasta las 23:59:59 UTC del día siguiente. - Ir al Panel de Control de Windows y desinstalar FlexxAgent introduciendo el token.
Antes de gestionar la desinstalación de FlexxAgent a través de herramientas como Intune o scripts propios, se deben mover los dispositivos deseados a un grupo de reporte que no tenga habilitada la protección.
Flexxible recomienda tener un grupo de reporte con la Protección contra la desinstalación deshabilitada, para facilitar tareas de desinstalación de FlexxAgent en los dispositivos.
Problemas conocidos
Instalación de FlexxAgent
Problema 1 - Windows Management Instrumentation (WMI)
Durante la instalación y/o reinstalación de FlexxAgent, si el equipo tiene problemas generados por el servicio Windows Management Instrumentation (WMI), es posible que el proceso reporte estos errores en la ventana de CMD:
Solución
Ejecutar los siguientes comandos:
Stop-Service winmgmt -Force
winmgmt /resetrepository
Start-Service winmgmt
Problema 2 - Restricción de procesos PowerShell
Algunas soluciones de seguridad no permiten que la instalación y/o autoactualización de FlexxAgent se realice de forma eficaz. El instalador podría devolver el mensaje:
The process was terminated with errors. A corrupted installation was detected due to external processes. This is usually caused by antivirus activity. Please check your antivirus settings.
Solución
Excluir los siguientes archivos del dispositivo:
C:\Windows\Temp\FlexxibleIT
C:\Windows\Temp\UpdateFlexxAgent.ps1
Desinstalación de FlexxAgent
Problema - FlexxAgent continúa en la lista de servicios
Podría suceder que FlexxAgent siga apareciendo en la lista de servicios, aunque se haya desinstalado y se hayan borrado todos los ficheros. Esto provocaría que FlexxAgent no se pueda volver a instalar.
Solución
Ejecutar como administrador el siguiente comando en la ventana de CMD:
sc delete "FlexxAgent service"
A continuación, reiniciar el dispositivo.
Parámetros admitidos
Parámetro | Tipo | Descripción |
---|---|---|
proxyAbsoluteUri | [string] | URL 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 archivo 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. |
RepairAgent | [bool] | Elimina la configuración preexistente de FlexxAgent cuando se reinstala en un dispositivo. |
Help | [switch] | Lista los parámetros admitidos, con tipo y descripción. |