From 40932fa33d82af77a135b09f7fb06eedb6a595ce Mon Sep 17 00:00:00 2001
From: Eric Lippmann <eric.lippmann@icinga.com>
Date: Fri, 12 Nov 2021 13:49:18 +0100
Subject: [PATCH] Add upgrading docs

---
 README.md           | 14 --------------
 doc/04-Upgrading.md | 21 +++++++++++++++++++++
 2 files changed, 21 insertions(+), 14 deletions(-)
 create mode 100644 doc/04-Upgrading.md

diff --git a/README.md b/README.md
index 4b1504f0..e7e5342e 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,3 @@
-# IMPORTANT (28.05.2021)
-
-> :warning: **We've changed a lot to prepare for Icinga DB 1.0.0 RC2** :warning:
-
-You will have to do the following steps to upgrade Icinga DB to the current master:
- 
-1. Completely stop Icinga 2 and Icinga DB
-2. Flush your Redis (`redis-cli flushall`) - We made a lot of changes to our Redis schema, so this is necessary
-3. Upgrade Icinga 2 to the latest snapshot/master
-4. Upgrade Icinga DB to latest master
-5. Upgrade the Icinga DB SQL schema (`mysql icingadb < schema/mysql/upgrades/1.0.0-rc2.sql`)
-6. Copy `config.yml.example` to `config.yml` and change it to your needs (The config file has changed and we don't use the old `icingadb.ini` config anymore)
-7. Start Icinga 2 and Icinga DB (For Icinga DB use `go run cmd/icingadb/main.go`)
-
 # Icinga DB
 
 ![Icinga Logo](https://icinga.com/wp-content/uploads/2014/06/icinga_logo.png)
diff --git a/doc/04-Upgrading.md b/doc/04-Upgrading.md
new file mode 100644
index 00000000..37f40844
--- /dev/null
+++ b/doc/04-Upgrading.md
@@ -0,0 +1,21 @@
+# Upgrading Icinga DB <a id="upgrading"></a>
+
+## Upgrading to Icinga DB RC2
+
+Icinga DB RC2 is a complete rewrite compared to RC1. Because of this, a lot has changed in the Redis and database
+schema, which is why they have to be deleted and recreated. The configuration file has changed from `icingadb.ini`
+to `config.yml`. Instead of the INI format, we are now using YAML and have introduced more configuration options. We
+have also changed the packages of `icingadb-redis`, which is why the Redis CLI commands are now prefixed with `icingadb`
+instead of just `icinga`, i.e. the Redis CLI is now accessed via `icingadb-redis-cli`.
+
+Please follow the steps below to upgrade to Icinga DB RC2:
+
+1. Stop Icinga 2 and Icinga DB.
+2. Flush your Redis instances using `icinga-redis-cli flushall` (note the `icinga` prefix as we did not
+   upgrade `icingadb-redis` yet) and stop them afterwards.
+3. Upgrade Icinga 2 to version 2.13.2 or newer.
+4. Remove the `icinga-redis` package where installed as it may conflict with `icingadb-redis`.
+5. Install Icinga DB Redis (`icingadb-redis`) on your primary Icinga 2 nodes to version 6.2.6 or newer.
+6. Upgrade Icinga DB to RC2.
+7. Drop the Icinga DB MySQL database and recreate it using the provided schema.
+8. Start Icinga DB Redis, Icinga 2 and Icinga DB.