install nagios环境

admin

Installing Nagios Core From Source

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
  
  - o5 s" W9 y# K9 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.

: O7 P( q* ^; |- O7 q& \) {- t

Please select your OS:

• Red Hat Enterprise Linux (RHEL)
  6 k5 n8 a5 m1 g3 o
• CentOS
  7 {( @% Z1 G$ T) K& D# _
• Oracle Linux
  
• Ubuntu
  
• SUSE SLES | openSUSE Leap
  , E  q3 y, K# p9 H5 f5 T  ?
• Debian
  + I$ ?8 a9 ~) K1 [- }1 X9 ~
• Raspbian
  
• Fedora
  ' Q& a' }# {: M  c$ }
• Arch Linux
  . i+ p. S" W5 v5 V! e" \$ x7 m
• Gentoo
  
• FreeBSD
  
• Solaris
  $ l+ {' B( f$ O
• Apple OS X
  
  

; ?! a2 o2 C0 N  R+ W* Q4 @
1 B- }" v$ e- n2 B0 k% n

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
2 a) U, H( S% m5 H: _tar xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
2 Z) U% V- @  a4 H9 g./configure
( T0 o$ k; j5 ?: p  Smake all
+ \3 f; N" {! q+ ?, P, gCreate 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
/ F% t8 o* n; h# u" W# U0 YInstall 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
( y' X, V. U, q& ~, h* S( Uchkconfig --level 2345 httpd on

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

make install-init
* u& A+ D3 W  `" d4 _. v$ n7 msystemctl enable httpd.service

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

# F" E. H+ L4 z0 x# X5 kInstall 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. Also configure Apache settings if required.

make install-webconf
8 V8 l2 v$ @1 _$ B! n3 l, w4 kConfigure 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
service ip6tables save
6 ~- _2 ?* ^( ]. @

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

firewall-cmd --zone=public --add-port=80/tcp
firewall-cmd --zone=public --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

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 Server

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

service httpd start

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

systemctl start httpd.service
Start 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

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

systemctl start nagios.service
6 o6 W* x# A) K9 J& |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.

8 {; K5 ^8 F/ Y% o3 ~) XInstalling 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+ J; g8 V5 Q

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

% e. B. `# k9 _8 G3 K: oPrerequisites

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
. @0 k. h- r. W2 y, a! t: zyum install -y perl-Net-SNMP
cd /tmp
" h3 `- Q( D! H2 ]! }; |7 a" jwget http://ftp.gnu.org/gnu/autoconf/autoconf-2.60.tar.gz
4 R7 d$ z* y+ E1 Etar xzf autoconf-2.60.tar.gz
cd /tmp/autoconf-2.60
5 j# x3 H& F* x./configure
* @% _. c3 G9 U/ emake
& n5 X. x& d9 b* X7 D8 zmake 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
7 p# m2 O" L5 cyum install -y perl-Net-SNMP
3 I  T, t- c# E7 ~% ~6 b2 i

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

cd /tmp
wget http://archives.fedoraproject.or ... latest-5.noarch.rpm
9 i, j9 K  [9 A3 \: erpm -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
: X9 w7 Z6 V( [% awget http://ftp.gnu.org/gnu/autoconf/autoconf-2.60.tar.gz
tar xzf autoconf-2.60.tar.gz
+ i; e4 s: P% K! ?3 gcd /tmp/autoconf-2.60
( W7 l2 |8 E' c, B./configure
make
1 }4 m8 B  q9 V" @1 H5 @! h2 g5 nmake install
9 H( H& s2 M4 S1 M, @

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

cd /tmp
! N( D6 z1 g* Fwget https://dl.fedoraproject.org/pub ... latest-6.noarch.rpm
rpm -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
# ]" I# g) j, U% k2 ]& c7 fyum install -y perl-Net-SNMP
* h% U' t0 l3 z

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

cd /tmp
wget https://dl.fedoraproject.org/pub ... latest-7.noarch.rpm
rpm -ihv epel-release-latest-7.noarch.rpm
$ n, h) [0 R. A- q% Hsubscription-manager repos --enable=rhel-7-server-optional-rpms
/ p/ O* N% I+ g/ q8 Z: Yyum install -y gcc glibc glibc-common make gettext automake autoconf wget openssl-devel net-snmp net-snmp-utils
7 e. h5 u0 B$ J7 E" O+ l3 ]yum install -y perl-Net-SNMP
) m* C: K8 t7 [# n) G6 m7 ?3 j: e

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

yum install -y yum-utils
yum-config-manager --enable ol7_optional_latest
cd /tmp
wget https://dl.fedoraproject.org/pub ... latest-7.noarch.rpm
0 O0 g' R6 p9 ^, k+ O5 i6 Vrpm -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
& P/ B  c( }( o) |yum install -y perl-Net-SNMP
Downloading The Sourcecd /tmp
5 s' x2 ]7 o& r7 [' Twget --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
./configure
make
make install
8 ?: Z; C) S. M/ H5 E  T& W. F7 ATest 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.

7 i$ c  a1 V5 D: k7 H  F& rService / 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
service nagios stop
2 ]$ b# e& j) [6 P4 b. T% s. H5 Pservice nagios restart
service nagios status
# J4 }- n, d0 H& i4 U

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

systemctl start nagios.service
; x9 g7 I" t9 H& y$ F8 ~systemctl stop nagios.service
# Q- `1 h4 U2 a% h& Csystemctl restart nagios.service
systemctl status nagios.service
: L6 H6 _  W0 h  `/ f4 P

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*
( V; V  ^2 t# W0 t+ C- C/ sPrerequisites

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

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

sudo apt-get update
1 B: C0 h8 i- psudo apt-get install -y autoconf gcc libc6 make wget unzip apache2 php libapache2-mod-php7.0 libgd2-xpm-dev
, t4 J2 K: w+ G% X

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

sudo apt-get update
sudo apt-get install -y autoconf gcc libc6 make wget unzip apache2 php libapache2-mod-php7.2 libgd-dev
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/
sudo ./configure --with-httpd-conf=/etc/apache2/sites-enabled
$ x) g) l& T7 k0 J# g( A1 Fsudo 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
/ Y& \; Y$ g  w- L8 q9 Asudo usermod -a -G nagios www-data
% {/ v8 @. |3 ?' R8 G* e6 ]Install 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
$ Q' o2 d3 \$ w0 ?% n

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
; E0 A) M* j5 E. L- n" fInstall 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
2 d" n) l! F9 Q2 i! W' {sudo a2enmod rewrite
sudo a2enmod cgi
$ E* U0 J7 C. u; pConfigure 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
sudo 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

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

) R/ J2 t, k* t0 D2 l
Start Apache Web Server

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

Need to restart it because it is already running.

sudo service apache2 restart
$ F( {  L5 k8 Q) B% a  ~

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

Need to restart it because it is already running.

sudo systemctl restart apache2.service
( O6 v5 o/ V1 c! rStart Service / Daemon

This command starts Nagios Core.

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

sudo start nagios

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

sudo systemctl start nagios.service
( p( p' w, f1 Z' I1 }1 \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.

2 |2 T. g/ X9 u

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

0 k3 [3 K# C2 w; u3 Q8 F" \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/
4 P7 w9 `( T/ A* S7 O: T( m/ C9 k/ msudo ./tools/setup
5 }8 t% x9 h" t+ ~: N# L# psudo ./configure
# @0 J: q' P" y  Q8 Z7 o8 P, i% J/ gsudo make
$ @1 r$ X% ~8 u* t  G( ]2 isudo 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.

! ?+ A* A8 g, u) B9 t. m- v, X. @Service / Daemon Commands

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

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

sudo start nagios
; _' \  R* X( C3 o3 t* N" t* Gsudo stop nagios
4 Q; X; P4 b: B: N9 isudo restart nagios
; C- ]. u$ A1 x. |  o( m* I/ Lsudo status nagios

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

sudo systemctl start nagios.service
2 t5 Z4 ]5 @1 Y2 U9 Esudo systemctl stop nagios.service
; l/ o& ~0 C. s1 X3 t4 Ksudo systemctl restart nagios.service
+ I# i/ l) Z8 h3 @sudo systemctl status nagios.service
3 I: d/ f" D, Q8 X' J9 x+ e7 v3 L

  [) j& y+ u$ N. p! ]1 U0 H

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.

# ~& m- m: v, \Prerequisites

Perform these steps to install the pre-requisite packages.

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

cd /tmp
, D) x8 ^  b: v" M3 `2 F' Z9 r# swget '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'
9 E. T5 `# S. F  twget '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'
) }1 c" J9 I( j6 N0 C( hsudo rpm -ivh sle-sdk-release-*
sudo suse_register
sudo 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
9 p' _7 }  l2 A+ J; p' \. swget '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'
4 {( H7 ]( ]* F* Ewget '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'
% P2 Z6 G3 a5 f% ^* Psudo rpm -ivh sle-sdk-release-*
* Q7 W4 n0 p! Y4 q6 c+ s* vsudo suse_register
8 @  S6 T' c3 f1 T4 Q( asudo 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
sudo SUSEConnect -p sle-module-web-scripting/12/x86_64
6 t2 \9 ?% p5 ssudo zypper --non-interactive install autoconf gcc glibc make wget unzip apache2 apache2-utils php5 apache2-mod_php5 gd gd-devel
. z2 P% @0 n: K7 \

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

sudo SUSEConnect -p sle-sdk/12.1/x86_64
: [4 |, A- l- F  q/ A. ~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
2 l; z3 a* [7 B0 K

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

sudo SUSEConnect -p sle-sdk/12.2/x86_64
$ J5 s9 X% R, @9 _, Csudo 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
6 f& @6 |2 k$ h: a# t6 M0 O

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

sudo SUSEConnect -p sle-sdk/12.3/x86_64
! d7 t+ Z; M4 G2 Wsudo 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
; `. M3 T: N) x$ @

===== 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
: L! E! v* |# U/ s/ Y' b0 u

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

% d4 Q8 U1 s% }. N: Y( wDownloading the Sourcecd /tmp
wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
tar xzf nagioscore.tar.gz
3 L3 }4 L) A% eCompilecd /tmp/nagioscore-nagios-4.4.0/
) \1 t1 [$ f+ o- H" H( x0 qsudo ./configure --with-httpd-conf=/etc/apache2/vhosts.d
sudo make all
$ _# k$ Y  p: G! @  T! gCreate 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
0 y9 k, A5 c( s; ]

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

sudo make install-groups-users
sudo /usr/sbin/usermod -a -G nagios wwwrun
Install 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.

Install Command Mode

This installs and configures the external command file.

sudo make install-commandmode
! H$ `* ?3 s1 S0 Q8 O! `, IInstall 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. Also configure Apache settings if required.

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

sudo make install-webconf
sudo /usr/sbin/a2enmod rewrite
0 Z- W; c4 H8 p3 r7 t1 csudo /usr/sbin/a2enmod cgi
% F1 `/ y& h2 k3 J! |sudo /usr/sbin/a2enmod version
sudo /usr/sbin/a2enmod php5
' i- S, D  ~2 |) Bsudo /sbin/chkconfig --set apache2 on

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

sudo make install-webconf
sudo /usr/sbin/a2enmod rewrite
sudo /usr/sbin/a2enmod cgi
1 C" c  F: v$ k* bsudo /usr/sbin/a2enmod version
sudo /usr/sbin/a2enmod php5
; t: y( v4 q- Q! ], g5 O7 csudo systemctl enable apache2.service

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

sudo make install-webconf
3 u. e2 p  b: N* r2 Xsudo /usr/sbin/a2enmod rewrite
sudo /usr/sbin/a2enmod cgi
9 y7 R& N+ }/ lsudo /usr/sbin/a2enmod version
sudo /usr/sbin/a2enmod php7
. q4 U4 P4 L5 g7 Asudo systemctl enable apache2.service
8 U; n( I2 ]0 _+ M  D5 m% K  ?" YConfigure 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
: N: f( Y" ^( ysudo /sbin/service SuSEfirewall2_init restart
sudo /sbin/service SuSEfirewall2_setup restart
- l. G, A9 V" }) L" e8 R

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

sudo /usr/sbin/SuSEfirewall2 open EXT TCP 80
sudo systemctl restart SuSEfirewall2
  ^1 d- Y. r* w5 r

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

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

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

sudo firewall-cmd --zone=public --add-port=80/tcp
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent

. L! a, z2 y8 O8 @7 A$ g: |2 c0 ?# FCreate 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).

% G& b" Q" O# Z$ R! g& O
Start Apache Web Server

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

sudo /sbin/service apache2 start

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

sudo systemctl start apache2.service
Start Service / Daemon

This command starts Nagios Core.

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

sudo /sbin/service nagios start
4 V* j$ u6 f2 `: z( D

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

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.

5 p, @; ~+ W5 w+ y* p

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.

===== 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
7 a% \- H% l7 m) P5 w1 C: r

===== 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
5 y- Z* j5 |9 j2 `Downloading The Sourcecd /tmp
3 ~: T. x/ g7 W& l. }2 bwget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
) A5 F6 y$ }; Y7 utar zxf nagios-plugins.tar.gz
4 V/ y6 [6 \6 ]7 YCompile + Installcd /tmp/nagios-plugins-release-2.2.1/
sudo ./tools/setup
sudo ./configure
- D: s# p$ s3 W7 s* Tsudo make
, y7 M, ]0 `  rsudo 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.

$ P+ h' R3 Z4 _6 K4 [) A5 gService / 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
3 W/ g- ^4 m. Z" x3 H, \sudo /sbin/service nagios status

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

sudo systemctl start nagios.service
sudo systemctl stop nagios.service
# _& B9 o; S' c9 Y4 J  wsudo systemctl restart nagios.service
sudo systemctl status nagios.service


; }4 o" e7 X8 U

