Upgrade an OpenStack environment to a new major release

Registered by David J. Easter on 2014-04-16

The goal of this user story is to investigate the methods available for upgrading and creating a more turnkey upgrade process.

Current approach (7.0) assumes that the new environment created alongside with the old one. Control plane of the new environment is used to replace the original one.

Proposed approach is to refrain from creating new environment:
* Upgrade is performed on the node level.
* Environment settings are updated during upgrade of the Fuel Master itself
* New control plane installed alongside with the existing one.
* Nodes are reinstalled without moving data.

Blueprint information

Status:
Complete
Approver:
Fuel Core Team
Priority:
Essential
Drafter:
Oleg S. Gelbukh
Direction:
Approved
Assignee:
None
Definition:
Approved
Series goal:
Accepted for mitaka
Implementation:
Implemented
Milestone target:
milestone icon 9.0
Started by
Oleg S. Gelbukh on 2015-04-16
Completed by
Alexey Shtokolov on 2016-09-27

Related branches

Sprints

Whiteboard

[Dmitry Borodaenko 2014-10-28]
Manual in-place upgrade process is described in this blog post:
https://www.mirantis.com/blog/yes-can-upgrade-openstack-heres/

[Oleg Gelbukh 2015-04-16]
First iteration is upgrade 5.1.1 to 6.0 as semi-automatic scripted procedure.

Gerrit topic: https://review.openstack.org/#q,topic:bug/1455032,n,z

Addressed by: https://review.openstack.org/183058
    Experimental upgrade of environment 5.1.1 to 6.0

Gerrit topic: https://review.openstack.org/#q,topic:bp/upgrade-major-openstack-environment,n,z

Addressed by: https://review.openstack.org/185136
    Upgrade MOS environment major release specification

Gerrit topic: https://review.openstack.org/#q,topic:bug/1479469,n,z

Addressed by: https://review.openstack.org/207142
    Experimental upgrade of environment 5.1.1 to 6.1

Addressed by: https://review.openstack.org/214648
    Upgrade the OpenStack environment 6.1 to 7.0

Addressed by: https://review.openstack.org/240547
    Rename ClusterUpgradeHandler

Addressed by: https://review.openstack.org/240548
    Add ClusterUpgradeHandler

Addressed by: https://review.openstack.org/224302
    Spec for integrated upgrade of OpenStack to liberty-8.0

Addressed by: https://review.openstack.org/272734
    [upgrade] Spec for upgrade of cluster's metadata to version 9.0

Addressed by: https://review.openstack.org/276854
    Add relation between nodes and releases

Addressed by: https://review.openstack.org/277932
    Remove obsolete patches

Addressed by: https://review.openstack.org/278063
    Move scripts to bin/ directory

Addressed by: https://review.openstack.org/280067
    Reassign nodes without reinstallation

Addressed by: https://review.openstack.org/289691
    Use the 9.0 release in tests for cluster_upgrade

Gerrit topic: https://review.openstack.org/#q,topic:bug/1602587,n,z

Addressed by: https://review.openstack.org/360086
    Merge master into stable/mitaka

Gerrit topic: https://review.openstack.org/#q,topic:bug/1616925,n,z

Addressed by: https://review.openstack.org/367019
    Merge branch stable/mitaka into master

Addressed by: https://review.openstack.org/367419
    Merge remote-tracking branch 'gerrit/stable/mitaka'

(?)

Work Items

Work items:
5.1.1 to 6.0 upgrade guide document: DONE
5.1.1 to 6.1 upgrade script and documentation: DONE
6.1 to 7.0 upgrade script: DONE

Dependency tree

* Blueprints in grey have been implemented.

This blueprint contains Public information 
Everyone can see this information.