public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-09-25 12:38:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1112 from niusmallnan/upgrade-notes

Browse Source 
Add upgrading notes for ROS
This commit is contained in:
Denise
2019-01-25 09:53:51 -08:00
committed by GitHub
parent 3d1bcc7f33 f800fc2355
commit 6dd0cc07fe
1 changed files with 28 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/os/v1.x/en/upgrading/_index.md
+28 -1
View File
@@ -7,7 +7,7 @@ If RancherOS has released a new version and you want to learn how to upgrade you
Since RancherOS is a kernel and initrd, the upgrade process is downloading a new kernel and initrd, and updating the boot loader to point to it. The old kernel and initrd are not removed. If there is a problem with your upgrade, you can select the old kernel from the Syslinux bootloader.
To see all of our releases, please visit our [releases page](https://github.com/rancher/os/releases) in GitHub.
Before upgrading to any version, please review the release notes on our [releases page](https://github.com/rancher/os/releases) in GitHub to review any updates in the release.
> **Note:** If you are using [`docker-machine`]({{< baseurl >}}/os/v1.x/en/installation/running-rancheros/workstation/docker-machine/) then you will not be able to upgrade your RancherOS version. You need to delete and re-create the machine.
@@ -135,3 +135,30 @@ rancher:
url: https://releases.rancher.com/os/releases.yml
image: rancher/os
```
### Upgrade Notes for v1.4.0+
If you are upgrading to v1.4.0+, please review these notes that could alter your RancherOS settings.
Due to changes in the location of user-docker's data-root, after upgrading to v1.4.0+, you must move or copy the files of user-docker's data-root. If you do not do this, your data will *NOT* be available.
```
#!/bin/bash
old_docker_root="/proc/1/root/var/lib/docker"
new_docker_root="/proc/1/root/var/lib/user-docker"
system-docker stop docker
cp -a $old_docker_root/* $new_docker_root
system-docker start docker
```
If you had another bridge IP set for system-docker, you may need to explicitly set it again depending on your upgrade path. Before re-setting it, you can confirm if it's set.
```
# Check to see if docker bridge IP is set
$ sudo ros config get rancher.system_docker.bip
# If it is no longer set, re-set the setting
$ sudo ros config set rancher.system_docker.bip 10.0.0.1/16
```