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

 

 

 

Proxy

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

 

linux_dashboard

 

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