Linux
The Linux agent allows the inclusion of devices with this operating system in the service consoles, enabling support teams to have complete visibility of all devices in use within the organization. Support for Linux includes distributions like Fedora, Debian, and its derivative Ubuntu. Both physical and virtual devices on VMware as a hypervisor and VDIs published with Citrix as a broker are supported.
FlexxAgent is composed of a process of the same name, which runs at the system level and obtains all device information: its consumption metrics, performance, and all information visible in the consoles related to the device. FlexxAgent-Session initiates an instance for each user session on the device. It collects session-related information, such as the applications used and their resource consumption, system resource usage by the session, and session delivery times.
Supported versions
Currently, FlexxAgent officially supports the following distributions and versions:
- Fedora 37 or later
- Debian/GNU Linux 11 (bullseye) or later
- Ubuntu 22.04, 24.04
More distributions are periodically validated.
To include any distribution in the supported distributions list, please contact Flexxible.
Requirements
Before installing, updating all system packages is recommended.
The necessary components will be installed, depending on the distribution. The packages are detailed below.
Package dependencies for Fedora and Debian:
- dmidecode
- imvirt
- systemd
Limitations
Certain functionalities are not available for Linux, such as remote assistance, user microservices, or executing flows, as well as collecting data from plug and play peripherals and proxy usage.
On-demand microservice execution from Workspaces supports Bash as the scripting language.
Download and installation
To install FlexxAgent, you must run the installation script using a preset configuration file.
The installation script can be downloaded from
https://update.workspaces.flexxible.com/agents/Linux/FlexxAgent/latest/flexxagent-install.sh
FlexxAgent downloads its latest version when the script is executed before installation.
The configuration file is required for installation. It can be obtained by contacting Flexxible.
Installation steps
- Download the installer from the URL.
- Grant permissions to the script.
sudo chmod +x ./flexxagent-install.sh - Run the script.
sudo ./flexxagent-install.sh -c [configuration file] - Clean up the used files.
Installation script parameters
| Parameter | Description |
|---|---|
-v,--version <VERSION> | Use a specific version; default is latest. |
-d,--distro <DISTRO> | The script automatically detects the DISTRIBUTION in use on the system it is running on. This parameter helps to force the installation of the FlexxAgent version for a specific DISTRIBUTION when working with derived or similar distributions. |
--verbose,-Verbose | Displays diagnostic information. |
-c,--config <CONFFILE> | Applies the configuration from a configuration file; default is settings.conf. |
-?,--?,-h,--help,-Help | Displays help. |
Examples
Install FlexxAgent with the configuration file:
flexxagent-install.sh [-c|--config <path/file.conf>]
Install a specific version of FlexxAgent:
flexxagent-install.sh [-v|--version <VERSION>]
Force the installation of FlexxAgent for a specific distribution:
flexxagent-install.sh [-d|--distro <DISTRO>]
Access the help:
flexxagent-install.sh -h|-?|--help
Uninstallation
The uninstallation script can be downloaded from
https://update.workspaces.flexxible.com/agents/Linux/FlexxAgent/latest/flexxagent-uninstall.sh
Steps to uninstall:
-
Download the uninstaller from the URL.
-
Grant permissions to the script.
sudo chmod +x ./flexxagent-uninstall.sh -
Run the script.
sudo ./flexxagent-uninstall.sh -
Clean up the used files.
Uninstallation script parameters
| Parameter | Description |
|---|---|
-d,--distro <DISTRO> | The script automatically detects the DISTRIBUTION in use on the system it is running on. This parameter helps to force the uninstallation of the FlexxAgent version for a specific DISTRIBUTION when working with derived or similar distributions. |
-c,--cleanup <VERSION> | Cleans configurations and logs; default is false. |
-?,--?,-h,--help,-Help | Displays help. |
Examples
Uninstall and clean configurations and logs:
flexxagent-uninstall.sh [-c|--cleanup]
Force uninstallation for a DISTRO:
flexxagent-uninstall.sh [-d|--distro <DISTRO>]
Access the help:
sudo ./flexxagent-uninstall.sh --help
Update
There are two ways to update FlexxAgent to its latest version:
- From Workspaces, select the device and click on
Operations->FlexxAgent->Update to the latest version. - Re-running the installation script to download and install the latest version.
Obtained fields
FlexxAgent obtains and sends the following general information to the consoles:
- Name: device name
- Device status: on, off
- Version: FlexxAgent version
- FlexxAgent status: running, stopped
- Last FlexxAgent report: date and time of last report received
- Connection: wireless LAN, mobile network, ethernet, unknown
- Network: device network addressing and public IP for internet access. These networks are created automatically when more than four workspaces are connected to the same network.
- Subnet: device's network segment
- MAC Address
- Wireless network: network name
- Network signal: network reception percentage
- Network changes: last time the network changed
- Sessions: number of user sessions
- Last user
- Connected from
- Connection time: date and time of session start
- Code: allows the user to identify the workspace with a personal code. This code must be manually filled in individually using the Edit option in the Operations menu of the workspace details.
- RAM: total available RAM capacity
- Cores: number of processor cores
- IP Address: device's local network IP address
- OS: operating system name
- Operating system: operating system version
- System disk: total disk capacity and usage percentage
- Public IP and ISP: this ISP is obtained using the public IP. It may not be accurate if connected to a corporate network or using a VPN.
- Region: obtained using the public IP. It might not be accurate if connected to a corporate network or using a VPN.
- Broker type: if detected, shows the session broker used.
- Delivery group: if detected, collection of machines selected from one or more machine catalogs.
- Subscription: if detected, the subscription in use for Citrix Cloud, Azure services, etc.
- Hypervisor: if virtualization is detected, shows the hypervisor used.
- Session Analyzer: whether it is configured or not.
- Session Analyzer version: Session Analyzer version number
- Report group: report group to which the device belongs
At the detailed information level in the device view in Workspaces, it includes:
- List of sessions with resource consumption details (CPU/RAM) for each session
- List of workspace disks with occupied space
- Graphical performance counters for CPU, RAM, bandwidth, and wireless connection signal
The Analyzer module receives the general data of the device, as well as information about CPU and RAM usage, installed applications, and also the processes and applications running.
