openstack/keystone
Code Issues Proposed changes

Merge "Doc fix: "keystone-manage upgrade" is not a thing"

Browse Source
This commit is contained in:
Jenkins
2016-08-25 04:26:46 +00:00
committed by Gerrit Code Review
parent 62f0f31dee 52b2503e55
commit 5685990287
1 changed files with 9 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
doc/source/upgrading.rst
View File

@@ -81,11 +81,12 @@ Upgrading without downtime
-------------------------- --------------------------
This is a high-level description of our upgrade strategy built around This is a high-level description of our upgrade strategy built around
``keystone-manage upgrade``. Although it is much more complex than the upgrade additional options in ``keystone-manage db_sync``. Although it is much more
process described above, it assumes that you are not willing to have downtime complex than the upgrade process described above, it assumes that you are not
of your control plane during the upgrade process. With this upgrade process, willing to have downtime of your control plane during the upgrade process. With
end users will still be able to authenticate to receive tokens normally, and this upgrade process, end users will still be able to authenticate to receive
other OpenStack services will still be able to authenticate requests normally. tokens normally, and other OpenStack services will still be able to
authenticate requests normally.
#. Make a backup of your database. Keystone does not support downgrading the #. Make a backup of your database. Keystone does not support downgrading the
database, so restoring from a full backup is your only option for recovery database, so restoring from a full backup is your only option for recovery
@@ -104,7 +105,7 @@ other OpenStack services will still be able to authenticate requests normally.
diagnose symptoms of common deployment issues and receive instructions for diagnose symptoms of common deployment issues and receive instructions for
resolving them. resolving them.
#. Run ``keystone-manage upgrade --expand`` on the first node to expand the #. Run ``keystone-manage db_sync --expand`` on the first node to expand the
database schema to a superset of what both the previous and next release can database schema to a superset of what both the previous and next release can
utilize, and create triggers to facilitate the live migration process. utilize, and create triggers to facilitate the live migration process.
@@ -116,7 +117,7 @@ other OpenStack services will still be able to authenticate requests normally.
triggers will live migrate the data to the new schema so it can be read by triggers will live migrate the data to the new schema so it can be read by
the next release. the next release.
#. Run ``keystone-manage upgrade --migrate`` on the first node to forcefully #. Run ``keystone-manage db_sync --migrate`` on the first node to forcefully
perform data migrations. This process will migrate all data from the old perform data migrations. This process will migrate all data from the old
schema to the new schema while the previous release continues to operate schema to the new schema while the previous release continues to operate
normally. normally.
@@ -136,7 +137,7 @@ other OpenStack services will still be able to authenticate requests normally.
As the next release begins writing to the new schema, database triggers will As the next release begins writing to the new schema, database triggers will
also migrate the data to the old schema, keeping both data schemas in sync. also migrate the data to the old schema, keeping both data schemas in sync.
#. Run ``keystone-manage upgrade --contract`` to remove the old schema and all #. Run ``keystone-manage db_sync --contract`` to remove the old schema and all
data migration triggers. data migration triggers.
When this process completes, the database will no longer be able to support When this process completes, the database will no longer be able to support