Changes between Version 8 and Version 9 of NSM2021/Agenda/iCinga

Timestamp:

May 22, 2021, 11:58:05 PM (3 years ago)

Author:

deepthi

Comment:

--

NSM2021/Agenda/iCinga

@@ -1 @@
-= Configuring iCinga on Single server =
+= Configuring iCinga2 on Single server =
 
 This will guide you through installing Icinga setup on Ubuntu 20.04 LTS server; 
@@ -6 +6 @@
 
 * Linux Server running Ubuntu 20.04 LTS
-* NGINX Installed.
 * SSL/ HTTPS Certificates issued ( May be using Letsencrypt or Otherwise)
 * sudo access to the server. All following commands have to be entered as the root user. Best way to do it is, by login in as root with {{{ sudo su }}}
 
+Execute the commands as super user
+
+== Installing using a Script ==
+
+Download the script into your server
+
+`wget https://raw.githubusercontent.com/LEARN-LK/Tutorials/master/installing_icinga2_ubuntu.sh`
+
+Assign execute permission for the script
+
+`chmod +x installing_icinga2_ubuntu.sh`
+
+Then execute file using terminal
+
+`./installing_icinga2_ubuntu.sh`
+
+Select `yes` for the options pop up when icinga2-ido-mysql starts installing and creating database for module. Enter a password for when it prompt(it is used for icinga2 database)
+
+== Manual Installation == 
+
 === Ubuntu Repositories===
 
@@ -22 +41 @@
 `. /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`
+`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`
@@ -95 +114 @@
 `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 :
 
-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.
+(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 ====
@@ -128 +149 @@
 
 `systemctl restart icinga2`
+
+
 
 ==== Setting Up Icinga 2 REST API ====
@@ -148 +171 @@
 }
 
+(add an api user for the director as well)
+
 Restart Icinga 2 to activate the configuration.
 
@@ -169 +194 @@
 This is due to local security restrictions whereas the web wizard cannot create a database/user through a local unix domain socket.
 
-`mysql -u root -p`;
+==== 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###';`
+`CREATE USER icingaweb2@localhost IDENTIFIED BY '##PASSWORD##';`
 
 `GRANT ALL ON icingaweb2.* TO icingaweb2@localhost;`
 
-`flush privileges;`
+`Flush privileges;`
 
 `quit`
 
-=== Enabling Director in Icinga ==
+===== 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}
+`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 
@@ -199 +294 @@
 `icingacli module enable director`
 
-=== Starting Web Setup ===
+=== 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`
+
+`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`
+
+== Starting Web Setup ==
 
 Finally visit Icinga Web 2 in your browser to access the setup wizard and complete the installation: