You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

22
+

23
23
24
-
## What is Icinga2?
24
+
## What is Icinga 2?
25
25
26
-
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.
26
+
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.
27
27
28
-
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.
28
+
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.
29
29
30
-
This guide shows how to install and configure the latest version of Icinga2 web monitoring tool on Debian 9 to monitor network infrastructure.
30
+
This guide shows how to install and configure the latest version of Icinga 2 web monitoring tool on Debian 9 to monitor network infrastructure.
31
31
32
32
## Before You Begin
33
33
@@ -61,9 +61,9 @@ Restart the Apache daemon to apply the new changes:
61
61
62
62
systemctl restart apache2
63
63
64
-
## Configure Icinga2 Databases
64
+
## Configure Icinga 2 Databases
65
65
66
-
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:
66
+
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:
@@ -79,59 +79,59 @@ Restart the Apache daemon to apply the new changes:
79
79
80
80
sudo mysql_secure_installation
81
81
82
-
4. Log back in to the database console and create the database for Icinga2:
82
+
4. Log back in to the database console and create the database for Icinga 2:
83
83
84
84
mysql –u root -p
85
85
86
-
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:
86
+
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:
87
87
88
88
create database icingadb;
89
89
grant all privileges on icingadb.* to 'icinga_user'@'localhost' identified by 'strongpassword';
90
90
flush privileges
91
91
92
-
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`):
92
+
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`):
93
93
94
94
create database icinga_users;
95
95
grant all privileges on icinga_users.* to 'icinga_user'@'localhost' identified by 'strongpassword';
96
96
exit
97
97
98
-
## Install Icinga2
98
+
## Install Icinga 2
99
99
100
-
Install Icinga2 and the Icinga2 MySQL module for accessing MariaDB database backend:
100
+
Install Icinga 2 and the Icinga 2 MySQL module for accessing MariaDB database backend:
101
101
102
102
apt install icinga2 icinga2-ido-mysql
103
103
104
104
During the installation, when asked:
105
105
106
-
* If Icinga2 should use the MySQL module,
106
+
* If Icinga 2 should use the MySQL module,
107
107
108
108
* Choose **Yes** from the prompt.
109
109
110
110
* To configure a database for `icinga2-ido-mysql` with `dbconfig-common` option,
111
111
112
112
* Choose **No** from the prompt.
113
113
114
-
After Icinga2 has been installed, start the Icinga2 service and check the daemon status:
114
+
After Icinga 2 has been installed, start the Icinga 2 service and check the daemon status:
115
115
116
116
systemctl start icinga2.service
117
117
systemctl status icinga2.service
118
118
119
-
## Install the Icinga2 Web Interface
119
+
## Install the Icinga 2 Web Interface
120
120
121
-
In order to manage Icinga2 via the web interface, install the Icinga2 web interface and Command Line Interface (CLI) packages:
121
+
In order to manage Icinga 2 via the web interface, install the Icinga 2 web interface and Command Line Interface (CLI) packages:
122
122
123
123
apt install icingaweb2 icingacli
124
124
125
-
Restart the Icinga2 daemon and verify the Icinga2 daemon status:
125
+
Restart the Icinga 2 daemon and verify the Icinga 2 daemon status:
126
126
127
127
systemctl restart icinga2.service
128
128
systemctl status icinga2.service
129
129
130
-
Install the MySQL schema required Icinga2 database:
130
+
Install the MySQL schema required Icinga 2 database:
131
131
132
132
mysql -u root icingadb -p < /usr/share/icinga2-ido-mysql/schema/mysql.sql
133
133
134
-
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):
134
+
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):
Create an Icinga Web 2 log directory and add the proper file system permissions to grant the Icinga2 group write permissions:
151
+
Create an Icinga Web 2 log directory and add the proper file system permissions to grant the Icinga 2 group write permissions:
152
152
153
153
mkdir -p /var/log/icingaweb2/
154
154
chgrp -R icingaweb2 /var/log/icingaweb2/
155
155
chmod -R 775 /var/log/icingaweb2/
156
156
157
-
## Configure Icinga2 via Web Interface
157
+
## Configure Icinga 2 via Web Interface
158
158
159
-
1. Generate an installation token. Save it somewhere easily accessible. You will need to use it to access the Icinga2 setup:
159
+
1. Generate an installation token. Save it somewhere easily accessible. You will need to use it to access the Icinga 2 setup:
160
160
161
161
icingacli setup token create
162
162
@@ -178,21 +178,21 @@ Create an Icinga Web 2 log directory and add the proper file system permissions
178
178
179
179

180
180
181
-
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.
181
+
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.
182
182
183
183
6. Choose **Authentication Type = Database**:
184
184
185
185

186
186
187
-
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:
187
+
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:
12. Press **Next** to continue setting up Icinga2 engine monitoring module.
211
+
12. Press **Next** to continue setting up Icinga 2 engine monitoring module.
212
212
213
-
13. Add a name for the Icinga2 Backend, select **IDO** as Backend Type and press **Next**.
213
+
13. Add a name for the Icinga 2 Backend, select **IDO** as Backend Type and press **Next**.
214
214
215
-
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**.
215
+
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**.
216
216
217
-
15. Configure the Icinga2 Command Transport module with the following settings and press **Next**:
217
+
15. Configure the Icinga 2 Command Transport module with the following settings and press **Next**:
218
218
219
219
***Transport Name** = icinga2
220
220
@@ -224,21 +224,21 @@ Create an Icinga Web 2 log directory and add the proper file system permissions
224
224
225
225
16. Use the default values or configure the monitoring security environment variables to sensitive information and press **Next**.
226
226
227
-
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.
227
+
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.
228
228
229
229
After the installation and setup process completes, a message informs you that Icinga Web 2 has been successfully set up.
230
230
231
231
18. Log in to Icinga Web 2 to exit the setup process and log in to Icinga Web 2 login webpage:
232
232
233
233

234
234
235
-
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:
235
+
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:
236
236
237
237

238
238
239
239
## Secure the Icinga Web 2 Interface Via TLS
240
240
241
-
To access Icinga2 monitoring application via HTTPS protocol, enable the Apache SSL module, SSL site configuration file, and Apache rewrite module:
241
+
To access Icinga 2 monitoring application via HTTPS protocol, enable the Apache SSL module, SSL site configuration file, and Apache rewrite module:
242
242
243
243
a2enmod ssl rewrite
244
244
a2ensite default-ssl.conf
@@ -287,4 +287,4 @@ Add a new rule to allow HTTPS traffic to pass through the firewall.
287
287
288
288
## That’s All!
289
289
290
-
You have successfully installed, set up, and secured the Icinga2 engine monitoring application and Icinga Web 2 Interface on Debian 9.
290
+
You have successfully installed, set up, and secured the Icinga 2 engine monitoring application and Icinga Web 2 Interface on Debian 9.
0 commit comments