Change log¶
Moving to Ansible Galaxy¶
Starting with version 0.9.0, the zhmc Ansible modules are no longer distributed as the zhmc-ansible-modules package on Pypi, but as the ibm.ibm_zhmc collection on Galaxy.
Version 0.8.4¶
Released: 2020-12-14
Bug fixes:
- Fixed the incorrect statement about support for Python 3.4. Ansible never officially supported Python 3.4.
Enhancements:
- Migrated from Travis and Appveyor to GitHub Actions. This required several changes in package dependencies for development.
- Increased the development status shown for the package on Pypi to Production/Stable. (Issue #285)
Version 0.8.3¶
Released: 2020-11-11
Bug fixes:
- Fixed percent-encoding in the ‘zhmc_storage_group’ and ‘zhmc_storage_volume’ modules.
- Docs: Increased supported Ansible versions from 2.0 or higher to be 2.4 or higher. This is what is currently tested. See issue #209.
Enhancements:
- In the zhmc_nic module, updated the definition of NIC properties to the z15 machine generation. This makes the ‘mac_address’ property writeable, and adds the ‘vlan_type’, ‘function_number’ and ‘function_range’ properties.
- zhmc_cpc: Added an artificial property ‘storage-groups’ to the output that shows the storage groups attached to the partition, with only a subset of their properties.
- zhmc_partition: Added an artificial property ‘storage-groups’ to the output that shows the storage groups attached to the partition, with all of their properties and artificial properties as in the result of zhmc_storage_group. This is enabled by the new boolean input parameter ‘expand_storage_groups’.
- zhmc_partition: Added an artificial property ‘crypto-adapters’ to the ‘crypto-configuration’ property, showing the adapter properties of the crypto adapters attached to the partition, with all of their properties and artificial properties as in the result of zhmc_adapter. This is enabled by the new boolean input parameter ‘expand_crypto_adapters’.
- zhmc_partition: Added artificial properties to the ‘nics’ property:
- ‘adapter-name’: Name of the adapter backing the NIC
- ‘adapter-port’: Port index on the adapter backing the NIC
- ‘adapter-id’: Adapter ID (PCHID) of the adapter backing the NIC
- Examples: Added an example playbook ‘get_cpc_io.yml’ which retrieves information about a CPC in DPM mode and its I/O configuration and creates a markdown file showing the result.
- Added support in the zhmc_crypto_attachment module for specifying crypto adapters by name instead of just their count. (See issue #187)
Version 0.8.2¶
Released: 2020-09-22
Bug fixes:
- Fixed ParameterError raised when creating NICs on CNA adapter ports.
Version 0.8.1¶
Released: 2020-09-09
Bug fixes:
- Fixed AttributeError when using the zhmc_adapter module to create a HiperSockets adapter. (see issue #141)
Version 0.8.0¶
Released: 2019-04-02
Bug fixes:
- Fixed an issue in the zhmc_crypto_attachment module where the incorrect crypto adapter was picked, leading to a subsequent crypto conflict when starting the partition. See issue #112.
Enhancements:
- Improved the quaity of error messages in the zhmc_crypto_attachment module.
Version 0.7.0¶
Released: 2019-02-20
Incompatible changes:
- Temporarily disabled the retrieval of full properties in the result data of the zhmc_adapter module.
Bug fixes:
- Docs: Fixed change log of 0.6.0 (see the 0.6.0 section below).
Enhancements:
Renovated the logging: - Added support for the log_file parameter to all modules. - Changed the format of the log lines. - Set log level also when no log_file is specified, causing
the logs to be propagated to the root logger.
Version 0.6.0¶
Released: 2019-01-07
Fixed this change log in 0.6.1 and 0.7.0
Bug fixes:
- Fixed dependency to zhmcclient package to be >=0.20.0, instead of using its master branch from the github repo.
- Updated the ‘requests’ package to 2.20.0 to fix the following vulnerability: https://nvd.nist.gov/vuln/detail/CVE-2018-18074
- Added support for Python 3.7. This required increasing the minimum version of Ansible from 2.2.0.0 to 2.4.0.0. This also removes the dependency on the ‘pycrypto’ package, which has vulnerabilities and is no longer maintained since 2013. Ansible uses the ‘cryptography’ package, instead. See issue #66.
- The crypto_number property of Adapter is an integer property, and thus the Ansible module zhmc_adapter needs to change the string passed by Ansible back to an integer. It did that correctly but only for the properties input parameter, and not for the match input parameter. The type conversions are now applied for all properties of Adapter also for the match parameter.
- The dictionary to check input properties for the zhmc_cpc module had the acceptable_status property written with a hyphen instead of underscore. This had the effect that it was rejected as non-writeable when specifying it as input.
Enhancements:
- Added support for managing CPCs by adding a zhmc_cpc Ansible module. The module allows setting writeable properties of a CPC in an idempotent way, and to gather facts for a CPC (i.e. all of its properties including a few artificial ones). See issue #82.
- Added support for managing adapters by adding a zhmc_adapter Ansible module. The module allows setting writeable properties of an adapter, changing the adapter type for FICON Express adapters, and changing the crypto type for Crypto Express adapters, all in an idempotent way. It also allows gathering facts for an adapter (i.e. all of its properties# including a few artificial ones). See issue #83.
- Added a zhmc_crypto_attachment Ansible module, which manages the attachment of crypto adapters and of crypto domains to partitions in an idempotent way. This was already supported in a less flexible and non-idempotent way by the zhmc_partition Ansible module.
- Added support for adjusting the value of the ssc_ipv4_gateway input property for the zhmc_partition module to None if specified as the empty string. This allows defaulting the value more easily in playbooks.
- Docs: Improved and fixed the documentation how to release a version and how to start a new version.
Version 0.5.0¶
Released: 2018-10-24
Incompatible changes:
- Changed ‘make setup’ back to ‘make develop’ for consistency with the other zhmcclient projects.
Bug fixes:
- Several fixes in the make process and package dependencies.
- Synced package dependencies with zhmcclient project.
Enhancements:
- Added support for DPM storage groups, attachments and volumes, by adding new modules ‘zhmc_storage_group’, ‘zhmc_storage_group_attachment’, and ‘zhmc_storage_volume’. Added several playbooks as examples.
Version 0.4.0¶
Released: 2018-03-15
Bug fixes:
- Fixed the bug that a TypeError was raised when setting the ‘ssc_dns_servers’ property for a Partition. The property value is a list of strings, and lists of values were not supported previously. Extended the function test cases for partitions accordingly. (Issue #34).
- Fixed that the “type” property for Partitions could not be specified. It is valid for Partition creation, and the only restriction is that its value cannot be changed once the Partition exists. Along with fixing the logic for such create-only properties, the same issue was also fixed for the adapter port related properties of HBAs. (Issue #31).
- Improved the logic for handling create+update properties in case the resource does not exist, such that they are no longer updated in addition to being set during creation. The logic still supports updating as an alternative if the resource does not exist, for update-only properties (e.g. several properties in Partitions). (Fixed as part of issue #31).
- Fixed the issue that a partition in “terminated” or “paused” status could not be made absent (i.e. deleted). Now, the partition is stopped which should bring it into “stopped” status, and then deleted. (Issue #29).
Enhancements:
- Added get_facts.py script to examine usage of the Ansible 2.0 API.
- Added support for gathering partition and child facts. The fact support is invoked by specifying state=facts. The fact support is implemented by returning the partition properties in the result. The returned partition properties are enriched by adding properties ‘hbas’, ‘nics’, ‘virtual-functions’ that are a list of the properties of the respective child elements of that partition. (Issue #32).
Version 0.3.0¶
Released: 2017-08-16
Incompatible changes:
Deprecations:
Bug fixes:
Enhancements:
- Added support for specifying integer-typed and float-typed properties of Partitions, NICs, HBAs, and VFs also as decimal strings in the module input.
- Specifying string typed properties of Partitions, NICs, HBAs, and VFs with Unicode characters no longer performs an unnecessary property update.
Dependencies:
- Increased minimum Ansible release from 2.0.0.1 to 2.2.0.0.
- Upgraded zhmcclient requirement to 0.15.0