Debian | Raspbian

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

Debian:

su

Raspbian:

sudo -i

All commands from this point onwards will be as root.

8 d. o& r+ T* N& QSecurity-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*
Prerequisites

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
. K' y/ _: H8 j* I* E4 c

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

apt-get update
apt-get install -y autoconf gcc libc6 make wget unzip apache2 apache2-utils php libgd-dev
$ x3 `& ^6 B4 D$ U) C5 nDownloading the Sourcecd /tmp
wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
4 e/ E2 v  V6 Itar xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
' _) n5 \9 _* [. F# t3 E./configure --with-httpd-conf=/etc/apache2/sites-enabled
$ Z5 U1 q6 H; s& d1 Wmake all
6 [) K* J9 r! N2 L6 GCreate 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
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
+ z) E4 Q4 J" V5 t4 H) ~- p

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

& ~1 j7 M! U7 Y+ p+ r: iInstall 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
  ?3 [4 o( |2 u8 q  NInstall Apache Config Files

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

make install-webconf
a2enmod rewrite
" Z6 l) X2 L% C  e9 {6 B' _a2enmod 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
2 ~9 T5 C2 ^3 Qapt-get install -y iptables-persistent

Answer yes to saving existing rules

4 d8 F1 y" b* a0 Q+ ECreate 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).

* m4 X" }- D0 L1 A1 j
, {7 @; h, H2 L) |Start Apache Web Server

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

Need to restart it because it is already running.

service apache2 restart
7 n! K+ D+ s- ]- p4 f4 V

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

Need to restart it because it is already running.

systemctl restart apache2.service
2 J6 m5 I! K1 E+ KStart Service / Daemon

This command starts Nagios Core.

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

service nagios start
: _. {6 u) Y  J: r" X4 s

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

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.

) q: k5 U4 {' w$ n6 G# W9 S  v7 U

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

3 r6 o& Q& O& K! K/ A( E# nPrerequisites

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
/ g, U6 m( M9 {Downloading The Sourcecd /tmp
# Q2 H( t6 H! ?7 _- I% R1 z7 fwget --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/
8 ?2 r( c; D* o+ ]./tools/setup
./configure
make
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.

& @; l+ `$ B; O. q( BService / Daemon Commands

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

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

service nagios start
service nagios stop
9 i8 y4 M8 \9 L3 h: }service nagios restart
service nagios status

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

