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 interfície gràfica i sense ella, per la qual cosa és perfectament compatible amb mecanismes de desplegament desatès, així com utilitzant l'assistent d'instal·lació.
FlexxAgent es compon d'un servei de Windows anomenat FlexxAgent Service, el qual dirigeix dos processos: FlexxAgent, que s'executa a nivell sistema, i FlexxAgent Analyzer, que s'inicia per a cada sessió d'usuari.
Aquesta estructura habilita a FlexxAgent per abordar dispositius de múltiples sessions, com servidors de terminal, Citrix o AVD, i adquirir mètriques detallades per millorar les capacitats de diagnòstic.
Per exemple, si una persona està treballant al seu portàtil, s'executaria el procés FlexxAgent a nivell de sistema i FlexxAgent Analyzer des de la identitat de l'usuari. Si el dispositiu alberga múltiples sessions d'usuari, s'executaria, a més de FlexxAgent a nivell de sistema, FlexxAgent Analyzer per cada sessió d'usuari en aquest dispositiu.
Consums
Quant als requisits de recursos, FlexxAgent té consums molt optimitzats, rondant els valors següents:
- Espai en disc utilitzat: < 200 MB
- CPU: < 0,5%
- RAM: 100-200 MB
Procés FlexxAgent (sistema)
- Per a la informació de consum de recursos, que inclou comptadors de rendiment, maquinari, sessions, perfils, discs, particions i serveis de Windows, el valor per defecte és de 60 segons.
- Els esdeveniments d'error del registre d'esdeveniments s'envien cada 10 minuts.
- La informació dels perfils d'usuari s'obté cada 15 minuts.
Procés FlexxAgent Analyzer (usuari)
- Inclou l'anàlisi d'ús de les aplicacions, dades de diagnòstic i experiència d'usuari.
- Les dades es recol·lecten de forma local cada 15 segons.
- El report s'envia al servei cada 5 minuts, encara que aquesta mètrica pot canviar en funcionalitats específiques.
Aquests valors es poden adaptar en el apartat Settings
en les diferents consoles, la qual cosa atorga flexibilitat per ajustar-se a les necessitats específiques.
Versions suportades
Els sistemes operatius compatibles amb FlexxAgent són aquells que encara es troben en cicle de suport pel seu fabricant. Tot i que es permet la instal·lació en versions que no comptin amb aquest suport, s'ha de tenir en compte que certes funcionalitats podrien no estar disponibles.
Els sistemes operatius Microsoft amb suport i compatibilitat completa són:
- Microsoft Windows 10 versió o posterior
- Microsoft Windows Server 2016 o posterior
FlexxAgent també es pot instal·lar a Windows 7 i 8.1 SP1, Windows Server 2008 R2 SP1 i Windows Server 2012, però estarà subjecte a algunes limitacions.
Requisits de programari
FlexxAgent també requereix certs components de programari:
- .NET Framework 4.6.2 o posterior, Flexxible recomana instal·lar
.NET Framework 4.8
. - Windows PowerShell 4.0 o posterior (recomanat Windows PowerShell 5.1)
- Nota: La política d'execució d'Azure PowerShell s'ha d'establir com
Sense restriccions
.
- Nota: La política d'execució d'Azure PowerShell s'ha d'establir com
Consideracions per a versions de Windows en EOL
Les versions de Windows en End of Life (EOL), és a dir, que estan fora de suport, tenen algunes limitacions en l'execució de FlexxAgent, la qual cosa pot ocasionar que certes funcionalitats no siguin suportades.
Limitacions
Quan s'utilitza FlexxAgent en sistemes operatius Windows antics que estan fora de suport, no s'admeten les següents característiques:
- Recull de mètrica de consum de GPU
- Execució de flows
- Execució de microserveis per l'usuari final
- Informació de les unitats d'emmagatzematge
- En el cas de dispositius virtuals, la detecció de broker i hipervisor no està disponible per a tots els proveïdors.
- No hi ha dades de User Input Delay (UID) perquè aquest comptador només és compatible amb Windows Server 2019 en endavant i amb Windows 10, versió 1809, en endavant.
La detecció d'intermediaris pot no funcionar per a tots els intermediaris. 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
La instal·lació de FlexxAgent suporta el sistema operatiu Windows 7 x64 o Windows Server 2008 R2 SP1, sota les següents condicions:
- S'ha d'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.'
- S'ha d'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, com a mínim, .NET Framework 4.6, però Flexxible recomana instal·lar
.NET Framework 4.8
. - PowerShell 2.0 amb Windows 7 no és compatible amb la versió TLS 1.2 necessària per instal·lar FlexxAgent. Es requereix instal·lar
Windows Management Framework 5.1
, que instal·la PowerShell 5.1.
Windows 8 i 2012
La instal·lació de FlexxAgent suporta el sistema operatiu Windows 8 sota les següents condicions:
- Es requereix
.NET Framework 4.6.2
, Microsoft bloqueja la instal·lació de versions posteriors de .NET Framework en Windows 8.0. - Es requereixen totes les actualitzacions de seguretat de Windows per garantir la
compatibilitat amb TLS 1.2 i la signatura de codi SHA-2
.
Descàrrega
DESCÀRREGA DEL BINARI D'INSTAL·LACIÓ SENSE INTERFÍCIE GRÀFICA
La descàrrega de FlexxAgent sense interfície gràfica es realitza des de Workspaces
-> Nivell 2
-> Grups de report
.
A la taula de la vista de llista, s'ha de seleccionar el grup de report sobre el qual es desitja descarregar l'agent i fer clic sobre el botó Descarregar FlexxAgent
.
S'obrirà una finestra per descarregar l'instal·lador de FlexxAgent.
-
Si se selecciona l'opció
Generate standalone installer (offline)
, durant la instal·lació, el binari no requerirà accés a internet per a la comprovació o descàrrega de binaris. -
Si, pel contrari, no es selecciona l'opció
Generate standalone installer (offline)
, es descarregarà el paquet d'instal·lació mínim. D'aquesta manera, el binari accedirà a internet per comprovar i descarregar els binaris més recents.
Desplegament desatès
FlexxAgent suporta ser llançat mitjançant mètodes de desplegament desatès, com ara distribució per GPOs, Intune, SSCM i moltes més eines.
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
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 de Microsoft que s'utilitza per desinstal·lar FlexxAgent no elimina tots els arxius, carpetes, claus de registre o valors de registre creats durant la instal·lació de FlexxAgent. Si necessites una imatge neta del sistema, pots eliminar de forma segura els següents arxius, carpetes, claus de registre i valors de registre.
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\Flexxible
C:\ProgramData\Flexxible
Reinstal·lació
Per reinstal·lar FlexxAgent en un dispositiu eliminant la seva configuració preexistent 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 permet protegir el procés de desinstal·lació de FlexxAgent per evitar que un usuari pugui desinstal·lar-lo dels dispositius. La configuració es pot realitzar a nivell Producte i Grups de report.
Consideracions
- La configuració només pot realitzar-la un usuari Administrador d'organització.
- Es requereix tenir instal·lada la versió 25.4.2 de FlexxAgent.
- Per defecte, la funcionalitat està deshabilitada.
Configuració a nivell Producte
- Accedir a
Portal
->Configuració
->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, habilitar o deshabilitar el botó
Protecció de desinstal·lació de FlexxAgent
. - Fer clic a
Guardar
.
Configuració a nivell 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, editar la funcionalitat
Protecció de desinstal·lació de FlexxAgent
(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 Producte; no obstant això, poden sobrescriure 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ó: aplica la configuració que tingui el Producte al qual pertany el grup de report, 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
->Workspaces
i seleccionar el dispositiu. - Executar l'acció
Reveal uninstall token
que 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)
Durant la instal·lació i/o reinstal·lació de FlexxAgent, si l'equip té problemes generats pel servei Windows Management Instrumentation (WMI), é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 següents fitxers del dispositiu:
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 FlexxAgent no es pugui 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.
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ó. |
Configuració proxy
FlexxAgent admet proxies configurats de forma transparent a nivell de sistema. També se suporten proxies amb autenticació i sense. La configuració del proxy es pot realitzar per línia de comandaments o mitjançant modificació de claus de registre que controlen aquesta configuració.
Configuració 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 és a la IP o DNS més 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, ho informarà de manera directa (sense proxy).
Configuració mitjançant claus de registre
Localització de les claus de registre que s'ocupen d'emmagatzemar la configuració del proxy per a FlexxAgent:
'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
- Nom de la clau: Proxy_URL
- Tipus de clau: 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
- Nom de la clau: Proxy_User
- Tipus de clau: 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
- Nom de la clau: Proxy_Pwd
- Tipus de clau: 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ó. Pot utilitzar un lloc com a https://www.base64encode.org/ per crear la cadena de contrasenya codificada en base64.
Tenint en compte que FlexxAgent desencadena un procés a nivell de sistema (FlexxAgent.exe) i un altre a nivell de sessió (FlexxAgent Analyzer.exe) i depenent de com actuï el proxy a un nivell o un altre, pot ser necessari aplicar configuracions diferents a ambdós processos mitjançant la definició del Tipus de proxy
. Això es pot realitzar des de la Configuració de FlexxAgent, en Productes
.
Actualització manual
Anar al mòdul Workspaces
-> Nivell 1
-> Workspaces
-> Operacions
-> FlexxAgent
-> Actualitzar FlexxAgent
.
Es poden conèixer les diferents versions instal·lades en l'opció desplegable 'My filters' -> 'Predefined filters' -> 'FlexxAgent version summary'. Això generarà una vista de tots els dispositius agrupats per versió de FlexxAgent.
Una vegada executada l'operació d'actualització, es generarà un Treball
a la corresponent secció amb tots els detalls de l'operació.
Logs
FlexxAgent pot generar tres tipus de logs:
Aquests registres permeten consultar informació i diagnosticar problemes des de la instal·lació de FlexxAgent.