Changelog

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