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 (procés), que s'executa a nivell sistema, i FlexxAgent Analyzer (procés), 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 en el seu portàtil, s'executaria el procés FlexxAgent a nivell de sistema i FlexxAgent Analyzer des de la identitat de l'usuari; i si el dispositiu hospeda 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.

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

Servei 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.

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.

info

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.

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
• No es mostra informació de les unitats d'emmagatzematge.
• En el cas de màquines 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

La descàrrega del binari d'instal·lació per a FXXOne està disponible amb interfície gràfica i sense ella.

DESCÀRREGA DEL BINARI D'INSTAL·LACIÓ AMB INTERFÍCIE GRÀFICA

BOTÓ PER DESCARREGAR FLEXXAGENT

A Portal -> Inici, el botó Descargar l'agent permetrà descarregar FlexxAgent al dispositiu. Aquesta opció està disponible per a tots els usuaris Administradors d'Organització de qualsevol tipus d'organització.

Si l'organització té més d'un grup d'informe, en fer clic al botó Descargar l'agent la interfície canviarà cap a la secció Grups d'informe per descarregar FlexxAgent al grup d'informe escollit.

Passats uns segons després de finalitzar la instal·lació, el dispositiu serà visible a Workspaces. A partir d'aquell moment, s'activaran totes les funcionalitats per controlar, monitoritzar i automatitzar tasques en els teus dispositius.

BOTÓ PER GENERAR UN ENLLAÇ MÀGIC

El botó Generar enllaç màgic optimitza l'accés a la descàrrega de FlexxAgent als dispositius. Permet als usuaris amb rol Administrador d'Organització dins d'una organització de tipus soci generar i enviar un enllaç als usuaris perquè puguin descarregar l'agent als seus dispositius sense estar loguejats.

Crear un enllaç màgic

El botó Generar un enllaç màgic està ubicat a la pàgina d'inici del Portal a les consoles dels usuaris amb rol Administrador d'Organització dins d'una organització de tipus soci.

En fer clic sobre el botó s'obre un formulari on s'ha d'indicar a quin grup d'informe se li assignarà l'enllaç i durant quant de temps estarà actiu.

A continuació, una finestra indicarà que l'enllaç ha estat creat. I permetrà copiar-lo directament per poder compartir-lo.

En fer clic a Acceptar, de manera automàtica la consola anirà a la vista de detall del grup d'informe escollit. Des d'allà es podrà consultar l'enllaç màgic que s'acaba de crear, així com altres que s'hagin creat amb anterioritat.

Utilitzar un enllaç màgic

Per utilitzar l'enllaç n'hi ha prou amb copiar-lo i enganxar-lo a la barra d'adreça del navegador. En aquell moment, FlexxAgent mostrarà la següent pantalla, indicant que s'ha descarregat al dispositiu.

Revocar un enllaç màgic

Es pot revocar un Enllaç màgic des de Portal -> Configuració -> Grups d'informe. A la vista de llista s'ha de fer clic sobre el grup d'informe on es troba l'Enllaç màgic que es vol revocar. I, a continuació, al camp Acció de la taula, triar l'opció Revocar.

Apareixerà una finestra per confirmar l'acció.

En fer clic a Acceptar, a la taula del grup d'informe apareixerà durant uns segons un missatge informant de l'acció: "L'enllaç màgic s'ha revocat correctament".

No és possible tornar a utilitzar un Enllaç màgic que ha estat revocat o que ha expirat.

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 -> Level 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úmeros
• C:\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

Problemes coneguts

Instal·lació de FlexxAgent (clic per expandir)

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ó

Executa 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ç. El 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ó

Exclou els següents fitxers del dispositiu:

C:\Windows\Temp\FlexxibleIT

C:\Windows\Temp\UpdateFlexxAgent.ps1

Desinstal·lació de FlexxAgent (clic per expandir)

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ó

Executa com a administrador el següent comando en 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.

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`

info

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
• Clau Proxy_User
• Clau Proxy_Pwd

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.

info

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ó

FlexxAgent pot actualitzar-se de forma automàtica o manual des de Workspaces.

Actualització automàtica

Aquesta funcionalitat es controla amb un ajust en Workspaces que usualment està activat. La ruta per veure o canviar la configuració d'aquesta funcionalitat és 'Workspaces' -> 'Level 3' -> 'Settings' -> 'Auto update'. Seleccionar 'True' permetrà que, quan es detecti una nova versió de FlexxAgent, aquesta s'enviï de forma automàtica a tots els dispositius actius de l'organització. Aquesta acció deixarà un 'Job' a Workspaces amb tots els detalls de l'operació.

Actualització manual

La ruta per actualitzar FlexxAgent de forma manual: 'Level 1' -> 'Workspaces' -> 'Operations' -> 'FlexxAgent' -> 'Update to latest version'.

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 'Job' en la corresponent secció amb tots els detalls de l'operació.

Logs

FlexxAgent pot generar tres tipus de logs:

• Logs d'instal·lació i actualització
• Logs de FlexxAgent Analyzer
• Logs de servei FlexxAgent

Aquests registres permeten consultar informació i diagnosticar problemes des de la instal·lació de FlexxAgent.

Logs d'instal·lació i actualització

Dins la carpeta %LOCALAPPDATA%\Flexxible es deixa un log de text que conté informació del procés d'instal·lació o actualització, així com informació de dependències i detalls del procés.

Logs de FlexxAgent Analyzer

Dins del directori '%LOCALAPPDATA%\FAAgent\Logs' s'emmagatzemen els logs de FlexxAgent Analyzer. Aquests poden ser configurats per incloure o no informació per nivells de criticitat.

Canviar nivell de logs per a FlexxAgent Analyzer

Des de Workspaces, és possible canviar el nivell de log per a un o diversos dispositius mitjançant les opcions disponibles al botó 'Operacions'.

Logs de FlexxAgent service

Es poden consultar els logs de FlexxAgent service en la branca 'Aplicació', dins del 'Visor d'esdeveniments' de Windows.