OMD Server Installation

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" [email protected]

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 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 > 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

Install OMD Dependancies:

---

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:

---

clusterfrak.com
omdistro.org
labs.consol.de
mathias-kettner.de