Merge pull request #4147 from Icinga/fix/missing-upgrade-docs-4122

Add missing upgrade docs

CHANGELOG.md

@@ -4,7 +4,7 @@ Please make sure to always read our [Upgrading](doc/80-Upgrading.md) documentati
 
 ## What's New
 
-### What's New in Version 2.8.0-rc1
+### What's New in Version 2.8.0
 
 You can find all issues related to this release on our [Roadmap](https://github.com/Icinga/icingaweb2/milestone/55?closed=1).
 
@@ -50,6 +50,28 @@ extraneous spaces to your username.
 * External logout not working from the navigation dashboard [#3995](https://github.com/Icinga/icingaweb2/issues/3995)
 * Username with extraneous spaces are not invalid [#4030](https://github.com/Icinga/icingaweb2/pull/4030)
 
+### Changes in Packaging and Dependencies
+
+Valid for distributions:
+
+* RHEL / CentOS 7
+  * Upgrade to PHP 7.3 via RedHat SCL
+  * See [Upgrading to Icinga Web 2 2.8.x](doc/80-Upgrading.md#upgrading-to-icinga-web-2-28x)
+    for manual steps that are required
+
+#### Discontinued Package Updates
+
+Icinga Web 2 v2.8+ is not supported on these platforms:
+
+* RHEL / CentOS 6
+* Debian 8 Jessie
+* Ubuntu 16.04 LTS (Xenial Xerus)
+
+Please consider an upgrade of your central Icinga system to a newer distribution release.
+
+[icinga.com](https://icinga.com/subscription/support-details/) provides an overview about
+currently supported distributions.
+
 ### What's New in Version 2.7.3
 
 This is a hotfix release and fixes the following issue:

doc/80-Upgrading.md

@@ -1,10 +1,49 @@
 # Upgrading Icinga Web 2 <a id="upgrading"></a>
 
-Upgrading Icinga Web 2 is quite straightforward. Usually the only manual steps involved are schema updates for the
+Specific version upgrades are described below. Please note that upgrades are incremental. An upgrade from
-Icinga Web 2 database.
+v2.6 to v2.8 requires to follow the instructions for v2.7 too.
 
-Specific version upgrades are described below. Please note that version updates are incremental. An upgrade from
+## Upgrading to Icinga Web 2 2.8.x
-v2.3 to v2.5 requires to follow the instructions for v2.4 too.
+
+**Changes in packaging and dependencies**
+
+Valid for distributions:
+
+* RHEL / CentOS 7
+  * Upgrade to PHP 7.3 via RedHat SCL
+
+After upgrading to version 2.8.0 you'll get the new `rh-php73` dependency installed. This is a drop-in replacement
+for the previous `rh-php71` dependency and only requires the setup of a new fpm service and possibly some copying
+of customized configurations.
+
+**php.ini or php-fpm settings** you have tuned in the past need to be copied over to the new path:
+
+From `/etc/opt/rh/rh-php71/` to `/etc/opt/rh/rh-php73/`.
+
+Don't forget to also install any additional **php-modules** for PHP 7.3 you've had previously installed
+for e.g. Icinga Web 2 modules.
+
+There's also a new **service** included which replaces the previous one for php-fpm:
+
+Stop the old service: `systemctl stop rh-php71-php-fpm.service`  
+Start the new service: `systemctl start rh-php73-php-fpm.service`
+
+You can now safely remove the previous dependency if you like:
+
+`yum remove rh-php71*`
+
+**Discontinued package updates**
+
+Icinga Web 2 v2.8+ is not supported on these platforms:
+
+* RHEL / CentOS 6
+* Debian 8 Jessie
+* Ubuntu 16.04 LTS (Xenial Xerus)
+
+Please consider an upgrade of your central Icinga system to a newer distribution release.
+
+[icinga.com](https://icinga.com/subscription/support-details/) provides an overview about
+currently supported distributions.
 
 ## Upgrading to Icinga Web 2 2.7.x <a id="upgrading-to-2.7.x"></a>