95 lines
3.0 KiB
ReStructuredText
95 lines
3.0 KiB
ReStructuredText
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:
|
|
|
|
.. include:: ../repositories.txt
|
|
|
|
.. We need to manually continue our list numbering here since the above
|
|
"include" directive breaks the numbering.
|
|
|
|
3. Clean the yum cache to ensure only the new repos are used::
|
|
|
|
sudo yum clean all
|
|
|
|
#. Update required package:
|
|
|
|
.. admonition:: Validations
|
|
:class: 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"]}')
|
|
|
|
.. admonition:: Newton to Ocata
|
|
:class: ntoo
|
|
|
|
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
|
|
|
|
.. admonition:: Ocata to Pike
|
|
:class: otop
|
|
|
|
.. admonition:: Ceph
|
|
:class: 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.
|
|
|
|
.. _validations: ../validations/validations.html#running-a-group-of-validations
|
|
.. _tripleo-validations: https://github.com/openstack/tripleo-validations/tree/master/validations
|