Manual Installation — Linux Agent

The files required to manually install the Linux Agent are included in a DEB or RPM installation package that you download from the All Devices view. First you download the installation package, install the Agent, and then register the Agent.

To optimize installation time and ensure Check and Automated Task consistency across devices, you can Configure default monitoring templates for installation.

You can also install the Linux Agent using the Remote Worker Site Installation Package. For more information, see Site Installation Package — Linux Agent.

The Linux Agent requires unzip, ethtool, smartmontools, dmidecode and glibc (2.12 minimum), which are generally installed by default in modern Linux distributions. If any of these packages are not installed, you must add them during this manual DEB or RPM installation. For an example of checking and then installing a package (glibc), see Package Dependencies.

1. Download Linux Agent installation package

  1. On the All Devices view, go to AgentDownload Agent > Download Linux Agent

  2. Select the Linux Agent version to download and the required installer:
    • DEB Installer — Debian-based systems, including Ubuntu
    • RPM Installer — other distributions
    • Raspberry Pi Deb Installer —  Raspberry Pi OS and Ubuntu from 20.04

    The installation package downloads to your computer.

2. Install the Agent

Run the following commands as root to install the Agent on the target operating system. If the command is not executed from the package directory, enter its location as part of the second argument.

For example,

# dpkg --install ./Download/rmmagent_2.0.0.deb

Install on Debian-based distributions

When in the root shell

# dpkg --install ./rmmagent_2.0.0.deb

Using sudo

$ sudo dpkg --install ./rmmagent_2.0.0.deb

Where a missing dependencies message is returned, run the following command to install the dependencies then complete the Agent installation.

# apt-get install -f

Install on SUSE-based distributions

# zypper install ./rmmagent-2.0.0.rpm

Install on Red Hat, Fedora and CentOS

To check whether the computer is using DNF or YUM, run the following command.

# yum --version

DNF installation command

# dnf localinstall ./rmmagent-2.0.0.rpm

YUM installation command

# yum localinstall ./rmmagent-2.0.0.rpm

3. Register the Linux Agent

When the Linux Agent is installed, run the following command as root to register the Agent with the All Devices view:

  • Debian-based distributions

    # ./usr/local/rmmagent/rmmagentd register

  • Other distributions

    # /usr/local/rmmagent/rmmagentd register

To verify the source of any future updates, we recommend you install the Linux Agent package GPG (GNU Privacy Guard) key.

The user receives a prompt to provide their All Devices view credentials along with the information required to complete the registration process.

  1. Provide the Dashboard Username and Password
  2. Enter the Client number to register the Device against, or enter 0 to create a new Client
  3. Enter the Site number to register the Device against, or enter 0 to create a new Site
  4. Populate the device description to display against the Device on the Dashboard
  5. Review the registration information
  6. Enter yes to accept or to change the registration information.

** Agent registration **
User name: dashboard@login.key
Your current clients:
0) Create new Client/Site
1) Abertay Pharmaceuticals
2) Juggling Supplies
Select the Client number:1
Sites for client Abertay Pharmaceuticals:
0) Create new Client/Site
1) Main Office
2) Laboratory
Select the Site number:2
Device Description: Linux Server

Please check registration data:
Client: Abertay Pharmaceuticals
Site: Laboratory
Device Description: "Linux Server"
Want to continue registration? Answer "yes" or "no"
Successfully registered

What do you want to do?