nova/doc/source
Dan Smith 104c9e6375 Clarify/correct the ordering of API and Cell database schema updates
Everyone seems to agree that the only sane ordering of these operations
is "api first, cell after." However, grenade and our own documentation
shows the api database as coming after the main one. I believe this
was added to grenade in a sort of append operation, and thus after the
main database. This was done back when usage of the API database was
still optional (for upgrades) and thus the ordering didn't matter much.
Since the process has been correct (api first) in devstack for a long
time, and since grenade runs after devstack, we haven't had any issues.
A recent change to add something to a core data structure column format
highlighted the out-of-order-ness of this.

I also believe the docs got the same append behavior when adding the
command to the list, and/or it may have been copied from grenade, which
is our in-code manifestation of the upgrade steps.

Change-Id: I19f263ed314a8b01bbb07337467392cc1c146b66
Related-Bug: #1761775
2018-04-06 08:24:33 -07:00
..
_extra doc: merge numa.rst to cpu-topologies.rst 2018-02-10 17:50:16 +09:00
_static Improve stable-api doc with current API state 2017-08-09 14:13:17 +00:00
admin Merge "Update the cells FAQs and scheduler maintenance docs." 2018-04-05 23:16:22 +00:00
cli Merge "Add --enable and --disable options to nova-manage update_cell" 2018-04-05 23:16:13 +00:00
configuration Fix the format file name 2017-11-27 11:43:41 +07:00
contributor [placement] Add to contributor docs about handler testing 2018-03-30 11:30:52 +01:00
figures XenAPI: update the picture in Xen hypervisor document 2017-12-06 22:20:11 -08:00
install Merge "Re-work the metadata service docs" 2018-03-13 21:44:45 +00:00
reference update_provider_tree devref and docstring updates 2018-04-05 09:09:26 -05:00
user Clarify/correct the ordering of API and Cell database schema updates 2018-04-06 08:24:33 -07:00
conf.py tox: Make everything work with Python 3 2018-03-28 12:57:24 +01:00
index.rst update_provider_tree devref and docstring updates 2018-04-05 09:09:26 -05:00