Commit Graph

15 Commits

Author SHA1 Message Date
Samriddhi Jain 459f078d0c Reorganised keystone documentation structure
Divided the keystone docs into four categories, depending
upon the usage criteria: general information (which will
be common for all), developer documentation,
user documantation and operator documentation.

Change-Id: I2f5dd41acd9874739accc54c4f4fd69460b58334
2017-06-22 13:26:46 +05:30
Dolph Mathews e6ef702f22 Doc db_sync --expand incurring downtime in upgrades to Newton
The current implementation of db_sync --expand automatically runs any
outstanding legacy operations to ensure it's safety. However, that
behavior also means that legacy migrations may violate the safety
assumptions around --expand.

This is only true for Mitaka to Newton upgrades, as there should not be
any newer migrations in the legacy repository to be triggered by this
behavior.

[1] 0ebd557325/keystone/common/sql/upgrades.py (L269-L271)

Change-Id: Ib175f7fce96011d77eb4783123cb2d265d60aa42
Closes-Bug: 1676925
2017-03-28 15:40:30 +00:00
Richard Avelar 99db3c83e0 Address db_sync check against new install
This patch fixes a bug and causes a log message along with an exit
code to be returned when a DBMigration error is raised.

Change-Id: Iba7aff606937561ad98e2ef551ca4005bd4f337d
Closes-Bug: #1663627
2017-02-14 16:10:19 +00:00
“Richard d5ce8ea0ed Add --check to keystone-manage db_sync command
This patch adds a new command to the db_sync upgrade commands. --check
will check the current state of the users upgrade repos and relay info
back to the user based on what version each command is currently at and
if the user has any outstanding db_sync commands left to run. It will
also notify the user if the db_sync commands were not upgraded in order

Closes-Bug: 1642212
Change-Id: I79d3640a780d624f14059fe311fafa0542c03357
2017-02-09 19:45:02 +00:00
Eric Brown 30d9095d28 Use https for docs.openstack.org references
The openstack.org pages now support https and our references to
the site should by default be one signed by the organization.

Change-Id: I30a462e03d1fd7852511e22cac34c6bc0e8917f4
2017-01-30 16:05:08 -08:00
Jenkins 12ff43cbf1 Merge "Doc warning for keystone db migration" 2016-11-08 20:16:55 +00:00
Richard Avelar 52f58eb4df Doc warning for keystone db migration
The new keystone upgrade features (keystone-manage db_sync --expand)
requires for MySQL deployments that the keystone user is granted SUPER
privilege or that set global log_bin_trust function_creators=1; is run.
Adding a warning message to notify reader.

Change-Id: I78738a335d14c6ad824c348a7385bb1ee8ad75bf
Closes-Bug: 1638368
2016-11-08 16:34:56 +00:00
Richard Avelar 08e9ba9b96 Wording error in upgrading documentation
small doc word fix

Change-Id: I3795aa0b7f1b3069d37be019abba55303c9d2e0a
2016-11-07 19:08:21 +00:00
Eric Brown 4d08a1c015 Fix for unindent warning in doc build
Trivial fix for the following:

/home/ericwb/keystone/doc/source/upgrading.rst:115: WARNING:
Enumerated list ends without a blank line; unexpected unindent.

Partial-Bug: #1602422
Change-Id: Ia1e65267440df6dd43e7b5fe47f86f871a13975d
2016-09-20 03:09:43 +00:00
Matt Fischer 9418f2609f New notes on advanced upgrade/fallback for cluster
For clustered Keystone nodes it's possible to optimize the upgrade
process to minimize downtime. Additionally a process to quickly restore
after a failed upgrade are described.

Change-Id: I746d46a968dd887b0559644f91ae207055146390
2016-09-08 20:51:19 +00:00
Jenkins 5685990287 Merge "Doc fix: "keystone-manage upgrade" is not a thing" 2016-08-25 04:26:46 +00:00
Dolph Mathews 5ae761e8e3 Doc fix: license rendered in published doc
This wasn't indented correctly, so it ended up being rendered in the
HTML as plain text:

  http://docs.openstack.org/developer/keystone/upgrading.html

Change-Id: I3f7f43484abaf128a5a2d3c3f120df9c4951b856
2016-08-23 10:35:33 -05:00
Dolph Mathews 52b2503e55 Doc fix: "keystone-manage upgrade" is not a thing
This was part of Henry's initial patch, which ended up just being part
of db_sync instead.

Change-Id: Ibbfec6d665e59a0195a425f75a108819d42a946d
2016-08-23 10:17:59 -05:00
Dolph Mathews a5e2906dc4 Add rolling upgrade documentation
This documentation conflicts a bit with the approach originally proposed
in bp manage-migration because it depends on the notion of having
database triggers to assist in the migration process.

Change-Id: Iec9269ab6d799b757451cb8afe7fa889fe7068b9
2016-08-18 16:15:13 +00:00
Dolph Mathews ff00d33e9b Add basic upgrade documentation
Rolling upgrades are being introduced in the Newton release, which will
substantially impact the process that deployers will have to follow to
upgrade keystone.

This will provide us a basis for documenting rolling upgrades (also,
it's about time we documented our current process).

bp manage-migration

Change-Id: I5a37c781b83967b12cda60b054c612df3c3cb697
2016-08-08 16:12:24 -05:00