Windows
FlexxAgent suporta sistemes operatius Windows de 64 bits, no és possible instal·lar-lo en sistemes de 32 bits. El binari d'instal·lació està disponible amb o sense interfície gràfica, per tant és compatible tant amb mètodes de desplegament desatès, com amb la instal·lació mitjançant assistent.

Arquitectura del servei
FlexxAgent es compon d'un servei de Windows anomenat FlexxAgent Service, que coordina dos processos:
- FlexxAgent, executat a nivell sistema
- FlexxAgent Analyzer, iniciat per a cada sessió d'usuari.
Aquesta arquitectura permet que FlexxAgent gestioni dispositius amb múltiples sessions (com servidors de terminal, Citrix o AVD) i obtingui mètriques detallades per millorar les capacitats de diagnòstic.
Exemple:
- En un portàtil, s'executen FlexxAgent (a nivell de sistema) i FlexxAgent Analyzer (sota la identitat de l'usuari).
- En un dispositiu amb múltiples sessions, a més de FlexxAgent, s'executarà un procés FlexxAgent Analyzer per cada sessió.
Consums
FlexxAgent està optimitzat per minimitzar l'ús de recursos. Els valors aproximats són:
- Espai en disc: < 200 MB
- CPU: < 0,5%
- RAM: 100-200 MB
Procés FlexxAgent (sistema)
- Recollida d'informació de rendiment, maquinari, sessions, perfils, discos, particions i serveis de Windows: cada 60 segons.
- Enviament d'esdeveniments d'error del registre d'esdeveniments: cada 10 minuts.
- Actualització d'informació de perfils d'usuari: cada 15 minuts.
Procés FlexxAgent Analyzer (usuari)
- Analitza l'ús d'aplicacions, dades de diagnòstic i experiència d'usuari.
- Recollida local de dades: cada 15 segons.
- Enviament d'informes al servei: cada 5 minuts (aquesta mètrica pot canviar en funcionalitats específiques).
Versions suportades
FlexxAgent és compatible amb els sistemes operatius Windows actualment en cicle de suport per Microsoft. Encara que pot instal·lar-se en versions sense suport, algunes funcionalitats podrien no estar disponibles.
Compatibilitat completa
- Microsoft Windows 10 versió o posterior
- Microsoft Windows Server 2016 o posterior
Compatibilitat limitada
- Windows 7 SP1
- Windows 8.1 SP1
- Windows Server 2008 R2 SP1
- Windows Server 2012
Requisits de programari
FlexxAgent requereix els components següents:
- .NET Framework 4.6.2 o posterior (recomanat: .NET Framework 4.8).
- Windows PowerShell 4.0 o posterior (recomanat PowerShell 5.1).
- Nota: La política d'execució de Azure PowerShell s'ha d'establir a Sense restriccions.
Consideracions per a versions de Windows en EOL
En sistemes fora de suport (EOL), FlexxAgent pot presentar limitacions o manca de compatibilitat amb determinades funcionalitats.
Funcionalitats no suportades
Quan s'utilitza FlexxAgent en sistemes operatius Windows antics que estan fora de suport, no s'admeten les següents funcionalitats:
- Recopilació de mètriques de consum de GPU.
- Execució de fluxos.
- Execució de microserveis per l'usuari final.
- Obtenció d'informació de les unitats d'emmagatzematge.
- En el cas de dispositius virtuals, detecció de broker i hipervisor (limitada segons proveïdor).
- User Input Delay (UID) (només disponibles a partir de Windows Server 2019 i Windows 10 versió 1809).
La detecció d'intermediaris pot no funcionar per a tots. No hi ha dades de rendiment de retard d'entrada de l'usuari, ja que aquest comptador no existeix en Windows 7 o Windows Server 2008 R2.
Windows 7 i 2008 R2
FlexxAgent pot instal·lar-se en Windows 7 x64 o Windows Server 2008 R2 SP1 sota les condicions següents:
- Instal·lar l'actualització KB4474419: (SHA-2 code signing support update for Windows Server 2008 R2, Windows 7, and Windows Server 2008: September 23, 2019).
- Instal·lar l'actualització KB3140245: (Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows) i seguir les instruccions de la secció How to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows de la pàgina de suport de Microsoft.
- Requereix almenys .NET Framework 4.6 (recomanat: 4.8).
- PowerShell 2.0 amb Windows 7 no és compatible amb TLS 1.2; instal·lar Windows Management Framework 5.1, que inclou PowerShell 5.1.
Windows 8 i 2012
La instal·lació de FlexxAgent suporta Windows 8 sota les condicions següents:
- Requereix .NET Framework 4.6.2 (Microsoft bloqueja la instal·lació de versions posteriors a Windows 8.0).
- S'han d'aplicar totes les actualitzacions de seguretat de Windows per garantir la compatibilitat amb TLS 1.2 i la signatura de codi SHA-2.
Descàrrega
BINARI SENSE INTERFÍCIE GRÀFICA
Passos per realitzar la descàrrega:
-
Accedir a
Workspaces->Nivell 2->Grups de report. -
En vista de llista, seleccionar el grup de report sobre el qual es vol descarregar l'agent i fer clic a
Descarregar FlexxAgent.

