ironic-inspector/doc/source/admin/upgrade.rst
dparalen 93d6f69f70 Introducing the installation content
Moving the installation and upgrade guides down the mandatory directory
structure.  Had to change the upgrade headline level.

Partial-Bug: 1702142

Change-Id: If00d2e3d90ac89421c51d1b1530d7cc685fad78f
2017-07-24 15:28:57 +01:00

29 lines
965 B
ReStructuredText

Upgrade Guide
-------------
The `release notes <http://docs.openstack.org/releasenotes/ironic-inspector/>`_
should always be read carefully when upgrading the ironic-inspector service.
Starting with the Mitaka series, specific upgrade steps and considerations are
well-documented in the release notes.
Upgrades are only supported one series at a time, or within a series.
Only offline (with downtime) upgrades are currently supported.
When upgrading ironic-inspector, the following steps should always be taken:
* Update ironic-inspector code, without restarting the service yet.
* Stop the ironic-inspector service.
* Run database migrations::
ironic-inspector-dbsync --config-file <PATH-TO-INSPECTOR.CONF> upgrade
* Start the ironic-inspector service.
* Upgrade the ironic-python-agent image used for introspection.
.. note::
There is no implicit upgrade order between ironic and ironic-inspector,
unless the `release notes`_ say otherwise.