Upgrade guide needs to be made generic and improved

[Jay Faulkner]

The existing upgrade guide, at http://docs.openstack.org/developer/ironic/deploy/upgrade-guide.html has a few issues that need to be addressed:

1) It's been the longstanding upgrade policy that Ironic gets upgraded before all other services. This is not indicated in our upgrade guide; it should be.
2) The guide should be rearranged to contain generic steps/process, and then specific notes on upgrading from one release to another. These specific notes should be pulled from upgrade: tagged release notes.
3) The upgrade guide is missing all support for Mitaka. Notes for Liberty -> Mitaka upgrade should be added as part of this change.

[Sam Betts (sambetts)]

We may also now need upgrade note for Mitaka to Newton.

[Jay Faulkner (jason-oldos)]

Hey Rama,

Are there any patches up for this bug yet? I don't see any linked in the bug.

Thanks!
Jay

[Ramamani Yeleswarapu (ramamani-yeleswarapu)]

Hi Jay,

I posted a patch: https://review.openstack.org/#/c/439196/3

Thanks,
Rama.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/439196
Committed: https://git.openstack.org/cgit/openstack/ironic/commit/?id=77f3b3391ecd98f8bab2105fd47dc70b32136ea9
Submitter: Jenkins
Branch: master

commit 77f3b3391ecd98f8bab2105fd47dc70b32136ea9
Author: Ramamani Yeleswarapu <email address hidden>
Date: Tue Feb 28 14:32:07 2017 -0800

    Update the Ironic Upgrade guide

    This patch does the following:

    - streamlines the upgrade information
    - adds headers for L->M, M->N and N->O upgrades.

    Partial-Bug: #1606675
    Change-Id: I0cdf423ed1bf302f2c721e87cec291712f3f18d3

[Ruby Loo (rloo)]

I closed this bug. Most, if not all, of the issues have been addressed. I think if there are other issues, we should open new bugs for them. Thanks!