macOS

The macOS agent allows you to include devices with this operating system in the service consoles, thereby enabling complete visibility for support teams of all devices in use within the organization. Support for macOS includes versions starting from 10.15.

Supported versions

Support for macOS starts with version Catalina (10.15) or later. Regarding architectures, FlexxAgent supports both Intel processors (amd64 architecture) and Apple processors with arm architecture (arm64).

Limitations

Certain functionalities are not available for macOS, such as remote assistance, on-demand microservices execution from Workspaces, or user microservices and flows, as well as the use of proxies or sending notifications.

An expected behavior in macOS, due to how the operating system works, is that when the device screen is locked, the operating system stops background processes, so the device stops reporting information to the consoles or receiving actions until the screen is unlocked or the session is started again.

Download and installation

The installation script that downloads FlexxAgent in its latest version can be obtained from https://update.workspaces.flexxible.com/agents/MacOS/FlexxAgent/latest/flexxagent-install.sh

The configuration file must be obtained from Flexxible and is required for installation.

Steps for installation:

1. Download the installer from the URL.
2. Grant permissions to the script, open the terminal, and execute:

   sudo chmod +x ./flexxagent-install.sh

3. Run the script.

   sudo ./flexxagent-install.sh -c [configuration file]

4. Clean files.

Installation script parameters

Parameter	Description
-v,--version <VERSION>	Use a specific version, by default, latest.
--verbose,-Verbose	Displays diagnostic information.
-c,--config <CONFFILE>	Applies the configuration from a configuration file by default 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>]

Access the help:

flexxagent-install.sh -h|-?|--help

Uninstallation

The uninstallation script can be downloaded from:

https://update.workspaces.flexxible.com/agents/MacOS/FlexxAgent/latest/flexxagent-uninstall

Steps to uninstall:

1. Download the uninstaller from the URL.
2. Grant permissions to the script.

   sudo chmod +x ./flexxagent-uninstall.sh

3. Run the script.

   sudo ./flexxagent-uninstall.sh

Uninstallation script parameters

Parameter	Description
-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]

Access the help:

sudo ./flexxagent-uninstall.sh --help

Update

It is possible to update the agent to the latest version in two ways:

• 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:

• Device name
• Device status (on, off...)
• 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 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 an identification code. This code must be filled in using the Edit option in the Operations menu of the workspace details.
• RAM: total capacity of available RAM.
• Cores: number of processor cores
• IP Address: device IP address on the local network
• OS: name of the operating system.
• Operating system: version of the operating system.
• System disk: total disk capacity and usage in 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.
• Session Analyzer: whether it is configured or not.
• Session Analyzer version: version number of Session Analyzer
• Report group: report group to which the device belongs

Performance counter information is also retrieved:

• CPU
• RAM
• Bandwidth
• Wireless connection signal percentage
• Session list
• List of disks with total and occupied capacity