Install the Agent

Linux Monitoring Agent Version 2 moved away from installing the Agent from the repository and instead combined all the required files into a Dashboard downloadable DEB or RPM package.

Download Linux Monitoring Agent Version 2

  1. Go to Agent > Download Agent or navigate to File > Add Device > Download Agent
  2. Select the version of the Linux Agent to download then choose the required installer:
    • DEB Installer: Debian-based systems, including Ubuntu
    • RPM Installer: other distributions
  3. The installation package then downloads to your computer

Agent Package Dependencies: Linux Monitoring Agent Version 2 requires unzip, ethtool, smartmontools, dmidecode and glibc (2.12) which are generally installed by default in modern Linux distributions. If missing they are automatically installed by the Remote Worker Site Installation Package, but must be manually installed when deploying through the .deb or .rpm available from the Dashboard. For an example of checking then installing a package (glibc), visit Linux Monitoring Agent Version 2 Package Dependencies

Agent Installation

Run the following commands as root to install the Agent on the target operating system. Where 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

A warning message appears when running the installer on a device with Linux Monitoring Agent Version 1 installed when upgrading specifically to Linux Monitoring Agent 2.0. This message informs the user that Agent 1.0 will be uninstalled during migration and its data removed from the Dashboard. Answer "y" to continue or "n" to abort the upgrade process. Visit Migrate from Linux Monitoring Agent v1 to v2.0 for more information.

All Site Installation Packages based on Linux Monitoring Agents version 2.0.1 or later support an upgrade path from Linux Monitoring Agent Version 1 that does not require the uninstallation of the existing Agent and retains the device's data.

Register the Linux Agent

Once installed, the final stage is to run the following command as root to register the Agent with the Dashboard .

# /usr/local/rmmagent/rmmagentd register

The user receives a prompt to provide their Dashboard 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
Password:
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
 

Register rmmagent as a service to ensure the Linux Monitoring Agent starts automatically starts after a reboot.

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

What do you want to do?