Skip to content

Commit bda34ef

Browse files
committed
Replace 'Icinga2' with 'Icinga 2'
The official spelling of the project name is 'Icinga 2'.
1 parent e8b8738 commit bda34ef

File tree

2 files changed

+59
-59
lines changed

2 files changed

+59
-59
lines changed

docs/uptime/monitoring/install-icinga2-monitoring-on-debian-9.md

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
author:
33
name: Linode Community
44
email: docs@linode.com
5-
description: "This guide shows you how to install and configure Icinga2 and Icinga Web 2 on Debian to monitor your Linode services and performance."
6-
og_description: "This guide will show you how to install and configure Icinga2 to monitor your system"
5+
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."
6+
og_description: "This guide will show you how to install and configure Icinga 2 to monitor your system"
77
keywords: ["debian", "icinga", "monitoring", "icinga2"]
88
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
99
published: 2017-12-12
1010
modified: 2017-12-12
1111
modified_by:
1212
name: Linode
13-
title: 'Install Icinga2 Monitoring on Debian 9'
13+
title: 'Install Icinga 2 Monitoring on Debian 9'
1414
expiryDate: 2019-12-12
1515
contributor:
1616
name: Matt Vass
@@ -19,15 +19,15 @@ external_resources:
1919
- '[Official Icinga Documentation](https://www.icinga.com/docs/icinga2/latest/doc/01-about/)'
2020
---
2121

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

24-
## What is Icinga2?
24+
## What is Icinga 2?
2525

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

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

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

3232
## Before You Begin
3333

@@ -61,9 +61,9 @@ Restart the Apache daemon to apply the new changes:
6161

6262
systemctl restart apache2
6363

64-
## Configure Icinga2 Databases
64+
## Configure Icinga 2 Databases
6565

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

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

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

8080
sudo mysql_secure_installation
8181

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

8484
mysql –u root -p
8585

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

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

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`):
9393

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

98-
## Install Icinga2
98+
## Install Icinga 2
9999

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

102102
apt install icinga2 icinga2-ido-mysql
103103

104104
During the installation, when asked:
105105

106-
* If Icinga2 should use the MySQL module,
106+
* If Icinga 2 should use the MySQL module,
107107

108108
* Choose **Yes** from the prompt.
109109

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

112112
* Choose **No** from the prompt.
113113

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

116116
systemctl start icinga2.service
117117
systemctl status icinga2.service
118118

119-
## Install the Icinga2 Web Interface
119+
## Install the Icinga 2 Web Interface
120120

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

123123
apt install icingaweb2 icingacli
124124

125-
Restart the Icinga2 daemon and verify the Icinga2 daemon status:
125+
Restart the Icinga 2 daemon and verify the Icinga 2 daemon status:
126126

127127
systemctl restart icinga2.service
128128
systemctl status icinga2.service
129129

130-
Install the MySQL schema required Icinga2 database:
130+
Install the MySQL schema required Icinga 2 database:
131131

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

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):
135135

136136
{{< file-excerpt "/etc/icinga2/features-enabled/ido-mysql.conf" conf >}}
137137
library "db_ido_mysql"
@@ -144,19 +144,19 @@ object IdoMysqlConnection "ido-mysql" {
144144
}
145145
{{< /file-excerpt >}}
146146

147-
Save the file and restart the Icinga2 daemon:
147+
Save the file and restart the Icinga 2 daemon:
148148

149149
systemctl restart icinga2.service
150150

151-
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:
152152

153153
mkdir -p /var/log/icingaweb2/
154154
chgrp -R icingaweb2 /var/log/icingaweb2/
155155
chmod -R 775 /var/log/icingaweb2/
156156

157-
## Configure Icinga2 via Web Interface
157+
## Configure Icinga 2 via Web Interface
158158

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

161161
icingacli setup token create
162162

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

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

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

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

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

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

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

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

193-
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**.
193+
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**.
194194

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

197197
* Check **Show Stacktraces**
198198

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

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

211-
12. Press **Next** to continue setting up Icinga2 engine monitoring module.
211+
12. Press **Next** to continue setting up Icinga 2 engine monitoring module.
212212

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**.
214214

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**.
216216

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**:
218218

219219
* **Transport Name** = icinga2
220220

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

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

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

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

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

233233
![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")
234234

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

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

239239
## Secure the Icinga Web 2 Interface Via TLS
240240

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

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

288288
## That’s All!
289289

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

Comments
 (0)