From e4fdb02de8622a8869f293f66d5c7f07b91de7e7 Mon Sep 17 00:00:00 2001 From: Thomas Gelf Date: Wed, 21 Sep 2022 08:30:54 +0200 Subject: [PATCH] doc, module.info: raise dependencies --- doc/02-Installation.md | 14 +++++++------- doc/05-Upgrading.md | 14 +++++++++++++- doc/82-Changelog.md | 4 ++-- module.info | 2 +- 4 files changed, 23 insertions(+), 11 deletions(-) diff --git a/doc/02-Installation.md b/doc/02-Installation.md index 87ba9cbe..f25bd71d 100644 --- a/doc/02-Installation.md +++ b/doc/02-Installation.md @@ -9,24 +9,24 @@ to the latest version, please [read on here](05-Upgrading.md). Requirements ------------ -* Icinga 2 (>= 2.6.0) +* Icinga 2 (>= 2.8.0) * It is recommended to use the latest feature release of Icinga 2 * All versions since 2.4.3 should also work fine, but we do no longer test and support them. * Some features require newer Icinga 2 releases * Flapping requires 2.8 for the thresholds to work - and at least 2.7 on all nodes -* Icinga Web 2 (>= 2.6.0). All versions since 2.2 should also work fine, but +* Icinga Web 2 (>= 2.8.0). All versions since 2.2 should also work fine, but might show smaller UI bugs and are not actively tested * The following Icinga modules must be installed and enabled: - * [incubator](https://github.com/Icinga/icingaweb2-module-incubator) (>=0.12.0) + * [incubator](https://github.com/Icinga/icingaweb2-module-incubator) (>=0.18.0) * If you are using Icinga Web < 2.9.0, the following modules are also required * [ipl](https://github.com/Icinga/icingaweb2-module-ipl) (>=0.5.0) * [reactbundle](https://github.com/Icinga/icingaweb2-module-reactbundle) (>=0.9.0) -* A database, MySQL (>= 5.1) or PostgreSQL (>= 9.1). MariaDB and other - MySQL forks are also fine. Mentioned versions are the required minimum, - for MySQL we suggest using at least 5.5.3, for PostgreSQL 9.4. -* PHP (>= 5.6.3). For best performance please use 7.x or 8.x +* A database: MariaDB (>= 10.1), MySQL (>= 5.7), PostgreSQL (>= 9.6). Other + forks and older versions might work, but are neither tested not supported +* PHP (>= 7.3) + * Director v1.10 is the last version with support for PHP v5.6 * php-pdo-mysql and/or php-pdo-pgsql * php-curl * php-iconv diff --git a/doc/05-Upgrading.md b/doc/05-Upgrading.md index c2e4cc4c..63630b6b 100644 --- a/doc/05-Upgrading.md +++ b/doc/05-Upgrading.md @@ -5,7 +5,7 @@ Icinga Director is very upgrade-friendly. We never had any complaint referring data loss on upgrade. But to be on the safe side, please always [backup](#backup-first) your database before running an upgrade. -Then drop the new version to your Icinga Web 2 module folder and you're all done. +Then drop the new version to your Icinga Web 2 module folder, and you're all done. Eventually refresh the page in your browser[[1]](#footnote1), and you are ready to go. @@ -15,6 +15,7 @@ you will be told so in your frontend. Please read more about: * [Database Backup](#backup-first) +* [Upgrading to 1.10.x](#upgrade-to-1.10.x) * [Upgrading to 1.9.x](#upgrade-to-1.9.x) * [Upgrading to 1.8.x](#upgrade-to-1.8.x) * [Upgrading to 1.7.x](#upgrade-to-1.7.x) @@ -40,6 +41,17 @@ use the tools provided by your database backend, like `mysqldump` or `pg_dump`. Restoring from a backup is trivial, and Director will always be able to apply pending database migrations to an imported old database snapshot. +Upgrading to 1.10.x +-------------------------------------------------- + +Please check module dependencies, we raised some of them. In case you're missing +one of them, the Web UI will tell you after the upgrade. You'll then be prompted +to apply pending Database Migrations. + +PHP 7.3 is now claimed to be required, but we still support 5.6+ on Director +v1.10.x. Same goes for database dependencies: you should upgrade them to recent +versions, but v1.10 still works on the ones supported with v1.9.x. + Upgrading to 1.9.x ------------------------------------------------- diff --git a/doc/82-Changelog.md b/doc/82-Changelog.md index 9d923a04..155bc83a 100644 --- a/doc/82-Changelog.md +++ b/doc/82-Changelog.md @@ -8,8 +8,8 @@ v1.10.0 (unreleased) -------------------- ### Breaking Changes -* Module dependencies have been raised, [Upgrading](05-Upgrading.md) and - [Installation](02-Installation.md) documentations contain related details +* Module and system dependencies have been raised, [Upgrading](05-Upgrading.md) + and [Installation](02-Installation.md) documentations contain related details ### Fixed issues * You can find issues and feature requests related to this release on our diff --git a/module.info b/module.info index 3ecd20e7..05fb5832 100644 --- a/module.info +++ b/module.info @@ -1,6 +1,6 @@ Name: Icinga Director Version: master -Depends: reactbundle (>=0.9.0), ipl (>=0.5.0), incubator (>=0.12.0) +Depends: reactbundle (>=0.9.0), ipl (>=0.5.0), incubator (>=0.18.0) Description: Director - Config tool for Icinga 2 Icinga Director is a configuration tool that has been designed to make Icinga 2 configuration easy and understandable.