In this tutorial, you’ll learn that how to setup Icinga 2 web interface. In our previous guide we already cover the installation of Icinga 2 on Ubuntu 20.04. If you missed the installation guide visit the below link.
How To Install Icinga 2 on Ubuntu 20.04
Icinga 2 Web provides the interface for Web and centralized interface for the Network monitoring. For easy and optimal settings follow the complete guide.
Step 1: Update Your System
As usual we do, first of all update your system to the latest packages by hitting the below command.
sudo apt -y update && sudo apt -y upgrade
Step 2: Adding Icinga 2 Repository on Ubuntu 20.04
To add the icinga 2 repository on Ubuntu 20.04, make sure to be the root user or switch it by
sudo su -
Also make sure to get the https and curl packages if they are not already installed.
apt-get install -y apt-transport-https curl
Then run the given command to add the Icinga public signing key
curl https://packages.icinga.com/icinga.key | apt-key add -
After it fire the below command to add the Icinga repository on Ubuntu 20.04.
echo "deb http://packages.icinga.com/ubuntu icinga-$(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/icinga2.list
echo "deb-src http://packages.icinga.com/ubuntu icinga-$(lsb_release -sc) main" | sudo tee -a /etc/apt/sources.list.d/icinga2.list
Then update the repository cache by running the command.
apt-get update
Step 3: Install PHP Packages on Ubuntu 20.04
Fire the given command to install the PHP packages required for Icinga 2 web on Ubuntu 20.04.
apt-get install -y php-gd php-json php-dba php-intl php-ldap php-pdo-mysql php-pgsql php-imagick php-dom
Note:During installation I got error due to the latest php version(7.4). So, if you face the same issue switch to the previous version of php like 7.0 as Icinga doesn’t support latest version. Install the PHP7.0 by running below command with the remaining extensions.
add-apt-repository ppa:ondrej/php apt update
apt-get install -y php7.0 add-apt-repository ppa:ondrej/php apt-update apt-get install -y php7.0-gd php7.0-json php7.0-dba php7.0-intl php7.0-ldap php7.0-pdo-mysql php7.0-pgsql php7.0-imagick php7.0-dom
Then restart the apache server.
systemctl restart apache2
Step 4: Installing Icinga Web 2
Now, as we’ve already added the repository for icinga web 2 run the below command to install the icinga web 2.
apt-get install -y icingaweb2
As the Icinga Web 2 also have the CLI installed in it in order to perform different operations from CLI as well as from web. So, both have access to logs & configs. To do this add the web server user (www-data) to the system group (icingaweb2).
addgroup --system icingaweb2
usermod -a -G icingaweb2 www-data
And then set the timezone according to your time in php.ini file.
nano /etc/php/7.*/apache2/php.ini
date.timezone= Asia/Karachi
Then restart the apache server.
systemctl restart apache2
Step 5: Setup Icinga Web 2
Now, visit the below link to start the wizard for setting up Icinga Web 2.
http://your.ip.addr.ess/icingaweb2/setup or localhost/icingaweb2/setup
And run the following command in your terminal to generate a toke for security.
icingacli setup token create
You’ll see the similar output
icingacli setup token create The newly generated setup token is: e00b72902b690722
On Browser wizard, copy and paste the above generated token & hit Next.
On the next screen, select the installed modules(during icinga installation) to enable them & hit the Next button.
Below pages output the information of the system, timezone & the PHP extensions.
Note: If anything missing, you’ll need to install it before proceeding further. If everything goes fine then click on Next button.
In next step choose the authentication type. Make sure that Icinga Web 2 supports the AD, LDAP & Local for authentication purposes. Here I’m going to use local. For this select Database.
As Icinga Web 2 stores info in database, so create one for it. Type in the terminal.
mysql -u root -p
> CREATE DATABASE icingawebdb; > grant all privileges on icingawebdb.* to icingaweb@localhost identified by 'icinga123'; > quit
And put these database details in the Wizard opened in browser & click Next.
Now, type authentication backend name & click Next button.
In next step create an admin account. Make sure to keep the credentials in safe place.
Fill the details for storing logs & configs. Then click Next.
Finally review your settings & click Next.
And click Next on the next screen to configure the monitoring of Icinga web 2.
Choose monitoring backend for retrieving the info. I’m going to use IDO.
As we’ve already created the DB for IDO in Icinga 2 installation, so use that one. Click here to go the installation post to see the Database details. Enter the IDO database details & click on Next button .
Step 6: Setup Command Transport
Icinga Web 2 support the following command transports.
- Local Command File
- Icinga 2 API (Recommended)
- Remote Command Line
It’s up to you to use multiple command transport or single one. For demo here I’m going to use single local command transport.
- Local Command File
- Icinga 2 API
Fire the given command to setup Icinga 2 API command transport.
icinga2 api setup
Output:
Here’s output sample.
icinga2 api setup information/cli: Generating new CA. warning/cli: CA files '/var/lib/icinga2/ca//ca.crt' and '/var/lib/icinga2/ca//ca.key' already exist. warning/cli: Found CA, skipping and using the existing one. information/cli: Private key file '/var/lib/icinga2/certs//Ubuntu20.localdomain.key' already exists, not generating new certificate. information/cli: Adding new ApiUser 'root' in '/etc/icinga2/conf.d/api-users.conf'.
You can find the API user detail in /etc/icinga2/conf.d/api-users.conf file.
cat /etc/icinga2/conf.d/api-users.conf
Then restart the Icinga 2 services.
Now, provide the above credentials on the web page & click Next.
Then enter the variable info to protect yourself from bad ones. Then click Next.
Finally review your monitoring configuration.
Below given page shows the successful setup of Icinga Web 2.
Hit the Login to Icinga Web 2 button.
Step 7: Accessing Icinga Web 2
Now, provide the admin account details created earlier to login.
You’ll see the Icinga Web 2 dashboard here.
Now, navigate to Overview>>Hosts to look all the connected hosts.
So, this is how you can setup Icinga Web 2 on Ubuntu 20.04. In our next tutorial, we’ll cover the monitoring of remote hosts.
