Icinga2 installation - Ubuntu 20.04

-

 Ubuntu Repositories 

You need to add the Icinga repository to your package management configuration. The following commands must be executed with root permissions unless noted otherwise.


apt-get update

apt-get -y install apt-transport-https wget gnupg

wget -O - https://packages.icinga.com/icinga.key | apt-key add -

. /etc/os-release; if [ ! -z ${UBUNTU_CODENAME+x} ]; then DIST="${UBUNTU_CODENAME}"; else DIST="$(lsb_release -c| awk '{print $2}')"; fi;

echo "deb https://packages.icinga.com/ubuntu icinga-${DIST} main" > /etc/apt/sources.list.d/${DIST}-icinga.list

echo "deb-src https://packages.icinga.com/ubuntu icinga-${DIST} main" >> /etc/apt/sources.list.d/${DIST}-icinga.list

apt-get update


Installing Icinga 2 

The following commands must be executed with root permissions unless noted otherwise.


apt-get install icinga2


Setting up Check Plugins 


Without plugins Icinga 2 does not know how to check external services. The Monitoring Plugins Project provides an extensive set of plugins which can be used with Icinga 2 to check whether services are working properly.


apt-get install monitoring-plugins


Running Service 


Start the service using following command


systemctl restart icinga2


Enabling the service if a reboot happens


systemctl enable icinga2


Extra :

If you’re stuck with configuration errors, you can manually invoke the configuration validation.

icinga2 daemon -C


Configuration Syntax Highlighting 

If you are using Vim 


apt-get install vim-icinga2 vim-addon-manager

vim-addon-manager -w install icinga2


Ensure that syntax highlighting is enabled e.g. by editing the user’s vimrc configuration file:


# vim ~/.vimrc syntax on


Test it:

vim /etc/icinga2/conf.d/templates.conf


Note : If you are using Nano the syntax files are installed with the icinga2-common package already


Setting up Icinga Web 2 

Configuring DB IDO MySQL 


Installing MySQL database server:


#apt-get install mariadb-server


#mysql_secure_installation

(After executing mysql_secure_installation, change the root password and remove test database.)


Installing the IDO modules for MySQL 


The next step is to install the icinga2-ido-mysql

apt-get install icinga2-ido-mysql


Select yes for the options pop up and enter a password for when it prompt(it is used for icinga2 database)

Note :

(OPTIONAL)The Ubuntu packages provide a database configuration wizard by default. You can skip the automated setup and install/upgrade the database manually if you prefer.


Setting up the MySQL database 


 mysql -u root -p


CREATE DATABASE icinga;


CREATE USER 'icinga'@'localhost' IDENTIFIED BY '###PASSSWORD### ;


GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON icinga.* TO 'icinga'@'localhost';


quit


After creating the database you can import the Icinga 2 IDO schema using the following command. Enter the root password into the prompt when asked.

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


Enabling the IDO MySQL module 


The package provides a new configuration file that is installed in /etc/icinga2/features-available/ido-mysql.conf. (You can update the database credentials in this file if needed.)


You can enable the ido-mysql feature configuration file using icinga2 feature enable:

icinga2 feature enable ido-mysql

You will see Module 'ido-mysql' was enabled.

Make sure to restart Icinga 2 for these changes to take effect.

systemctl restart icinga2


Setting Up Icinga 2 REST API 


Icinga Web 2 and other web interfaces require the REST API to send actions (reschedule check, etc.) and query object details.

You can run the CLI command icinga2 api setup to enable the api feature and set up certificates as well as a new API user root with an auto-generated password in the /etc/icinga2/conf.d/api-users.conf configuration file:


icinga2 api setup


Edit the api-users.conf file and add a new ApiUser? object. Specify the permissions attribute with minimal permissions required by Icinga Web 2.


vim /etc/icinga2/conf.d/api-users.conf


object ApiUser "icingaweb2" {

  password = "Wijsn8Z9eRs5E25d"

  permissions = [ "status/query", "actions/*", "objects/modify/*", "objects/query/*" ]

}


(add an api user for the director as well)


Restart Icinga 2 to activate the configuration.

systemctl restart icinga2


Installing Icinga Web 2 


apt-get install icingaweb2 libapache2-mod-php


Preparing Web Setup 


You can set up Icinga Web 2 quickly and easily with the Icinga Web 2 setup wizard which is available the first time you visit Icinga Web 2 in your browser. When using the web setup you are required to authenticate using a token. In order to generate a token use the

 icingacli:

icingacli setup token create


In case you do not remember the token you can show it using the icingacli:


icingacli setup token show


On Debian and derivates, you need to manually create a database and a database user prior to starting the web wizard. This is due to local security restrictions whereas the web wizard cannot create a database/user through a local unix domain socket.


Database for backend use 


log as root user

mysql -u root -p

then execute the following commands to create icingaweb db and director db


For icingaweb db

 

CREATE DATABASE icingaweb2;


CREATE USER icingaweb2@localhost IDENTIFIED BY '##PASSWORD##';


GRANT ALL ON icingaweb2.* TO icingaweb2@localhost;


Flush privileges;


quit


director db 


CREATE DATABASE director CHARACTER SET 'utf8';


CREATE USER director@localhost IDENTIFIED BY '##PASSWORD##';


GRANT ALL ON director.* TO director@localhost;


Flush privileges;


quit


enabling reactbundle module


Copy following script to a bash flle and execute or execute in the terminal.

REACTBUNDLE_MODULE_NAME=reactbundle


REACTBUNDLE_MODULE_VERSION=v0.9.0


REACTBUNDLE_REPO="https://github.com/Icinga/icingaweb2-module-${REACTBUNDLE_MODULE_NAME}"


