install nagios环境

admin

Installing Nagios Core From Source
& f1 v! G, @: P7 \, l7 n% x

This document describes how to install Nagios Core from source.

This guide is broken up into several sections and covers different operating system (OS) distributions. If your OS Distribution is not included in this guide then please contact us to see if we can get it added. Some distributions may be missing as we don't have access to a test environment that allows us to develop the documentation.

Nagios Core 4.4.0 and Nagios Plugins 2.2.1 is what this guide instructs you to install, however future versions should also work fine with these steps.

This documentation is broken up into two distinct sections:

• Install Nagios Core
  
• Install Nagios Plugins
  1 a/ V5 V# J6 [! z2 O
  

This separation is to make a clear distinction as to what prerequisite packages are required by the OS it is being installed on. For example the SNMP packages are installed as part of the Nagios Plugins section, as SNMP is not required by Nagios Core.

Please select your OS:

• Red Hat Enterprise Linux (RHEL)
  
• CentOS
  
• Oracle Linux
  ! S: G3 Z; E9 Q( t9 o/ u7 Q
• Ubuntu
  
• SUSE SLES | openSUSE Leap
  
• Debian
  
• Raspbian
  
• Fedora
  9 o3 |: q8 O9 X9 M9 z2 X
• Arch Linux
  
• Gentoo
  
• FreeBSD
  
• Solaris
  5 K  {, G' Z  z5 l& V! k! V7 ^
• Apple OS X
  ; a2 S) v/ M. S9 q$ {" e
  0 ?9 Z* ?4 _/ X0 d, P5 o2 P# p

CentOS | RHEL | Oracle Linux

Security-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. Steps to do this are as follows.

sed -i 's/SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config
setenforce 0
Prerequisites

Perform these steps to install the pre-requisite packages.

yum install -y gcc glibc glibc-common wget unzip httpd php gd gd-devel perl postfix Downloading the Sourcecd /tmp
wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
. W( k* ?( Y, K8 |/ |& ?: |Compilecd /tmp/nagioscore-nagios-4.4.0/
./configure
( _$ o4 k; e  v% Wmake all
2 j+ Z: S1 y% k3 R9 u. zCreate User And Group

This creates the nagios user and group. The apache user is also added to the nagios group.

make install-groups-users
' G. L- N8 ?9 {" r/ x* Pusermod -a -G nagios apache
Install Binaries

This step installs the binary files, CGIs, and HTML files.

make install
+ j5 j9 Z: @; Y8 v7 y7 b6 _' c% mInstall Service / Daemon

This installs the service or daemon files and also configures them to start on boot. The Apache httpd service is also configured at this point.

===== CentOS 5.x / 6.x | RHEL 5.x / 6.x | Oracle Linux 5.x / 6.x =====

make install-init
chkconfig --level 2345 httpd on

===== CentOS 7.x | RHEL 7.x | Oracle Linux 7.x =====

make install-init
* h- l8 _* S1 M. Lsystemctl enable httpd.service

Information on starting and stopping services will be explained further on.

Install Command Mode

This installs and configures the external command file.

make install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

make install-config
. F! u/ u2 D5 L- Z: dInstall Apache Config Files

This installs the Apache web server configuration files. Also configure Apache settings if required.

make install-webconf
Configure Firewall

You need to allow port 80 inbound traffic on the local firewall so you can reach the Nagios Core web interface.

===== CentOS 5.x / 6.x | RHEL 5.x / 6.x | Oracle Linux 5.x / 6.x =====

iptables -I INPUT -p tcp --destination-port 80 -j ACCEPT
service iptables save
ip6tables -I INPUT -p tcp --destination-port 80 -j ACCEPT
) Q- z7 V& a( u9 \# H" ]5 Xservice ip6tables save

===== CentOS 7.x | RHEL 7.x | Oracle Linux 7.x =====

firewall-cmd --zone=public --add-port=80/tcp
+ C& v( a! ]. P& K! p! S6 Kfirewall-cmd --zone=public --add-port=80/tcp --permanent
) D3 k" G5 y; k6 s8 wCreate nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

# s, y$ K9 y$ ~* n# S3 _1 @/ O
Start Apache Web Server

===== CentOS 5.x / 6.x | RHEL 5.x / 6.x | Oracle Linux 5.x / 6.x =====

service httpd start
6 D2 r* w! Q3 n) T, g5 Z

===== CentOS 7.x | RHEL 7.x | Oracle Linux 7.x =====

systemctl start httpd.service
9 M2 C3 v; c% s! D' Q/ J# g3 xStart Service / Daemon

This command starts Nagios Core.

===== CentOS 5.x / 6.x | RHEL 5.x / 6.x | Oracle Linux 5.x / 6.x =====

service nagios start
2 s) q' j( `( t

===== CentOS 7.x | RHEL 7.x | Oracle Linux 7.x =====

systemctl start nagios.service
! \% c7 m9 `( h% u! lTest Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

" Z$ }+ ?+ t2 N+ ?3 W# OInstalling The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

Prerequisites

Make sure that you have the following packages installed.

===== CentOS 5.x =====

yum install -y gcc glibc glibc-common make gettext automake wget openssl-devel net-snmp net-snmp-utils epel-release
yum install -y perl-Net-SNMP
cd /tmp
1 l+ o* V6 ?4 v8 v, j7 J0 f* swget http://ftp.gnu.org/gnu/autoconf/autoconf-2.60.tar.gz
# H4 D6 Y4 W1 @' v3 E; w7 ~tar xzf autoconf-2.60.tar.gz
cd /tmp/autoconf-2.60
- y9 }+ y0 T6 L./configure
make
, |* P, e4 [( \- R+ l6 R# Q9 ?& Smake install

===== CentOS 6.x / 7.x =====

yum install -y gcc glibc glibc-common make gettext automake autoconf wget openssl-devel net-snmp net-snmp-utils epel-release
yum install -y perl-Net-SNMP
1 |$ G; A6 w/ O, G. L

===== RHEL 5.x | Oracle Linux 5.x =====

cd /tmp
. J( g( c& A1 S+ F( Kwget http://archives.fedoraproject.or ... latest-5.noarch.rpm
rpm -ihv epel-release-latest-5.noarch.rpm
yum install -y gcc glibc glibc-common make gettext automake wget openssl-devel net-snmp net-snmp-utils
yum install -y perl-Net-SNMP
4 p5 K$ E8 J1 q1 h$ p  Xwget http://ftp.gnu.org/gnu/autoconf/autoconf-2.60.tar.gz
* P+ B7 `% |, g; R& `9 e8 }tar xzf autoconf-2.60.tar.gz
cd /tmp/autoconf-2.60
./configure
& {& T' \3 e) b1 e! k) d5 w) ]# R6 \# ?make
( t3 I5 H4 s! h" q* b) o1 d( xmake install
+ p1 D- t4 y8 N* J8 m2 Y$ B

===== RHEL 6.x | Oracle Linux 6.x =====

cd /tmp
wget https://dl.fedoraproject.org/pub ... latest-6.noarch.rpm
3 i) I5 u& R: f7 n: T" _- W( jrpm -ihv epel-release-latest-6.noarch.rpm
yum install -y gcc glibc glibc-common make gettext automake autoconf wget openssl-devel net-snmp net-snmp-utils
* l6 q+ o( x( X+ T2 xyum install -y perl-Net-SNMP
# P; F! G& q" j: v3 x" J+ V

===== RHEL 7.x =====

cd /tmp
wget https://dl.fedoraproject.org/pub ... latest-7.noarch.rpm
rpm -ihv epel-release-latest-7.noarch.rpm
subscription-manager repos --enable=rhel-7-server-optional-rpms
; M% F9 v3 G6 J: o, X* Jyum install -y gcc glibc glibc-common make gettext automake autoconf wget openssl-devel net-snmp net-snmp-utils
; V3 b  C% q9 U; |% ?yum install -y perl-Net-SNMP
# B0 B- X% _( q- f1 H' Z; z

===== Oracle Linux 7.x =====

yum install -y yum-utils
2 H# P9 _6 A; x' t2 Ayum-config-manager --enable ol7_optional_latest
: b- A- G# b3 m4 D/ rcd /tmp
wget https://dl.fedoraproject.org/pub ... latest-7.noarch.rpm
" k) R, N: z! N5 Y) r/ krpm -ihv epel-release-latest-7.noarch.rpm
yum install -y gcc glibc glibc-common make gettext automake autoconf wget openssl-devel net-snmp net-snmp-utils
( r+ O& W# |4 X$ f5 N! _yum install -y perl-Net-SNMP
Downloading The Sourcecd /tmp
$ n& ^% P, }: G9 l( @wget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
tar zxf nagios-plugins.tar.gz
( R% o. g6 S* }3 J, zCompile + Installcd /tmp/nagios-plugins-release-2.2.1/
./tools/setup
6 \2 F* g5 y5 s1 P1 v./configure
make
$ W  V& p, Q3 S- H* Mmake install
Test Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

Service / Daemon Commands

Different Linux distributions have different methods of starting / stopping / restarting / status Nagios.

===== CentOS 5.x / 6.x | RHEL 5.x / 6.x | Oracle Linux 5.x / 6.x =====

service nagios start
8 }  |6 A, J: Y% C4 R; d6 Nservice nagios stop
& n5 _1 ?4 z/ T( [$ Iservice nagios restart
service nagios status

===== CentOS 7.x | RHEL 7.x | Oracle Linux 7.x =====

systemctl start nagios.service
systemctl stop nagios.service
systemctl restart nagios.service
systemctl status nagios.service
! G: s- B- Z2 y, w' l
* x8 p7 V+ A( C; Y
' M1 ]& x! U/ N" M

Ubuntu

Security-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. SELinux is not enabled by default on Ubuntu. If you would like to see if it is installed run the following command:

sudo dpkg -l selinux*
Prerequisites

Perform these steps to install the pre-requisite packages.

===== Ubuntu 14.x / 15.x =====

sudo apt-get update
sudo apt-get install -y autoconf gcc libc6 make wget unzip apache2 apache2-utils php5 libgd2-xpm-dev
/ [# p" d# a4 {0 N3 W; d! U) h

===== Ubuntu 16.x / 17.x =====

sudo apt-get update
% G$ m& T" l( usudo apt-get install -y autoconf gcc libc6 make wget unzip apache2 php libapache2-mod-php7.0 libgd2-xpm-dev
' v4 [; _& y4 K. ^  I9 {

===== Ubuntu 18.x =====

sudo apt-get update
% P( v3 u/ C- u( o2 C( E& }* Gsudo apt-get install -y autoconf gcc libc6 make wget unzip apache2 php libapache2-mod-php7.2 libgd-dev
' U, V' ]/ n/ cDownloading the Sourcecd /tmp
4 F( @2 l# Y- L2 w. {wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
$ d' v, d# ?7 \8 v! ICompilecd /tmp/nagioscore-nagios-4.4.0/
sudo ./configure --with-httpd-conf=/etc/apache2/sites-enabled
5 X6 X! k! P6 m) ^& g: hsudo make all
Create User And Group

This creates the nagios user and group. The www-data user is also added to the nagios group.

sudo make install-groups-users
sudo usermod -a -G nagios www-data
Install Binaries

This step installs the binary files, CGIs, and HTML files.

sudo make install
  B% s4 `* E  q$ p/ Q) aInstall Service / Daemon

This installs the service or daemon files and also configures them to start on boot.

sudo make install-init

Information on starting and stopping services will be explained further on.

Install Command Mode

This installs and configures the external command file.

sudo make install-commandmode
) i4 c& q. [( F5 YInstall Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

sudo make install-config
Install Apache Config Files

This installs the Apache web server configuration files and configures Apache settings.

sudo make install-webconf
sudo a2enmod rewrite
' P  f: V* X& K0 _9 osudo a2enmod cgi
2 U5 y& Y5 v! z% U9 ?Configure Firewall

You need to allow port 80 inbound traffic on the local firewall so you can reach the Nagios Core web interface.

sudo ufw allow Apache
+ i9 a, n" n. V' C& Tsudo ufw reload
Create nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

sudo htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
' F& z6 s+ t& g% d1 F1 b

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

* W# ^5 y9 \4 j3 @0 Y0 |; }
Start Apache Web Server

===== Ubuntu 14.x =====

Need to restart it because it is already running.

sudo service apache2 restart

===== Ubuntu 15.x / 16.x / 17.x /18.x =====

Need to restart it because it is already running.

sudo systemctl restart apache2.service
Start Service / Daemon

This command starts Nagios Core.

===== Ubuntu 14.x =====

sudo start nagios
$ S* a5 s. [6 ~6 d

===== Ubuntu 15.x / 16.x / 17.x / 18.x =====

sudo systemctl start nagios.service
( ^/ L0 }  {2 |% m5 Q% ~/ Q4 xTest Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

; ^( f8 }, ]) T, Q1 o: _. WInstalling The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

; L% B- V& @" y! `! ?

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

Prerequisites

Make sure that you have the following packages installed.

sudo apt-get install -y autoconf gcc libc6 libmcrypt-dev make libssl-dev wget bc gawk dc build-essential snmp libnet-snmp-perl gettext
Downloading The Sourcecd /tmp
wget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
tar zxf nagios-plugins.tar.gz
Compile + Installcd /tmp/nagios-plugins-release-2.2.1/
sudo ./tools/setup
sudo ./configure
5 T/ V& z1 j3 c( |sudo make
sudo make install
1 `9 j6 y  X7 r) UTest Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

$ T" J0 f  C0 b* N% IService / Daemon Commands

Different Linux distributions have different methods of starting / stopping / restarting / status Nagios.

===== Ubuntu 14.x =====

sudo start nagios
9 s9 q% s& I( h* F! Osudo stop nagios
7 W1 }1 k2 n% P- {& M& Asudo restart nagios
sudo status nagios

===== Ubuntu 15.x / 16.x / 17.x / 18.x =====

sudo systemctl start nagios.service
! @, c5 T0 `+ Hsudo systemctl stop nagios.service
sudo systemctl restart nagios.service
sudo systemctl status nagios.service
* W2 L  U- r$ Z7 F& }$ h: L
, t3 d: ~% `, P; o! d! D, Z% M6 p
  I+ [6 E8 L9 ~+ ]

SUSE SLES | openSUSE Leap

Security-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. SELinux is not enabled by default on SUSE. If you would like to see if it is enabled run the following command:

ls -la /etc/selinux/config

If the file does not exist, SELinux is not enabled.

Prerequisites

Perform these steps to install the pre-requisite packages.

===== SUSE SLES 11.3 =====

cd /tmp
* {, d' q% f) h5 kwget 'https://nu.novell.com/repo/$RCE/SLE11-SDK-SP3-Pool/sle-11-x86_64/rpm/x86_64/sle-sdk-release-11.3-1.69.x86_64.rpm'
, G$ D, S& P  F* Ywget 'https://nu.novell.com/repo/$RCE/SLE11-SDK-SP3-Pool/sle-11-x86_64/rpm/x86_64/sle-sdk-release-SDK-11.3-1.69.x86_64.rpm'
8 T0 A3 {" T1 Dsudo rpm -ivh sle-sdk-release-*
. U6 F. b% |  i: b- s/ Gsudo suse_register
8 C* \$ X& i! q- Q/ V1 ssudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php53 apache2-mod_php53 gd gd-devel

===== SUSE SLES 11.4 =====

cd /tmp
) H5 H2 N9 k3 M$ |& C6 B4 wwget 'https://nu.novell.com/repo/$RCE/SLE11-SDK-SP4-Pool/sle-11-x86_64/rpm/x86_64/sle-sdk-release-11.4-1.55.x86_64.rpm'
& T" i0 f; t+ h; m' C  y3 wwget 'https://nu.novell.com/repo/$RCE/SLE11-SDK-SP4-Pool/sle-11-x86_64/rpm/x86_64/sle-sdk-release-SDK-11.4-1.55.x86_64.rpm'
sudo rpm -ivh sle-sdk-release-*
# z- S. P6 L( C1 u  hsudo suse_register
/ _6 n- w5 ^2 F  Wsudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php53 apache2-mod_php53 gd gd-devel

===== SUSE SLES 12 =====

sudo SUSEConnect -p sle-sdk/12/x86_64
( P0 t% D3 X( q/ _sudo SUSEConnect -p sle-module-web-scripting/12/x86_64
sudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php5 apache2-mod_php5 gd gd-devel
+ r3 }5 c; h* u% f

===== SUSE SLES 12.1 =====

sudo SUSEConnect -p sle-sdk/12.1/x86_64
sudo SUSEConnect -p sle-module-web-scripting/12/x86_64
sudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php5 apache2-mod_php5 gd gd-devel
, r% b0 o* @, n5 r2 K' a$ H

===== SUSE SLES 12.2 =====

sudo SUSEConnect -p sle-sdk/12.2/x86_64
8 B5 P2 @/ A9 ^* |8 Xsudo SUSEConnect -p sle-module-web-scripting/12/x86_64
sudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php5 apache2-mod_php5 gd gd-devel

===== SUSE SLES 12.3 =====

sudo SUSEConnect -p sle-sdk/12.3/x86_64
sudo SUSEConnect -p sle-module-web-scripting/12/x86_64
sudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php5 apache2-mod_php5 gd gd-devel

===== openSUSE Leap 42.x =====

sudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php5 apache2-mod_php5 gd gd-devel

===== openSUSE Leap 15.x =====

sudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php7 apache2-mod_php7 gd gd-devel

) D. o' {0 Z( N4 _% W6 qDownloading the Sourcecd /tmp
wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
9 q. S. ?' Q' D3 w( W, [tar xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
sudo ./configure --with-httpd-conf=/etc/apache2/vhosts.d
sudo make all
Create User And Group

This creates the nagios user and group. The apache user is also added to the nagios group.

===== SUSE SLES 11.x =====

sudo make install-groups-users
sudo /usr/sbin/usermod -A nagios wwwrun
+ _7 D# v" @7 D( o) u( y

===== SUSE SLES 12.x | openSUSE Leap 42.x / 15.x =====

sudo make install-groups-users
1 D+ p. W8 D) x" [  |5 ?sudo /usr/sbin/usermod -a -G nagios wwwrun
. y1 K8 X% ?! u- j- U7 z1 D; NInstall Binaries

This step installs the binary files, CGIs, and HTML files.

sudo make install
Install Service / Daemon

This installs the service or daemon files and also configures them to start on boot.

sudo make install-init

Information on starting and stopping services will be explained further on.

3 Z4 M' O: K0 uInstall Command Mode

This installs and configures the external command file.

sudo make install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

sudo make install-config
- C+ Z2 Z$ b, W6 J( `. p  F; gInstall Apache Config Files

This installs the Apache web server configuration files. Also configure Apache settings if required.

===== SUSE SLES 11.x =====

sudo make install-webconf
sudo /usr/sbin/a2enmod rewrite
sudo /usr/sbin/a2enmod cgi
sudo /usr/sbin/a2enmod version
# d5 a' Z  h! o% hsudo /usr/sbin/a2enmod php5
1 \. P. r0 C/ H; hsudo /sbin/chkconfig --set apache2 on
# c1 E8 w3 W! ]

===== SUSE SLES 12.x | openSUSE Leap 42.x =====

sudo make install-webconf
$ b* O% U4 b* ^/ f# E! W0 Ssudo /usr/sbin/a2enmod rewrite
sudo /usr/sbin/a2enmod cgi
sudo /usr/sbin/a2enmod version
sudo /usr/sbin/a2enmod php5
sudo systemctl enable apache2.service
& a% G3 H# @3 C9 O& I+ l3 O

===== openSUSE Leap 15.x =====

sudo make install-webconf
4 b% h4 T8 l" wsudo /usr/sbin/a2enmod rewrite
sudo /usr/sbin/a2enmod cgi
- e. V& g: R0 m2 m) |: \# V" z& q5 esudo /usr/sbin/a2enmod version
sudo /usr/sbin/a2enmod php7
sudo systemctl enable apache2.service
Configure Firewall

You need to allow port 80 inbound traffic on the local firewall so you can reach the Nagios Core web interface.

===== SUSE SLES 11.x =====

sudo sed -i '/FW_SERVICES_EXT_TCP=/s/\"$/\ 80\"/' /etc/sysconfig/SuSEfirewall2
2 X0 H# ^$ F8 g' `' U1 Xsudo /sbin/service SuSEfirewall2_init restart
2 X0 B* Z+ f- I# e3 D" ^sudo /sbin/service SuSEfirewall2_setup restart
3 k. A8 k1 H* F) w

===== SUSE SLES 12.x =====

sudo /usr/sbin/SuSEfirewall2 open EXT TCP 80
sudo systemctl restart SuSEfirewall2
* i/ X! R! ?% Z/ P, p

===== openSUSE Leap 42.x =====

Port 80 is enabled when Apache is installed, nothing needs to be done.

) l7 p/ S) \% F# h( s

===== openSUSE Leap 15.x =====

sudo firewall-cmd --zone=public --add-port=80/tcp
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
9 b2 w1 [3 Z3 \$ J& |
3 ^5 O0 d  }) n$ uCreate nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

sudo htpasswd2 -c /usr/local/nagios/etc/htpasswd.users nagiosadmin

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

& O0 g! l" w! z  l( f; g; z2 wStart Apache Web Server

===== SUSE SLES 11.x =====

sudo /sbin/service apache2 start
0 o" `) V8 I" r! N1 l; E0 o+ {

===== SUSE SLES 12.x | openSUSE Leap 42.x / 15.x =====

sudo systemctl start apache2.service
7 m* r) X( |3 ?1 G1 qStart Service / Daemon

This command starts Nagios Core.

===== SUSE SLES 11.x =====

sudo /sbin/service nagios start
0 f' k, Y* v: E$ P! c4 H

===== SUSE SLES 12.x | openSUSE Leap 42.x / 15.x =====

sudo systemctl start nagios.service
Test Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

4 R6 R: l, r# e8 F' Z  G5 FInstalling The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

- b9 Y3 c0 N  ~: lPrerequisites

Make sure that you have the following packages installed.

===== SUSE SLES 11.x / 12.x | openSUSE Leap 42.x =====

sudo zypper --non-interactive install autoconf gcc glibc libmcrypt-devel make libopenssl-devel wget gettext gettext-runtime automake net-snmp perl-Net-SNMP

===== openSUSE Leap 15.x =====

sudo zypper --non-interactive install autoconf gcc glibc libgcrypt-devel make libopenssl-devel wget gettext gettext-runtime automake net-snmp perl-Net-SNMP
( u$ y4 ]. V: t! ], O2 A5 C; H% n4 SDownloading The Sourcecd /tmp
wget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
& Y" X! F# |9 a/ @7 v; j8 q; a- t- ytar zxf nagios-plugins.tar.gz
, V8 E3 C! I$ K4 ]: kCompile + Installcd /tmp/nagios-plugins-release-2.2.1/
4 U9 N+ \! m# a/ w4 Ssudo ./tools/setup
sudo ./configure
- E% }, i0 V; _) Csudo make
sudo make install
Test Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

