{"id":8678,"date":"2021-04-17T20:59:50","date_gmt":"2021-04-17T17:59:50","guid":{"rendered":"https:\/\/kifarunix.com\/?p=8678"},"modified":"2024-03-18T22:56:59","modified_gmt":"2024-03-18T19:56:59","slug":"install-nagios-core-on-freebsd-13","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/install-nagios-core-on-freebsd-13\/","title":{"rendered":"Install Nagios Core on FreeBSD 13"},"content":{"rendered":"\n

In this guide, we are going to learn how to install Nagios Core on FreeBSD 13. Nagios<\/a> is an opensource tool that provides an enterprise-class central monitoring engine for IT monitoring, network monitoring, server and applications monitoring. It also provides a web interface for viewing current status, historical logs, and basic reports.<\/p>\n\n\n\n

Installing Nagios Core on FreeBSD 13<\/h2>\n\n\n\n

Nagios Core 4.4.6<\/a> is the current stable release as of this writing. Fortunately, Nagios Core 4.4.6 is available on the default FreeBSD 13 repository catalogue.<\/p>\n\n\n\n

Prerequisites<\/h3>\n\n\n\n

Install Apache HTTP Server and PHP on FreeBSD<\/h4>\n\n\n\n

Install Apache and PHP on FreeBSD by running the command below;<\/p>\n\n\n\n

pkg install apache24 mod_php74 php74-gd<\/code><\/pre>\n\n\n\n
Once the installation is done, ensure Apache is able to server PHP content by ensuring index.php<\/strong><\/code> is part of your DirectoryIndex.<\/p>\n\n\n\n
sed i.bak ‘s\/DirectoryIndex index.html\/DirectoryIndex index.html index.php\/’ \/usr\/local\/etc\/apache24\/httpd.conf<\/p>\n\n\n\n
Also, you should add the following to your Apache configuration file:<\/p>\n\n\n\n
cat >> \/usr\/local\/etc\/apache24\/httpd.conf << 'EOL'\n<FilesMatch \"\\.php$\">\n    SetHandler application\/x-httpd-php\n<\/FilesMatch>\n<FilesMatch \"\\.phps$\">\n    SetHandler application\/x-httpd-php-source\n<\/FilesMatch>\n'EOL'<\/code><\/pre>\n\n\n\n
Save and exit the file.<\/p>\n\n\n\n
Ensure that Apache can server PHP by creating test file;<\/p>\n\n\n\n
echo \"<? phpinfo(); ?>\" >> \/usr\/local\/www\/apache24\/data\/test.php<\/code><\/pre>\n\n\n\n
You can then start Apache;<\/p>\n\n\n\n
service apache24 onestart<\/code><\/pre>\n\n\n\n
and navigate to the url http:\/\/server-host-name-or-ip\/test.php<\/code><\/strong>.<\/p>\n\n\n\n
You should see PHP page displayed.<\/p>\n\n\n\n
You also need to install Apache utils like htpasswd<\/strong><\/code> for creating users for basic authentication. This can be done via FreeBSD ports;<\/p>\n\n\n\n
Check how to install FreeBSD ports.<\/a><\/p>\n\n\n\n
Once the ports are installed, Install htpasswd on FreeBSD as follows;<\/p>\n\n\n\n
cd \/usr\/ports\/security\/p5-Apache-Htpasswd\/<\/code><\/pre>\n\n\n\n
make install clean<\/code><\/pre>\n\n\n\n
Run the command below to reload the $PATH after installation;<\/p>\n\n\n\n
rehash<\/code><\/pre>\n\n\n\n
To begin with, update and upgrade the local catalogues of the enabled package repositories.<\/p>\n\n\n\n
pkg update<\/code><\/pre>\n\n\n\n
pkg upgrade<\/code><\/pre>\n\n\n\n
To verify the availability of the Nagios Core 4.x on FreeBSD;<\/p>\n\n\n\n
pkg search nagios4<\/code><\/pre>\n\n\n\n
cnagios-nagios4-0.33_1         Curses-based interface for nagios\nnagios4-4.4.6_1,1              Powerful network monitoring system<\/code><\/pre>\n\n\n\n
Thus, as you can see, we have the latest release version of Nagios Core available on the default FreeBSD catalogue.<\/p>\n\n\n\n
Installing Nagios Core on FreeBSD 13<\/h3>\n\n\n\n
You can therefore install Nagios Core by running the command below;<\/p>\n\n\n\n
pkg install nagios4-4.4.6_1,1<\/code><\/pre>\n\n\n\n
Sample installation output;<\/p>\n\n\n\n
Updating FreeBSD repository catalogue...\nFreeBSD repository is up to date.\nAll repositories are up to date.\nUpdating database digests format: 100%\nThe following 5 package(s) will be affected (of 0 checked):\n\nNew packages to be INSTALLED:\n\tlibltdl: 2.4.6\n\tnagios-plugins: 2.3.3_2,1\n\tnagios4: 4.4.6_1,1\n\tphp74-filter: 7.4.16\n\tphp74-xml: 7.4.16\n\nNumber of packages to be installed: 5\n\nThe process will require 10 MiB more space.\n2 MiB to be downloaded.\n\nProceed with this action? [y\/N]: y<\/code><\/pre>\n\n\n\n
Configure Nagios Core on FreeBSD 13<\/h3>\n\n\n\n
Once the installation is complete, proceed to configure Nagios Core on FreeBSD 13.<\/p>\n\n\n\n
Enable Apache CGI Modules<\/h4>\n\n\n\n
Once the installation is done, open the Apache configuration file and enable the CGI modules.<\/p>\n\n\n\n
Locate the lines below remove the # on the lines beginning with LoadModule such that they look like;<\/p>\n\n\n\n
vi \/usr\/local\/etc\/apache24\/httpd.conf<\/code><\/pre>\n\n\n\n
...\n<IfModule !mpm_prefork_module>\n        LoadModule cgid_module libexec\/apache24\/mod_cgid.so\n<\/IfModule>\n<IfModule mpm_prefork_module>\n        LoadModule cgi_module libexec\/apache24\/mod_cgi.so\n<\/IfModule>\n...<\/code><\/pre>\n\n\n\n
Save and exit the file.<\/p>\n\n\n\n
Create Apache Nagios Configuration file<\/h4>\n\n\n\n
Next, configure Apache to Server Nagios CGIs by creating a nagios.conf file that specify how Apache should server Nagios resources by running the command below;<\/p>\n\n\n\n
cat >> \/usr\/local\/etc\/apache24\/httpd.conf << 'EOL'\n<VirtualHost *:80>\n   ServerName nagios.kifarunix-demo.com\n   DocumentRoot \"\/usr\/local\/www\/nagios\"\n\n   ScriptAlias \/nagios\/cgi-bin\/ \/usr\/local\/www\/nagios\/cgi-bin\/\n   ScriptAlias \/nagios\/cgi-bin \/usr\/local\/www\/nagios\/cgi-bin\/\n\n   <Directory \"\/usr\/local\/www\/nagios\/cgi-bin\">\n      Options ExecCGI\n      AllowOverride None\n      #Require all denied\n      Require ip 127.0.0.1 192.168.60.1\n   <\/Directory>\n \n   Alias \/nagios\/ \/usr\/local\/www\/nagios\/\n   Alias \/nagios \/usr\/local\/www\/nagios\/\n \n   <Directory \"\/usr\/local\/www\/nagios\">\n      Options None\n      AllowOverride None\n      #Require all denied\n      Require ip 127.0.0.1 192.168.60.1\n \n      php_flag engine on\n      php_admin_value open_basedir \/usr\/local\/www\/nagios\/:\/var\/spool\/nagios\/\n   <\/Directory>\n   <Location \"\/\">\n      AuthName \"Restricted Nagios Access\"\n      AuthType Basic\n      AuthUserFile \/usr\/local\/www\/nagios\/htpasswd.users\n      Require valid-user\n   <\/Location>\n<\/VirtualHost>\n'EOL'<\/code><\/pre>\n\n\n\n
As you can see above, we have allowed access to our local Nagios from everywhere (Require all granted<\/code><\/strong>) and also enabled basic authentication to access Nagios web resources.<\/p>\n\n\n\n
Configure Nagios  Templates<\/h4>\n\n\n\n
Configuration templates are available in \/usr\/local\/etc\/nagios<\/code><\/strong> as *.cfg-sample<\/code> files.<\/p>\n\n\n\n
ls -1 \/usr\/local\/etc\/nagios\/<\/code><\/pre>\n\n\n\n
cgi.cfg-sample\nnagios.cfg-sample\nobjects\nresource.cfg-sample<\/code><\/pre>\n\n\n\n
ls -1 \/usr\/local\/etc\/nagios\/objects\/<\/code><\/pre>\n\n\n\n
commands.cfg-sample\ncontacts.cfg-sample\nlocalhost.cfg-sample\nprinter.cfg-sample\nswitch.cfg-sample\ntemplates.cfg-sample\ntimeperiods.cfg-sample\nwindows.cfg-sample<\/code><\/pre>\n\n\n\n
Copy them to *.cfg files where required and edit to suit your needs.<\/p>\n\n\n\n
cd \/usr\/local\/etc\/nagios\/<\/code><\/pre>\n\n\n\n
find . -type f -name \"*.cfg-sample\" -exec sh -c 'cp {} $(dirname {})\/$(basename {} .cfg-sample).cfg' \\;<\/code><\/pre>\n\n\n\n
Just to confirm;<\/p>\n\n\n\n
ls -1 \/usr\/local\/etc\/nagios\/<\/code><\/pre>\n\n\n\n
cgi.cfg\ncgi.cfg-sample\nnagios.cfg\nnagios.cfg-sample\nobjects\nresource.cfg\nresource.cfg-sample<\/code><\/pre>\n\n\n\n
ls -1 \/usr\/local\/etc\/nagios\/objects\/<\/code><\/pre>\n\n\n\n
commands.cfg\ncommands.cfg-sample\ncontacts.cfg\ncontacts.cfg-sample\nlocalhost.cfg\nlocalhost.cfg-sample\nprinter.cfg\nprinter.cfg-sample\nswitch.cfg\nswitch.cfg-sample\ntemplates.cfg\ntemplates.cfg-sample\ntimeperiods.cfg\ntimeperiods.cfg-sample\nwindows.cfg\nwindows.cfg-sample<\/code><\/pre>\n\n\n\n
If you want, you can configure the Nagios objects as you wish. for in this setup, we will go with the default settings.<\/p>\n\n\n\n
Set the ownership of Nagios configuration files to nagios<\/strong><\/code> user.<\/p>\n\n\n\n
chown -R nagios:nagios \/usr\/local\/etc\/nagios\/<\/code><\/pre>\n\n\n\n
Create Nagios Basic Authentication Users<\/h4>\n\n\n\n
Create users and password for authenticating to Nagios web resources;<\/p>\n\n\n\n
htpasswd -c \/usr\/local\/www\/nagios\/htpasswd.users kifarunix<\/code><\/pre>\n\n\n\n
The default authentication user is nagiosadmin<\/strong><\/code>. If you use a different user, you will need to make changes on the cgi.cfg<\/strong><\/code> file by replacing the user nagiosadmin appropriatetly.<\/p>\n\n\n\n
For example, in our case, we use the user kifarunix<\/strong><\/code> and hence, to replace the default nagiosadmin<\/strong><\/code> user use the command below;<\/p>\n\n\n\n
sed -i.org 's\/nagiosadmin\/kifarunix\/g' \/usr\/local\/etc\/nagios\/cgi.cfg<\/code><\/pre>\n\n\n\n
To add another user to the file, omit<\/code><\/strong> option -c<\/code> in the command above.<\/p>\n\n\n\n
Verify Nagios configuration data<\/h4>\n\n\n\n
You can now verify all configuration data just to ensure that there is no error;<\/p>\n\n\n\n
nagios -v \/usr\/local\/etc\/nagios\/nagios.cfg<\/code><\/pre>\n\n\n\n
Sample output;<\/p>\n\n\n\n
Nagios Core 4.4.6\nCopyright (c) 2009-present Nagios Core Development Team and Community Contributors\nCopyright (c) 1999-2009 Ethan Galstad\nLast Modified: 2020-04-28\nLicense: GPL\n\nWebsite: https:\/\/www.nagios.org\nReading configuration data...\n   Read main config file okay...\n   Read object config files okay...\n\nRunning pre-flight check on configuration data...\n\nChecking objects...\n\tChecked 8 services.\n\tChecked 1 hosts.\n\tChecked 1 host groups.\n\tChecked 0 service groups.\n\tChecked 1 contacts.\n\tChecked 1 contact groups.\n\tChecked 24 commands.\n\tChecked 5 time periods.\n\tChecked 0 host escalations.\n\tChecked 0 service escalations.\nChecking for circular paths...\n\tChecked 1 hosts\n\tChecked 0 service dependencies\n\tChecked 0 host dependencies\n\tChecked 5 timeperiods\nChecking global event handlers...\nChecking obsessive compulsive processor commands...\nChecking misc settings...\n\nTotal Warnings: 0\nTotal Errors:   0\n\nThings look okay - No serious problems were detected during the pre-flight check<\/code><\/pre>\n\n\n\n
Running Nagios on FreeBSD<\/h4>\n\n\n\n
Start and enable Nagios to run on system boot;<\/p>\n\n\n\n
sysrc nagios_enable=\"YES\"<\/code><\/pre>\n\n\n\n
service nagios start<\/code><\/pre>\n\n\n\n
Check status;<\/p>\n\n\n\n
service nagios status<\/code><\/pre>\n\n\n\n
nagios is running as pid 3584.<\/code><\/pre>\n\n\n\n
Running Apache<\/h4>\n\n\n\n
Enable Apache to run on system boot;<\/p>\n\n\n\n
sysrc apache24_enable=\"YES\"<\/code><\/pre>\n\n\n\n
Perform sanity check of Apache configuration;\n<\/p>\n\n\n\n
apachectl configtest<\/code><\/pre>\n\n\n\n
If you get the output, Syntax OK<\/code><\/strong>, start Apache.<\/p>\n\n\n\n
service apache24 restart<\/code><\/pre>\n\n\n\n
Accessing Nagios Web Interface on FreeBSD<\/h3>\n\n\n\n
You can now access your Nagios Web interface using the url http:\/\/server-host-name-OR-IP<\/strong><\/code> or http:\/\/server-host-name-OR-IP\/nagios<\/code><\/strong> or http:\/\/server-host-name-OR-IP\/nagios\/<\/strong><\/code>.<\/p>\n\n\n\n
Enter your basic authentication credentials;<\/p>\n\n\n\n
\"Install<\/figure><\/a><\/div>\n\n\n\n
Click sign in to proceed to dashboard.<\/p>\n\n\n\n
\"Install<\/figure><\/a><\/div>\n\n\n\n
And there you go.<\/p>\n\n\n\n
Other Tutorials<\/h3>\n\n\n\n
Add Hosts to Nagios Server For Monitoring<\/a><\/p>\n\n\n\n
Configure Nagios Email Notification Using Gmail<\/a><\/p>\n\n\n\n
Monitor SSL\/TLS Certificates Expiry with Nagios<\/a><\/p>\n\n\n\n
Monitor Linux Hosts using Nagios check_by_ssh Plugin<\/a><\/p>\n\n\n\n
Nagios SNMP Monitoring of Linux Hosts on AlienVault USM\/OSSIM<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
In this guide, we are going to learn how to install Nagios Core on FreeBSD 13. Nagios is an opensource tool that provides an enterprise-class central monitoring<\/p>\n","protected":false},"author":1,"featured_media":8688,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_lock_modified_date":false,"footnotes":""},"categories":[73,280,121,72],"tags":[1063,3454,3451,3453,76,3452],"class_list":["post-8678","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-nagios","category-freebsd","category-howtos","category-monitoring","tag-freebsd","tag-freebsd-nagios","tag-install-nagios-core-on-freebsd-13","tag-nagios-basic-authentication-freebsd","tag-nagios-core","tag-nagios-freebsd","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-50","resize-featured-image"],"_links":{"self":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/8678"}],"collection":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/comments?post=8678"}],"version-history":[{"count":8,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/8678\/revisions"}],"predecessor-version":[{"id":21839,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/8678\/revisions\/21839"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media\/8688"}],"wp:attachment":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media?parent=8678"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/categories?post=8678"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/tags?post=8678"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}