Azure Icinga 2.8 Updates Guide

Download PDF here.


Version 2.3

January 9, 2018

The purpose of this document is to provide the steps necessary for upgrading an instance of Icinga 2, version 2.8 or later, to a new version. The steps contained within are sourced from the official Icinga 2 documentation in Section 18, “Upgrading Icinga 2”

This version of the documentation has been adapted to match the necessary upgrade steps for an instance of the Shadow-Soft Marketplace VHD image.

Upgrading Icinga 2

This guide assumes that you have the most up to date version of the icinga-stable-release repository installed.

Instructions for adding this repository can be found in the official documentation at section “2.1.1. Package Repositories”

Updating the Client

[root@master~]# yum update icinga2
[root@master~]# icinga2 --version
icinga2 - The Icinga 2 network monitoring daemon (version: r2.8.1-1)

Upgrading to Icinga Web 2 2.5.x

  • Icinga Web 2 v2.5 requires at least PHP 5.6.
  • Hash marks (#) in INI files are no longer recognized as comments by parse_ini_file since PHP 7.0
  • Existing sessions of logged-in users do no longer work as expected due to a change in the User data structure. Everyone who was logged in before the upgrade has to log out once
  • Icinga Web 2 v2.5.0 requires a schema update for the database
  • Upgrading to PHP 7.0 / 7.1 via RedHat SCL (new dependency)
  • See Upgrading to FPM for manual steps that are required
  • Make sure to enable the new Apache module a2enmod php7 and restart apache2

See the official documentation for more information.

Upgrading the MySQL Database

If you’re upgrading an existing Icinga 2 instance, you should check the /usr/share/icinga2-ido-mysql/schema/upgrade directory for an incremental schema upgrade file. If there isn’t an upgrade file for your current version available, there’s nothing to do.

Apply all database schema upgrade files incrementally.

Database Import

[root@master~]# mysql -u root -p icinga < /usr/share/icinga2-ido-mysql/schema/upgrade/<version>.sql

The Icinga 2 DB IDO module will check for the required database schema version on startup and generate an error message if not satisfied.


You are upgrading from Icinga2 from version 2.0.2 to 2.3.0. Look into the /usr/share/icinga2-ido-mysql/schema/upgrade directory:

[root@master ~]# ls /usr/share/icinga2-ido-mysql/schema/upgrade/
2.0.2.sql  2.1.0.sql  2.2.0.sql  2.3.0.sql

There are three new upgrade files: 2.1.0.sql,  2.2.0.sql, and 2.3.0.sql which must be applied incrementally to your IDO database.

Incremental Example

[root@master ~]# mysql -u root -p icinga < /usr/share/icinga2-ido-mysql/schema/upgrade/2.1.0.sql
Enter password:
[root@master ~]# mysql -u root -p icinga < /usr/share/icinga2-ido-mysql/schema/upgrade/2.2.0.sql
Enter password:
[root@master ~]# mysql -u root -p icinga < /usr/share/icinga2-ido-mysql/schema/upgrade/2.3.0.sql
Enter password:
[root@master ~]#

Upgrading Director Module

Reference the official documentation for upgrading Icinga Director. github: Upgrading Director