# T, `) T( M) sService / Daemon Commands

Different Linux distributions have different methods of starting / stopping / restarting / status Nagios.

===== SUSE SLES 11.x =====

sudo /sbin/service nagios start
sudo /sbin/service nagios stop
sudo /sbin/service nagios restart
' S! V9 e: m9 Y& Z+ jsudo /sbin/service nagios status

===== SUSE SLES 12.x | openSUSE Leap 42.x / 15.x =====

sudo systemctl start nagios.service
5 |; y5 S7 C6 u$ g. n6 Qsudo systemctl stop nagios.service
% M. L6 o+ ~0 R+ s: Tsudo systemctl restart nagios.service
sudo systemctl status nagios.service

Debian | Raspbian

All steps on Debian require to run as root. To become root simply run:

Debian:

su
  y/ C" g0 H4 W

Raspbian:

sudo -i

All commands from this point onwards will be as root.

9 o/ Q4 X2 v% T2 S4 t2 u3 sSecurity-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. SELinux is not enabled by default on Debian. If you would like to see if it is installed run the following command:

dpkg -l selinux*
# ^' n8 f* }" J. L: cPrerequisites

Perform these steps to install the pre-requisite packages.

===== 7.x / 8.x =====

apt-get update
apt-get install -y autoconf gcc libc6 make wget unzip apache2 apache2-utils php5 libgd2-xpm-dev
# B1 k) K9 {" [) q2 }3 |

