From 30c87c5a9d246b4500d66720f1282f79bb2c1dae Mon Sep 17 00:00:00 2001 From: Matthew Edmonds Date: Fri, 18 May 2018 15:00:05 -0400 Subject: [PATCH] Update PowerVM hypervisor docs This refreshes the PowerVM hypervisor docs with a clearer flow and additional information. Change-Id: I0b33200b710960e4e8df7333d06c98456c4b0c00 --- .../configuration/hypervisor-powervm.rst | 63 +++++++++++++------ 1 file changed, 43 insertions(+), 20 deletions(-) diff --git a/doc/source/admin/configuration/hypervisor-powervm.rst b/doc/source/admin/configuration/hypervisor-powervm.rst index 1c42e86e49dd..415b3bf87202 100644 --- a/doc/source/admin/configuration/hypervisor-powervm.rst +++ b/doc/source/admin/configuration/hypervisor-powervm.rst @@ -1,34 +1,57 @@ PowerVM ======= -Usage ------ -To make use of the PowerVM compute driver, a PowerVM system set up with -`NovaLink`_ is required. +Introduction +------------ +OpenStack Compute supports the PowerVM hypervisor through `NovaLink`_. In the +NovaLink architecture, a thin NovaLink virtual machine running on the Power +system manages virtualization for that system. The ``nova-compute`` service +can be installed on the NovaLink virtual machine and configured to use the +PowerVM compute driver. No external management element (e.g. Hardware +Management Console) is needed. .. _NovaLink: https://www.ibm.com/support/knowledgecenter/en/POWER8/p8eig/p8eig_kickoff.htm -Installing the NovaLink software creates the ``pvm_admin`` group. In -order to function properly, the user executing the Nova compute service must -be a member of this group. Use the ``usermod`` command to add the user. For -example, to add the user ``stacker`` to the ``pvm_admin`` group, execute:: +Configuration +------------- +In order to function properly, the ``nova-compute`` service must be executed +by a member of the ``pvm_admin`` group. Use the ``usermod`` command to add the +user. For example, to add the ``stacker`` user to the ``pvm_admin`` group, execute:: sudo usermod -a -G pvm_admin stacker The user must re-login for the change to take effect. -The NovaLink architecture is such that the compute driver runs directly on the -PowerVM system. No external management element (e.g. Hardware Management -Console or PowerVC) is needed. Management of the virtualization is driven -through a thin virtual machine running on the PowerVM system. +To enable the PowerVM compute driver, set the following configuration option +in the ``/etc/nova/nova.conf`` file: -Configuration of the PowerVM system and NovaLink is required ahead of time. If -the operator is using volumes or Shared Storage Pools, they are required to be -configured ahead of time. +.. code-block:: ini + [Default] + compute_driver = powervm.PowerVMDriver -Configuration File Options --------------------------- -After nova has been installed the user must enable PowerVM as the compute -driver. To do so, set the ``compute_driver`` value in the ``nova.conf`` file -to ``compute_driver = powervm.driver.PowerVMDriver``. +The PowerVM driver supports two types of storage for ephemeral disks: +``localdisk`` or ``ssp``. If ``localdisk`` is selected, you must specify which +volume group should be used. E.g.: + +.. code-block:: ini + + [powervm] + disk_driver = localdisk + volume_group_name = openstackvg + +.. note:: + + Using the ``rootvg`` volume group is strongly discouraged since ``rootvg`` + is used by the management partition and filling this will cause failures. + +The PowerVM driver also supports configuring the default amount of physical +processor compute power (known as "proc units") which will be given to each +vCPU. This value will be used if the requested flavor does not specify the +``powervm:proc_units`` extra-spec. A factor value of 1.0 means a whole physical +processor, whereas 0.05 means 1/20th of a physical processor. E.g.: + +.. code-block:: ini + + [powervm] + proc_units_factor = 0.1