Version 7 (modified by jonmills, 8 years ago)


This tutorial assumes you are installing on a RHEL, CentOS, or equivalent system, and that you compiled OMD on the system itself (so there shouldn't be dependency problems).

RPM Install

Taking the RPM you created in OMDcompile, you now want to install it with, for example:

yum localinstall omd-0.50-rh60-25.x86_64.rpm

Create Site

First, select a site name. The site name will exist both as a local user/group entry in your /etc/passwd && /etc/group files, and it will also be part of the URL when pulling up the site, e.g: http://localhost/sitename. It is imperative that you choose a sitename that is unique to this instance of OMD. Don't make it something generic like 'nagios' or 'omd'. The reasons behind this will be come clear later on when you try to use MK_Multisite and need to use mod_proxy to fetch remote pnp4nagios graphs...

omd create sitename

Initial Configuration

Begin by becoming the 'sitename' user:

su - sitename

Make note of certain environmental variables:

echo $OMD_ROOT

Note the available 'omd' commands for the 'sitename' user:

$ omd
Usage (called as site user):

 omd help                        Show general help
 omd version    [SITE]           Show version of OMD
 omd versions                    List installed OMD versions
 omd sites                       Show list of sites
 omd update                      Update site to other version of OMD
 omd start      [SERVICE]        Start services of one or all sites
 omd stop       [SERVICE]        Stop services of site(s)
 omd restart    [SERVICE]        Restart services of site(s)
 omd reload     [SERVICE]        Reload services of site(s)
 omd status     [SERVICE]        Show status of services of site(s)
 omd config     ...              Show and set site configuration parameters
 omd diff       ([RELBASE])      Shows differences compared to the original version files

General Options:
 -V <version>                    set specific version, usefull in combination with update/create
  • We want to set up our basic operating environment. In particular, we need to set two necessary options:
    • Web_GUI --> APACHE_MODE=Shared
    • Web_GUI --> DEFAULT_GUI=check_mk
    • Set these options by running:
omd config

Starting the site

# /etc/init.d/httpd start
# su - sitename
OMD[sitename]:~$ omd start