This collection enables PowerHA cluster management through Ansible on IBM AIX. It is tested with IBM PowerHA 7.2.6 and 7.2.7 but should work with any PowerHA starting 7.2.1.
- AIX 7.2 or AIX 7.3
- IBM PowerHA SystemMirror 7.2
- Packages are already installed:
- bos.ahafs
- bos.cluster.rte
- bos.clvm
- rsct.basic.rte
- Ansible 2.13
- Python 3.9
We support all AIX and PowerHA versions which are officially supported by IBM.
Documentation is available at https://power-devops.github.io/powerha_aix/.
If you already installed the collection you can read the documentation using ansible-doc:
ansible-doc -M ./collections/ansible_collections/enfence/powerha_aix/plugins/modules enfence.powerha_aix.cluster
The following modules are available now:
- enfence.powerha_aix.appcontroller
- enfence.powerha_aix.cluster
- enfence.powerha_aix.fs
- enfence.powerha_aix.lv
- enfence.powerha_aix.pv_info
- enfence.powerha_aix.rg
- enfence.powerha_aix.service_ip
- enfence.powerha_aix.vg
More will come in the future.
Before using this collection, you need to install it with the Ansible Galaxy command-line tool:
ansible-galaxy collection install enfence.powerha_aix
You can also include it in a requirements.yml
file and install it with ansible-galaxy collection install -r requirements.yml
, using the format:
---
collections:
- name: enfence.powerha_aix
Note that if you install the collection from Ansible Galaxy, it will not be upgraded automatically when you upgrade the ansible
package. To upgrade the collection to the latest available version, run the following command:
ansible-galaxy collection install enfence.powerha_aix --upgrade
You can also install a specific version of the collection, for example, if you need to downgrade when something is broken in the latest version (please report an issue in this repository). Use the following syntax to install version 1.2.1
:
ansible-galaxy collection install enfence.powerha_aix:==1.2.1
Look at examples directory for playbook examples using the collection.
This collection is certified by Red Hat. It means you can download the collection from Ansible Automation Hub and it is fully supported for Red Hat's Ansible Automation Platform customers.
Summary of changes is available in Changelog.
We follow the Ansible Code of Conduct in all our interactions within this project.
If you encounter abusive behavior, please refer to the policy violations section of the Code for information on how to raise a complaint.
Contributions are welcome. Open an issue or create a pull request.
GNU General Public License v3.0 or later.
See LICENSE to see the full text.