systemctl start nagios.service
6 u  k5 B, L$ P& v% Xsystemctl stop nagios.service
systemctl restart nagios.service
systemctl status nagios.service


/ J! M# g0 s  l" L* ]& q

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
* Y' W) p. _7 q! d1 A+ W7 i: W- Osetenforce 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
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/
./configure
make all
Create 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
$ a" q! f7 l$ c: WInstall Binaries

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

make install
# o% ?" k, L5 g# T3 L8 R6 EInstall 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
systemctl 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
# y$ T& ]$ t5 c1 k7 H- }: ^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. 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.

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
" x/ v4 U9 \* E! L" W1 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).

3 u+ b+ I( y4 }( i4 |# Y
Start Apache Web Serversystemctl start httpd.service
% S& g7 Q/ z# L( FStart 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.

) R6 C5 |4 T% s; eInstalling 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.

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
tar zxf nagios-plugins.tar.gz
Compile + Installcd /tmp/nagios-plugins-release-2.2.1/
7 c" e# ~; q: {/ B, {1 \" G./tools/setup
$ w; @4 W& a1 o! l4 a./configure
* s3 A" x; y, N; Omake
make install
( B6 r7 E# }6 HTest 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.

- O3 l' q/ Q  |( G  D2 F% vService / Daemon Commands

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

systemctl start nagios.service
systemctl stop nagios.service
( L! _  u8 Z8 ?, S3 Tsystemctl restart nagios.service
systemctl status nagios.service
% H( V" |) t! s& e; `

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
$ p& b; h) h) X6 c) Vpacman --noconfirm -S gcc glibc make wget unzip apache php gd traceroute php-apache Downloading the Sourcecd /tmp
( X5 k" x  d$ Y# ~7 O; V$ |wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
2 ^' P, G2 P$ }8 Etar xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
./configure --with-httpd-conf=/etc/httpd/conf/extra
make all
7 X" ~) m- t% D3 X8 Q+ {1 ?4 d( v' OCreate User And Group

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

make install-groups-users
  X, G. u3 [, i1 X! Y5 iusermod -a -G nagios http
Install Binaries

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

make install
1 J6 r) |3 s8 K$ lInstall 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
" ^9 s/ |7 m$ ?/ R. \7 h& X0 F, msystemctl enable httpd.service
Install Command Mode

This installs and configures the external command file.

make install-commandmode
$ A0 V  o0 h+ B! o, o5 ]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
8 Q7 X; A8 ~9 VInstall Apache Config Files

