Changelog

Changes in Version 4.2.12

Added support for Alletra 9000 array
Used wsapi call instead of ssh command

Changes in Version 4.2.11

Added support in growVolume call to take integer value of size

Changes in Version 4.2.10

Added support for Primera array

Changes in Version 4.2.9

Added support for querying iscsi vlan tagged ports in getPorts call

Changes in Version 4.2.8

Added further support for Remote Copy Operations:
- getRemoteCopyGroupVolumes
- getRemoteCopyGroupVolume
- admitRemoteCopyLinks
- dismissRemoteCopyLinks
- startrCopy
- rcopyServiceExists
- getRemoteCopyLink
- rcopyLinkExists
- admitRemoteCopyTarget
- dismissRemoteCopyTarget
- targetInRemoteCopyGroupExists
- remoteCopyGroupStatusCheck
- remoteCopyGroupStatusStartedCheck
- remoteCopyGroupStatusStoppedCheck
Added support for Scheduling:
- createSchedule
- deleteSchedule
- getSchedule
- modifySchedule
- suspendSchedule
- resumeSchedule
- getScheduleStatus
Added option to use HTTP POST in addVolumeToRemoteCopyGroup
Added option to use HTTP DELETE in removeVolumeFromRemoteCopyGroup
Fixed an issue where password masking was causing errors when debug mode is true

Changes in Version 4.2.7

Fixed an issue while deleting VLUN when port is present but the host is not

Changes in Version 4.2.6

Added a support to getFlashCache()
Added a support to createFlashCache()
Added a support to deleteFlashCache()
Added a support to resyncPhysicalCopy()
Added a support to set volume metadata in modifyVolume()

Changes in Version 4.2.5

Fixed problem with getfshare command with Manila operations on 3.3.1 MU1 update
Added a function definition for retrieving snapshots of a volume using REST

Changes in Version 4.2.4

Added promote virtual copy support.

Changes in Version 4.2.3

Fixed exceptions invocation order.
Fix invocations for CLI commands createfstore, getfstore, getfsquota in Inform OS 3.3.1 (Real madrid)

Changes in Version 4.2.2

Fixed online physical copy logic.
Fixed setQOSRule doesn’t work if max_bw is not defined
Fixed bug with ssh client creation with privatekey argument passed explicitly
Fixed bug where get_description() needs to be invoked on exceptions instead of Exception. Refer bug 1586266
Fixed getvfs in Manila client to return multiple VFS entries and not just 1

Changes in Version 4.2.1

Add retries for certain exceptions.
- exceptions.HTTPServiceUnavailable
- requests.exceptions.ConnectionError

Changes in Version 4.2.0

Remove the destCPG during copyVolume operations when it’s not an online copy. 3PAR will throw an error if we don’t
Added valid key checks in the flask unit test server for the createPhysicalVolume action

Changes in Version 4.1.0

Adds the ability to retrieve all snapshots associated with a given volume
Fixes passing in the flag to the client object in order to suppressing SSL warnings

Changes in Version 4.0.2

Fixed documentation and README errors

Changes in Version 4.0.1

