From ff6d8a2095bf563685284cc41899f1c645a67b14 Mon Sep 17 00:00:00 2001
From: Jason Greathouse <jgreat@jgreat.me>
Date: Fri, 24 Aug 2018 14:33:03 -0500
Subject: [PATCH] Rename rke-add-ons upgrade doc, add helm upgrade procedure

---
 .../v2.x/en/upgrades/upgrades/_index.md       |  3 +-
 .../upgrades/ha-server-upgrade-helm/_index.md | 61 +++++++++++++++++++
 .../upgrades/ha-server-upgrade/_index.md      |  4 +-
 3 files changed, 65 insertions(+), 3 deletions(-)
 create mode 100644 content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade-helm/_index.md

diff --git a/content/rancher/v2.x/en/upgrades/upgrades/_index.md b/content/rancher/v2.x/en/upgrades/upgrades/_index.md
index fd0d80c242b..47fbe637a70 100644
--- a/content/rancher/v2.x/en/upgrades/upgrades/_index.md
+++ b/content/rancher/v2.x/en/upgrades/upgrades/_index.md
@@ -6,5 +6,6 @@ This section contains information about how to upgrade your Rancher server to a
 
 - [Upgrading a Single Node Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/single-node-upgrade/)
 - [Upgrading an Air Gapped Single Node Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/single-node-air-gap-upgrade/)
-- [Upgrading a High Availability Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade/)
+- [Upgrading a High Availability Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade-helm/)
 - [Migrating from a High Availability RKE Add-on Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/)
+- [Upgrading a High Availability Install - RKE Add-On Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade/)
\ No newline at end of file
diff --git a/content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade-helm/_index.md b/content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade-helm/_index.md
new file mode 100644
index 00000000000..2b7d02f311a
--- /dev/null
+++ b/content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade-helm/_index.md
@@ -0,0 +1,61 @@
+---
+title: High Availability (HA) Upgrade
+weight: 1020
+---
+
+The following instructions will help guide you through upgrading Rancher server [HA installed with the Helm package manager]({{< baseurl >}}/rancher/v2.x/en/installation/ha/).
+
+If you installed Rancher using the RKE Add-On yaml, see these docs to migrate or upgrade.
+
+* [Migrating from RKE Add-On Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/migrating-from-rke-add-on)
+* [High Availability (HA) Upgrade - RKE Add-On Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/ha-server-upgrade)
+
+## Prerequisites
+
+### kubectl
+
+Follow the `kubectl` configuration instructions and confirm that you can connect to the Kubernetes cluster running Rancher server.
+
+* [kubectl Installation and Config]({{< baseurl >}}/rancher/v2.x/en/faq/kubectl)
+
+### helm
+
+Install or update `helm` to the latest version.
+
+* [Installing helm](https://docs.helm.sh/using_helm/#installing-helm)
+
+### tiller
+
+Update the helm agent, `tiller` on your cluster.
+
+```
+helm init --upgrade --service-account tiller
+```
+
+## Backup Your Rancher Cluster
+
+Follow the instructions to take a one-time snapshot of your Rancher server cluster.
+
+* [HA Backups: Take a One-Time Snapshot]({{< baseurl >}}/rancher/v2.x/en/backups/backups/ha-backups/#option-b-one-time-snapshots)
+
+## Upgrade Rancher
+
+Update your local helm repo cache.
+
+```
+helm repo update
+```
+
+Get the set values from current Rancher release.
+
+```
+helm get values rancher
+
+hostname: rancher.my.org
+```
+
+Take the values above and use `helm` with `--set` options to upgrade Rancher to the latest version.
+
+```
+helm upgrade rancher rancher-stable/rancher --set hostname=rancher.my.org
+```
diff --git a/content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade/_index.md b/content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade/_index.md
index 416ada0d3a3..e8ba0f1a945 100644
--- a/content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade/_index.md
+++ b/content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade/_index.md
@@ -1,6 +1,6 @@
 ---
-title: High Availability (HA) Upgrade
-weight: 1020
+title: High Availability (HA) Upgrade - RKE Add-on
+weight: 1040
 aliases:
   - /rancher/v2.x/en/upgrades/ha-server-upgrade/
 ---