Remote Monitoring & Management Help

Linux Monitoring Agent - Debian Quick Installation Guide

Automatic Deployment from Repository

The Linux Monitoring Agent may be installed from the command line and the following examples use APT (Advanced Package Tool) to achieve this.

Add a repository reference to /etc/apt/sources.list with the repository location for the required distribution and architecture.

For example: deb http://repos.*/rmmagent/distribution/ ./

Note: the ./ line in the sources.list is required.

Add the repository key to the list of trusted keys, this can be achieved by downloading the Release.key to the device with wget then using the apt-key add command to append the key to the list.

# wget http://repos.*/rmmagent/distribution/Release.key

# apt-key add Release.key

Although it is possible to combine the above two steps into one command:

# wget -O - http://repos.*/rmmagent/distribution/Release.key | apt-key add -

Install the Linux Monitoring Agent

After the repository reference is added to /etc/apt/sources and the Release.key appended to the trusted keys list we suggest running apt-get update to update the local package index.

# apt-get update

Once updated the Agent installation process can begin using apt-get install:

# apt-get install rmmagent

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 Denied error 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 update-rc.d or 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 the update-rc.d or by using chkconfig which updates system services runlevel information.

To add the rmmagent with update-rc.d use defaults which sets the default runlevels and the rc*.d directories can then be queried to determine whether this was successful.

# update-rc.d rmmagent defaults

# find /etc/rc*.d/ -name *rmmagent*|grep rc|sort

For chkconfig 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.

Please be aware that some Debian systems (for example Ubuntu 12.04) do not have chkconfig installed by default and to install the package please run the following command at the CLI when logged on as a root:

# apt-get install chkconfig


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/apt/sources.list before editing which can be achieved with the copy command

# cp /etc/apt/sources.list /etc/apt/sources.list.orig