Package: pypowervm
NOTECurrent versions should utilize the local authentication mechanism.  The remote
authentication mechanism is intended only for development and test purposes for
the time being.Overviewpypowervm provides a Python-based API wrapper for interaction with IBM
PowerVM-based systems.LicenseThe library’s license can be found in theLICENSEfile.  It must be
reviewed prior to use.Project Structuredebian/: Debian packaging metadata and controls.pypowervm/: Project source code.helpers/: Decorator methods suitable for passing to thehelpersparameter of thepypowervm.adapter.Adapterinitializer.locale/: Translated message files for internationalization (I18N).tasks/: Modules for performing complex tasks on PowerVM objects.monitor/: Modules for tasks specific to the PowerVM Performance and
Capacity Monitoring (PCM) API.tests/: Functional and unit tests.  The directory and file structure
mirrors that of the project code.  For example, tests for modulepypowervm/wrappers/logical_partition.pycan be found inpypowervm/tests/wrappers/test_logical_partition.py.data/: Data files used by test cases.  These are generally XML dumps
obtained from real PowerVM REST API servers, often via the utilities
found inpypowervm/tests/test_utils/.helpers/: Tests for modules underpypowervm/helpers/.locale/: Directory structure containing sample
internationalization (I18N) files for I18N testing.tasks/: Tests for modules underpypowervm/tasks/.monitor/: Tests for modules underpypowervm/tasks/monitor/.test_utils/: Utilities useful for test development and implementation.utils/: Tests for modules underpypowervm/utils/.wrappers/: Tests for modules underpypowervm/wrappers/.pcm/: Tests for modules underpypowervm/wrappers/pcm/.utils/: Common helper utilities.wrappers/: Modules presenting intuitive hierarchical views and controls
on PowerVM REST objects.  Simple operations involving getting or setting single,
independent attributes on an object are handled by the wrappers defined here.pcm/: Wrapper modules specific to the PowerVM Performance and Capacity
Monitoring (PCM) API.Using SonarTo enable sonar code scans through tox there are a few steps involved.Install sonar locally.  See:http://www.sonarqube.org/downloads/Create a host mapping in /etc/hosts for the name ‘sonar-server’. If the
sonar server were on the local host then the entry might be:127.0.0.1  sonar-serverAlternatively, you can set the environment variable SONAR_SERVER prior to
invoking tox, to specify the server to use.The following environment variable must be set in order to log onto the
sonar server:SONAR_USER
SONAR_PASSWORDAn example invocation:# SONAR_USER=user SONAR_PASSWORD=password tox -e sonarSonar output is placed in:.sonar/Developer NotesThe propertypypowervm.base_partition.IOSlot.adapteris deprecated and
will be removed no sooner than January 1st, 2017.  It has been replaced by
thepypowervm.base_partition.IOSlot.io_adapterproperty.  Removal will
break compatibility with PowerVC 1.3.0.0 and 1.3.0.1.  The issue is resolved
as of PowerVC 1.3.0.2.Thexagargument to thepypowervm.wrappers.entry_wrapper.EntryWrapper.updatemethod is deprecated and will be removed no sooner than January 1st, 2017.Thexagsmember of thepypowervm.wrappers.virtual_io_server.VIOSclass is deprecated and will be removed no sooner than January 1st, 2017.
Please use the members ofpypowervm.const.XAGinstead.Remote Restart in a NovaLink environment is handled by the consuming
management layer, not by NovaLink itself.  As such, the propertiesrr_enabledandrr_stateofpypowervm.wrappers.logical_partition.LPARshould not be used.  These properties are now deprecated and will be removed
no sooner than January 1st, 2017.  Use thesrr_enabledproperty instead.The methodpypowervm.tasks.storage.crt_lu_linked_cloneis deprecated and
will be removed no sooner than January 1st, 2017.  You should now use thepypowervm.tasks.storage.crt_lumethod to create a linked clone by passing
the source image LU wrapper via thecloneparameter.The Adapter cache is removed as of release 1.0.0.4.  Attempting to
create an Adapter withuse_cache=Truewill result in aCacheNotSupportedException.The propertypypowervm.wrappers.managed_system.IOSlot.pci_sub_dev_idis
deprecated and will be removed no sooner than January 1st, 2019. It has been
replaced by thepypowervm.wrappers.managed_system.IOSlot.pci_subsys_dev_idproperty.The propertypypowervm.wrappers.managed_system.IOSlot.pci_revision_idis
deprecated and will be removed no sooner than January 1st, 2019. It has been
replaced by thepypowervm.wrappers.managed_system.IOSlot.pci_rev_idproperty.The propertypypowervm.wrappers.managed_system.IOSlot.pci_sub_vendor_idis
deprecated and will be removed no sooner than January 1st, 2019. It has been
replaced by thepypowervm.wrappers.managed_system.IOSlot.pci_subsys_vendor_idproperty.The propertypypowervm.wrappers.managed_system.IOSlot.dyn_reconfig_conn_indexis deprecated and will be removed no sooner than January 1st, 2019. It has
been replaced by thepypowervm.wrappers.managed_system.IOSlot.drc_indexproperty.The propertypypowervm.wrappers.managed_system.IOSlot.dyn_reconfig_conn_nameis deprecated and will be removed no sooner than January 1st, 2019. It has been
replaced by thepypowervm.wrappers.managed_system.IOSlot.drc_nameproperty.Passing an arbitrary dictionary into the add_parms argument ofpypowervm.tasks.power.power_onandpower_offis deprecated.  Consumers
should migrate to usingpypowervm.tasks.power_opts.PowerOnOptsandPowerOffOptsinstead.Thepypowervm.tasks.power.power_offmethod is deprecated and will be
removed no sooner than January 1st, 2019.  Consumers should migrate to usingpypowervm.tasks.power.PowerOp.stopfor single power-off; orpypowervm.tasks.power.power_off_progressivefor soft-retry flows.