From eced288e22ff90338210d9aba08c5c364f15d24c Mon Sep 17 00:00:00 2001 From: Summer Long Date: Mon, 21 Apr 2014 11:12:36 +1000 Subject: [PATCH] Added random-number generator info for instance creation Added hw_rng_model to image property keys and hw_rng information for flavors. Updated values to use uppercase, per new convention. Closes-bug: #1284835 Change-Id: I44b3f4fd03cd542e328e8334ded3379e4114cffd --- .../ch_cli_glance_property_keys.xml | 16 ++++++++-- .../section_cli_nova_customize_flavors.xml | 29 ++++++++++++++++--- 2 files changed, 39 insertions(+), 6 deletions(-) diff --git a/doc/cli-reference/ch_cli_glance_property_keys.xml b/doc/cli-reference/ch_cli_glance_property_keys.xml index 575a22d06c..3d7383eff6 100644 --- a/doc/cli-reference/ch_cli_glance_property_keys.xml +++ b/doc/cli-reference/ch_cli_glance_property_keys.xml @@ -15,9 +15,13 @@ with the option for both the glance image-update and glance image-create commands. For example: - $ glance image-update img-uuid --property architecture=x86_64 + $ glance image-update IMG-UUID --property architecture=x86_64 Behavior set using image properties overrides - behavior set using flavors. + behavior set using flavors. For more information, refer to + + OpenStack Cloud Administrator Guide + @@ -217,6 +221,14 @@ + + + + + + diff --git a/doc/common/section_cli_nova_customize_flavors.xml b/doc/common/section_cli_nova_customize_flavors.xml index c107dccd78..85fbc93103 100644 --- a/doc/common/section_cli_nova_customize_flavors.xml +++ b/doc/common/section_cli_nova_customize_flavors.xml @@ -46,7 +46,7 @@ @@ -106,7 +106,8 @@
Property keys
libvirt API driverhw_rng_modelAdds a random-number generator device to the image's instances. The cloud + administrator can enable and control device behavior by configuring the + instance's flavor. By default, the generator device is disabled.virtio
libvirt API driver hw_video_model
Name A descriptive name. - xx.size_name + XX.SIZE_NAME is typically not required, though some third party tools may rely on it.
Flavor customization can be limited by the hypervisor in use. For example the libvirt driver enables quotas on CPUs available to a VM, disk - tuning, bandwidth I/O, watchdog behavior, and instance VIF traffic control. + tuning, bandwidth I/O, watchdog behavior, random number generator device control, and + instance VIF traffic control. CPU limits You can configure the CPU limits with control parameters with the nova @@ -225,8 +226,8 @@ hw_watchdog_action is not specified, the watchdog is disabled. To set the behavior, use: - $ nova flavor-key flavorName set hw_watchdog_action=action - Valid action values are: + $ nova flavor-key FLAVOR-NAME set hw_watchdog_action=ACTION + Valid ACTION values are: disabled—(default) The device is not @@ -251,6 +252,26 @@ flavors. + + Random-number generator + If a random-number generator device has been added to the instance through its image + properties, the device can be enabled and configured using: + $ nova flavor-key FLAVOR-NAME set hw_rng:allowed=True +$ nova flavor-key FLAVOR-NAME set hw_rng:rate_bytes=RATE-BYTES +$ nova flavor-key FLAVOR-NAME set hw_rng:rate_period=RATE-PERIOD + Where: + + + RATE-BYTES—(Integer) Allowed amount of + bytes that the guest can read from the host's entropy per period. + + + RATE-PERIOD—(Integer) Duration of the + read period in seconds. + + + + Instance VIF traffic control Flavors can also be assigned to particular projects. By default, a flavor is public and available to all projects.