- S'obrirà una finestra amb l'opció
Generate standalone installer (offline), per descarregar l'instal·lador de FlexxAgent:

-
Si es selecciona l'opció: durant la instal·lació, el binari no requerirà accés a internet per a la comprovació o descàrrega de binaris.
-
Si no es selecciona: es descarregarà el paquet d'instal·lació mínim, que accedirà a internet per obtenir els binaris més recents.
Desplegament desatès
FlexxAgent admet desplegament desatès mitjançant GPOs, Intune, SCCM, o altres eines de distribució.
Instal·lació
La instal·lació de FlexxAgent de forma desatesa es realitza mitjançant PowerShell.
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle Hidden -Wait
Paràmetres admesos
| Paràmetre | Tipus | Descripció | |
|---|---|---|---|
| proxyAbsoluteUri | [string] | URI i port del proxy. | |
| proxyUser | [string] | User para proxy autenticado. | |
| proxyPass | [string] | Password per a proxy autenticat. | |
| proxyPersistConfig | [switch] | Si s' especifica, es persisteix la configuració en el registre. | |
| configFilePath | [string] | Directori alternatiu per a l' arxiu FlexxAgent-Configuration.conf. | |
| DebugMode | [switch] | Quan s' especifica, crea un arxiu de text a la mateixa carpeta amb la transcripció de l' execució de l' script. | |
| RepairAgent | [bool] | Elimina la configuració preexistent de FlexxAgent quan es reinstal·la en un dispositiu. | |
| Help | [switch] | Llista els paràmetres admesos, amb tipus i descripció. |
Desinstal·lació
Per desinstal·lar FlexxAgent de forma desatesa:
"C:\Program Files\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Program Files\Flexxible\FlexxAgent\FlexxAgent.exe" /quiet
L'instal·lador de Windows no elimina tots els arxius, carpetes, claus o valors de registre creats durant la instal·lació. Per a una imatge neta del sistema, es poden eliminar manualment:
Fitxers
C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf– on XXXXXXXX és una cadena de lletres i númerosC:\Windows\Temp\FlexxAgentInstallation.log
Carpetes
C:\Program Files\FlexxibleC:\ProgramData\Flexxible
Reinstal·lació
Per reinstal·lar FlexxAgent en un dispositiu eliminant la seva configuració prèvia s'ha d'executar:
FlexxAgent-Installer.exe -repairAgent
Per exemple:
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait
Protecció contra la desinstal·lació
Aquesta funcionalitat impedeix que un usuari desinstal·li FlexxAgent. La configuració es pot aplicar a nivell de Producte o Grup de reporti.
Requisits
- La configuració només la pot realitzar un usuari amb rol Administrador d'organització.
- Versió mínima de FlexxAgent: 25.4.2.
Aquesta funcionalitat està deshabilitada per defecte.
Configuració a nivell de Producte
- Accedir a
Portal->Configuració->Organització. - Al menú, selecciona la pestanya
Productes. - A la taula, escollir l'entorn sobre el qual es vol executar la funcionalitat, i en el camp
Acciófer clic sobreConfiguració de l'Agent. - Al formulari, habilita o deshabilita el botó
Protecció de desinstal·lació. - Fer clic a
Guardar.
Configuració a nivell de Grups de report
L'execució de la funcionalitat pot fer-se sobre un o diversos grups de report.
Habilitar la protecció a un grup de report
- Accedir a
Portal->Configuració->Grups de report. - A la taula, escollir el grup de report sobre el qual es vol executar la funcionalitat, i en el camp
Acciófer clic sobreConfiguració de l'Agent. - Al formulari, edita la funcionalitat
Protecció de desinstal·lació(botó amb forma de llapis) per poder triar entre habilitar-la o deshabilitar-la. - Fer clic a
Guardar.
Els grups de report hereten la configuració que es fa a nivell de Producte; no obstant això, poden sobreescriure la seva pròpia configuració.

