Jose Luis Franco Arza 159cce3c4a Unify undercloud upgrade steps

The steps needed to upgrade the undercloud were
specified in two different files. This commit
updates the steps to cover O to P from commit
496223 in the 'Undercloud Installation' section
and reuses that doc file for the 'Upgrading to
a Next Major Release'.

As an addition, a new class 'otop' has been
added to include specific documentation sections
when upgrading from Ocata to Pike.

Change-Id: I9097ca11a95f94c5eaf580fb8a82b3173d606a5d

2017-10-17 15:25:38 +02:00

3.0 KiB

Raw Blame History

Updating Undercloud Components

You can upgrade any packages that are installed on the undercloud machine.

Remove all Delorean repositories:

Note

You may wish to backup your current repos before disabling them:

mkdir /home/stack/REPOBACKUP
sudo mv /etc/yum.repos.d/delorean* /home/stack/REPOBACKUP

sudo rm /etc/yum.repos.d/delorean*

Enable new Delorean repositories:

Clean the yum cache to ensure only the new repos are used:
```
sudo yum clean all
```
Update required package:
Validations

It is strongly recommended that you validate the state of your undercloud before starting any upgrade operations. The tripleo-validations repo has some 'pre-upgrade' validations that you can execute by following the instructions at validations to execute the "pre-upgrade" group:
```
mistral execution-get-output $(openstack workflow execution create -f value -c ID tripleo.validations.v1.run_groups '{"group_names": ["pre-upgrade"]}')
```
Newton to Ocata

The following commands need to be run before the undercloud upgrade:
```
sudo systemctl stop openstack-*
sudo systemctl stop neutron-*
sudo systemctl stop openvswitch
sudo systemctl stop httpd
sudo yum -y update instack-undercloud openstack-puppet-modules openstack-tripleo-common
```
Ocata to Pike
Ceph

Prior to Pike, TripleO deployed Ceph with puppet-ceph. With the Pike release it is possible to use TripleO to deploy Ceph with either ceph-ansible or puppet-ceph, though puppet-ceph is deprecated. To use ceph-ansible, the CentOS Storage SIG Ceph repository must be enabled on the undercloud and the ceph-ansible package must then be installed:
```
sudo yum -y install --enablerepo=extras centos-release-ceph-jewel
sudo yum -y install ceph-ansible
```
Update TripleO CLI package:
```
sudo yum -y update python-tripleoclient
```
Run the undercloud upgrade command. This command will upgrade all packages and use puppet to apply new configuration and restart all OpenStack services:
```
openstack undercloud upgrade
```
Note

You may wish to use time and capture the output to a file for any debug:
```
time openstack undercloud upgrade 2>&1 | tee undercloud_upgrade.log
```
Note

If you added custom OVS ports to the undercloud (e.g. in a virtual testing environment) you may need to re-add them at this point.

3.0 KiB Raw Blame History

Updating Undercloud Components

3.0 KiB

Raw Blame History