openstack/openstack-manuals
Code Issues Proposed changes

[ops] Improves the procedure workflow

Browse Source 
Addresses the comments to https://review.openstack.org/#/c/323349

* s/utilizing/using
* Replaces "next", "then", "finally", etc., with the numbered list.

Change-Id: Iaf2b63e44cc3abd61f69298b7dbe49885b0b5336
This commit is contained in:
OlgaGusarenko 2016-06-01 10:29:09 +03:00 committed by Olena Logvinova
parent 11f20c19c8
commit 023d6ab6fd
1 changed files with 44 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

86
doc/ops-guide/source/ops_maintenance_compute.rst
View File

@ -8,75 +8,77 @@ reboot for maintenance reasons.
Planned Maintenance
~~~~~~~~~~~~~~~~~~~
If you need to reboot a compute node due to planned maintenance (such as
a software or hardware upgrade), first disable scheduling of new VMs to
the node, optionally providing a reason comment:
If you need to reboot a compute node due to planned maintenance, such as
a software or hardware upgrade, perform the following steps:
.. code-block:: console
#. Disable scheduling of new VMs to the node, optionally providing a reason
comment:
# nova service-disable --reason maintenance c01.example.com nova-compute
.. code-block:: console
Next, ensure that all hosted instances have been moved off the node. If your
cloud is utilizing shared storage, use the :command:`nova live-migration`
command. First, get a list of instances that need to be moved:
# nova service-disable --reason maintenance c01.example.com nova-compute
.. code-block:: console
#. Verify that all hosted instances have been moved off the node:
# nova list --host c01.example.com --all-tenants
* If your cloud is using a shared storage:
Next, migrate them one by one:
#. Get a list of instances that need to be moved:
.. code-block:: console
.. code-block:: console
# nova live-migration <uuid> c02.example.com
# nova list --host c01.example.com --all-tenants
If you are not using shared storage, you can use the
:option:`--block-migrate` option:
#. Migrate all instances one by one:
.. code-block:: console
.. code-block:: console
# nova live-migration --block-migrate <uuid> c02.example.com
# nova live-migration <uuid> c02.example.com
After you have migrated all instances, ensure that the ``nova-compute``
service has stopped:
* If your cloud is not using a shared storage, run:
.. code-block:: console
.. code-block:: console
# stop nova-compute
# nova live-migration --block-migrate <uuid> c02.example.com
If you use a configuration-management system, such as Puppet, that
ensures the ``nova-compute`` service is always running, you can
temporarily move the ``init`` files:
#. Stop the ``nova-compute`` service:
.. code-block:: console
.. code-block:: console
# mkdir /root/tmp
# mv /etc/init/nova-compute.conf /root/tmp
# mv /etc/init.d/nova-compute /root/tmp
# stop nova-compute
Next, shut down your compute node, perform your maintenance, and turn
the node back on. You can reenable the ``nova-compute`` service by
undoing the previous commands:
If you use a configuration-management system, such as Puppet, that
ensures the ``nova-compute`` service is always running, you can
temporarily move the ``init`` files:
.. code-block:: console
.. code-block:: console
# mv /root/tmp/nova-compute.conf /etc/init
# mv /root/tmp/nova-compute /etc/init.d/
# mkdir /root/tmp
# mv /etc/init/nova-compute.conf /root/tmp
# mv /etc/init.d/nova-compute /root/tmp
Then start the ``nova-compute`` service:
#. Shut down your compute node, perform the maintenance, and turn
the node back on.
.. code-block:: console
#. Start the ``nova-compute`` service:
# start nova-compute
.. code-block:: console
Finally, enable scheduling of VMs to the node:
# start nova-compute
.. code-block:: console
You can re-enable the ``nova-compute`` service by undoing the commands:
# nova service-enable c01.example.com nova-compute
.. code-block:: console
You can now optionally migrate the instances back to their original
compute node.
# mv /root/tmp/nova-compute.conf /etc/init
# mv /root/tmp/nova-compute /etc/init.d/
#. Enable scheduling of VMs to the node:
.. code-block:: console
# nova service-enable c01.example.com nova-compute
#. Optionally, migrate the instances back to their original compute node.
After a Compute Node Reboots
~~~~~~~~~~~~~~~~~~~~~~~~~~~~