Habilitar la protecció a diversos grups de report
- Accedir a
Portal->Configuració->Grups de report. - A la taula, seleccionar els grups de report sobre els quals es vol executar la funcionalitat.
- Fer clic a
Editar protecció de desinstal·lació. Es desplegaran tres opcions:
- Habilitar protecció de desinstal·lació. Protegeix els grups de report contra la desinstal·lació de FlexxAgent (aquesta opció no estarà disponible si la funcionalitat ja està habilitada en Producte).
- Deshabilitar protecció de desinstal·lació. Permet als usuaris desinstal·lar FlexxAgent (aquesta opció no estarà disponible si la funcionalitat ja està deshabilitada en Producte).
- Restablir protecció de desinstal·lació. Aplicarà la configuració que tingui el Producte al qual pertany el grup de report, ja sigui habilitada o deshabilitada.

Un dispositiu tindrà habilitada la Protecció contra la desinstal·lació de FlexxAgent en els següents casos:
- La funcionalitat està habilitada en el grup de report al qual pertany.
- La funcionalitat està desactivada en el grup de report (no està habilitada ni deshabilitada), però està habilitada a nivell Producte.
Formes de desinstal·lar FlexxAgent amb la protecció habilitada
Si un usuari té habilitada la funcionalitat, però necessita desinstal·lar FlexxAgent, tindrà dues opcions:
- Moure el dispositiu a un grup de report que no tingui la protecció habilitada.
- A través d'un token:
- Anar a
Portal->Workspacesi seleccionar el dispositiu. - Executar l'acció
Reveal uninstall tokenque mostrarà un token únic per a aquest dispositiu i que serà vàlid fins a les 23:59:59 UTC del dia següent. - Anar al Panell de Control de Windows i desinstal·lar FlexxAgent introduint el token.

Abans de gestionar la desinstal·lació de FlexxAgent a través d'eines com Intune o scripts propis, s'han de moure els dispositius desitjats a un grup de report que no tingui habilitada la protecció.
Flexxible recomana tenir un grup de report amb la Protecció contra la desinstal·lació deshabilitada per facilitar tasques de desinstal·lació de FlexxAgent als dispositius.
Problemes coneguts
Instal·lació del FlexxAgent
Problema 1 - Windows Management Instrumentation (WMI)
Si el dispositiu té problemes generats pel servei Windows Management Instrumentation (WMI) durant la instal·lació o reinstal·lació, és possible que el procés reporti aquests errors a la finestra de CMD:

