From b8956f03623a748c566e9f779e78f8959267d38e Mon Sep 17 00:00:00 2001
From: Varac <varac@varac.net>
Date: Tue, 17 Dec 2019 15:36:47 +0100
Subject: [PATCH] Start upgrading doc

---
 docs/index.rst    |  1 +
 docs/upgrading.md | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)
 create mode 100644 docs/upgrading.md

diff --git a/docs/index.rst b/docs/index.rst
index b10a8df90..68d3da6c0 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -27,6 +27,7 @@ For more information, go to `the OpenAppStack website`_.
    :caption: Contents:
 
    installation_instructions
+   upgrading
    testing_instructions
    design
    reference
diff --git a/docs/upgrading.md b/docs/upgrading.md
new file mode 100644
index 000000000..5e54888c9
--- /dev/null
+++ b/docs/upgrading.md
@@ -0,0 +1,18 @@
+# Upgrading OpenAppStack
+
+## From versions earlier than 0.2.3
+
+Upgrading from versions earlier than `0.2.3` requires manual
+intervention.
+
+* Move your local `settings.yml` file to a different location:
+
+    ```
+    cd CLUSTER_DIR
+    mkdir ./group_vars/all
+    mv settings.yml ./group_vars/all/
+    ```
+
+* remove all helm charts (WARNING: Please backup all data before!):
+
+    `helm delete --purge oas-prod-cert-manager oas-prod-local-storage oas-prod-prometheus oas-prod-proxy`
-- 
GitLab