Navigation:  Getting Started - Monitoring Agents > Linux Monitoring Agent Installation > Install, update and remove - Debian Family >

Linux Monitoring Agent - Debian Quick Installation Guide

Previous pageReturn to chapter overviewNext page


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