Solució
Executar els següents comandos:
Stop-Service winmgmt -Force
winmgmt /resetrepository
Start-Service winmgmt
Problema 2 - Restricció de processos PowerShell
Algunes solucions de seguretat no permeten que la instal·lació i/o l'autoactualització de FlexxAgent es realitzi de manera eficaç. L'instal·lador podria retornar el missatge:
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ó
Excloure els fitxers següents:
C:\Windows\Temp\FlexxibleIT
C:\Windows\Temp\UpdateFlexxAgent.ps1
Desinstal·lació del FlexxAgent
Problema - FlexxAgent continua a la llista de serveis
Podria succeir que FlexxAgent continuï apareixent a la llista de serveis, encara que s'hagi desinstal·lat i s'hagin esborrat tots els fitxers. Això provocaria que no es pogués tornar a instal·lar.
Solució
Executar com a administrador el següent comandament a la finestra de CMD:
sc delete "FlexxAgent service"
A continuació, reiniciar el dispositiu.
Configuració de proxy
FlexxAgent admet proxies configurats de forma transparent a nivell de sistema, amb o sense autenticació. La configuració del proxy es pot realitzar per línia de comandaments o mitjançant modificació de claus de registre.
Configuració de proxy mitjançant línia de comandaments
Instal·lació amb paràmetres:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyPersistConfig:$True
On ip.ad.dre.ss:port correspon a la IP o DNS i el port del proxy.
O incloent credencials:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyUser ProxyUserName -proxyPass ProxyUserPassword -proxyPersistConfig:$True
Pot ser que FlexxAgent no tingui accés al proxy que té aplicat en la seva configuració si està fora de la xarxa corporativa. Per determinar la seva accessibilitat, FlexxAgent intenta resoldre el registre DNS i fa una petició TCP al port corresponent. Si el proxy no és accessible, FlexxAgent ho reportarà directament (sense proxy).
Configuració mitjançant claus de registre
Les claus de registre que s'ocupen d'emmagatzemar la configuració del proxy per a FlexxAgent es localitzen:
'Equip\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications'
Claus de registre relatives a la configuració proxy:
Clau Proxy_URL
- Ruta de la clau:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Clau Proxy_URL
- Tipus: REG_SZ
- Valors admesos: la URL i el port; per exemple 'http://192.168.1.1:3128' o 'https://192.168.1.1:3128'
Clau Proxy_User
- Ruta de la clau:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Clau Proxy_User
- Tipus: REG_SZ
- Valors admesos: el nom d' usuari per autenticar-se en el proxy; per exemple 'Administrador'. Es pot ometre per a proxies no autenticats.
Clau Proxy_Pwd
- Ruta de la clau:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Clau Proxy_Pwd
- Tipus: REG_SZ
- Valors admesos: La contrasenya per autenticar-se en el proxy. Es pot ometre per a proxies no autenticats.
El valor de la clau Proxy_Pwd es pot establir en text sense format (no recomanat) o codificat en base i tancat per «&&&».
Per exemple: &&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&& per al valor "Proxy_Pwd".
En qualsevol dels dos casos, FlexxAgent xifra el valor quan el FlexxAgent s'inicia o intenta transmetre informació. Pots generar una cadena codificada en Base64 des de https://www.base64encode.org/.
Atès que FlexxAgent desencadena un procés a nivell de sistema (FlexxAgent.exe) i un altre a nivell de sessió (FlexxAgent Analyzer.exe) pot ser necessari definir tipus de proxy diferents per a cadascun, depenent de com actuï el proxy a un nivell o un altre.
Es pot definir el Tipus de proxy des de la Configuració del FlexxAgent, en Productes.
Actualització manual
Per actualitzar el FlexxAgent manualment:
- Accedir a
Workspaces->Nivell 1->Workspaces->Operacions->FlexxAgent->Actualitzar FlexxAgent.

-
Es poden conèixer les versions instal·lades des de 'Mis filtros' -> 'Filtros predefinidos' -> 'FlexxAgent version summary'. Això mostrarà una vista de tots els dispositius agrupats per versió.
-
Una vegada executada l'operació d'actualització, es generarà un 'Job' amb tots els detalls de l'operació.