Linux Agents

CommandCTRL 1.5 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 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-*

Thin client platforms (IGEL OS and Citrix eLux) will be documented in a future update, once their installation packages are published.