Linux Agents

CommandCTRL supports installing the agent on Debian-based and RPM-based Linux distributions from the Liquidware package repository, on the amd64 and arm64 architectures.

RPM-based distributions supported: Red Hat Enterprise, CentOS, Scientific, or Oracle 7; Red Hat Enterprise, Rocky, AlmaLinux, or Oracle 8 and 9; and Fedora 38, 39, and 40.

Install Using the Official Package Managers

This is the recommended way to install the agent on Linux. One command adds the Liquidware repository and installs the agent. The command already includes your tenant ID and API key.

1. In the side navigation panel, scroll down to the Miscellaneous section and click Install Agent.

2. In the Downloads section, expand Linux.

3. Under Official Package Managers, find the command for your package manager: dnf for Fedora, CentOS, and Red Hat, or apt for Ubuntu, Debian, and Linux Mint.

   

4. Click the copy icon to the right of the command.

5. On the Linux machine, paste the command into a terminal and press Enter.

To install the agent manually instead, follow the steps in Install on Debian-Based Distribution or Install on RPM-Based Distributions.

Install on Debian-Based Distribution

1. Add the repository key:

   Copy

   sudo mkdir -p /etc/apt/keyrings
   sudo apt-get install wget
   wget -q -O- https://cdn.liquidware.com/repo/commandctrl/liquidware_support.gpg.asc | sudo gpg --dearmor -o /etc/apt/keyrings/ccagent.gpg

2. Add the repository:

   Copy

   echo "deb [signed-by=/etc/apt/keyrings/ccagent.gpg arch=$(dpkg --print-architecture)] https://cdn.liquidware.com/repo/commandctrl/prod/$(lsb_release -is | tr A-Z a-z) $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ccagent.list > /dev/null

3. Install the package:

   Copy

   sudo apt-get update
   sudo apt-get install ccagent

4. Configure the TenantID and apiKey from your tenant in /etc/ccagent/ccagent.yaml. Leave a space between each variable and its value:

   Copy

   sudo nano /etc/ccagent/ccagent.yaml
   TenantID 12345677
   apikey 3Dfdd145

5. Start the agent:

   Copy

   sudo systemctl start ccagent

Install on RPM-Based Distributions

1. Add the repository by creating /etc/yum.repos.d/commandctrl.repo. For example, for Red Hat Enterprise, Rocky, AlmaLinux, or Oracle 9:

   Copy

   echo "[commandctrl]
   name=CommandCTRL
   baseurl=https://cdn.liquidware.com/repo/commandctrl/prod/redhat/redhat-9-\$basearch
   enabled=1
   gpgcheck=1
   gpgkey=https://cdn.liquidware.com/repo/commandctrl/liquidware_support.gpg.asc" | sudo tee /etc/yum.repos.d/commandctrl.repo

   For other distributions, substitute the matching baseurl path — for example redhat-7, redhat-8, or fedora/fedora-40.

2. Install the package. On Red Hat, CentOS, Scientific, or Oracle 7, use yum; on all others, use dnf:

   Copy

   sudo yum install -y ccagent     (RHEL/CentOS/Oracle 7)
   sudo dnf install -y ccagent     (all others)

3. Configure the TenantID and apiKey in /etc/ccagent/ccagent.yaml:

   Copy

   sudo vi /etc/ccagent/ccagent.yaml

4. Enable and start the agent:

   Copy

   sudo systemctl enable ccagent
   sudo systemctl start ccagent

Linux Support File Locations

1. Logs: /var/log/ccagent.log

2. Configuration file: /etc/ccagent/ccagent.yaml

3. Temporary files: /tmp/systemd-private-*-ccagent.service-*

For thin client platforms, see IGEL Agents and Citrix/Unicon eLux Agents.