openstack/nova
Code Issues Proposed changes
2c4421568e
nova/doc/source/admin/configuration/resize.rst

40 lines
1.3 KiB
ReStructuredText
Raw Normal View History

FUP for docs nits in cross-cell-resize series Addresses review comments from: * https://review.opendev.org/#/c/638269/63/doc/source/admin/configuration/resize.rst * https://review.opendev.org/#/c/696212/6/doc/source/admin/configuration/cross-cell-resize.rst Also updates contributor/resize-and-cold-migrate since that is relatively new and biased toward same-cell resize and cold migrate. However, I chose to link the same-cell resize glossary term to that contributor doc rather than admin/configuration/resize because the admin doc is woefully bare. Part of blueprint cross-cell-resize Change-Id: I93b051252e34c8604cebea617c34e9299ac508d4
2019-12-16 12:50:07 -05:00
======
Resize
======
doc: Import configuration reference Import the following files from the former config-reference [1]: api.rst cells.rst fibre-channel.rst hypervisor-basics.rst hypervisor-hyper-v.rst hypervisor-kvm.rst hypervisor-lxc.rst hypervisor-qemu.rst hypervisor-virtuozzo.rst hypervisor-vmware.rst hypervisor-xen-api.rst hypervisor-xen-libvirt.rst hypervisors.rst index.rst iscsi-offload.rst logs.rst resize.rst samples/api-paste.ini.rst samples/index.rst samples/policy.yaml.rst samples/rootwrap.conf.rst schedulers.rst The below files are skipped as they're already included, in slightly different forms, in the nova documentation. config-options.rst nova-conf-samples.rst nova-conf.rst nova.conf Part of bp: doc-migration Change-Id: I145e38149bf20a5e068f8cfe913f90c7ebeaad36
2017-08-08 16:10:45 +01:00
Resize (or Server resize) is the ability to change the flavor of a server, thus
allowing it to upscale or downscale according to user needs. For this feature
to work properly, you might need to configure some underlying virt layers.
FUP for docs nits in cross-cell-resize series Addresses review comments from: * https://review.opendev.org/#/c/638269/63/doc/source/admin/configuration/resize.rst * https://review.opendev.org/#/c/696212/6/doc/source/admin/configuration/cross-cell-resize.rst Also updates contributor/resize-and-cold-migrate since that is relatively new and biased toward same-cell resize and cold migrate. However, I chose to link the same-cell resize glossary term to that contributor doc rather than admin/configuration/resize because the admin doc is woefully bare. Part of blueprint cross-cell-resize Change-Id: I93b051252e34c8604cebea617c34e9299ac508d4
2019-12-16 12:50:07 -05:00
This document describes how to configure hosts for standard resize.
For information on :term:`cross-cell resize <Cross-Cell Resize>`, refer to
:doc:`/admin/configuration/cross-cell-resize`.
Add cross-cell resize policy rule and enable in API This adds the "compute:servers:resize:cross_cell" policy rule which is now used in the API to determine if a resize or cold migrate operation can be performed across cells. The check in the API is based on: - The policy check passing for the request. - The minimum nova-compute service version being high enough across all cells to perform a cross-cell resize. If either of those conditions fail a traditional same-cell resize will be performed. A docs stub is added here and will be fleshed out in an upcoming patch. Implements blueprint cross-cell-resize Change-Id: Ie8a0f79a3b16e02b7a34a1b81f547013a3d88996
2019-02-20 16:13:05 -05:00
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-02-21 15:45:34 +09:00
Virt drivers
------------
.. todo:: This section needs to be updated for other virt drivers, shared
doc: fix resize user guide link The admin config resize doc was linking to a now non-existent user guide doc which was deleted in pike. This change imports the resize user guide from the openstack-manuals stable/ocata branch, fixes the link, and updates the resize user doc to (1) link to our internal shutdown_timeout config option reference and (2) link to the image properties doc in glance for the os_shutdown_timeout image property. Change-Id: I9988abfd344d1d3b0b6eaf32b036369b51853965 Closes-Bug: #1784715
2018-08-01 18:51:31 -04:00
storage considerations, etc.
doc: Import configuration reference Import the following files from the former config-reference [1]: api.rst cells.rst fibre-channel.rst hypervisor-basics.rst hypervisor-hyper-v.rst hypervisor-kvm.rst hypervisor-lxc.rst hypervisor-qemu.rst hypervisor-virtuozzo.rst hypervisor-vmware.rst hypervisor-xen-api.rst hypervisor-xen-libvirt.rst hypervisors.rst index.rst iscsi-offload.rst logs.rst resize.rst samples/api-paste.ini.rst samples/index.rst samples/policy.yaml.rst samples/rootwrap.conf.rst schedulers.rst The below files are skipped as they're already included, in slightly different forms, in the nova documentation. config-options.rst nova-conf-samples.rst nova-conf.rst nova.conf Part of bp: doc-migration Change-Id: I145e38149bf20a5e068f8cfe913f90c7ebeaad36
2017-08-08 16:10:45 +01:00
KVM
~~~
Resize on KVM is implemented currently by transferring the images between
compute nodes over ssh. For KVM you need hostnames to resolve properly and
passwordless ssh access between your compute hosts. Direct access from one
compute host to another is needed to copy the VM file across.
doc: fix resize user guide link The admin config resize doc was linking to a now non-existent user guide doc which was deleted in pike. This change imports the resize user guide from the openstack-manuals stable/ocata branch, fixes the link, and updates the resize user doc to (1) link to our internal shutdown_timeout config option reference and (2) link to the image properties doc in glance for the os_shutdown_timeout image property. Change-Id: I9988abfd344d1d3b0b6eaf32b036369b51853965 Closes-Bug: #1784715
2018-08-01 18:51:31 -04:00
Cloud end users can find out how to resize a server by reading
:doc:`/user/resize`.
doc: Import configuration reference Import the following files from the former config-reference [1]: api.rst cells.rst fibre-channel.rst hypervisor-basics.rst hypervisor-hyper-v.rst hypervisor-kvm.rst hypervisor-lxc.rst hypervisor-qemu.rst hypervisor-virtuozzo.rst hypervisor-vmware.rst hypervisor-xen-api.rst hypervisor-xen-libvirt.rst hypervisors.rst index.rst iscsi-offload.rst logs.rst resize.rst samples/api-paste.ini.rst samples/index.rst samples/policy.yaml.rst samples/rootwrap.conf.rst schedulers.rst The below files are skipped as they're already included, in slightly different forms, in the nova documentation. config-options.rst nova-conf-samples.rst nova-conf.rst nova.conf Part of bp: doc-migration Change-Id: I145e38149bf20a5e068f8cfe913f90c7ebeaad36
2017-08-08 16:10:45 +01:00
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-02-21 15:45:34 +09:00
Automatic confirm
-----------------
There is a periodic task configured by configuration option
:oslo.config:option:`resize_confirm_window` (in seconds).
If this value is not 0, the ``nova-compute`` service will check whether
servers are in a resized state longer than the value of
:oslo.config:option:`resize_confirm_window` and if so will automatically
confirm the resize of the servers.
Copy Permalink