Skip to content

Replace 'Icinga2' with 'Icinga 2' #1481

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 2, 2018
Merged

Replace 'Icinga2' with 'Icinga 2' #1481

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 38 additions & 38 deletions docs/uptime/monitoring/install-icinga2-monitoring-on-debian-9.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
author:
name: Linode Community
email: [email protected]
description: "This guide shows you how to install and configure Icinga2 and Icinga Web 2 on Debian to monitor your Linode services and performance."
og_description: "This guide will show you how to install and configure Icinga2 to monitor your system"
description: "This guide shows you how to install and configure Icinga 2 and Icinga Web 2 on Debian to monitor your Linode services and performance."
og_description: "This guide will show you how to install and configure Icinga 2 to monitor your system"
keywords: ["debian", "icinga", "monitoring", "icinga2"]
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
published: 2017-12-12
modified: 2017-12-12
modified_by:
name: Linode
title: 'Install Icinga2 Monitoring on Debian 9'
title: 'Install Icinga 2 Monitoring on Debian 9'
expiryDate: 2019-12-12
contributor:
name: Matt Vass
Expand All @@ -19,15 +19,15 @@ external_resources:
- '[Official Icinga Documentation](https://www.icinga.com/docs/icinga2/latest/doc/01-about/)'
---

![Install Icinga2 Monitoring on Debian 9](/docs/assets/icinga/Icinga2.jpg "Install Icinga2 Monitoring on Debian 9")
![Install Icinga 2 Monitoring on Debian 9](/docs/assets/icinga/Icinga2.jpg "Install Icinga 2 Monitoring on Debian 9")

## What is Icinga2?
## What is Icinga 2?

Icinga, previously a fork of the popular Nagios monitoring system, is an open source network monitoring application that can be used to monitor critical services and systems on your Linode. Icinga2 can monitor hosts on a network or it can verify network external protocols, such as the state of an HTTP server, mail server, file-sharing service, or others.
Icinga, previously a fork of the popular Nagios monitoring system, is an open source network monitoring application that can be used to monitor critical services and systems on your Linode. Icinga 2 can monitor hosts on a network or it can verify network external protocols, such as the state of an HTTP server, mail server, file-sharing service, or others.

Icinga2 can be configured to monitor internal systems' state and check the load, memory, disk free space, or other internal parameters via Icinga agents deployed on each node that needs to be monitored. Icinga can also be configured to send notifications and alerts via email or SMS to the system administrators defined in contacts.
Icinga 2 can be configured to monitor internal systems' state and check the load, memory, disk free space, or other internal parameters via Icinga agents deployed on each node that needs to be monitored. Icinga can also be configured to send notifications and alerts via email or SMS to the system administrators defined in contacts.

This guide shows how to install and configure the latest version of Icinga2 web monitoring tool on Debian 9 to monitor network infrastructure.
This guide shows how to install and configure the latest version of Icinga 2 web monitoring tool on Debian 9 to monitor network infrastructure.

## Before You Begin

Expand Down Expand Up @@ -61,9 +61,9 @@ Restart the Apache daemon to apply the new changes:

systemctl restart apache2

## Configure Icinga2 Databases
## Configure Icinga 2 Databases

1. Install the backend database needed by Icinga2 monitoring web application and Icinga Web 2 frontend to store users, contacts and other collected data. Execute the following command to install MariaDB database and PHP module needed to access MySQL database in Debian 9:
1. Install the backend database needed by Icinga 2 monitoring web application and Icinga Web 2 frontend to store users, contacts and other collected data. Execute the following command to install MariaDB database and PHP module needed to access MySQL database in Debian 9:

apt install php7.0-mysql mariadb-server mariadb-client

Expand All @@ -79,59 +79,59 @@ Restart the Apache daemon to apply the new changes:

sudo mysql_secure_installation

4. Log back in to the database console and create the database for Icinga2:
4. Log back in to the database console and create the database for Icinga 2:

mysql –u root -p

5. Create a user with a strong password to manage Icinga2 application database, by issuing the following commands. You should replace `icingadb`, `icinga-user`, and `strongpassword` in this example with your own database name and credentials:
5. Create a user with a strong password to manage Icinga 2 application database, by issuing the following commands. You should replace `icingadb`, `icinga-user`, and `strongpassword` in this example with your own database name and credentials:

create database icingadb;
grant all privileges on icingadb.* to 'icinga_user'@'localhost' identified by 'strongpassword';
flush privileges

