Install cross-platform clients
How to install the Adaptiva Client on cross-platform devices.
You can install the Adaptiva Client on Linux and MacOS by installing the appropriate package and running the adaptivactl setup command. The setup command will install the OneSite client, configure firewall rules, and run post-installation checks to ensure functionality. The setup progress will print to the terminal and exit with a 0 exit-code if successful. If the client setup fails for any reason, it will exit with a non-zero exit-code.
The adaptivactl setup command checks for port availability before client setup. If a firewall is detected, setup will create firewall rules using the appropriate application: ufw with the DEB package, firewalld with the RPM package, and socketfilterfw with the MacOS package.
The client will now run post-setup checks to confirm connectivity with the server and other services. The setup will wait for these checks to be completed. You can skip these checks using the --skip-connection-checks flag.
There are several different installation packages provided for cross-platform device installations. Be sure to use the correct one for your operating system. Locate the installers\cross-platform folder in the downloaded .zip file.
Linux Installation
Adaptiva RPM signing key
With the inclusion of openSUSE and SUSE Linux support in version 10.1.972, you will need to import the Adaptiva RPM signing key on each SUSE-based Linux machine during prior to installation. This will allow these distributions to verify the signature of the RPM package.
The following distributions apply:
Required
SUSE-based (openSUSE, SUSE Linux Enterprise)
Optional - (Good practice to install the RPM signing key, but not necessary.)
Other RPM-based Linux distributions (Rocky Linux, Fedora, RHEL, etc.)
Does not apply
DEB-based (Debian and Ubuntu)
Open a terminal window and run the following command to import the Adaptiva RPM signing key:
sudo rpm --import https://adaptiva-releases.adaptivacdn.cloud/client/RPM-GPG-KEY-Adaptiva
Install the Linux package
Run the following command to execute the package (replace
<version>with the appropriate version of the Adaptiva client your are trying to install and<arch>with the specific architecture):DNF package manager
APT package manager
Zypper package manager
Configure the Linux client
Run the following
adaptivactlcommand in setup mode to configure the client:Only the
--serverflag is required. See the adaptivactl command line parameters for the available parameters.Example:
Once the client installation is completed, the client will perform a series of connection checks.
If installing a SUSE-based distribution, these checks will not be run.
When the connection checks are completed, the Patch Client is fully online and ready to be managed.
Linux logs
Run the following command to view the client service log:
Client logs: /opt/adaptiva/adaptivaclient/logs
MacOS Installation
Install the MacOS package
Open a Command terminal window, then run the following command to execute the package:
Configure the MacOS client
Run the following
adaptivactlcommand in setup mode to configure the client:
Only the --server flag is required. See the adaptivactl command line parameters section below for the available parameters.
Once the client installation is completed, the client will perform a series of connection checks.
MacOS logs
Client installation log: /opt/adaptivaclient/logs/adaptiva.log
Client logs: /opt/adaptiva/adaptivaclient/logs
adaptivactl command line parameters
A list of the command line parameters for the adaptivactl, both required and optional. Known flags can also be printed by running:
Required
--server <hostname> / <ip address> / url:port
IP Address, hostname, or URL of the Patch Server to which the client reports to.
Optional
--auth-secret <secret>
The client authentication secret to use to authenticate with the server. If absent, no authentication will be performed with the server.
--proxy <scheme>://<host>:<port>
The HTTP proxy to use. Has the format <scheme>://<host>:<port>. If absent, the system-wide proxy will be used if configured.
--server-guid <guid>
The Server GUID for your Adaptiva Server. You can find this in the Admin Portal under Settings, Server Activation.
--tenant-guid <guid>
The Tenant GUID used in multi-tenant environments.
--cloud-tenant-id <tenant id>
The ID of the cloud tenant in cloud-hosted environments.
--system-config <property>=<value>
A system config value to set during setup, and has the following format: <property>=<value> This flag may be repeated multiple times.
--skip-firewall-rules
Skip the creation of firewall rules.
--skip-connection-checks
Skip the post-setup connection checks.
Setup Examples:
Direct server using an IP address, an HTTP proxy, and a custom system config:
Server using cloud relay, hostname, client authentication:
Modify system configuration on Linux or MacOS
You can use the adaptivactl command to read and write system config values using the config operation.
The following command reads the value of a system config property:
The following command sets the value of a system config property:
Example - Get client details
Example - Configure a proxy server
This example shows how to set the proxy settings for the client using the adaptivactl config command.
First set the proxy server name.
Then set the port for the client to connect to the proxy server.
Restart the Adaptiva client
Use the following command to restart the Adaptiva Client Daemon.
Linux:
macOS:
Client upgrade
If you need to upgrade existing cross-platform clients to a newer version manually, perform package upgrades using the commands below. For more information on the supported operating systems, see Supported Systems. (Replace <version> with the appropriate version of the Adaptiva client your are trying to install and <arch> with the specific architecture)
Version 10.1.972 and later
Debian / Ubuntu:
AlmaLinux, Amazon Linux, CentOS Stream, Fedora Linux, Oracle Linux, Red Hat Enterprise Linux, Rocky Linux:
SUSE-Based:
macOS:
Use the following command in macOS to restart the Adaptiva Client Daemon:
Version 10.1.971 and below
Debian / Ubuntu:
AlmaLinux, CentOS Stream, Oracle, RHEL, Rocky:
macOS:
Use the following command in macOS to restart the Adaptiva Client Daemon:
Last updated
Was this helpful?