x
/
nova-dpm
Code Issues Proposed changes

Updated help text for DPM config options for Nova. 

This change updates the help text for the DPM option group
and for most of the DPM options, to be more consistent, and to
use the official z Systems terminology.

Change-Id: I1906a20d8a0addd41fb439002e4fcd29464a98de
Partial-Bug: 1659201
Signed-off-by: Andreas Maier <maiera@de.ibm.com>
This commit is contained in:
Andreas Maier 2017-01-25 10:49:19 +01:00 committed by Andreas Scheuring
parent 474eb617f6
commit 44d5c02320
1 changed files with 25 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
nova_dpm/conf/dpm.py
View File

@ -18,36 +18,44 @@ from oslo_config import cfg
dpm_group = cfg.OptGroup('dpm',
title='DPM options',
help="""
PR/SM2 (in DPM mode) is a hypervisor. By using PR/SM2 hypervisor we can create
partition on IBM z Systems or IBM LinuxONE system. A partition
is a virtual representation of the hardware resources of a
z Systems or LinuxONE system.
Hardware Management Console (HMC) is a component of DPM by
using which we can create partitions.
DPM options are used when the compute_driver is set to use
DPM (compute_driver=dpm.HMCDriver).
The IBM z13 system generation (and IBM LinuxONE) introduced a new
administrative mode named "Dynamic Partition Manager" (DPM) that allows for
managing the firmware-based logical partition hypervisor (PR/SM) with the
dynamic capabilities known from software-based hypervisors. A z13 or LinuxONE
machine is termed CPC (Central Processor Complex). Its management access point
is the z Systems HMC (Hardware Management Console) which exposes a Web Services
API that is used by the Nova driver for DPM and by the Neutron agent for DPM.
One HMC can manage multiple CPCs.
DPM config options for the Nova compute service (one for each OpenStack
hypervisor host) specify the target CPC, the HMC managing it, and limits on the
resource usage on the target CPC. These limits ensure that only a subset of the
target CPC is used for the OpenStack hypervisor host. To use the Nova driver
for DPM, the `[DEFAULT].compute_driver` config option needs to be set to the
value `dpm.DPMDriver`.
""")
ALL_DPM_OPTS = [
cfg.StrOpt('hmc', default='', required=True, help="""
Hostname or IP address for connection to HMC via zhmcclient"""),
Hostname or IP address of the HMC that manages the target CPC"""),
cfg.StrOpt('hmc_username', default='', required=True, help="""
User name for connection to HMC Host."""),
User name for connection to the HMC"""),
cfg.StrOpt('hmc_password', default='', required=True, help="""
Password for connection to HMC Host."""),
Password for connection to the HMC"""),
cfg.StrOpt('host', default='', required=True, help="""
CpcSubset name"""),
Name of the OpenStack hypervisor host"""),
cfg.StrOpt('cpc_uuid', help="""
Uuid of the CPC"""),
Object-id of the target CPC"""),
cfg.IntOpt('max_processors', help="""
Maximum number of shared IFL processors available on CpcSubset"""),
Maximum number of shared physical IFL processors on the target CPC that can
be used for this OpenStack hypervisor host"""),
cfg.IntOpt('max_memory', help="""
Maximum amount of memory available on CpcSubset"""),
Maximum amount of memory (in MiB) on the target CPC that can be used for
this OpenStack hypervisor host"""),
cfg.IntOpt('max_instances', help="""
Maximum number of instances that can be created on CpcSubset"""),
Maximum number of instances (partitions) that can be created for this
OpenStack hypervisor host"""),
cfg.StrOpt('physical_storage_adapter_mappings', help="""
Physical storage adapter with port details for hba creation""")
]