Windows
FlexxAgent supports 64-bit Windows operating systems; it cannot be installed on 32-bit systems. The installation binary is available with and without a graphical interface, making it fully compatible with unattended deployment mechanisms and the installation wizard.
FlexxAgent consists of a Windows service called FlexxAgent Service, which manages two processes: FlexxAgent (process), which runs at the system level, and FlexxAgent Analyzer (process), which starts for each user session.
This structure enables FlexxAgent to address multiple session devices, such as terminal servers, Citrix, or AVD, and acquire detailed metrics to enhance diagnostic capabilities.
For example, if a person is working on their laptop, the FlexxAgent process would run at the system level and FlexxAgent Analyzer would run from the user's identity. If the device hosts multiple user sessions, in addition to FlexxAgent at the system level, FlexxAgent Analyzer will run for each user session on that device.
Consumption
In terms of resource requirements, FlexxAgent has very modest consumption, hovering around the following values:
- Disk space used: < 200 MB
- CPU: < 0.5%
- RAM: 100-200 MB
FlexxAgent Process (system)
- For resource consumption information, including performance counters, hardware, sessions, profiles, disks, partitions, and Windows services, the default value is 60 seconds.
- Event log error events are sent every 10 minutes.
- User profile information is obtained every 15 minutes.
FlexxAgent Analyzer Process (user)
- Includes application usage analysis, diagnostic data, and user experience.
- Data is collected locally every 15 seconds.
- The report is sent to the service every 5 minutes, although this metric can change in specific functionalities.
These values can be adjusted in Settings
on the different consoles, providing flexibility to meet specific needs.
Supported versions
The operating systems compatible with FlexxAgent are those still within the manufacturer's support cycle. Although installation is allowed on versions without such support, certain functionalities might not be available.
Microsoft operating systems with full support and compatibility are:
- Microsoft Windows 10 or later
- Microsoft Windows Server 2016 or later
FlexxAgent can also be installed on Windows 7 and 8.1 SP1, Windows Server 2008 R2 SP1, and Windows Server 2012, but it will be subject to some limitations.
Software Requirements
FlexxAgent also requires certain software components:
- .NET Framework 4.6.2 or later, Flexxible recommends installing
.NET Framework 4.8
. - Windows PowerShell 4.0 or later (Windows PowerShell 5.1 recommended)
- Note: The Azure PowerShell execution policy should be set to
Unrestricted
.
- Note: The Azure PowerShell execution policy should be set to
Considerations for Windows versions in EOL
Windows versions in End of Life (EOL), meaning they are out of support, have some limitations in running FlexxAgent, which may cause certain functionalities to not be supported.
Limitations
Some limitations might disable its functionalities when using FlexxAgent on older Windows operating systems that are out of support:
- GPU consumption metric collection
- Flow execution
- End-user microservices execution
- Storage unit information
- For virtual devices, broker and hypervisor detection is not available for all providers.
- There is no User Input Delay (UID) data because this counter is only supported on Windows Server 2019 and later, and Windows 10, version 1809 and later.
Broker detection might not work for all brokers. There is no user input delay performance data as this counter does not exist in Windows 7 or Windows Server 2008 R2.
Windows 7 and 2008
The installation of FlexxAgent supports the Windows 7 x64 or Windows Server 2008 R2 SP1 operating system under the following conditions:
- The update KB4474419:
SHA-2 code signing support update for Windows Server 2008 R2, Windows 7, and Windows Server 2008: September 23, 2019
must be installed. - The update KB3140245:
Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows
must be installed, and follow the instructions in theHow to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows
section of the Microsoft support page. - Requires at least .NET Framework 4.6, but Flexxible recommends installing
.NET Framework 4.8
. - PowerShell 2.0 with Windows 7 is not compatible with the required TLS 1.2 version to install FlexxAgent.
Windows Management Framework 5.1
is required to be installed, which installs PowerShell 5.1.
Windows 8 and 2012
The installation of FlexxAgent supports the Windows 8 operating system under the following conditions:
.NET Framework 4.6.2
is required, Microsoft blocks the installation of later versions of .NET Framework on Windows 8.0.- All Windows security updates are required to ensure
compatibility with TLS 1.2 and SHA-2 code signing
.
Download
The installation binary download for FXXOne is available with and without graphical interface.
INSTALLATION BINARY DOWNLOAD WITH GRAPHICAL INTERFACE
BUTTON TO DOWNLOAD FLEXXAGENT
In Portal
-> Home
, the Download agent
button will allow you to download FlexxAgent to the device. This option is available for all Organization Administrator users of any type of organization.
If the organization has more than one reporting group, clicking on the Download agent
button will change the interface to the Reporting groups
section to download FlexxAgent in the chosen reporting group.
A few seconds after the installation, the device will be visible in the Workspaces module. All functionalities for controlling, monitoring, and automating tasks on your devices will be activated from that moment.
BUTTON TO GENERATE A MAGIC LINK
The Generate magic link
button optimizes the access to download FlexxAgent on the devices. Allows users with the Organization Administrator role within a partner-type organization to generate and send a link to users so they can download the agent on their devices without being logged in.
Create magic link
The Generate a magic link
button is located on the home page of the Portal for users with an Organization Administrator role within a partner-type organization.
Clicking the button opens a form where you should specify which reporting group the link will be assigned to and for how long it will be active.
Next, a window will indicate that the link has been created. And it will allow you to copy it directly to share it.
By clicking Accept
, the console will automatically go to the detail view of the selected reporting group. From there you can check the magic link just created, as well as others that have been created earlier.
Use a magic link
To use the link just copy and paste it into the browser's address bar. At that moment, FlexxAgent will show the following screen, indicating that it has been downloaded on the device.
Revoke a magic link
A Magic Link
can be revoked from Portal
-> Settings
-> Report Groups
. In the list view, click on the reporting group where the Magic link
you want to revoke is located. And then, in the Action
field of the table, choose the Revoke
option.
A window will appear to confirm the action.
By clicking Accept
, a message will appear for a few seconds in the reporting group table informing of the action: "The magic link has been successfully revoked."
It is not possible to use a Magic link
that has been revoked or has expired again.
INSTALLATION BINARY DOWNLOAD WITHOUT GRAPHICAL INTERFACE
The download of FlexxAgent without a graphical interface is done from Workspaces
-> Level 2
-> Reporting Groups
.
In the list view table, you must select the reporting group for which you want to download the agent and click on the Download FlexxAgent
button.
A window will open to download the FlexxAgent installer.
-
If the
Generate standalone installer (offline)
option is selected, during installation, the binary will not require internet access for verification or downloading binaries. -
If, on the other hand, the
Generate standalone installer (offline)
option is not selected, the minimal installation package will be downloaded. In this manner, the binary will access the internet to verify and download the latest binaries.
Unattended Deployment
FlexxAgent supports being launched through unattended deployment methods, such as GPO distribution, Intune, SSCM, and many more tools.
Installation
The unattended installation of FlexxAgent is done via PowerShell.
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle Hidden -Wait
Uninstall
To uninstall FlexxAgent unattended:
"C:\Program Files\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Program Files\Flexxible\FlexxAgent\FlexxAgent.exe" /quiet
The Microsoft Windows installer used to uninstall FlexxAgent does not delete all files, folders, registry keys, or registry values created during the installation of FlexxAgent. If you need a clean system image, you can safely delete the following files, folders, registry keys and registry values.
Files
C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf
– where XXXXXXXX is a string of letters and numbersC:\Windows\Temp\FlexxAgentInstallation.log
Folders
C:\Program Files\Flexxible
C:\ProgramData\Flexxible
Reinstallation
To reinstall FlexxAgent on a device removing its preexisting configuration, execute:
FlexxAgent-Installer.exe -repairAgent
For example:
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait
Uninstallation Protection
This feature allows protecting the uninstallation process of FlexxAgent to prevent a user from uninstalling it from devices. Configuration can be performed at the Product level and at the Reporting Group level.
Considerations
- Only an Organization Administrator user can configure it.
- Version 25.4.2 of FlexxAgent must be installed.
- By default, the feature is disabled.
Configuration at Product Level
- Go to
Portal
->Settings
->Products
. - In the table, choose the environment where you want to execute the functionality, and in the
Action
field click onAgent Settings
. - In the form, enable or disable the
FlexxAgent Uninstallation Protection
button. - Click on
Save
.
Configuration at Reporting Groups Level
The feature can be executed on one or several reporting groups.
Enable protection for a reporting group
- Go to
Portal
->Settings
->Reporting Groups
. - In the table, choose the reporting group where you want to execute the functionality, and in the
Action
field click onAgent Settings
. - In the form, edit the
FlexxAgent Uninstallation Protection
feature (pencil-shaped button) to choose whether to enable or disable it. - Click on
Save
.
The reporting groups inherit the configuration made at the Product level; however, they can overwrite their own configuration.
Enable protection for multiple reporting groups
- Go to
Portal
->Settings
->Reporting Groups
. - In the table, select the reporting groups where you want to execute the functionality.
- Click on
Edit uninstallation protection
. Three options will be displayed:
- Enable uninstallation protection. Protects the reporting groups against uninstallation of FlexxAgent (this option will not be available if the feature is already enabled in Product).
- Disable uninstallation protection. Allows users to uninstall FlexxAgent (this option will not be available if the feature is already disabled in Product).
- Reset uninstallation protection. Applies the configuration that the Product has to which the report group belongs, whether enabled or disabled.
A device will have FlexxAgent Uninstallation Protection enabled in the following cases:
- The feature is enabled in the reporting group to which it belongs.
- The feature is deactivated in the reporting group (it is neither enabled nor disabled), but it is enabled at the Product level.
Ways to uninstall FlexxAgent with protection enabled
If a user has the feature enabled but needs to uninstall FlexxAgent, they will have two options:
- Move the device to a reporting group that does not have protection enabled.
- Via a token:
- Go to
Portal
->Workspaces
and select the device. - Execute the action
Reveal uninstall token
which will display a unique token for that device valid until 23:59:59 UTC the next day. - Go to the Windows Control Panel and uninstall FlexxAgent by entering the token.
Before managing the uninstallation of FlexxAgent through tools like Intune or custom scripts, move the desired devices to a reporting group that does not have protection enabled.
Flexxible recommends having a reporting group with Uninstall Protection disabled, to facilitate uninstallation tasks of FlexxAgent on devices.
Known Issues
FlexxAgent installation
Issue 1 - Windows Management Instrumentation (WMI)
During the installation and/or reinstallation of FlexxAgent, if the computer encounters issues generated by the Windows Management Instrumentation (WMI) service, the process might report these errors in the CMD window:
Solution
Run the following commands:
Stop-Service winmgmt -Force
winmgmt /resetrepository
Start-Service winmgmt