Currently, the Linux Agent only officially supports Ubuntu, Red Hat, Debian, Fedora, and CentOS. Although most of the data collection is generic to any Linux distribution, thus far testing has only been completed on Ubuntu, Red Hat, Debian, Fedora, and CentOS.
Raspberry Pi/ARM-based Linux OS Support
ARM-based Linux operating systems are not currently supported for our Linux Agent. If this functionality appears useful to your organization, please upvote the implementation of this feature request here.
Linux Agent 1.9.4 and lower
If you are running Linux Agent 1.9.4 or lower you must uninstall your agent version before proceeding to install the latest version. Instructions for completing this can be found here
- Recording a Liongard Access Key ID and Secret
- Installing the Agent
- Downloading the Agent Installer Manually
- Uninstalling the Linux Agent
Liongard Access Key Tokens and Secrets can be reused when installing Agents, or you can generate a new Access Key Token and Secret every time.
If you do decide to reuse the Access Key and Secret, it should be secured as you would any other sensitive password.
Our Access Tokens are used only to register an Agent. It is not something that the Agent stores, so if a token gets deleted, nothing will happen to Agents that were installed using that token.
- In Liongard, navigate to Your Name > Account Settings > Access Tokens
- If you have an existing Access Token, you may use it to deploy the Agent.
- If you need to generate a new token, select Generate New Token then select Agent Install Token.
- Note: Users must be a member of the Global Admin, Global Environment Manager, or Global System Integrators groups to see the Agent Install Token option.
- Record a Liongard Access Key ID and Secret as you will need them in the next steps.
What user should I run the Agent as?
We recommend using a normal local user with sudo access on the system. We do not recommend running as root.
- Log into the Linux system
- Download the Liongard Agent using wget or your preferred method:
wget -k https://agents.static.liongard.com/LiongardAgent-lts-x64.xz.run
curl -o LiongardAgent-lts-x64.xz.run https://agents.static.liongard.com/LiongardAgent-lts-x64.xz.run
- Verify that the file was downloaded with the
chmod 700 LiongardAgent-lts-x64.xz.runto give the file executable permissions.
- Run the the command to install the agent:
sudo ./LiongardAgent-lts-x64.xz.run -- -u InstanceURL -k AccessKey -s AccessSecret
The use of
--must precede any arguments used for the installer
The available arguments for the agent installer are as follows:
- -u: Liongard Instance URL (Required)
- -k: Agent Access Key (Required)
- -s: Agent Access Secret (Required)
- -n: Agent Name
- -e: Liongard Environment
- -d: Agent Description
- Log in to Liongard
- Click on the Admin menu and select Agents
- Hover over the Download Agent Installer button in the top-right corner and select Linux
- You can either download the install script by clicking on the Download Linux Installer button or copy the curl command to download it in the Shell.
The agent can be uninstalled from the system with the installer file by using the
-x argument as shown below:
sudo ./LiongardAgent-lts-x64.xz.run -- -x
The following command can be used to check on the status of the Liongard Agent Service:
systemctl status liongard-agent
The following command can be used to check on the status of the Liongard Updater Service:
systemctl status liongard-agent-updater
The following command can be used to check when the Liongard updater service checks for updates:
systemctl list-timers | grep liongard
To assist support with troubleshooting Agent issues the following log files may be required to send to support for further analysis:
* Do I need to allowlist specific URLs?
Yes. You must allowlist npmjs.org and nodejs.org as well as your Liongard instance in order to download and install the Agent successfully.
For further information about allowing URLs with the Agent, please visit the Deployment via MSI Installer document under the Allowlisting Requirements
* Do you support all Linux distributions and versions?
We have attempted to support across all versions and distributions. However, most of the testing has been done on Ubuntu, Red Hat, Debian, and Fedora. If you encounter problems on a specific distribution, please Support Portal: Chat with Support.
Step 1. Download the uninstall script with the following command
curl -k https://roar2.app.liongard.com/api/v1/agents/scripts/uninstall-roar-agent/ -o uninstall-roar-agent
Step 2. Open terminal in uninstall script location and run the following command
chmod +x uninstall-roar-agent
Step 3. Finally, run the following command
sh -e uninstall-roar-agent
Step 4. Log into your Liongard Instance
Step 5. Navigate to your Agents by going to Admin > Agents
Step 5. Delete the Uninstalled Agent(s)
Updated 3 months ago