97cd1ccd3d
Remove a lot of noise and make things more generic through use of variables rather than hardcoded values. Change-Id: Ief498f902f24e5991cf463323db78729ae6f8d89 Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
59 lines
2.2 KiB
ReStructuredText
59 lines
2.2 KiB
ReStructuredText
==================
|
|
Resize an instance
|
|
==================
|
|
|
|
You can change the size of an instance by changing its flavor. This rebuilds
|
|
the instance and therefore results in a restart.
|
|
|
|
To resize an instance, use the :command:`openstack server resize` command:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server resize --flavor FLAVOR SERVER
|
|
|
|
.. note::
|
|
|
|
By default, the :command:`openstack server resize` command gives
|
|
the guest operating
|
|
system a chance to perform a controlled shutdown before the instance
|
|
is powered off and the instance is resized.
|
|
The shutdown behavior is configured by the
|
|
:oslo.config:option:`shutdown_timeout` parameter that can be set in the
|
|
``nova.conf`` file. Its value stands for the overall
|
|
period (in seconds) a guest operating system is allowed
|
|
to complete the shutdown. The default timeout is 60 seconds.
|
|
|
|
The timeout value can be overridden on a per image basis
|
|
by means of ``os_shutdown_timeout`` that is an image metadata
|
|
setting allowing different types of operating systems to specify
|
|
how much time they need to shut down cleanly. See
|
|
:glance-doc:`Useful image properties <admin/useful-image-properties>`
|
|
for details.
|
|
|
|
Resizing can take some time.
|
|
During this time, the instance status will be ``RESIZE``:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server list
|
|
+----------------------+----------------+--------+-----------------------------------------+
|
|
| ID | Name | Status | Networks |
|
|
+----------------------+----------------+--------+-----------------------------------------+
|
|
| 67bc9a9a-5928-47c... | myCirrosServer | RESIZE | admin_internal_net=192.168.111.139 |
|
|
+----------------------+----------------+--------+-----------------------------------------+
|
|
|
|
When the resize completes, the instance status will be ``VERIFY_RESIZE``.
|
|
You can now confirm the resize to change the status to ``ACTIVE``:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server resize --confirm SERVER
|
|
|
|
If the resize fails or does not work as expected, you can revert the resize.
|
|
This will revert the instance to the old flavor and change the status to
|
|
``ACTIVE``:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server resize --revert SERVER
|