MODULES_PATH="/usr/share/icingaweb2/modules"


git config --global advice.detachedHead false


git clone ${REACTBUNDLE_REPO} "${MODULES_PATH}/${REACTBUNDLE_MODULE_NAME}" --branch "${REACTBUNDLE_MODULE_VERSION}"


icingacli module enable "${REACTBUNDLE_MODULE_NAME}"


enabling ipl module 


Copy following script to a bash flle and execute or execute in the terminal.

IPL_MODULE_NAME=ipl


IPL_MODULE_VERSION=v0.5.0


IPL_REPO="https://github.com/Icinga/icingaweb2-module-${IPL_MODULE_NAME}"


MODULES_PATH="/usr/share/icingaweb2/modules"


git clone ${IPL_REPO} "${MODULES_PATH}/${IPL_MODULE_NAME}" --branch "${IPL_MODULE_VERSION}"


icingacli module enable "${IPL_MODULE_NAME}"


enabling incubator module 


Copy following script to a bash flle and execute or execute in the terminal.

INCUBATOR_MODULE_NAME=incubator


INCUBATOR_MODULE_VERSION=v0.6.0


INCUBATOR_REPO="https://github.com/Icinga/icingaweb2-module-${INCUBATOR_MODULE_NAME}"


MODULES_PATH="/usr/share/icingaweb2/modules"


git clone ${INCUBATOR_REPO} "${MODULES_PATH}/${INCUBATOR_MODULE_NAME}" --branch "${INCUBATOR_MODULE_VERSION}"


icingacli module enable "${INCUBATOR_MODULE_NAME}"


Enabling Director in Icinga


Copy following script to a bash flle and execute. The script with the files to the relevant directory using the script

ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"


REPO_URL="https://github.com/icinga/icingaweb2-module-director"


TARGET_DIR="${ICINGAWEB_MODULEPATH}/director"


MODULE_VERSION="1.8.0"


git clone "${REPO_URL}" "${TARGET_DIR}" --branch v${MODULE_VERSION}

and then enable the icinga-director module

icingacli module enable director


enabling business process module


Copy following script to a bash flle and execute or execute in the terminal.

BS_PROCESS_ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"


BS_PROCESS_REPO_URL="https://github.com/Icinga/icingaweb2-module-businessprocess"


BS_PROCESS_TARGET_DIR="${ICINGAWEB_MODULEPATH}/businessprocess"


git clone "${BS_PROCESS_REPO_URL}" "${BS_PROCESS_TARGET_DIR}"

icingacli module enable businessprocess


changing the permission for relevant users


chown -R www-data:icingaweb2 /etc/icingaweb2/


Running a demon for director service 


useradd -r -g icingaweb2 -d /var/lib/icingadirector -s /bin/false icingadirector

apt install -d -o icingadirector -g icingaweb2 -m 0750 /var/lib/icingadirector

MODULE_PATH=/usr/share/icingaweb2/modules/director


cp "${MODULE_PATH}/contrib/systemd/icinga-director.service" /etc/systemd/system/

systemctl daemon-reload

systemctl enable icinga-director.service

systemctl start icinga-director.service


(Please note that I used a script(included the all steps) for running whole process and the steps can be changed or will have to modified for the latest versions of the modules if it is outdated by now.)


sources :


https://computingforgeeks.com/install-icinga2-monitoring-tool-on-ubuntu-linux/

https://github.com/Icinga/icingaweb2-module-incubator/blob/master/README.md

https://github.com/Icinga/icingaweb2-module-ipl#sample-git-installation

https://github.com/Icinga/icingaweb2-module-reactbundle

Comments

Post a Comment

Popular posts from this blog

How to push a file into a docker container

-
Let's  see how to push a file into the container from the host.  We are assuming the test.html file is the file we are going to copy into the docker container.  web-application is container docker cp test.html web-application:/folderpath we can verify  after log in to the container. docker exec -it web-application bash And then check in the folder path and you will see the file there copied Sources : https://www.linkedin.com/events/kubernetes-freetechnicalworksho6807993779836985344/
Read more

Docker - Begginer 1

-
Image
Docker What, Docker? Opensource platform tool  Manages the containers Allow to build applications in a container with the libraries, binaried and dependencies run from anywhere Why Docker? portability light weight OS fast delivery(impact of light weight os) Multiple isolated OS Resource optimization Continous development and testing Architecture Docker Client Docker Host  Docker Hub(Registery) Also Docker images , Docker containers , Dcker Network and storages are contains in the architecture. Docker client is used to communicate with Docker hosts using Docker daemon is installed in Docker host. Clients are used to manage the Docker components and operations such as create, delete, pull, push, bulid, run etc. Docker client can connect to the Docker host remotly using REST API, UNIX sockets or using a network interface. Docker hub(Registery) is used to pull and push Docker images There are two types of docker hubs Docker Hub Online/Docker Hub
Read more

Project(on going) - IPv6 Fragmentation

-
An IP Datagram travels over different networks, each of which may have different MTU (Maximum Transmit Unit ) , which is the largest IP datagram that can be carried by a network. MTU - - maximum size of an unit which can be transmitted in a network and it depends on the network and media and how they be allowed to transmitted. also encapsulation....etc. It happens when the MTU values of hosts and routers are different from each other;         When we have two different type of network/media connected with router which have different MTU in such case router broke down packet to appropriate size regarding network/media type payload exceed the Maximum Transmission Unit in the interface. so the payload has to be chopped and put them into IP fragmented packets. they are:     -reassembled at destination     -each fragment is independent datagram        - could be routed in a different direction        - could be delivered out of order        - can be used to bypass IPS       
Read more