Manual upgrades¶

Check out the Newton release¶

Ensure your OpenStack-Ansible code is on the latest Newton tagged release.

# git checkout 14.0.1

Prepare the shell variables¶

From the openstack-ansible root directory, run the following commands:

# export MAIN_PATH="$(pwd)"
# export SCRIPTS_PATH="${MAIN_PATH}/scripts"
# export UPGRADE_PLAYBOOKS="${SCRIPTS_PATH}/upgrade-utilities/playbooks"

These variables reduce typing when running the remaining upgrade tasks.

Re-bootstrap Ansible for Newton¶

Bootstrapping Ansible again ensures that all OpenStack-Ansible role dependencies are in place before running playbooks from the Newton release.

# ${SCRIPTS_PATH}/bootstrap-ansible.sh

Change to playbooks directory¶

Change to the playbooks directory so that the OpenStack-Ansible dynamic inventory is found automatically.

# cd playbooks

Pre-flight checks¶

Before starting with the new version, you should do pre-flight checks to ensure everything is fine. If any of those check fail, the upgrade should stop to let the deployer chose what to do.

Making sure LBaaS v1 isn’t in the way¶

Because LBaaS was deprecated, this playbook checks if it was previously deployed, and fails if this is the case.

See lbaas-version-check.yml for more details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/lbaas-version-check.yml"

Cleanup old facts¶

Some configuration changed, and old facts should be purged before the upgrade.

See ansible_fact_cleanup.yml for more details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/ansible_fact_cleanup.yml"

Update configuration and environment files¶

The user configuration files in /etc/openstack_deploy/ and the environment layout in /etc/openstack_deploy/env.d have new name values added in Newton.

See deploy-config-changes.yml for more details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/deploy-config-changes.yml"

Update user secrets file¶

Newton introduces new user secrets to the stack. These are populated automatically with the following playbook.

See user-secrets-adjustment.yml for more details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/user-secrets-adjustment.yml"

Cleanup old MariaDB apt repositories¶

The default MariaDB apt repositories have been changed to use HTTP instead of HTTPS. This playbook removes existing repositories of the previous default.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/mariadb-apt-cleanup.yml"

Update database collations¶

The default database collation has been changed to utf8_general_ci. This play performs a conversion on existing databases and tables.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/db-collation-alter.yml"

Cleanup pip.conf file¶

The presence of pip.conf file can cause build failures when upgrading to Newton. This play removes the pip.conf file on all the physical servers and on the repo containers.

See pip-conf-removal.yml for more details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/pip-conf-removal.yml"

Upgrade hosts¶

Before installing the infrastructure and OpenStack, update the host machines.

# openstack-ansible setup-hosts.yml --limit '!galera_all'

This command is the same as doing host setups on a new install. The galera_all host group is excluded to prevent reconfiguration and restarting of any Galera containers.

Update Galera LXC container configuration¶

Update the Galera container configuration independently.

# openstack-ansible lxc-containers-create.yml -e \
'lxc_container_allow_restarts=false' --limit galera_all

This command is a subset of the host setup playbook, limited to the galera_all host group. The configuration of those containers will be updated but a restart for any changes to take effect will be deferred to a later playbook.

Perform a controlled rolling restart of the galera containers¶

Restart containers one at a time, ensuring that each is up, responding, and synced with the other nodes in the cluster, before moving on to the next. This step allows the lxc container config applied earlier to take effect, ensuring that the containers are restarted in a controlled fashion.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/galera-cluster-rolling-restart.yml"

Update HAProxy configuration¶

Install and update any new or changed HAProxy service configurations.

# openstack-ansible haproxy-install.yml

Update repo servers¶

Update the configuration of the repo servers and build new packages required by the Newton release.

# openstack-ansible repo-install.yml

Ensure hostname aliases are created for non-RFC1034/35 hostnames¶

Ensure an alias is created for non-RFC1034/35 hostnames.

See old-hostname-compatibility.yml for details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/old-hostname-compatibility.yml"

Perform a mariadb version upgrade¶

Update mariadb to the most 10.0 minor release across the cluster.

# openstack-ansible galera-install.yml -e 'galera_upgrade=true'

Upgrade infrastructure¶

The following commands perform all steps from the setup-infrastructure playbook, except for repo-install.yml`, haproxyinstall.yml, and galera-install.yml` which we ran earlier. Running these playbook applies the relevant Newton settings and packages.

For certain versions of Mitaka, you must upgrade the RabbitMQ service.

See setup-infrastructure.yml for details.

# openstack-ansible memcached-install.yml
# openstack-ansible rabbitmq-install.yml -e 'rabbitmq_upgrade=true'
# openstack-ansible utility-install.yml
# openstack-ansible rsyslog-install.yml

Flush Memcached cache¶

See memcached-flush.yml for details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/memcached-flush.yml"

Stop and remove aodh-api service¶

See aodh-api-init-delete.yml for details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/aodh-api-init-delete.yml"

Stop and remove ceilometer-api service¶

See ceilometer-api-init-delete.yml for details.

# openstack-ansible "${UPGRADE_PLAYBOOKS}/ceilometer-api-init-delete.yml"

Upgrade OpenStack¶

Upgrade the OpenStack components with the same installation playbook, without any additional options.

# openstack-ansible setup-openstack.yml