Debian/Ubuntu package

We provide and maintain an apt repository and package containing the latest agent, making it easy to install and upgrade the agent on Debian-flavoured distributions.

Configuring apt-get

The first step in installing the agent is configuring your aptitude package manager so that it is aware of our repository.

Adding our public key

For added security, all of our Linux packages and repositories are signed. You must add our public key to your apt-get keyring in order to download and install the agent package.

wget http://www.serverdensity.com/downloads/boxedice-public.key
sudo apt-key add boxedice-public.key

Adding our repository

Next, add our repository to your list of repositories. This list is contained in a file called sources.list, usually in /etc/apt/. An editor such as nano will work:

sudo nano -w /etc/apt/sources.list

Add the following line at the end of the file:

deb http://www.serverdensity.com/downloads/linux/debian lenny main

Finally, update apt-get:

sudo apt-get update

You can confirm that the agent is now available for installation by looking in apt-cache:

apt-cache search sd-agent

Installing the agent

Once our repository has been configured on your server, the agent may be installed just like any other package:

sudo apt-get install sd-agent

NOTE: Remember to configure your agent after installation. See part 3 of Agent installation. You need to edit the file /etc/sd-agent/config.cfg.

Running the agent

The package sets up the agent init script for you automatically. In addition to starting on boot, you can start the agent manually:

sudo /etc/init.d/sd-agent start

Uninstalling the agent

There are two options for uninstallation of the agent through apt-get. The first option is to simply remove the package. This removes the agent but keeps the init script and config file on your system, in case you need them in the future.

sudo apt-get remove sd-agent

If you want to completely remove all files related to the agent, then you will want to purge the package.

sudo apt-get purge sd-agent