Document migration path from grizzly to havana

[Lorin Hochstein]

We need to document the process of migrating/upgrading a grizzly deployment to havana.

Setting importance to "High" since this is pretty important for release.

[Stephen Gordon (sgordon)]

- Quantum -> Neutron?
- Nova API upgrade?

[Stephen Gordon (sgordon)]

I think in general what we need is a "generic" upgrade process template that we would then bolt release specific steps into. Effectively

- Stop services.
- Upgrade code.
- Upgrade databases.
- Release specific steps?
- Start services.

Here is an example of what I did for Grizzly, but I'm not sure I would consider it exhaustive:

https://access.redhat.com/site/documentation/en-US/Red_Hat_OpenStack/3/html-single/Release_Notes/index.html#chap-OpenStackNotes-Upgrading

This kind of procedure is also only really suited to relatively small deployments. Users are likely interested in how to perform a staggered upgrade of a larger/more realistic deployment.

[Jon Proulx (jproulx)]

seems to me https://wiki.openstack.org/wiki/ReleaseNotes/Havana#General_Upgrade_Notes is a good place for something like Stephen's "generic upgrade process"

as a cloud admin/operator that's where I'd look and the release/project specific upgrade notes should be in line in the same document.

I think the amount of variation between sites precludes and exhaustive step by step procedural description.

[Tom Fifield (fifieldt)]

yay for Jon back on docs!

We also have to remember: http://docs.openstack.org/trunk/openstack-ops/content/maintenance.html#upgrades :)

[Summer Long (slong-g)]

And I have an RH Havana process. Tom, where was the upgrade put in for Grizzly? Only in the Ops Guide? Perhaps in the Install Guide?

[Anne Gentle (annegentle)]

Only in the Ops Guide. It hasn't ever been in an Install Guide. It has been in the old Compute Admin Manual.

[Anne Gentle (annegentle)]

Also, upgrade notes are supposed to be put in release notes in the wiki. I can dig up examples if needed.

[Summer Long (slong-g)]

After talk with Anne, will put in wiki, as well as updating the generic process in Ops guide if need be.

[Tom Fifield (fifieldt)]

Another tidbit:

Following the migration, we found that nova image-list and glance image-list were showing different results.

The root cause was related to the bug https://bugs.launchpad.net/glance/+bug/1152716. The fix for the problem was to add the policy statement for the parameter context_is_admin which is needed to limit access to private images for projects.

[Anne Gentle (annegentle)]

https://review.openstack.org/#/c/68936

[Matt Kassawara (ionosphere80)]

Can we set this to "in progress" status?

[Summer Long (slong-g)]

Can't figure out a way to assing Matt...https://launchpad.net/~ionosphere80. Have taken myself off at least.