This installs the Apache web server configuration files.

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

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>
/ |0 P: c9 c6 J. ~2 y6 Z        #LoadModule cgid_module libexec/apache24/mod_cgid.so
</IfModule>
<IfModule mpm_prefork_module>
% z% T0 d0 X. S9 l, x        #LoadModule cgi_module libexec/apache24/mod_cgi.so
</IfModule>

To this:

<IfModule !mpm_prefork_module>
        LoadModule cgid_module libexec/apache24/mod_cgid.so
</IfModule>
. c* W3 |3 ]4 z4 i" P7 T<IfModule mpm_prefork_module>
        LoadModule cgi_module libexec/apache24/mod_cgi.so
- g; M: r( [2 w</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
" O( E- s/ R& M" {</IfModule>
# S8 |! J, I1 a

Add these lines to the end of the file:

LoadModule php7_module modules/libphp7.so
Include "conf/extra/nagios.conf"
/ b; {' a. s$ j0 IInclude "conf/extra/php7_module.conf"
<FilesMatch ".php$">
    SetHandler application/x-httpd-php
- `2 r! h7 G& M$ u4 h, \</FilesMatch>
<FilesMatch ".phps$">
    SetHandler application/x-httpd-php-source
% m4 D6 y9 q* ?</FilesMatch>
7 M9 X* A: N6 S! v3 J

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
" g( H' c, n# W/ a5 e6 jsed -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
( s  m% F8 Y7 J* w( K" p/ Ised -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
0 z7 Z  x, T8 a3 n6 F" }echo 'Include "conf/extra/php7_module.conf"' >> /etc/httpd/conf/httpd.conf
printf '\n<FilesMatch ".php$">\n' >> /etc/httpd/conf/httpd.conf
6 `; O7 }# {+ t7 Z) V: @) Wprintf '\tSetHandler application/x-httpd-php\n' >> /etc/httpd/conf/httpd.conf
printf '</FilesMatch>\n' >> /etc/httpd/conf/httpd.conf
printf '<FilesMatch ".phps$">\n' >> /etc/httpd/conf/httpd.conf
0 i9 t4 W1 b/ O( Z  H9 R' d6 ]' c3 pprintf '\tSetHandler application/x-httpd-php-source\n' >> /etc/httpd/conf/httpd.conf
printf '</FilesMatch>\n' >> /etc/httpd/conf/httpd.conf
Configure 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).

* ]( Y4 A3 }( h' q
Start Apache Web Serversystemctl start httpd.service
! ?/ ^% v& h, z. JStart Service / Daemon

This command starts Nagios Core.

systemctl start nagios.service
" i: L6 T! }9 \1 R  ^) UTest 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.

3 u! k9 S3 r* N3 v0 M3 [( 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

( G( _9 D8 Y2 c) U7 N2 aPrerequisites

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
wget --no-check-certificate -O nagios-plugins.tar.gz https://github.com/nagios-plugin ... elease-2.2.1.tar.gz
0 ?4 w- r9 E1 \( x9 Utar zxf nagios-plugins.tar.gz
Compile + Installcd /tmp/nagios-plugins-release-2.2.1/
  t3 S2 F- C4 z./tools/setup
./configure
5 g) H( y9 [% G. O+ T5 Smake
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.

  |# Z) q1 ]0 s% N' n" [Service / Daemon Commands

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

systemctl start nagios.service
systemctl stop nagios.service
+ ^* U7 g+ p' t" n( Y: ?! \8 d2 @systemctl status nagios.service
) Y; m  ^3 |, R& e

8 S0 T* r6 D$ `9 [* L

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.

Prerequisites

Perform these steps to install the pre-requisite packages.

emerge --sync
mkdir -p /etc/portage/package.use
6 B, L" T7 o7 F* `! _, u2 x/ m, jecho "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
% H1 ^6 H' x8 |) ~8 b3 `" pecho "app-eselect/eselect-php apache2" >> /etc/portage/package.use/eselect-php
echo "media-libs/gd gd png jpeg" >> /etc/portage/package.use/gd
emerge --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
4 c6 `9 j# y- d/ o. Ttar xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
./configure --with-httpd-conf=/etc/apache2/vhosts.d --sysconfdir=/usr/local/nagios/etc
$ t' ]9 A8 B/ Y0 Umake 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
) v$ t% L$ D2 h$ ousermod -a -G nagios apache
Install Binaries

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

make install
; c) ^2 O+ d" X9 U- j0 p- g, PInstall 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
7 u: s- a/ V& ^6 `& v( |

===== systemd =====

make install-init
systemctl enable apache2.service
) ?5 B7 z2 S; a( w# N. Z" `! DInstall 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
+ t7 ~) J& U4 ^6 C0 i% X3 wInstall Apache Config Files

This installs the Apache web server configuration files.

make install-webconf
% L" |: ~4 T/ t( c" v

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"
, A; z) \( p. A# W

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

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
Configure 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).

- B8 @- _, @, A6 L7 H% F9 @
Retart Apache Web Server

===== openrc =====

rc-service apache2 restart

===== systemd =====

systemctl restart apache2.service
Start Service / Daemon

This command starts Nagios Core.

===== openrc =====

rc-service nagios start
  z; j. [$ M/ [/ q& X

===== systemd =====

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

Prerequisites

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
. t: g2 e6 z; G9 |" G9 v7 Wwget --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/
3 \4 G2 x  L. `( B2 b2 N./tools/setup
& m8 j1 B8 }; I./configure
& t+ {" s5 E. U6 Smake
make install
/ ]- b8 b  x! [" q0 u" G3 H# n- Rchmod u+s /bin/ping
2 r8 ^& {+ `( g, |% Uchmod u+s /bin/ping6
6 Z' a3 _7 ]9 z% e) cTest 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.

5 A& T" z8 _* E+ q) mService / Daemon Commands

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

===== openrc =====

rc-service nagios start
6 z' w1 Z* T$ v, K" V! d8 Wrc-service nagios stop
rc-service nagios status
rc-service nagios restart
0 S! O5 Q7 e! _. F0 o

===== systemd =====

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

7 R2 Z6 |  a/ q
5 Y& d( c" I% l+ Y

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.

Prerequisites

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
1 j- C* |8 ]0 ^wget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
9 f$ K8 J' Z3 {2 f7 q5 star xzf nagioscore.tar.gz
Compilecd /tmp/nagioscore-nagios-4.4.0/
) C9 v/ W" v5 `: u3 X./configure --with-httpd-conf=/usr/local/etc/apache24/Includes
; d: Y) J0 \- X2 `gmake all
4 x* w: V+ |" b; u, kCreate 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
  C5 j( s5 v; }* D8 [6 x4 ]echo '/usr/local/etc/rc.d/nagios start' >> /etc/rc.local

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
/ S, ?5 @* @% Y5 @# DInstall 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
Install Apache Config Files

This installs the Apache web server configuration files.

gmake install-webconf
: x" R) r1 A/ v

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>
        #LoadModule cgid_module libexec/apache24/mod_cgid.so
</IfModule>
<IfModule mpm_prefork_module>
        #LoadModule cgi_module libexec/apache24/mod_cgi.so
0 [- c5 q& p3 W' [; P& ]</IfModule>

To this:

<IfModule !mpm_prefork_module>
        LoadModule cgid_module libexec/apache24/mod_cgid.so
. V7 t6 ]! T7 ~6 A/ s4 Z& y</IfModule>
<IfModule mpm_prefork_module>
, Y# U( D9 U6 h0 ^& M* M        LoadModule cgi_module libexec/apache24/mod_cgi.so
% A( }! I6 f& C</IfModule>
# d6 E8 r2 c8 ]/ V' w. `

Change this:

<IfModule dir_module>
, u6 |3 R4 W; V5 O9 a    DirectoryIndex index.html
</IfModule>

To this:

<IfModule dir_module>
/ a# d6 T! V5 C5 K    DirectoryIndex index.php index.html index.htm AddType application/x-httpd-php .phpAddType application/x-httpd-php-source .phps
, I' v- B, M  G% Y" `6 q4 p</IfModule>
& J+ a! [- A; ^  |* Q

Add these lines to the end of the file:

<FilesMatch ".php$">
    SetHandler application/x-httpd-php
9 K+ x1 M( g6 S</FilesMatch>
) \9 F3 f, T+ z# u<FilesMatch ".phps$">
4 e# m+ m/ E9 k9 _+ }' S# G    SetHandler application/x-httpd-php-source
) m  |; z" U9 U' Y</FilesMatch>

Execute the following commands to make the changes described above:

cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini
/ F3 i* [( d1 P/ U: Y0 pecho 'apache24_enable="YES"' >> /etc/rc.conf
; h+ i, o0 g/ h: ]  N% }# d# Dsed -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
7 F4 L5 J% ?/ d, `* f. P; ^/ K' q# Tsed -i '' 's/#LoadModule cgid_module/LoadModule cgid_module/g' /usr/local/etc/apache24/httpd.conf
sed -i '' 's/#LoadModule cgi_module/LoadModule cgi_module/g' /usr/local/etc/apache24/httpd.conf
printf '\n<FilesMatch ".php$">\n' >> /usr/local/etc/apache24/httpd.conf
printf '\tSetHandler application/x-httpd-php\n' >> /usr/local/etc/apache24/httpd.conf
# ]. L" S8 K4 X2 a; y4 D9 p2 fprintf '</FilesMatch>\n' >> /usr/local/etc/apache24/httpd.conf
printf '<FilesMatch ".phps$">\n' >> /usr/local/etc/apache24/httpd.conf
6 X! x7 p9 x8 {2 x! K+ Q: `6 p' Hprintf '\tSetHandler application/x-httpd-php-source\n' >> /usr/local/etc/apache24/httpd.conf
( W/ e4 [2 ^: X5 k  P6 xprintf '</FilesMatch>\n' >> /usr/local/etc/apache24/httpd.conf
% c8 U* F% w" GConfigure 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

9 S  g# e8 D6 I4 z& t/ R2 }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).

Start Apache Web Serverservice apache24 start
; z. m  g8 P/ L2 B7 C* Z1 IStart Service / Daemon

This command starts Nagios Core.

service nagios start
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.

8 `. |- r3 O  r$ e0 C! [: l. eInstalling 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.

! z& A6 G6 |5 y2 l

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

0 J1 A) L  H8 }/ P0 `Prerequisites

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
Downloading The Sourcecd /tmp
" E) d+ E5 m8 ~6 [. U2 P  c0 mwget --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
$ G6 b+ a; J. w; b2 c+ GCompile + Installcd /tmp/nagios-plugins-release-2.2.1/
./tools/setup
+ S8 o5 r0 R  z% q, e3 i& M% o./configure
gmake
gmake 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.

service nagios start
5 e0 j$ i- q0 x, _3 ^- xservice nagios stop
$ J/ d+ v3 M8 z# O0 I" x/ \9 m$ `service nagios restart
9 r4 q; ?+ x4 A  |; |$ Q3 J8 Fservice nagios status
1 y/ a! A' a5 v5 J5 c( K/ b0 K: H
, l6 g" {9 X& C. h# r3 F
, |8 S. J+ L; v" f& s2 T

Solaris

Tested with Solaris 11.

6 [! q8 k  v, ^5 w! _$ t* LSecurity-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
3 w( c: X  ~, W  T. j/ F! Opkgadd -d http://get.opencsw.org/now
% O  N& G: N2 @% Uanswer all
answer y
2 s5 A% a. ?3 W, rperl -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
pkg install gcc-45 web/php-53 apache-php53 gd Downloading the Sourcecd /tmp
5 S+ e8 g( v: D9 J, Dwget -O nagioscore.tar.gz https://github.com/NagiosEnterpr ... nagios-4.4.0.tar.gz
* @3 j  b' {# X; I/ C: A4 Ltar xzf nagioscore.tar.gz
8 S9 N5 s8 ?6 ]8 v! KCompilecd /tmp/nagioscore-nagios-4.4.0/
./configure --with-httpd-conf=/etc/apache2/2.2/conf.d --with-gd-inc=/usr/include/gd2
7 Z& R, B2 {6 H* C' pgmake all
8 p9 R3 O( w0 J) N' D9 C* [3 sCreate User And Group

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

gmake install-groups-users
  B5 w) W7 n2 H0 E- }usermod -G nagios webservd
Install Binaries

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

gmake install
" d- Q3 b0 ]9 x4 Y9 V' VInstall 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
1 g( F! A# q$ Z. d: g! b! P& i+ d; Gsvcbundle -o /lib/svc/manifest/site/nagios.xml -s service-name=application/nagios -s rc-script=/etc/init.d/nagios:2 -s model=contract
& [9 \& F& N' a9 `; p* y. q

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

9 x2 U4 G) }9 w5 XInstall Command Mode

This installs and configures the external command file.

gmake install-commandmode
% ]# q, m# v( [& m3 N5 [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
! p& v. P+ q6 J) t' r  {4 g3 qInstall Apache Config Files

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

gmake install-webconf
5 s4 Y; A0 a9 s6 BConfigure 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
  @* H7 K; O8 G( x) g% y

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

0 ~" ]6 G! u8 F, aStart Apache Web Serversvcadm enable apache22
Start Service / Daemon

This command starts Nagios Core.

svcadm restart manifest-import
svcadm enable nagios
: b" d2 N" W8 c( g! m6 ETest 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.

0 i9 y: \! h* _8 s1 b% |0 kInstalling 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.

9 b- ~( ~7 L/ x# z8 ?' _

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

  _+ H9 V7 b; p7 H5 C" dPrerequisites

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
: i* S2 y) v  rwget --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
0 n/ ^! d8 G3 b, A$ ]4 b./configure
gmake
, t; G' D0 S. Z# B9 Tgmake 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

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

svcadm enable nagios
svcadm disable nagios
1 J, X( x$ b" x+ c/ Isvcadm restart nagios
: t# c2 v9 ]. w; I9 esvcs nagios
: o% _& T) Z! h* A9 {# S* L8 A, I6 \svcs -xv nagios
svcadm clear nagios
+ H7 a( R, c1 O) @# O3 T

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

How To Clear Solaris Service Maintenance Status

% }  W6 U2 [; C$ ?. \0 W/ F

# C' ~, g' N! J# d4 P

Apple OS X

Security-Enhanced Linux

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

+ X4 _4 i, R% GPrerequisites

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
sudo 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
Downloading the Sourcecd /tmp
curl -L -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/
sudo ./configure --with-httpd-conf=/opt/local/apache2/conf/extra --with-gd-lib=/opt/local/lib --with-gd-inc=/opt/local/include
! w4 }1 x$ ?8 D  X% Lsudo make all
' P5 @7 {9 D$ R+ l. K9 |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
% ?8 e* D" W4 F1 Q8 }& c5 V# p& \& R  osudo dseditgroup -o edit -a _www -t user nagios
Install Binaries

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

sudo make install
Install 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

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"?>
7 J/ A( l2 @0 r( ^0 k5 E<!DOCTYPE plist PUBLIC "-//Apple/DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
8 o2 A& o6 ^, C9 h% s. p% ]<dict>
        <key>Label</key>
$ V2 m! p  ~) @4 V/ D# u* r        <string>org.nagios.nagios</string>
        <key>UserName</key>
        <string>nagios</string>
        <key>GroupName</key>
        <string>nagios</string>
- {7 T" J. ~3 Q' t        <key>Program</key>
  J% ~9 P* ^, r0 k$ [3 ]        <string>/etc/rc.d/init.d/nagios</string>
        <key>ProgramArguments</key>
        <array>
" ~8 a' b1 ~" D& \4 c5 B" Z/ b' x7 r                <string>nagios</string>
; M7 c8 H* b" R% B  T5 u* C. \1 n                <string>start</string>
        </array>
) K, W+ ]9 E: e# u        <key>KeepAlive</key>
        <dict>
& F: N/ z0 S' v/ T/ e                <key>SuccessfulExit</key>
, K2 d: p/ p- P; g7 D. y( P                <false/>
                <key>NetworkState</key>
                <true/>
  |- U! ~$ u. y' Z7 C* M; @: U        </dict>
        <key>RunAtLoad</key>
% k" z/ z# p5 p4 U! {4 S        <true/>
0 \. q. @! x* M% `  e/ t        <key>ProcessType</key>
) [; D6 p( @( H% @6 @9 T        <string>Background</string>
9 [% A2 Q+ {! R+ Q</dict>
</plist>
) o+ @: }" C3 D# C/ h

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.

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

# L& b& g: F' S- y4 e! D7 _Install 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
( m# a- ]6 U! v7 r& N, U6 e" j2 jInstall Apache Config Files

This installs the Apache web server configuration files.

sudo make install-webconf
8 Z$ Z# E5 E. @7 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:

<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
/ n/ L6 e, H1 X2 m1 ?$ q3 r7 I4 {</IfModule>

Add these lines to the end of the file:

Include conf/extra/nagios.conf
" n0 j9 U! U. s  qInclude conf/extra/mod_php70.conf
, k- e& b* Z/ s5 E6 \8 Q) `5 _

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
cd /opt/local/apache2/modules/
sudo /opt/local/apache2/bin/apxs -a -e -n php7 mod_php70.so
, w. B2 O! W( Y( j& K; D6 Gprintf '\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
4 T6 X  D: S8 d! ysudo 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.

) z/ `- k$ J5 H9 u! k% MCreate 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
' j  P3 A' K7 E# u  S8 S! 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).

2 A: p+ R) @9 u' y% M! |5 D
5 [4 n2 S3 l2 Z7 T7 ]Start Apache Web Serversudo /opt/local/bin/port load apache2
; P7 ]! w1 A7 b1 Y9 ~, @/ K* L4 M7 HStart Service / Daemon

This command starts Nagios Core.

sudo /etc/rc.d/init.d/nagios start
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 C8 d1 w3 a0 ^1 [% S, lInstalling 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
3 p, e1 k! t# L# j. dsudo sed -i '' 's/\/usr\/local\/nagios\/libexec/\/opt\/local\/libexec\/nagios/g' /usr/local/nagios/etc/resource.cfg
1 V  h/ V7 e/ }5 w$ C; xsudo /etc/rc.d/init.d/nagios stop
sudo /etc/rc.d/init.d/nagios start
& k0 H: C" H; b6 e' ZTest 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.

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



Final Thoughts

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

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

; @: E# l2 q1 P4 B+ H6 J8 c