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
- Go to Agent > Download Agent or navigate to File > Add Device > Download Agent
- 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
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
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.
# 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
$ 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.
- Provide the Dashboard Username and Password
- Enter the Client number to register the Device against, or enter 0 to create a new Client
- Enter the Site number to register the Device against, or enter 0 to create a new Site
- Populate the device description to display against the Device on the Dashboard
- Review the registration information
- Enter yes to accept or to change the registration information.
** Agent registration **
User name: firstname.lastname@example.org
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
Select the Site number:2
Device Description: Linux Server
Please check registration data:
Client: Abertay Pharmaceuticals
Device Description: "Linux Server"
Want to continue registration? Answer "yes" or "no"
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?
- Review the supported Distributions (overview or detail)
- Learn how to deploy the Linux Monitoring AgentSite Installation Package
- Cover the steps to update Linux Monitoring Agent Version 2
- Uninstall Linux Monitoring Agent Version 2
- Appraise the Required Linux Server Permissions the Linux Monitoring Agent