6. Create the second MySQL database used by Icinga2 web to store its interface users and groups. As in the previous step, replace the database name and credentials accordingly and choose a strong password for database user. You can use the same MySQL user account to manage both databases simultaneously (`icinga_user'@'localhost`):
6. Create the second MySQL database used by Icinga 2 web to store its interface users and groups. As in the previous step, replace the database name and credentials accordingly and choose a strong password for database user. You can use the same MySQL user account to manage both databases simultaneously (`icinga_user'@'localhost`):

create database icinga_users;
grant all privileges on icinga_users.* to 'icinga_user'@'localhost' identified by 'strongpassword';
exit

## Install Icinga2
## Install Icinga 2

Install Icinga2 and the Icinga2 MySQL module for accessing MariaDB database backend:
Install Icinga 2 and the Icinga 2 MySQL module for accessing MariaDB database backend:

apt install icinga2 icinga2-ido-mysql

During the installation, when asked:

* If Icinga2 should use the MySQL module,
* If Icinga 2 should use the MySQL module,

* Choose **Yes** from the prompt.

* To configure a database for `icinga2-ido-mysql` with `dbconfig-common` option,

* Choose **No** from the prompt.

After Icinga2 has been installed, start the Icinga2 service and check the daemon status:
After Icinga 2 has been installed, start the Icinga 2 service and check the daemon status:

systemctl start icinga2.service
systemctl status icinga2.service

## Install the Icinga2 Web Interface
## Install the Icinga 2 Web Interface

In order to manage Icinga2 via the web interface, install the Icinga2 web interface and Command Line Interface (CLI) packages:
In order to manage Icinga 2 via the web interface, install the Icinga 2 web interface and Command Line Interface (CLI) packages:

apt install icingaweb2 icingacli

Restart the Icinga2 daemon and verify the Icinga2 daemon status:
Restart the Icinga 2 daemon and verify the Icinga 2 daemon status:

systemctl restart icinga2.service
systemctl status icinga2.service

Install the MySQL schema required Icinga2 database:
Install the MySQL schema required Icinga 2 database:

mysql -u root icingadb -p < /usr/share/icinga2-ido-mysql/schema/mysql.sql

