User Tools

Site Tools


Debian/Ubuntu Quickstart

Download a current binary package

Download the most current binary package from the download page.

Installation (for GNOME-based systems)

If you are using GNOME, you most probably have installed the package gdebi, which provides the easiest way of how to install OMD on Debian/Ubuntu. Just call gdebi with the name of the OMD package:

gdebi omd-0.43_0.43lucid1_amd64.deb

That will automatically install all packages, OMD needs for proper operation and then OMD itself.

Installation (without gdebi)

If you are not using <tt>gdebi</tt> you have to manually install the packages OMD depends on. You can find out those packages with: dpkg-deb –info <omd-package> gives you some information like this:

...
 Depends: debconf (>= 0.5) | debconf-2.0, libapache2-mod-python, libapache2-mod-php5, php5-sqlite, php5-mcrypt, libgd2-xpm, libdbi0, libapache2-mod-proxy-html
 Recommends: xinetd, mysql-server, graphviz, dnsutils, snmp, fping, smbclient, unzip, libnet-snmp-perl, libxml-simple-perl
...

Install all neccessary packages from the line Depends:, i.e.

apt-get install libapache2-mod-python libapache2-mod-php5 php5-sqlite php5-mcrypt libgd2-xpm libdbi0 libapache2-mod-proxy-html

Just a copy and paste, but remove the ”,”. Then install the omd package:

dpkg -i <omd-package>

Apache basics

OMD needs two apache proxy modules: mod_proxy and mod_proxy_http. You have to enable both:

a2enmod proxy_http

Apache configuration for each site will be placed in /omd/apache, so this directory has to be included. The Debian/Ubuntu packages create the file /etc/apache2/conf.d/zzz_omd.conf with the following content:

Include /opt/omd/apache/*.conf

If the directory is empty (i.e. you have omd installed, no site created and the dummy file /omd/apache/empty.conf deleted) you get an error if you try to start/restart apache. Create a site or recreate the dummy file /omd/apache/empty.conf.

Last, but not least restart apache:

/etc/init.d/apache2 restart

Create a site and start OMD

Create a site as user root (or use sudo on Ubuntu). For example mysite:

omd create mysite

Start omd globally as user root (or use sudo):

omd start

Now you can play around with a very basic configuration and the web frontend:

http://myhost/mysite base url of the site mysite
http://myhost/mysite/nagios classic web frontend
http://myhost/mysite/check_mk check_mk multisite frontend
http://myhost/mysite/pnp4nagios pnp4nagios start page
http://myhost/mysite/nagvis nagvis start page

Where to go from here

The page Configuration basics explains the basic structure of OMD.