openstack
/
fuel-octane
Code Issues Proposed changes
RETIRED, Tools to upgrade OpenStack cloud managed by the Fuel installer.
1,391 Commits 3 Branches 0 Tags 12 MiB
Go to file
OpenDev Sysadmins 04fe4b929e OpenDev Migration Patch 
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
 		2019-04-19 19:31:02 +00:00
deploy Add transfer_snapshots method 2015-08-20 15:40:48 +03:00
misc Add all-in-one.sh script for creating all in one commits in Gerrit 2015-09-07 15:36:29 +03:00
octane Merge "Setup public ssl, ntp and dns only if it not setup" into stable/8.0 2016-11-22 09:55:09 +00:00
specs Include patches recursively in RPM package 2016-05-25 10:56:09 +00:00
.coveragerc Change ignore-errors to ignore_errors 2015-09-21 14:58:59 +00:00
.gitignore Properly ignore octane.log 2015-09-16 13:37:08 +03:00
.gitreview OpenDev Migration Patch 2019-04-19 19:31:02 +00:00
.mailmap Initial Cookiecutter Commit. 2015-07-15 11:14:34 +03:00
HACKING.rst Cleanup after cookiecutter 2015-07-15 12:23:13 +03:00
LICENSE Initial Cookiecutter Commit. 2015-07-15 11:14:34 +03:00
MAINTAINERS New maintainer in fuel-octane 2016-01-18 12:40:04 +03:00
MANIFEST.in Add octane/bin directory to manifest file 2016-05-23 13:54:57 +00:00
README.rst Update README file for version 8.0 2016-08-12 18:35:48 +00:00
other-requirements.txt Add binary requirements file 2016-04-12 09:58:17 +00:00
requirements.txt Pin version of python-fuelclient 2016-05-13 10:49:15 +00:00
setup.cfg Add cleanup command 2016-08-11 18:58:38 +00:00
setup.py Set pyzabbix as an optional dependency 2015-10-16 15:58:48 +03:00
test-requirements.txt Set pyzabbix as an optional dependency 2015-10-16 15:58:48 +03:00
tox.ini Prepare coverage target to gating 2016-09-13 09:51:21 +00:00

README.rst

octane

Octane - upgrade your Fuel.

Tool set to backup, restore and upgrade Fuel installer and OpenStack environments that it manages. This version of the toolset supports upgrade from version 7.0 to version 8.0.

Features

  • Backup the Fuel Master node configuraiton, OpenStack release bundles, metadata of environments and target nodes
  • Restore metadata of the Fuel Master node, environments and target nodes from previous backup
  • Upgrade OpenStack environment after upgrade of the Fuel Master node that manages it

Installation

Fuel Octane is installed on the Fuel Master node. Version of fuel-octane package must match the version of Fuel.

To download the latest version of fuel-octane package on the Fuel Master node, use the following command:

yum instal fuel-octane

Usage

Note

Make sure that you install a latest Maintenance Update onto Fuel 7.0 before making backup of configuration information.

Backup Fuel configuration

Use this command to backup configuration of the Fuel Master node, environments and target nodes:

octane fuel-backup --to=/path/to/backup.file.tar.gz

Backup Fuel repos and images

Use this command to backup packages and images for all supported OpenStack release bundles from the Fuel Master node:

octane fuel-repo-backup --full --to=/path/to/repo-backup.file.tar.gz

Restore Fuel configuration

Use this command to restore configuration of the Fuel Master node, environments and target nodes:

octane fuel-restore --from=/path/to/backup.file.tar.gz --admin-password=<passwod>

Replace <password> with appropriate password for user admin in your installation of Fuel.

Restore Fuel repos and images

Use this command to restore package repositories and images for OpenStack release bundbles from backup file:

octane fuel-repo-restore --from=/path/to/repo-backup.file.tar.gz

Upgrade Fuel Master node

Upgrade of Fuel Master node requires making both backups of configuration and repos and images from older Fuel, as described above. Copy those files to a secure location. After you create two backup files, install a new (8.0) version of Fuel on the same physical node or on a new one.

Note

Please, note that you must specify the same IP address for the new installation of the Fuel Master node as for the old one. Otherwise, target nodes won't be able to communicate with the new Fuel Master node.

Note

Make sure that you installed the latest available Maintenance Update onto the fresh installation of Fuel 8.0 before restoring configuration data on it.

Copy backup files to a new node from the secure location. Use octane to restore Fuel configuration and packages from backup files. Database schema will be upgraded according to migration scripts. See detailed commands above.

The Fuel Master node of new version must now have all configuration data from an old version of the Fuel Master node.

Upgrade OpenStack cluster

Install 9.0 Seed environment

Pick environment of version 7.0 that you want to upgrade. Run the following command and remember an ID of the environment you picked:

export SEED_ID=<ID>

Run command to create Upgrade Seed environment:

octane upgrade-env $SEED_ID

Remember ID of environment that will be shown:

export ORIG_ID=<ID>

Upgrade controller #1

Pick controller with minimal ID:

export $NODE_ID=<ID>

Run the following command to upgrade it:

octane upgrade-node --isolated $SEED_ID $NODE_ID

Upgrade DB

Run the following command to upgrade state database of OpenStack environment to be upgraded:

octane upgrade-db $ORID_ID $SEED_ID

Upgrade Ceph (OPTIONAL)

Run the command to upgrade Ceph cluster:

octane upgrade-ceph $ORIG_ID $SEED_ID

Upgrade Ceph OSDs (OPTIONAL)

Use this step only when upgrade from version 7.0 or less, and only if you plan to use live migration for minimal downtime.

The command below updates version of Ceph packages running on Ceph OSD nodes.

octane upgrade-osd [-h] --admin-password <PASSWORD> $ORIG_ID

Cutover to the updated control plane

The following command redirects all nodes in OpenStack cluster to talk to the new OpenStack Controller with upgraded version:

octane upgrade-control $ORIG_ID $SEED_ID

Upgrade controller #2 and #3

Run the following command to upgrade remaining controllers to version 8.0:

octane upgrade-node $SEED_ID $NODE_ID_2 $NODE_ID_3

Upgrade computes

Pick a compute node(s) to upgrade and remember their IDs.

export NODE_ID_1=<ID1>
...

Run the command to upgrade the compute node(s) without evacuating virtual machines:

octane upgrade-node --no-live-migration $SEED_ID $NODE_ID_1 ...

Run the command to upgrade the compute node(s) with evacuating virtual machines to other compute nodes in the environment via live migration:

octane upgrade-node $SEED_ID $NODE_ID_1 ...

Clean up the environment

Run the command to remove temporary configurations, including parameter upgrade_levels set in Nova configuration files at Controller and Compute nodes:

octane cleanup $SEED_ID