Debian/Ubuntu Quickstart¶
Download a current binary package¶
Download the most current binary package from the omd-debian project 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 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 a file:
# /etc/apache2/conf.d/zzz_omd.conf 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¶
- Configuration basics explains the basic structure of omd bases Nagios installations.