FlexxAgent for Windows enables the monitoring, management, and automation of Windows devices from the Flexxible platform.
It is distributed as a single executable that integrates all the components needed for its operation, so it does not require any prior installation of dependencies or additional software.
This design simplifies deployment, update, and maintenance processes, especially in environments with a large number of managed devices.
Compatibility
FlexxAgent is compatible with Windows versions that are within Microsoft’s official support lifecycle:
-
Microsoft Windows 10 or later.
-
Microsoft Windows Server 2016 or later.
Architecture requirements
FlexxAgent is only compatible with 64-bit operating systems. It cannot be installed on 32-bit systems.
Architecture
FlexxAgent is distributed as a single executable. During installation, the components necessary for its execution are configured automatically at both the system and user session levels.
This architecture simplifies agent administration, streamlines diagnostic tasks, and reduces the operational complexity associated with its maintenance.
Resource consumption
FlexxAgent is optimized to minimize its impact on device performance. Approximate consumption values are as follows:
| Resource | Approximate consumption |
|---|
| Disk space | < 300 MB |
| CPU | < 0.5 % |
| RAM | 90 - 170 MB |
Download and installation
-
Click Download FlexxAgent, available at the bottom of the side menu.
-
Select the reporting group that will be associated with the device.
-
Download the configuration file
(.conf) and the Windows installer.
The operating system may block files downloaded from the Internet. If this happens, they will need to be manually unblocked before starting the installation.
Installer types
The advanced options let you select the installer format:
| Format | Description |
|---|
.exe | Recommended. Allows installations via a graphical interface or unattended. |
.msi | Designed for unattended installations and automated deployments. |
Installation via graphical interface
To install FlexxAgent through the graphical interface:
-
Run the downloaded
.exe file.
-
Read and accept the license agreement.
-
Select the configuration file
(.conf) downloaded previously.
-
Click Install to start the installation process.
Unattended installation
FlexxAgent supports unattended installations using the downloaded files.
- Installer (
.exe or .msi).
- Configuration file (
.conf).
Installation via EXE
Available parameters
| Parameter | Type | Required | Description |
|---|
/AgentConfig | String | Yes | For installations with a graphical interface, you will be prompted for the configuration value. To reuse a previous configuration, specify /UsePrevConfig=True. |
/UsePrevConfig | Boolean | No | When set to True, the installer attempts to reuse the existing configuration on the device. In this case, /AgentConfig does not need to be specified. |
/SendTelemetry | Boolean | No | Default value: False. |
Example
.\FlexxAgent.Installer.exe /verysilent /AgentConfig="C:\Path\To\Settings\settings.conf"
Installation via MSI
Available parameters
| Parameter | Type | Required | Description |
|---|
AGENT_CONFIG | String | Yes | Absolute path to the configuration file (.conf). If you want to reuse a previous configuration, specify USE_PREV_CONFIG=True. |
USE_PREV_CONFIG | Boolean | No | When set to True, the installer attempts to reuse the existing configuration on the device. In this case, AGENT_CONFIG does not need to be specified. |
SEND_TELEMETRY | Boolean | No | Default value: False. |
msiexec options
| Option | Description |
|---|
/i | Installs the specified MSI package. |
/qn | Runs the installation in silent mode, with no user interaction. |
Example
msiexec /qn /i "C:\Path\To\Installer\FlexxAgent.Installer.msi" AGENT_CONFIG="C:\Path\To\Settings\settings.conf"
Uninstallation
FlexxAgent can be uninstalled manually from the device’s Control Panel.
To perform an unattended uninstallation, you can use the following methods.
Uninstallation via EXE
"C:\Program Files\Flexxible\FlexxAgentUniversal\unins000.exe" /verysilent [/log="mi_fichero_de_log"]
Uninstallation via MSI
msiexec /qn /passive /x "{6F330B47-2577-43AD-9095-18614A74D82F}"
Connectivity test
The connectivity test lets you verify that FlexxAgent can communicate correctly with Flexxible services.
To run it, you need administrator permissions on the device.
Steps to run the connectivity test
-
Open a console with administrator privileges.
-
Change to the installation directory:
cd "%ProgramFiles%\Flexxible\FlexxAgentUniversal"
-
Run the following command:
FlexxAgent.Universal.exe connectivity
-
Review the diagnostic information shown on the screen.
The output will include information about connectivity status and any possible communication errors with Flexxible services.
Proxy configuration
If the environment uses a proxy server to access the Internet, the configuration must be done before installing FlexxAgent.
To do so, modify the downloaded configuration file (.conf) and add the proxy parameter to the [Agent/Network] section.
Proxy without authentication
proxy = http://proxy_uri:port
Example:
proxy = http://192.168.0.100:443
Proxy with authentication
proxy = http://user:password@proxy_uri:port
Example:
Magic link
Available only in FXXOne environments.
The magic link lets users with the Organization Administrator role in partner-type organizations distribute the FlexxAgent installer without end users needing to sign in or authenticate on the platform.
The link is generated from the platform and can be shared with users to make it easier to download the agent directly onto their devices.
Create a magic link
- Go to Home from the platform menu.
- Click Generate a magic link.
-
Complete the form indicating:
- The reporting group associated with the link.
- The platform for which the installer is required.
- The number of days during which the link will remain active.
-
Click New.
-
Copy the generated link and click OK.
Use a magic link
To use a magic link, simply copy it and paste it into the address bar of a web browser.
Once you access the link, the installer will start downloading and a confirmation page will be displayed.
Revoke a magic link
- Go to Settings → Reporting groups.
- In the Action column of the reporting group, select the Revoke option.
- Confirm the action by clicking OK.
Once revoked or expired, a magic link cannot be used again.