diff options
| author | Jenkins <jenkins@review.openstack.org> | 2015-04-10 17:47:53 +0000 |
|---|---|---|
| committer | Gerrit Code Review <review@openstack.org> | 2015-04-10 17:47:53 +0000 |
| commit | aa2cf65e4db36184e538885656f98e753fa6a768 (patch) | |
| tree | b99e3991a6af65b1dc23f9f5f0d143ec1f5c5b6b | |
| parent | c4e790148feb461b944735986fc7e512213c92f5 (diff) | |
| parent | 995999730ac563d61b0c8357e3796ff874df7a69 (diff) | |
| download | ironic-aa2cf65e4db36184e538885656f98e753fa6a768.tar.gz | |
Merge "Add notes about upgrading juno->kilo to docs"
| -rw-r--r-- | doc/source/deploy/upgrade-guide.rst | 36 | ||||
| -rw-r--r-- | doc/source/index.rst | 1 |
2 files changed, 37 insertions, 0 deletions
diff --git a/doc/source/deploy/upgrade-guide.rst b/doc/source/deploy/upgrade-guide.rst new file mode 100644 index 000000000..2ce9e0952 --- /dev/null +++ b/doc/source/deploy/upgrade-guide.rst @@ -0,0 +1,36 @@ +.. _upgrade-guide: + +===================================== +Bare Metal Service Upgrade Guide +===================================== + +This document outlines various steps and notes for operators to consider when +upgrading their Ironic-driven clouds from previous versions of OpenStack. + +The Ironic service is tightly coupled with the Ironic driver that is shipped +with Nova. Currently, some special considerations must be taken into account +when upgrading your cloud from previous versions of OpenStack. + +Upgrading from Juno to Kilo +=========================== + +When upgrading a cloud from Juno to Kilo, users must ensure the Nova +service is upgraded prior to upgrading the Ironic service. Additionally, +users need to set a special config flag in Nova prior to upgrading to ensure +the newer version of Nova is not attempting to take advantage of new Ironic +features until the Ironic service has been upgraded. The steps for upgrading +your Nova and Ironic services are as follows: + +- Edit nova.conf and ensure force_config_drive=False is set in the [DEFAULT] + group. Restart nova-compute if necessary. +- Install new Nova code, run database migrations +- Install new python-ironicclient code. +- Restart Nova services. +- Install new Ironic code, run database migrations, restart Ironic services. +- Edit nova.conf and set force_config_drive to your liking, restaring + nova-compute if necessary. + +Note that during the period between Nova's upgrade and Ironic's upgrades, +instances can still be provisioned to nodes, however, any attempt by users +to specify a config drive for an instance will cause error until Ironic's +upgrade has completed. diff --git a/doc/source/index.rst b/doc/source/index.rst index a3339207d..7ea533fdb 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -57,6 +57,7 @@ Overview deploy/user-guide deploy/install-guide + deploy/upgrade-guide deploy/drivers deploy/cleaning |