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

Add missing upgrade docs
This commit is contained in:
Johannes Meyer 2020-05-27 15:42:02 +02:00 committed by GitHub
commit 886925959d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 66 additions and 5 deletions

View File

@ -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:

View File

@ -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
Icinga Web 2 database.
Specific version upgrades are described below. Please note that upgrades are incremental. An upgrade from
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
v2.3 to v2.5 requires to follow the instructions for v2.4 too.
## Upgrading to Icinga Web 2 2.8.x
**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>