===== 9.x =====

apt-get update
- D2 q8 X5 Q1 H! h! hapt-get install -y autoconf gcc libc6 make wget unzip apache2 apache2-utils php libgd-dev
3 t, M7 w& y% R( TDownloading the Sourcecd /tmp
! y  z6 _# C! w5 R+ p/ }wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
8 K( J& Q5 r/ G4 U* _7 W: w( V& DCompilecd /tmp/nagioscore-nagios-4.4.0/
! r5 X. \* g# n1 ]6 ~1 @, G2 p./configure --with-httpd-conf=/etc/apache2/sites-enabled
make all
5 J* q5 r& k7 XCreate User And Group

This creates the nagios user and group. The www-data user is also added to the nagios group.

make install-groups-users
usermod -a -G nagios www-data
, a0 U8 V& [( h$ ]Install Binaries

This step installs the binary files, CGIs, and HTML files.

make install
Install Service / Daemon

This installs the service or daemon files and also configures them to start on boot.

make install-init
* X1 `* x7 w! n' ]

Information on starting and stopping services will be explained further on.

Install Command Mode

This installs and configures the external command file.

make install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

make install-config
Install Apache Config Files

This installs the Apache web server configuration files and configures the Apache settings.

make install-webconf
a2enmod rewrite
& e5 c" s- }3 b, ?' {1 [2 oa2enmod cgi
Configure Firewall

You need to allow port 80 inbound traffic on the local firewall so you can reach the Nagios Core web interface.

iptables -I INPUT -p tcp --destination-port 80 -j ACCEPT
apt-get install -y iptables-persistent

Answer yes to saving existing rules

Create nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
" z  o( b, x9 @! N( C( @; {

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

/ L" e  C0 _% r3 s/ p2 y
Start Apache Web Server

===== 7.x =====

Need to restart it because it is already running.

service apache2 restart

===== 8.x / 9.x =====

Need to restart it because it is already running.

systemctl restart apache2.service
' z+ u: O" H, f% r, MStart Service / Daemon

This command starts Nagios Core.

===== 7.x =====

service nagios start

===== 8.x / 9.x =====

systemctl start nagios.service
- O7 B' r1 j' C$ kTest Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

Installing The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

) j" v' ^8 u9 {8 K: _5 F6 @

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

Prerequisites

Make sure that you have the following packages installed.

apt-get install -y autoconf gcc libc6 libmcrypt-dev make libssl-dev wget bc gawk dc build-essential snmp libnet-snmp-perl gettext
7 _7 \7 ?6 x! MDownloading The Sourcecd /tmp
. t! _$ @9 d" M' Mwget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
, @% w) @" B8 ?& o0 w) d7 b8 m' rtar zxf nagios-plugins.tar.gz
Compile + Installcd /tmp/nagios-plugins-release-2.2.1/
./tools/setup
0 n* L7 _% ]# X, Z./configure
# m0 |" b: ?' G+ P" rmake
make install
' L5 ?1 F: L  |& rTest Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

Service / Daemon Commands

Different Linux distributions have different methods of starting / stopping / restarting / status Nagios.

===== 7.x =====

service nagios start
! \2 M  l1 ^& y+ kservice nagios stop
7 R& p* |6 u, q, C) A+ {service nagios restart
9 n! J( Q7 m8 R$ w" }1 L% V: O0 Pservice nagios status

===== 8.x / 9.x =====

systemctl start nagios.service
systemctl stop nagios.service
systemctl restart nagios.service
systemctl status nagios.service


8 D; C3 |* G& d8 e8 v+ b9 h( O, v

Fedora

Security-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. Steps to do this are as follows.

sed -i 's/SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config
setenforce 0
Prerequisites

Perform these steps to install the pre-requisite packages.

dnf install -y gcc glibc glibc-common perl httpd php wget gd gd-devel
dnf update -y Downloading the Sourcecd /tmp
# G5 |4 z/ s3 e) a9 q0 _wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
5 f+ V: X% K/ H! s% B! G1 S0 k/ PCompilecd /tmp/nagioscore-nagios-4.4.0/
+ @: h, r  s7 b* A. y0 ~- F% z6 j./configure
make all
( E* F. x) |& _' j5 }. G/ G/ b- F7 u( kCreate User And Group

This creates the nagios user and group. The apache user is also added to the nagios group.

make install-groups-users
usermod -a -G nagios apache
Install Binaries

This step installs the binary files, CGIs, and HTML files.

make install
Install Service / Daemon

This installs the service or daemon files and also configures them to start on boot. The Apache httpd service is also configured at this point.

make install-init
0 t4 c" d/ ?2 P, E( Hsystemctl enable httpd.service
9 |7 R0 m1 H4 ^: b+ F& ?

Information on starting and stopping services will be explained further on.

  E$ b. v! Y6 b5 y$ nInstall Command Mode

This installs and configures the external command file.

make install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

make install-config
& ~+ Q% r9 @! `0 u) CInstall Apache Config Files

This installs the Apache web server configuration files. Also configure Apache settings if required.

make install-webconf
- M, F) T0 A! f0 R5 \: @) u( @* q) iConfigure Firewall

You need to allow port 80 inbound traffic on the local firewall so you can reach the Nagios Core web interface.

firewall-cmd --zone=FedoraServer --add-port=80/tcp
firewall-cmd --zone=FedoraServer --add-port=80/tcp --permanent
Create nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
( }9 V) o& `. `

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

