openstack/nova
Code Issues Proposed changes
64b99bd853
nova/doc/source/user/resize.rst
Takashi NATSUME 5fdcb2ca49 Remove wrong description for auto resize confirm 
Remove wrong description for auto resize confirm
in the API guide.
Move a description of a configuration option
'resize_confirm_window' from the API guide
to the admin configuration guide.
Add a description of automatic resize confirm
in the user guide.

Change-Id: If739877422d5743e221c57be53ed877475db0647
Closes-Bug: #1816859
2019-03-03 20:03:09 +00:00

2.3 KiB
Raw Blame History

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 openstack server resize command:

$ openstack server resize --flavor FLAVOR SERVER

Note

By default, the 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.configshutdown_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 Useful image properties <admin/useful-image-properties> for details.

Resizing can take some time. During this time, the instance status will be RESIZE:

$ 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:

$ openstack server resize --confirm SERVER

Note

The resized server may be automatically confirmed based on the administrator's configuration of the deployment.

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:

$ openstack server resize --revert SERVER