Fixed error where you could not create a LUN with the ID of 0. (issue #17)
Allows suppressing of InsecureRequestWarning messages (Issue #18)
Changes the exception isinstance check to look for basestring/str instead of bytes in order to properly store the error description.
Allows changing timeouts for requests
Added remote copy support
- getRemoteCopyInfo
- getRemoteCopyGroups
- getRemoteCopyGroup
- createRemoteCopyGroup
- removeRemoteCopyGroup
- modifyRemoteCopyGroup
- addVolumeToRemoteCopyGroup
- removeVolumeFromRemoteCopyGroup
- startRemoteCopy
- stopRemoteCopy
- synchronizeRemoteCopyGroup
- recoverRemoteCopyGroupFromDisaster
- toggleRemoteCopyConfigMirror
Testing remote copy against two live arrays is now supported through config.ini

Changes in Version 4.0.0

Rebranded the client from HP to HPE.
Updated documentation to use the new PyPi project name for the client, ‘python-3parclient’.

Changes in Version 3.3.0

Replaced all httplib2 calls with Python Request calls
SSL certificate verification can be enabled by passing secure=True
SSL certificate verification can be done against a self provided .crt file with secure=’/path/to/ca-certificates.crt’

Changes in Version 3.2.2

Python3.4+ compliant
Added requirements-py3.txt and test-requirements-py3.txt for Python3.4 to pull and install from
Updated tox to run py34 tests
Modified basic Python calls to work with both Python2 and Python3.4
Added optional ‘ca’ parameter to createfshare and setfshare (for SMB Continuous Availability)
Improved handling of nested and optional lists in File Persona get methods
Volume Set snapshot capabilities have been added
Adds tests for volume set snapshots
Fixed error that was happening during client initialization when an error was missing a description. (issue #15)
Add support for VLUN queries in getVLUN and getHostVLUNs when a backend with WSAPI 1.4.2 or greater is being used.
Added support for calling srstatld with a given interval and history
Added unit tests for the Exception class.

Changes in Version 3.2.1

Improved debug capabilities during initialization of the client.
Reworked findHost to use a random hostname to fix collisions
Fix cross-protocol share hang by using non-interactive flag
Require 3.2.1 (MU3) for File Persona client
Improved file client test coverage
Renew SSH session if lost and increase retry attempts to 2 (issue #5)
Added missing exceptions to API docs for deleteVolume.
Fix JSON parsing using Python3
Be safe accessing ‘hostname’ key in getHostVLUNs (issue #14)

Changes in Version 3.2.0

Added File Persona Client:
- getfs
- createfpg
- growfpg
- getfpg
- setfpg
- removefpg
- createvfs
- getvfs
- setvfs
- removevfs
- createfsip
- setfsip
- getfsip
- removefsip
- createfsgroup
- setfsgroup
- removefsgroup
- createfsuser
- setfsuser
- removefsuser
- createfstore
- getfstore
- setfstore
- removefstore
- createfshare
- setfshare
- getfshare
- removefshare
- createfsnap
- getfsnap
- removefsnap
- startfsnapclean
- getfsnapclean
- stopfsnapclean
- setfsquota
- getfsquota
- gettpdinterface
Added paramiko SSH simulator initially supporting just a few test cases.
Fixed PEP8 violations.
Change GitHub account reference from WaltHP to hp-storage.
Modify the steps in the Installing from Source section to ensure correct installation of dependencies and ordering.
Added support for flash cache policy set on a virtual volume set.
Added tox environments to run tests with code coverage and to generate the documentation
Consolidated the test/README.rst into the top level README.rst and added clarifications

Changes in Version 3.1.3

Added ‘paramiko’ and ‘eventlet’ requirements to setup.py. Running a standard python setup.py install should install these modules now if they are missing.
Use static loggers to fix duplicate logging problem.
Update unit tests to better support more backend configurations and versions.
Made corrections to the API documentation.

Changes in Version 3.1.2

Added API
- findAllVolumeSets
- getCPGAvailableSpace
- getOverallSystemCapacity
Revised unit tests to use asserts instead of try/catch/except blocks.
Removed SSH call from the findVolumeSet method and replaced it with REST.
Improved findVolumeSet documentation.
Changed SSH connections to now only get created when an SSH command needs to be executed.
Added closing of an SSH connection during logout if one is active.
Changed SSH connections to no longer use keep-alive packets to stay active.
Removed an unneeded print statement output that was occuring when an SSH connection was closed.

Changes in Version 3.1.1

Added known_host_file and missing_key_policy parameters to: - HP3ParClient.setSSHOptions - HP3PARSSHClient
Fixed an issue with building the ClientException when body of the response was empty.
Fixed spelling error in urllib import for Python 3.0 or greater environments.

Changes in Version 3.1.0

Added APIs
- setVolumeMetaData
- getVolumeMetaData
- getAllVolumeMetaData
- removeVolumeMetaData
- findVolumeMetaData
Added two new enumerations for CHAP initiator and target.
Converted existing metadata functions to use REST API calls instead of SSH.
Updated the minimum required HP 3PAR build version to be 3.1.3.230. This corresponds to 3.1.3 MU1 firmware.
Added support for volume metadata REST API calls in the flask server.
Numerous API documentation improvements
Fixed 2 enumerations
- PORT_TYPE_RCIP changed to 7
- PORT_TYPE_ISCSI changed to 8
Numerous Enumerations added
- Port Type
- Port Protocol
- Task Type
- VLUN Type
- CPG RAID
- CPG HA
- CPG Chunklet
- CPG Disk Type
- Host Persona
Added host set API:
- findHostSet
- getHostSets
- getHostSet
- createHostSet
- deleteHostSet
- modifyHostSet
- addHostToHostSet
- removeHostFromHostSet
- removeHostFromItsHostSet
Added showpatch API:
- getPatch
- getPatches
Unit tests and flask server
- Fixed missing tearDown() to improve flask server shutdown.
- Added VLUN and host set check before allowing deleteHost.
- Fixed some flask error codes and error messages to match array.
- Removed the ‘test_’ prefix from classes that don’t contain tests.
- Reduced volume sizes used in tests.
- Made domain and cpg_ldlayout_ha configurable.
- Added more tests.
Bug fixes
- Fixed an incorrect exception message for getHostVLUNs.

Changes in Version 3.0.0

Requires the 3.1.3 3PAR Firmware or greater.
Added new 3.1.3 firmware APIs.
Added support for QOS and Virtual Volume sets
Added query host by wwns or iqns
Added APIs for getTasks, stopOfflinePhysicalCopy, modifyVolume

Changes in Version 2.9.2

Removed the ssh pooling to fix an issue with timeouts

Changes in Version 2.9.1

Renamed stopPhysicalCopy to stopOnlinePhysicalCopy

Changes in Version 2.9.0

Added SSH interface
Added stopPhysicalCopy
updated doc string to fix some pylint

Changes in Version 1.1.0

Added support for hosts and ports

Changes in Version 1.0.1

The unit tests now work when running nosetest from the top level dir and from the test dir

Changes in Version 1.0.0

First implementation of the REST API Client