OMD Server Installation


Open Monitor Distribution
For more information on Open Monitor Distribution, visit omdistro.org


Description:


OMD bundles Nagios together with many important addons and can easily be installed on every major Linux distribution. We provide prebuilt packages for all enterprise Linux distributions and also for some other, such as Ubuntu.

OMD currently comes with the following software:

Nagios Monitoring Plugins (Former known as Nagios-Plugins) nsca, check_nrpe, Icinga, Shinken, NagVis, pnp4nagios, rrdtool/rrdcached Check_MK, MK Livestatus, Multisite, Dokuwiki, Thruk, Mod-Gearman check_logfiles, check_oracle_health, check_mysql_health, jmx4perl check_webinject, check_multi


Pre-Requisites:


Install the packages that are needed to support OMD


   COMPATABILITY NOTICE:
These instructions are only compatible with Debian     and Ubuntu  
Although OMD can be installed on CentOS 7/RHEL 7, the site does not come up clean, and extensive troubleshooting is required to compile non RPM bundled dependancies such as mod_python.


apt-get update
apt-get -y install postfix mailutils vim python-mysqldb


Patch and Fix postfix:


sed -i 's/inet_interfaces\ =\ localhost/inet_interfaces\ =\ all/g' /etc/postfix/main.cf
systemctl restart postfix.service
echo "This is the body of the email" | mail -s "This is the subject line" user@yourcompany.com


Import the GPG key:



wget -q "https://labs.consol.de/repo/stable/RPM-GPG-KEY" -O - | sudo apt-key add -


Install the repo:


Install the labs.consol.de repository for the official OMD packages. You can take a look at all of the available repositories on labs.consol.de labs.consol.de


Debian   Debian Jessie:

echo "deb http://labs.consol.de/repo/stable/debian $(lsb_release -cs) main" > /etc/apt/sources.list.d/labs-consol-stable.list
apt-get update


Ubuntu   Ubuntu > 15.04:

echo "deb http://labs.consol.de/repo/stable/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/labs-consol-stable.list
apt-get update


Install OMD:


Install the official Open Monitor Distribution packages


apt-get install -y omd


root@omdserver:~# omd

Usage (called as root):

 omd help                               Show general help
 omd setup                              Prepare operating system for OMD (installs packages)
 omd uninstall                          Remove OMD and all sites!
 omd setversion VERSION                 Sets the default version of OMD which will be used by new sites
 omd version    [SITE]                  Show version of OMD
 omd versions                           List installed OMD versions
 omd sites                              Show list of sites
 omd create     SITE                    Create a new site (-u UID, -g GID)
 omd init       SITE                    Populate site directory with default files and enable the site
 omd rm         SITE                    Remove a site (and its data)
 omd disable    SITE                    Disable a site (stop it, unmount tmpfs, remove Apache hook)
 omd enable     SITE                    Enable a site (reenable a formerly disabled site)
 omd mv         SITE NEWNAME            Rename a site
 omd cp         SITE NEWNAME            Make a copy of a site
 omd update     SITE                    Update site to other version of OMD
 omd start      [SITE] [SERVICE]        Start services of one or all sites
 omd stop       [SITE] [SERVICE]        Stop services of site(s)
 omd restart    [SITE] [SERVICE]        Restart services of site(s)
 omd reload     [SITE] [SERVICE]        Reload services of site(s)
 omd status     [SITE] [SERVICE]        Show status of services of site(s)
 omd config     SITE ...                Show and set site configuration parameters
 omd diff       SITE ([RELBASE])        Shows differences compared to the original version files
 omd su         SITE                    Run a shell as a site-user
 omd umount     [SITE]                  Umount ramdisk volumes of site(s)
 omd backup     SITE SITE [-|ARCHIVE_PATH] Create a backup tarball of a site, writing it to a file or stdout
 omd restore    [SITE] [-|ARCHIVE_PATH] Restores the backup of a site to an existing site or creates a new site
 ```

<br>

## Install OMD Dependancies:
-------
```bash
omd setup


Create and Start the monitor site:


omd create production
Adding /omd/sites/production/tmp to /etc/fstab.
Creating temporary filesystem /omd/sites/production/tmp...OK
Restarting Apache...OK
Created new site production with version 1.30.

  The site can be started with omd start production.
  The default web UI is available at http://omdserver.yourcompany.com/production/
  The admin user for the web applications is omdadmin with password omd.
  Please do a su - raleigh for administration of this site.


omd start production
Starting rrdcached...OK
Starting npcd...OK
Starting nagios...OK
Starting dedicated Apache for site production...OK
Initializing Crontab...OK


Access the Site:


Open a web browser and go to http://omdserver.yourcompany.com/production/

   Default Credentials:
username: omdadmin
password: omd


Commands:


Stop the service

omd stop


Check Status

omd status
Doing 'status' on site production:
rrdcached:      running
npcd:           running
nagios:         running
apache:         running
crontab:        running
-----------------------
Overall state:  running


Post Requisites:


None


References:


omdistro.org

labs.consol.de

mathias-kettner.de