Edit the Icinga2 MySQL IDO configuration file and add Icinga2 engine database credentials, as shown in the following example. Use the credentials of the first database created in the [earlier database creation step](#configure-icinga2-databases):
Edit the Icinga 2 MySQL IDO configuration file and add Icinga 2 engine database credentials, as shown in the following example. Use the credentials of the first database created in the [earlier database creation step](#configure-icinga2-databases):

{{< file-excerpt "/etc/icinga2/features-enabled/ido-mysql.conf" conf >}}
library "db_ido_mysql"
Expand All @@ -144,19 +144,19 @@ object IdoMysqlConnection "ido-mysql" {
}
{{< /file-excerpt >}}

Save the file and restart the Icinga2 daemon:
Save the file and restart the Icinga 2 daemon:

systemctl restart icinga2.service

Create an Icinga Web 2 log directory and add the proper file system permissions to grant the Icinga2 group write permissions:
Create an Icinga Web 2 log directory and add the proper file system permissions to grant the Icinga 2 group write permissions:

mkdir -p /var/log/icingaweb2/
chgrp -R icingaweb2 /var/log/icingaweb2/
chmod -R 775 /var/log/icingaweb2/

## Configure Icinga2 via Web Interface
## Configure Icinga 2 via Web Interface

1. Generate an installation token. Save it somewhere easily accessible. You will need to use it to access the Icinga2 setup:
1. Generate an installation token. Save it somewhere easily accessible. You will need to use it to access the Icinga 2 setup:

icingacli setup token create

Expand All @@ -178,21 +178,21 @@ Create an Icinga Web 2 log directory and add the proper file system permissions

![Select Doc and Monitoring Modules](/docs/assets/icinga/icinga-docs-and-modules.png "Select Doc and Monitoring Modules")

5. Icinga2 will check your system requirements and PHP modules to see if all requirements are met before continuing with the installation and configuration process. Scroll down to the end of the page and press **Next** to continue.
5. Icinga 2 will check your system requirements and PHP modules to see if all requirements are met before continuing with the installation and configuration process. Scroll down to the end of the page and press **Next** to continue.

6. Choose **Authentication Type = Database**:

![Choose the "Database" Authentication Type](/docs/assets/icinga/icinga-database-authentication-type.png "Choose the "Database" Authentication Type")

7. Use the information from the second database created earlier to add the credentials needed to access the Icinga2 database for storing web interface users and groups. Use `icingaweb_db` as a name for this resource and leave the **Host**, **Port** and **Character** set variables as default. Do not enable **Persistent** and **SSL** option. Press **Validate Configuration** button to validate the database. After the database has been validated successfully, press **Next** to continue to the next phase of Icinga2’s configuration process:
7. Use the information from the second database created earlier to add the credentials needed to access the Icinga 2 database for storing web interface users and groups. Use `icingaweb_db` as a name for this resource and leave the **Host**, **Port** and **Character** set variables as default. Do not enable **Persistent** and **SSL** option. Press **Validate Configuration** button to validate the database. After the database has been validated successfully, press **Next** to continue to the next phase of Icinga 2’s configuration process:

![Database Resource Information](/docs/assets/icinga/icinga-database-resource-info.png "Database Resource Information")

8. Define a name for the database authentication backend (you can use the default value) and press **Next**.

9. Add a username with a strong password in order to log in to the Icinga2 web interface and further manage the Icinga2 engine and press **Next**.
9. Add a username with a strong password in order to log in to the Icinga 2 web interface and further manage the Icinga 2 engine and press **Next**.

10. Adjust the Icinga2 application and logging configurations using these settings, then press **Next**:
10. Adjust the Icinga 2 application and logging configurations using these settings, then press **Next**:

* Check **Show Stacktraces**

Expand All @@ -208,13 +208,13 @@ Create an Icinga Web 2 log directory and add the proper file system permissions

![Icinga Configuration Summary](/docs/assets/icinga/icinga-configuration-summary.png "Icinga Configuration Summary")

12. Press **Next** to continue setting up Icinga2 engine monitoring module.
12. Press **Next** to continue setting up Icinga 2 engine monitoring module.

13. Add a name for the Icinga2 Backend, select **IDO** as Backend Type and press **Next**.
13. Add a name for the Icinga 2 Backend, select **IDO** as Backend Type and press **Next**.

14. Add the Icinga2 engine database credentials in order to setup the IDO resource environment. After adding the Icinga2 database credentials, press **Validate Configuration** to validate the Icinga2 Monitoring IDO Resource. After the **Successfully validated** message appears, press **Next**.
14. Add the Icinga 2 engine database credentials in order to setup the IDO resource environment. After adding the Icinga 2 database credentials, press **Validate Configuration** to validate the Icinga 2 Monitoring IDO Resource. After the **Successfully validated** message appears, press **Next**.

15. Configure the Icinga2 Command Transport module with the following settings and press **Next**:
15. Configure the Icinga 2 Command Transport module with the following settings and press **Next**:

* **Transport Name** = icinga2

Expand All @@ -224,21 +224,21 @@ Create an Icinga Web 2 log directory and add the proper file system permissions

16. Use the default values or configure the monitoring security environment variables to sensitive information and press **Next**.

17. The next screen shows a detailed report of the current configuration. A message will also show you that Icinga2 Monitoring module has been successfully configured. Review the configuration and press **Finish** to complete the setup process.
17. The next screen shows a detailed report of the current configuration. A message will also show you that Icinga 2 Monitoring module has been successfully configured. Review the configuration and press **Finish** to complete the setup process.

After the installation and setup process completes, a message informs you that Icinga Web 2 has been successfully set up.

18. Log in to Icinga Web 2 to exit the setup process and log in to Icinga Web 2 login webpage:

![Icinga Successfully Set up - "Login to Icinga Web 2" button](/docs/assets/icinga/icinga-set-up-success-login.png "Icinga Successfully Set up - 'Login to Icinga Web 2' button")

You will be directed to the Icinga Web 2 Dashboard, where you should see the default services and Linode resources that are currently monitored by the Icinga2 engine:
You will be directed to the Icinga Web 2 Dashboard, where you should see the default services and Linode resources that are currently monitored by the Icinga 2 engine:

![Icinga Dashboard and Current Incidents](/docs/assets/icinga/icinga-dashboard-current-incidents.png "Icinga Dashboard and Current Incidents")

## Secure the Icinga Web 2 Interface Via TLS

To access Icinga2 monitoring application via HTTPS protocol, enable the Apache SSL module, SSL site configuration file, and Apache rewrite module:
To access Icinga 2 monitoring application via HTTPS protocol, enable the Apache SSL module, SSL site configuration file, and Apache rewrite module:

a2enmod ssl rewrite
a2ensite default-ssl.conf
Expand Down Expand Up @@ -287,4 +287,4 @@ Add a new rule to allow HTTPS traffic to pass through the firewall.

## That’s All!

You have successfully installed, set up, and secured the Icinga2 engine monitoring application and Icinga Web 2 Interface on Debian 9.
You have successfully installed, set up, and secured the Icinga 2 engine monitoring application and Icinga Web 2 Interface on Debian 9.
Loading