ivampiresp/longhorn
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update upgrade.md

Browse Source
This commit is contained in:
Sheng Yang 2019-01-15 10:26:56 -08:00 committed by GitHub
parent fb540f2f86
commit f61d6392eb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/upgrade.md
View File

@ -240,7 +240,7 @@ approximately the same for all workloads.
**ALWAYS MAKE BACKUPS BEFORE UPGRADE THE ENGINE IMAGES.** **ALWAYS MAKE BACKUPS BEFORE UPGRADE THE ENGINE IMAGES.**
### Offline upgrade ### Offline upgrade
If live upgrade is not available (e.g. from v0.1/v0.2 to v0.3): If live upgrade is not available (e.g. from v0.1/v0.2 to v0.3), or the volume stuck in degraded state:
1. Follow [the detach procedure for relevant workloads](upgrade.md#detach-volumes). 1. Follow [the detach procedure for relevant workloads](upgrade.md#detach-volumes).
2. Select all the volumes using batch selection. Click batch operation button 2. Select all the volumes using batch selection. Click batch operation button
`Upgrade Engine`, choose the engine image available in the list. It's `Upgrade Engine`, choose the engine image available in the list. It's
@ -248,12 +248,15 @@ the default engine shipped with the manager for this release.
3. Resume all workloads by reversing the [detach volumes procedure](upgrade.md#detach-volumes). 3. Resume all workloads by reversing the [detach volumes procedure](upgrade.md#detach-volumes).
Any volume not part of a Kubernetes workload must be attached from Longhorn UI. Any volume not part of a Kubernetes workload must be attached from Longhorn UI.
### Live upgrade (expermential feature since v0.3.3) ### Live upgrade (beta feature since v0.3.3)
1. Select the volume you want to upgrade. Live upgrade should only be done with healthy volumes.
2. Click `Upgrade Engine` in the drop down. 2. Select the volume you want to upgrade.
3. Select the engine image you want to upgrade to. 3. Click `Upgrade Engine` in the drop down.
4. Select the engine image you want to upgrade to.
1. Normally it's the only engine image in the list, since the UI exclude the current image from the list. 1. Normally it's the only engine image in the list, since the UI exclude the current image from the list.
4. Click OK. 5. Click OK.
During the live upgrade, the user will see double number of the replicas temporarily. After upgrade complete, the user should see the same number of the replicas as before, and the `Engine Image` field of the volume should be updated.
### Clean up the old image ### Clean up the old image
After you've done upgrade for all the images, select `Settings/Engine Image` from Longhorn UI. Now you should able to remove the non-default image. After you've done upgrade for all the images, select `Settings/Engine Image` from Longhorn UI. Now you should able to remove the non-default image.