Linux Monitoring Agent - Red Hat Quick Installation Guide

Automatic Deployment from Repository

To download, install and update the Linux Agent we suggest adding our repository reference to the device.

The following examples are based on yum (Yellowdog Updater Modified) and the repository information required to populate these fields is contained in the .repo file for that specific Linux distribution and build available from the repository.

There are a number of options to achieve this and in each case it is necessary to login as root to action the required changes.

Add a .repo file for the particular distribution and architecture in the /etc/yum.repos.d directory pointing to the repository.

Depending upon preference there are a variety of ways this can be added:

Download the file from the server to the directory /etc/yum.repos.d, for example using wget:

# cd /etc/yum.repos.d

# wget http://repos.*/rmmagent/distribution/rmmagent.repo

Add a repository reference to /etc/yum.conf entering the contents of the .repo file on the repository server for the required distribution and architecture*.

Open yum.conf then after PUT YOUR REPOS HERE OR IN separate files named file.repo in /etc/yum.repos.d either manually complete the details from .repo or where the contents were copied, paste the information in this section.

There is also the option to Add the repository from the graphical user interface via Edit, Repositories.

Regardless of the method used after adding the repository it may be necessary to import the required GPG key and this can be achieved with the rpm - import command, referencing the repomd.xml.key in the repodata directory of the repository:

# rpm --import http://repos.*/rmmagent/distribution/repodata/repomd.xml.key

Once the repository is setup, to deploy the Agent rmmagent.rpm package run the yum install command including the architecture of the device the Agent is to be installed upon (i.e. i386 or x86_64)

# yum install rmmagent.i386

# yum install rmmagent.x86_64

Manual deployment using RPM (Red Hat Package Management)

The Agent is available as an RPM file and as such it is possible to automatically install the package from the command line.

Enter rpm -Uhv and the location of the package for this distribution and architecture, for example its repository position:

# rpm -Uhv http://repos.*/rmmagent/distribution/architecture/rmmagent-*.rpm

This command initiates the download and installation of the Agent onto the target device:

Register the Linux Monitoring Agent with the Dashboard

Navigate to the Agent installation directory

# cd /usr/local/rmmagent

Apply the following command to register the Agent on the Dashboard.

# ./rmmagentd -i

When prompted input the login credentials (for example the Agent Key Username and password) then select the required Client and Site.

Please note it is normal to see one or more Access Deniederror messages while the Agent attempts to locate the correct territory system instance.

When complete you can Start Agent Now ?  to run the Agent as a daemon.

Register rmmagent as a service using chkconfig to ensure the Linux Monitoring Agent starts after a reboot

Please ensure the Linux Monitoring Agent is registered as a service to start automatically when the server enters runlevel 3. This can be achieved using chkconfig which updates system services runlevel information.

Use --add <servicename> to add the service then --list <servicename> to ensure this was successful.

# chkconfig --add rmmagent

# chkconfig --list rmmagent

Where not set to as a service the Linux Monitoring Agent must be manually started after a reboot.


Where communication is through a proxy on the network, the pak.xml file contained in /usr/local/rmmagent directory - must be edited before registration to take account of this. Amendments to the proxy settings may be applied post-registration in agentconfig.xml in the rmmagent directory.

Apply the ./rmmagentd -i command to register the Agent on the Dashboard.

After the Agent is registered against the Dashboard it will appear in the Server Monitoring section with a Linux icon clip0458


Please note as there is no management console for the Linux Monitoring Agent, any changes (change Agent settings add or edit Checks) are configured from the Dashboard.

* Note, in line with best practice we suggest making a copy of /etc/yum.conf before editing which can be achieved with the copy command

# cp /etc/yum.conf /etc/yum.conf.orig