From 335c29c4103a5a2ffa214bf806e2291b51e1bd01 Mon Sep 17 00:00:00 2001 From: Sriharsha Chintalapani Date: Tue, 4 Oct 2022 13:34:18 -0700 Subject: [PATCH] Fix Upgrade Index doc (#7947) --- .../content/deployment/upgrade/index.md | 58 ++++--------------- .../content/deployment/upgrade/kubernetes.md | 22 +++---- 2 files changed, 23 insertions(+), 57 deletions(-) diff --git a/openmetadata-docs/content/deployment/upgrade/index.md b/openmetadata-docs/content/deployment/upgrade/index.md index d2518899c0c..0a2aeb6716a 100644 --- a/openmetadata-docs/content/deployment/upgrade/index.md +++ b/openmetadata-docs/content/deployment/upgrade/index.md @@ -11,19 +11,12 @@ OpenMetadata community will be doing feature releases and stable releases. - Feature releases are to upgrade your sandbox or POCs to give feedback to the community and any potential bugs that the community needs to fix. - Stable releases are to upgrade your production environments and share it with your users. -## 0.12.0 - Feature release +## 0.12.1 - Stable release - OpenMetadata 0.12.0 is a feature release ** Please do not upgrade your production ** + OpenMetadata 0.12.1 is a stable release. For Release notes please check here Join our slack https://slack.open-metadata.org provide your feedback and help community to get to the stable 0.12.1 release -## 0.12.0 - Known Issues -- Upgrade Issues - https://github.com/open-metadata/OpenMetadata/issues/7504 -- Bots listing page not showing Ingestion Bot account - https://github.com/open-metadata/OpenMetadata/issues/7539 -- UI- Search Filter malfunction - https://github.com/open-metadata/OpenMetadata/issues/7313 - - - ## Backup Metadata @@ -48,6 +41,15 @@ to the following guide for our backup utility: Once your metadata is safe, follow the required upgrade instructions: + + Upgrade your Kubernetes installation + + Upgrade your Bare Metal installation - - Upgrade your Kubernetes installation - -## Upgrade for a specific version - -You can find further information about specific version upgrades in the following sections: - - - - Upgrade from 0.11 to 0.12 inplace. - - - Upgrade from 0.10 to 0.11 inplace. - - - Upgrade from 0.9 to 0.10. This is a backward incompatible upgrade! - - diff --git a/openmetadata-docs/content/deployment/upgrade/kubernetes.md b/openmetadata-docs/content/deployment/upgrade/kubernetes.md index 2a5ca8d0d97..f9330e7522f 100644 --- a/openmetadata-docs/content/deployment/upgrade/kubernetes.md +++ b/openmetadata-docs/content/deployment/upgrade/kubernetes.md @@ -79,33 +79,34 @@ open-metadata/openmetadata-dependencies 0.0.34 0.11.4 Helm Dependenc ## Upgrade OpenMetadata Dependencies - -We have upgraded the Airflow version from 2.1.4 to 2.3.3 with OpenMetadata `0.12.X` releases. Before you start upgrading OpenMetadata Dependencies, it is adviced to follow airflow migration docs [here](/deployment/upgrade/bare-metal#upgrade-ingestion-container). +### Step 1: Upgrade Airfow - +We have **upgraded the Airflow version from 2.1.4 to 2.3.3** with OpenMetadata `0.12.X` releases. -Upgrade OpenMetadata Dependencies with the below command: +Before you start upgrading OpenMetadata Dependencies, you must follow airflow migration docs [here](/deployment/upgrade/bare-metal#upgrade-ingestion-container) to upgrade Airflow. + + +### Step 2: Upgrade OpenMetadata Dependencies with the below command ```commandline helm upgrade openmetadata-dependencies open-metadata/openmetadata-dependencies ``` - The above command uses configurations defined [here](https://raw.githubusercontent.com/open-metadata/openmetadata-helm-charts/main/charts/deps/values.yaml). You can modify any configuration and deploy by passing your own `values.yaml`. - - +### Step 3: Troubleshooting If your helm upgrade fails with the below command result - ``` Error: UPGRADE FAILED: cannot patch "mysql" with kind StatefulSet: StatefulSet.apps "mysql" is invalid: spec: Forbidden: updates to statefulset spec for fields other than 'replicas', 'template', 'updateStrategy', 'persistentVolumeClaimRetentionPolicy' and 'minReadySeconds' are forbidden ``` -This is probably because with `0.12.1`, we have default size of mysql persistence set to 50Gi. +This is probably because with `0.12.1`, we have **default size of mysql persistence set to 50Gi**. + Kubernetes does not allow changes to Persistent volume with helm upgrades. In order to work around this issue, you can either default the persistence size to 8Gi or run the below command which will patch Persistent Volumes and Persistent Volume Claims for mysql helm and then run the above `helm upgrade` command. @@ -115,8 +116,6 @@ kubectl patch pvc data-mysql-0 -p '{"spec":{"resources":{"requests":{"storage":" kubectl patch pv -p '{"spec":{"storage":"50Gi"}}' ``` - - Make sure that, when using your own `values.yaml`, you are not overwriting elements such as the `image` of the containers. @@ -148,6 +147,9 @@ We have added a conditional suggestion mapping for all of the elasticsearch inde Click on the "Recreate Indexes" lable and click "Re Index All" + + + ## Troubleshooting for 0.12 Release ### Using custom helm values