Start Apache Web Serversystemctl start httpd.service
7 X; T! ~) {8 o  P5 VStart Service / Daemon

This command starts Nagios Core.

systemctl start nagios.service
/ x( U, P+ s# o) iTest Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

Installing The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

. T1 a. v+ C% K, q& g

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

  [" Z6 x: s% ~9 [0 YPrerequisites

Make sure that you have the following packages installed.

dnf install -y gcc glibc glibc-common openssl-devel perl wget gettext make net-snmp net-snmp-utils perl-Net-SNMP automake autoconf
Downloading The Sourcecd /tmp
wget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
5 E5 @( y: J' h' [6 ^tar zxf nagios-plugins.tar.gz
Compile + Installcd /tmp/nagios-plugins-release-2.2.1/
./tools/setup
% t# v- X' d( {./configure
make
3 ?9 X5 A& t8 s* w% u! v8 A' Wmake install
Test Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

9 c" _$ k0 U( G# y! cService / Daemon Commands

These commands are for starting / stopping / restarting / status Nagios.

systemctl start nagios.service
5 g( F/ t# K" H5 ]systemctl stop nagios.service
systemctl restart nagios.service
2 h/ g) W& f' bsystemctl status nagios.service

( w( n9 i) R' s( X$ \

Arch Linux

Security-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. SELinux is not installed on a base build of Arch Linux. If you would like to see if it is enabled run the following command:

ls -la /etc/selinux/config

If the file does not exist, SELinux is not enabled.

Prerequisites

Perform these steps to install the pre-requisite packages.

pacman --noconfirm -Syyu
% T; c# U& r0 v" j# Xpacman --noconfirm -S gcc glibc make wget unzip apache php gd traceroute php-apache Downloading the Sourcecd /tmp
- U" Q. L$ L4 t6 i( L3 h% H/ p3 I6 |9 awget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
2 A( G. }8 J7 [8 Y0 B5 n8 w- wtar xzf nagioscore.tar.gz
( W7 Y' W" x" U' T3 ACompilecd /tmp/nagioscore-nagios-4.4.0/
, O% P9 W: q( W! S; W& a./configure --with-httpd-conf=/etc/httpd/conf/extra
$ I2 h) D* m# p/ p. R1 mmake all
Create User And Group

This creates the nagios user and group. The http user is also added to the nagios group.

make install-groups-users
usermod -a -G nagios http
, H) k" _  Y% Q. p, Z; @7 SInstall Binaries

This step installs the binary files, CGIs, and HTML files.

make install
Install Service / Daemon

This installs the service or daemon files and also configures them to start on boot. The Apache httpd service is also configured at this point.

make install-init
4 m$ P' h. Z2 Y" D0 F3 r3 S* csystemctl enable httpd.service
Install Command Mode

This installs and configures the external command file.

make install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

make install-config
Install Apache Config Files

This installs the Apache web server configuration files.

make install-webconf
8 b9 {, c0 z8 a

As well as installing the Apache web server configuration files, there are additional changes required to the Apache config file httpd.conf to enable modules.

Commands that do all of these changes are below, but first is a list of the changes being made.

Change this:

LoadModule mpm_event_module modules/mod_mpm_event.so

To this:

#LoadModule mpm_event_module modules/mod_mpm_event.so

Change this:

#LoadModule mpm_prefork_module modules/mod_mpm_prefork.so

To this:

LoadModule mpm_prefork_module modules/mod_mpm_prefork.so

Change this:

<IfModule !mpm_prefork_module>
6 X) d5 Z8 y* D# e# L2 \        #LoadModule cgid_module libexec/apache24/mod_cgid.so
</IfModule>
<IfModule mpm_prefork_module>
        #LoadModule cgi_module libexec/apache24/mod_cgi.so
</IfModule>

To this:

<IfModule !mpm_prefork_module>
        LoadModule cgid_module libexec/apache24/mod_cgid.so
</IfModule>
<IfModule mpm_prefork_module>
# {$ C) c' \* `0 |. k1 a/ U* Z$ ~4 y        LoadModule cgi_module libexec/apache24/mod_cgi.so
</IfModule>
( @8 U+ T7 w3 m

Change this:

<IfModule dir_module>
    DirectoryIndex index.html
</IfModule>

To this:

<IfModule dir_module>
    DirectoryIndex index.php index.html index.htm AddType application/x-httpd-php .phpAddType application/x-httpd-php-source .phps
</IfModule>
% [8 {' B4 n, I, }

Add these lines to the end of the file:

LoadModule php7_module modules/libphp7.so
3 ~$ g! C  ]' S# ^4 s' S, gInclude "conf/extra/nagios.conf"
Include "conf/extra/php7_module.conf"
, D+ t& R$ x7 |5 P5 H( O<FilesMatch ".php$">
8 B* `, s; d# [: V4 }& _    SetHandler application/x-httpd-php
1 d7 V$ ]6 O! r, X0 h! @' E9 `</FilesMatch>
6 k' _, x3 {3 a7 M<FilesMatch ".phps$">
    SetHandler application/x-httpd-php-source
% l8 H. q+ a' Q/ @</FilesMatch>
# F' u' l* P1 u2 @9 Y) S( |

Execute the following commands to make the changes described above:

sed -i 's/^LoadModule mpm_event_module modules\/mod_mpm_event\.so/#LoadModule mpm_event_module modules\/mod_mpm_event\.so/g' /etc/httpd/conf/httpd.conf
sed -i 's/^#LoadModule mpm_prefork_module modules\/mod_mpm_prefork\.so/LoadModule mpm_prefork_module modules\/mod_mpm_prefork\.so/g' /etc/httpd/conf/httpd.conf
1 V$ [7 w0 s. }, nsed -i 's/DirectoryIndex index.html/DirectoryIndex index.php index.html index.htm AddType application\/x-httpd-php .phpAddType application\/x-httpd-php-source .phps/g' /etc/httpd/conf/httpd.conf
sed -i 's/#LoadModule cgid_module/LoadModule cgid_module/g' /etc/httpd/conf/httpd.conf
sed -i 's/#LoadModule cgi_module/LoadModule cgi_module/g' /etc/httpd/conf/httpd.conf
echo 'LoadModule php7_module modules/libphp7.so' >> /etc/httpd/conf/httpd.conf
echo 'Include "conf/extra/nagios.conf"' >> /etc/httpd/conf/httpd.conf
echo 'Include "conf/extra/php7_module.conf"' >> /etc/httpd/conf/httpd.conf
& N+ B% b3 o5 |printf '\n<FilesMatch ".php$">\n' >> /etc/httpd/conf/httpd.conf
# u8 K; o0 x6 ?4 q5 f6 i/ Y& k; yprintf '\tSetHandler application/x-httpd-php\n' >> /etc/httpd/conf/httpd.conf
3 }5 f3 l- K* A+ {" N2 z( _7 fprintf '</FilesMatch>\n' >> /etc/httpd/conf/httpd.conf
printf '<FilesMatch ".phps$">\n' >> /etc/httpd/conf/httpd.conf
printf '\tSetHandler application/x-httpd-php-source\n' >> /etc/httpd/conf/httpd.conf
printf '</FilesMatch>\n' >> /etc/httpd/conf/httpd.conf
0 U3 D* l& V% U; a" aConfigure Firewall

Arch Linux does not have a firewall enabled in a fresh installation. Please refer to the Arch Linux documentation on allowing TCP port 80 inbound.

Create nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

' C( V3 t# a1 O+ b! a! d, q
Start Apache Web Serversystemctl start httpd.service
7 J6 L; }+ ^" q& l6 J+ ^Start Service / Daemon

This command starts Nagios Core.

systemctl start nagios.service
Test Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

Installing The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

/ p: [/ `1 ?7 }; s% ~Prerequisites

Make sure that you have the following packages installed.

pacman --noconfirm -S autoconf gcc glibc make openssl wget perl gettext net-snmp perl-net-snmp automake autoconf
Downloading The Sourcecd /tmp
/ B  ?5 |; W( D  q  c! }wget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
tar zxf nagios-plugins.tar.gz
Compile + Installcd /tmp/nagios-plugins-release-2.2.1/
./tools/setup
& w' N! I) H6 V8 B2 r$ L) ]8 P' f./configure
3 g* G' y/ F# B6 Z; r, t, Rmake
make install
Test Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

2 V3 W9 T1 M" z. {. bService / Daemon Commands

Different Linux distributions have different methods of starting / stopping / restarting / status Nagios.

systemctl start nagios.service
8 n0 w: L8 x/ wsystemctl stop nagios.service
) Q0 v0 Z, y* n6 R+ B# ]systemctl status nagios.service

Gentoo

Security-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. SELinux is not installed on a base build of Gentoo. If you would like to see if it is enabled run the following command:

ls -la /etc/selinux/config

If the file does not exist, SELinux is not enabled.

( T3 l2 z( }4 k8 B( [2 jPrerequisites

Perform these steps to install the pre-requisite packages.

emerge --sync
' d  n4 D/ l9 ~; ^1 i5 e0 F  w( O* Jmkdir -p /etc/portage/package.use
# t0 Z% ~# m/ o* w: @3 ?; Zecho "www-servers/apache dir cgi cgid event prefork apache2_modules_version" >> /etc/portage/package.use/apache
echo "dev-lang/php apache2" >> /etc/portage/package.use/php
! e2 e9 R9 |7 {1 S8 e) I7 g- Decho "app-eselect/eselect-php apache2" >> /etc/portage/package.use/eselect-php
echo "media-libs/gd gd png jpeg" >> /etc/portage/package.use/gd
4 f3 y' r' f1 q7 z7 [1 Wemerge --noreplace sys-devel/gcc sys-libs/glibc net-misc/wget app-arch/unzip www-servers/apache dev-lang/php media-libs/gd Downloading the Sourcecd /tmp
wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
# u3 N/ D  p7 @1 W2 F./configure --with-httpd-conf=/etc/apache2/vhosts.d --sysconfdir=/usr/local/nagios/etc
make all
8 u$ I7 o: y6 ~, LCreate User And Group

This creates the nagios user and group. The http user is also added to the nagios group.

make install-groups-users
usermod -a -G nagios apache
Install Binaries

This step installs the binary files, CGIs, and HTML files.

make install
: d( H) f# k+ @" s1 JInstall Service / Daemon

This installs the service or daemon files and also configures them to start on boot. The apache2 service also needs to be configured to start at boot.

===== openrc =====

make install-init
rc-update add apache2 default
% N/ a" F' f( P! {9 S" O0 e, M

===== systemd =====

make install-init
systemctl enable apache2.service
( z8 }& ]3 N$ W, W; BInstall Command Mode

This installs and configures the external command file.

make install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

make install-config
/ L$ i7 g) ^: c6 O# dInstall Apache Config Files

This installs the Apache web server configuration files.

make install-webconf
8 {$ L5 @: m2 |" b& i2 L8 D0 U

As well as installing the Apache web server configuration files, there are additional changes required to the Apache config file apache2 to enable modules.

Commands that do all of these changes are below, but first is a list of the changes being made.

In the file /etc/conf.d/apache2 change this:

APACHE2_OPTS="-D DEFAULT_VHOST -D INFO -D SSL -D SSL_DEFAULT_VHOST -D LANGUAGE"

To this:

APACHE2_OPTS="-D DEFAULT_VHOST -D INFO -D SSL -D SSL_DEFAULT_VHOST -D LANGUAGE -D PHP"
% ?$ _6 n& T6 z7 g; x7 M, d

The /run/apache_ssl_mutex directory also needs to be created.

0 d2 b0 _$ S' v9 f( i% T

Execute the following commands to make the change described above:

sed -i '/^APACHE2_OPTS=/s/\([^"]*\)"$/\1 '"-D PHP"'"/' /etc/conf.d/apache2
mkdir -p /run/apache_ssl_mutex
0 t" x" M+ q# g/ M% J# C8 T; H1 \+ TConfigure Firewall

Gentoo does not have a firewall enabled in a fresh installation. Please refer to the Gentoo documentation on allowing TCP port 80 inbound.

Create nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

: z! H5 t1 L' ^5 h( y0 R/ Z
Retart Apache Web Server

===== openrc =====

rc-service apache2 restart

===== systemd =====

systemctl restart apache2.service
% |9 H9 y7 f  c- f3 J, {; MStart Service / Daemon

This command starts Nagios Core.

===== openrc =====

rc-service nagios start
2 C( q  h+ B2 R3 N4 s1 u7 M2 z

===== systemd =====

systemctl start nagios.service
' t( L* {# M8 t5 j( K" ~Test Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

: V3 W& {. w# D1 b9 CInstalling The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

# _5 M7 a: S. A( L$ S8 hPrerequisites

Make sure that you have the following packages installed.

emerge --noreplace sys-devel/gcc sys-libs/glibc net-misc/wget sys-devel/make sys-devel/gettext sys-devel/automake sys-devel/autoconf dev-libs/openssl net-analyzer/net-snmp dev-perl/Net-SNMP
Downloading The Sourcecd /tmp
wget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
tar zxf nagios-plugins.tar.gz
$ r9 {0 O1 U% e# H( m$ z' T  pCompile + Installcd /tmp/nagios-plugins-release-2.2.1/
  U% l7 V: H8 \$ P: B./tools/setup
./configure
make
make install
chmod u+s /bin/ping
; @4 T; v6 I- R7 I! y1 X) }/ s: E# Schmod u+s /bin/ping6
Test Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

Service / Daemon Commands

The different init systems have different methods of starting / stopping / restarting / status Nagios.

===== openrc =====

rc-service nagios start
rc-service nagios stop
rc-service nagios status
rc-service nagios restart
1 ?' b: j  ]* }% Q3 n

===== systemd =====

systemctl start nagios.service
1 ^2 L  n7 t/ Usystemctl stop nagios.service
systemctl status nagios.service
$ j- Y# U; q; A' e0 Rsystemctl restart nagios.service
- S3 j# t3 p+ f0 M( J+ W8 a( E1 H

& H) r9 X$ D9 Z' `* I4 q

FreeBSD

Security-Enhanced Linux

This guide is based on SELinux being disabled or in permissive mode. SELinux is not enabled by default on FreeBSD. If you would like to see if it is enabled run the following command:

ls -la /etc/selinux/config

If the file does not exist, SELinux is not enabled.

1 @# n( m' ?" b$ O) X; SPrerequisites

Perform these steps to install the pre-requisite packages.

pkg install -y wget autoconf automake gmake gettext gcc apache24 php70 php70-extensions mod_php70 libgd Downloading the Sourcecd /tmp
$ R/ w) M# T' vwget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
% w8 R4 ?/ r3 W3 d+ V1 S./configure --with-httpd-conf=/usr/local/etc/apache24/Includes
- P8 e3 k- h7 b/ J( R5 ogmake all
2 T; N4 P# `0 k9 J6 c" FCreate User And Group

This creates the nagios user and group. The www user is also added to the nagios group.

make install-groups-users
pw group mod nagios -m www
Install Binaries

This step installs the binary files, CGIs, and HTML files.

gmake install
chown nagios:nagios /usr/local/nagios/bin/*
Install Service / Daemon

This installs the service or daemon files and also configures them to start on boot.

gmake install-init
echo '/usr/local/etc/rc.d/nagios start' >> /etc/rc.local
5 D6 O# s' ~! F3 D7 T; Z

Information on starting and stopping services will be explained further on.

Install Command Mode

This installs and configures the external command file.

gmake install-commandmode
3 O& C6 x$ ]" o' @2 lInstall Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

gmake install-config
$ ?# b7 P7 @1 \& ^Install Apache Config Files

This installs the Apache web server configuration files.

gmake install-webconf

As well as installing the Apache web server configuration files, there are additional changes required to the Apache config file httpd.conf to enable modules.

Commands that do all of these changes are below, but first is a list of the changes being made.

Change this:

<IfModule !mpm_prefork_module>
/ V  I0 d5 ]% S: b! r: ?% p0 N        #LoadModule cgid_module libexec/apache24/mod_cgid.so
</IfModule>
<IfModule mpm_prefork_module>
% j" {* y3 ^. z: L; I        #LoadModule cgi_module libexec/apache24/mod_cgi.so
1 b0 V; x7 t/ ^1 ^# S' w( i# B0 \</IfModule>

To this:

<IfModule !mpm_prefork_module>
        LoadModule cgid_module libexec/apache24/mod_cgid.so
: q6 n' W$ C# ]9 ?</IfModule>
<IfModule mpm_prefork_module>
        LoadModule cgi_module libexec/apache24/mod_cgi.so
</IfModule>

Change this:

<IfModule dir_module>
    DirectoryIndex index.html
</IfModule>

To this:

<IfModule dir_module>
    DirectoryIndex index.php index.html index.htm AddType application/x-httpd-php .phpAddType application/x-httpd-php-source .phps
</IfModule>
- {: h; G. d; O& m/ ]. Q

Add these lines to the end of the file:

<FilesMatch ".php$">
% E3 `! ]6 }' D: Z, {  e6 d2 t    SetHandler application/x-httpd-php
8 f0 {7 Y( V5 I: E7 w/ e; b</FilesMatch>
<FilesMatch ".phps$">
! x$ B: X4 X. R7 G1 r% ~    SetHandler application/x-httpd-php-source
9 z# ^6 D$ Q4 Q& I$ y* w</FilesMatch>
8 C) s1 Y" s. ^- s( w2 o

Execute the following commands to make the changes described above:

cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini
echo 'apache24_enable="YES"' >> /etc/rc.conf
7 H9 S% |. m; k2 {5 Psed -i '' 's/DirectoryIndex index.html/DirectoryIndex index.php index.html index.htm AddType application\/x-httpd-php .phpAddType application\/x-httpd-php-source .phps/g' /usr/local/etc/apache24/httpd.conf
/ I% [1 g2 r  v  X4 `sed -i '' 's/#LoadModule cgid_module/LoadModule cgid_module/g' /usr/local/etc/apache24/httpd.conf
- ~- V/ G/ q: I# \: v: d7 ?, dsed -i '' 's/#LoadModule cgi_module/LoadModule cgi_module/g' /usr/local/etc/apache24/httpd.conf
3 I  Q: m1 A' I' T, }printf '\n<FilesMatch ".php$">\n' >> /usr/local/etc/apache24/httpd.conf
% C% {0 u# h0 qprintf '\tSetHandler application/x-httpd-php\n' >> /usr/local/etc/apache24/httpd.conf
printf '</FilesMatch>\n' >> /usr/local/etc/apache24/httpd.conf
printf '<FilesMatch ".phps$">\n' >> /usr/local/etc/apache24/httpd.conf
1 J8 }; N1 e* M1 Rprintf '\tSetHandler application/x-httpd-php-source\n' >> /usr/local/etc/apache24/httpd.conf
printf '</FilesMatch>\n' >> /usr/local/etc/apache24/httpd.conf
Configure Firewall

Please refer to the FreeBSD documentation for information on how to enable or configure IP Filter to allow TCP port 80 inbound.

Documentation - Firewalls

8 R0 z$ ~: J. w7 Q5 B" s& t- r8 a3 ICreate nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
1 J7 Q  l  e" C5 R$ q" y3 f" z

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

  V! Z, |6 x6 kStart Apache Web Serverservice apache24 start
Start Service / Daemon

This command starts Nagios Core.

service nagios start
% n. t7 i9 S; E) O( M: qTest Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

* }5 k4 V( {2 s6 N7 lInstalling The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

! [. a6 }. [/ w, i7 W. A9 {

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

# D+ b: G6 T; t& E% ^/ L' }+ p* P; jPrerequisites

Make sure that you have the following packages installed. In the steps below, when installing FreeBSD packages you will be prompted with screens asking what you would like installed. You can just press Enter to accept the default selections.

pkg install -y wget autoconf automake gettext gcc openssl-devel net-snmp p5-Net-SNMP-Util
) W. L! j- ?8 P) eDownloading The Sourcecd /tmp
3 ~  h0 h; Q/ l6 \+ O/ M, [! ^$ f9 xwget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
8 ?  z2 a% w% A$ G! d6 Ftar zxf nagios-plugins.tar.gz
2 Y! e: i& c0 cCompile + Installcd /tmp/nagios-plugins-release-2.2.1/
0 A' G+ J/ ?3 c3 e( S./tools/setup
./configure
gmake
# C) a+ g  p' g$ y+ I8 kgmake install
" s5 r) n: M+ T- p4 w/ B2 [Test Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

Service / Daemon Commands

Different Linux distributions have different methods of starting / stopping / restarting / status Nagios.

service nagios start
service nagios stop
: o7 m1 ~' _- g  L; kservice nagios restart
, C7 ?# Z% U2 J7 g' w, kservice nagios status

! e$ ^9 X! G- b2 i- M

Solaris

Tested with Solaris 11.

Security-Enhanced Linux

SELinux is not implemented in Solaris and hence is not an issue.

Prerequisites

Perform these steps to install the pre-requisite packages.

echo 'export PATH=$PATH:/opt/csw/bin:/usr/xpg4/bin:/usr/sfw/bin' >> ~/.profile
source ~/.profile
( T" Q% n7 |+ y! I* s( m0 ^5 R- `pkgadd -d http://get.opencsw.org/now
5 g2 L: l' Q+ uanswer all
& {: l9 [3 \- a% H0 m+ w1 u) fanswer y
/ i7 H' N9 @; o9 v4 x2 b5 aperl -ni.bak -le 'print; print "mirror=http://mirrors.ibiblio.org/opencsw/stable" if /mirror=/' /etc/opt/csw/pkgutil.conf
pkgutil -y -i autoconf automake unzip gd
/ e/ N/ V! g# U4 L: opkg install gcc-45 web/php-53 apache-php53 gd Downloading the Sourcecd /tmp
wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
* P# ^: [) P9 B+ z: u6 g$ y3 |Compilecd /tmp/nagioscore-nagios-4.4.0/
! o# `( |% h2 |: i5 I; r) j7 v./configure --with-httpd-conf=/etc/apache2/2.2/conf.d --with-gd-inc=/usr/include/gd2
gmake all
Create User And Group

This creates the nagios user and group. The webservd user is also added to the nagios group.

gmake install-groups-users
; k4 N6 `' h$ o% h% fusermod -G nagios webservd
. ]+ H$ n# w' u' V: [Install Binaries

This step installs the binary files, CGIs, and HTML files.

gmake install
Install Service / Daemon

This installs the service or daemon files and also configures them to start on boot. The Apache httpd service is also configured at this point.

gmake install-init
svcbundle -o /lib/svc/manifest/site/nagios.xml -s service-name=application/nagios -s rc-script=/etc/init.d/nagios:2 -s model=contract

Information on starting and stopping services will be explained further on.

Install Command Mode

This installs and configures the external command file.

gmake install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

gmake install-config
  q* `$ C, q* S+ `0 ]% MInstall Apache Config Files

This installs the Apache web server configuration files. Also configure Apache settings if required.

gmake install-webconf
Configure Firewall

On a manually networked system, IP Filter is not enabled by default. Please refer to the Solaris documentation for information on how to enable or configure IP Filter to allow TCP port 80 inbound.

Documentation - Configuring IP Filter

Create nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
2 a  K9 u2 ]. v. G+ o% @

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

Start Apache Web Serversvcadm enable apache22
* j1 E' w( F* Q) q4 {: i9 C& @Start Service / Daemon

This command starts Nagios Core.

svcadm restart manifest-import
- a' j9 s7 _# i" ssvcadm enable nagios
Test Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

Installing The Nagios Plugins

Nagios Core needs plugins to operate properly. The following steps will walk you through installing Nagios Plugins.

These steps install nagios-plugins 2.2.1. Newer versions will become available in the future and you can use those in the following installation steps. Please see the releases page on GitHub for all available versions.

Please note that the following steps install most of the plugins that come in the Nagios Plugins package. However there are some plugins that require other libraries which are not included in those instructions. Please refer to the following KB article for detailed installation instructions:

Documentation - Installing Nagios Plugins From Source

Prerequisites

Already completed as part of the Nagios installation. Some of the plugins require the NET::SNMP perl module. Please refer to the following documentation:

http://www.net-snmp.org/docs/README.solaris.html

Downloading The Sourcecd /tmp
" \8 l) Q3 S/ I! [  g) rwget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
* N) X6 M& X% ^tar zxf nagios-plugins.tar.gz
Compile + Installcd /tmp/nagios-plugins-release-2.2.1/
./tools/setup
7 k% H( N- P: B./configure
gmake
gmake install
5 S% T6 \! l8 E! z% E! T* kTest Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

Service / Daemon Commands

These commands are for starting / stopping / restarting / status Nagios.

svcadm enable nagios
& \; y5 k1 d1 f# f0 M  T! ^) wsvcadm disable nagios
svcadm restart nagios
& y" z8 _, ?" m. l* I5 d8 [/ Usvcs nagios
svcs -xv nagios
7 w; V% e2 \7 p% E/ Ysvcadm clear nagios

The following KB article has important information on Solaris and services:

How To Clear Solaris Service Maintenance Status

Apple OS X

Security-Enhanced Linux

SELinux is not implemented in Apple OS X and hence is not an issue.

Prerequisites

First, make sure Xcode is installed. If it is not installed visit the App Store and install Xcode (3.8GB download).

Then you need to download and install MacPorts, instructions for doing this can be found here:

https://www.macports.org/install.php

Once you've done this, follow these steps in a terminal session:

sudo xcodebuild -license
View the agreement and then type agree
' ]1 k- u, `8 d5 Z; R2 u. Msudo xcode-select --install

You will be prompted on your Mac display to install the component, click install

Click Agree

Wait while it is downloaded and installed

Continue in your terminal session (you may need to close and open your terminal session):

sudo /opt/local/bin/port install zlib libpng jpeg gd2 apache2 php70 php70-apache2handler
9 Z0 D& D2 w8 _: _9 }+ QDownloading the Sourcecd /tmp
+ l* j9 B2 V/ I* L8 G% s" G3 R) Tcurl -L -o nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
; u1 k' e) v/ \. {Compilecd /tmp/nagioscore-nagios-4.4.0/
2 d9 n5 x5 X) X6 v* Z& j% asudo ./configure --with-httpd-conf=/opt/local/apache2/conf/extra --with-gd-lib=/opt/local/lib --with-gd-inc=/opt/local/include
sudo make all
Create User And Group

Currently Nagios Core does not have a built in script for creating the nagios user and group. However NRPE v3 does have this script, so we're going to download it and run it which makes things easy.

sudo make install-groups-users
$ v3 S) n2 [  F7 k* ksudo dseditgroup -o edit -a _www -t user nagios
2 v" u& H( }" x: a6 nInstall Binaries

This step installs the binary files, CGIs, and HTML files.

sudo make install
) Z4 s1 a  W7 ~1 FInstall Service / Daemon

This installs the script in /etc/rc.d/init.d/nagios which is not the correct way it should be run in OS X however a native OS X launch script does not exist in this version of Nagios Core.

sudo make install-init
& M- `; V: l8 ^: b2 U3 F) H, i  i6 a6 V

You will configure it to start at boot using a Global Daemon property list.

Open the vi text editor with the following command:

sudo vi /Library/LaunchDaemons/org.nagios.nagios.plist

This creates a new file.

Press i on the keyboard to enter insert mode.

Paste the following into the vi editor:

<?xml version="1.0" encoding="UTF-8"?>
2 S2 i" g2 u* |. N! N7 _<!DOCTYPE plist PUBLIC "-//Apple/DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
* O" W1 L! `: |9 A2 P+ f<plist version="1.0">
<dict>
. o) J; {2 N( X& X# Q        <key>Label</key>
" K, C. Z) z+ }6 v! F) p* F        <string>org.nagios.nagios</string>
        <key>UserName</key>
        <string>nagios</string>
        <key>GroupName</key>
# L6 ^) J3 A& x2 q' i        <string>nagios</string>
+ l- \5 H- Z8 L0 {: J# s- f1 l        <key>Program</key>
. a; f/ _; _4 C1 R0 J' N; o        <string>/etc/rc.d/init.d/nagios</string>
        <key>ProgramArguments</key>
        <array>
5 N6 R* S6 b4 B# i2 t. C' h: g/ D& U, E                <string>nagios</string>
$ ^" g: z" K' N5 d& a9 u                <string>start</string>
        </array>
) G1 w( v* s6 I+ \+ l! W+ |        <key>KeepAlive</key>
, i+ P0 k. w8 D9 E        <dict>
                <key>SuccessfulExit</key>
2 J5 ~$ i9 g3 H                <false/>
                <key>NetworkState</key>
                <true/>
  X, O9 u' u: u% [+ e- V  e- U        </dict>
        <key>RunAtLoad</key>
        <true/>
        <key>ProcessType</key>
0 r, o4 h& x3 f; N% b5 ^! Y        <string>Background</string>
</dict>
</plist>
& B1 i% R( @5 j1 v, |# S& y

Press escape on the keyboard to exit insert mode.

Type :wq on the and press Enter.

The file has been saved and Nagios will automatically start on the next boot.

: N1 q1 o, K5 ~2 w

Information on starting and stopping services will be explained further on.

( j' J: K( e3 Q6 rInstall Command Mode

This installs and configures the external command file.

sudo make install-commandmode
Install Configuration Files

This installs the *SAMPLE* configuration files. These are required as Nagios needs some configuration files to allow it to start.

sudo make install-config
$ `1 d0 H6 e" K* TInstall Apache Config Files

This installs the Apache web server configuration files.

sudo make install-webconf
3 b( v, W0 }$ f$ a1 d: ]

As well as installing the Apache web server configuration files, there are additional changes required to the Apache config file httpd.conf to enable modules.

Commands that do all of these changes are below, but first is a list of the changes being made.

Change this:

<IfModule dir_module>
    DirectoryIndex index.html
9 }0 C3 v! k3 {4 q8 h3 \# t</IfModule>

To this:

<IfModule dir_module>
1 `3 t, N" \# a+ p5 {    DirectoryIndex index.php index.html index.htm AddType application/x-httpd-php .phpAddType application/x-httpd-php-source .phps
2 Q8 t7 \/ l% l. b8 w  S) P</IfModule>

Add these lines to the end of the file:

Include conf/extra/nagios.conf
: G+ h4 P4 ?6 `! W/ {Include conf/extra/mod_php70.conf
1 M  X( ~1 u# Y, n5 |; C

Execute the following commands to make the changes described above:

sudo cp /opt/local/etc/php70/php.ini-production /opt/local/etc/php70/php.ini
. F8 d" [/ X4 {6 X) H" X$ M' S9 Jcd /opt/local/apache2/modules/
  w( [4 N$ V; x7 lsudo /opt/local/apache2/bin/apxs -a -e -n php7 mod_php70.so
printf '\nInclude conf/extra/nagios.conf\n' | sudo tee -a /opt/local/apache2/conf/httpd.conf
printf '\nInclude conf/extra/mod_php70.conf\n' | sudo tee -a /opt/local/apache2/conf/httpd.conf
sudo sed -i '' 's/DirectoryIndex index.html/DirectoryIndex index.php index.html index.htm AddType application\/x-httpd-php .phpAddType application\/x-httpd-php-source .phps/g' /opt/local/apache2/conf/httpd.conf
Configure Firewall

The firewall in OS X is turned off by default. Please refer to the Apple documentation for information on how to enable or configure TCP port 80 inbound.

1 ^. l) ~# y2 i3 x* s8 lCreate nagiosadmin User Account

You'll need to create an Apache user account to be able to log into Nagios.

The following command will create a user account called nagiosadmin and you will be prompted to provide a password for the account.

sudo htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
# P* _4 B+ O0 c/ a+ U

When adding additional users in the future, you need to remove -c from the above command otherwise it will replace the existing nagiosadmin user (and any other users you may have added).

5 v) |, g* o# s; N2 n5 wStart Apache Web Serversudo /opt/local/bin/port load apache2
' `& |, @8 P, ?; c3 `1 z# |& FStart Service / Daemon

This command starts Nagios Core.

sudo /etc/rc.d/init.d/nagios start
" k$ c/ w# }5 c- }0 a7 {Test Nagios

Nagios is now running, to confirm this you need to log into the Nagios Web Interface.

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

You will be prompted for a username and password. The username is nagiosadmin (you created it in a previous step) and the password is what you provided earlier.

Once you have logged in you are presented with the Nagios interface. Congratulations you have installed Nagios Core.

BUT WAIT ...

Currently you have only installed the Nagios Core engine. You'll notice some errors under the hosts and services along the lines of:

(No output on stdout) stderr: execvp(/usr/local/nagios/libexec/check_load, ...) failed. errno is 2: No such file or directory

These errors will be resolved once you install the Nagios Plugins, which is covered in the next step.

% _9 }. X. Y; UInstalling The Nagios Plugins

Nagios Core needs plugins to operate properly. These steps are going to install the Nagios Plugins that are available via MacPorts. Future versions of the Nagios Plugins package will be updated to support OS X, until then the version available via MacPorts will be fine.

These get installed to /opt/local/libexec/nagios/ so the /usr/local/nagios/etc/resource.cfg file also needs to be updated and Nagios restarted (covered in the steps below).

sudo /opt/local/bin/port install nagios-plugins
; i: U7 H/ D  u0 d/ V) m4 `3 n4 Lsudo sed -i '' 's/\/usr\/local\/nagios\/libexec/\/opt\/local\/libexec\/nagios/g' /usr/local/nagios/etc/resource.cfg
8 q5 G# B/ F& Z4 o- S* K, ~+ Psudo /etc/rc.d/init.d/nagios stop
sudo /etc/rc.d/init.d/nagios start
Test Plugins

Point your web browser to the ip address or FQDN of your Nagios Core server, for example:

http://10.25.5.143/nagios

http://core-013.domain.local/nagios

Go to a host or service object and "Re-schedule the next check" under the Commands menu. The error you previously saw should now disappear and the correct output will be shown on the screen.

; z3 j! Z4 n) Q' V& mService / Daemon Commands

These commands are for starting / stopping / restarting / status Nagios.

sudo /etc/rc.d/init.d/nagios start
sudo /etc/rc.d/init.d/nagios stop
sudo /etc/rc.d/init.d/nagios restart
sudo /etc/rc.d/init.d/nagios status


( p/ J' n1 X+ o% g4 z
% d' p: w/ b: _! [' {Final Thoughts

For any support related questions please visit the Nagios Support Forums at:

[url=]http://support.nagios.com/forum/[/url]