The Ansible Modules for Dell EMC PowerMax allow Data Center and IT administrators to use RedHat Ansible to automate and orchestrate the configuration and management of Dell EMC PowerMax arrays.
The capabilities of Ansible modules are managing volumes, storage groups, ports, port groups, hosts, host groups, masking views, snapshots, SRDF,RDF group and gather high-level facts about the arrays. The options available for each capability are list, show, create, delete, and modify. These tasks can be executed by running simple playbooks written in yaml syntax. The modules are written so that all the operations are idempotent, so making multiple identical requests has the same effect as making a single request.
Ansible modules for PowerMax are supported by Dell EMC and are provided under the terms of the license attached to the source code. Dell EMC does not provide support for any source code modifications. For any Ansible module issues, questions or feedback, join the Dell EMC Automation community.
- Dell EMC PowerMax Arrays 5978.221.221 , 5978.444.444, 5978.665.665
- Unisphere version 9.1 and higher
- Ansible 2.8 or higher
- Python 2.7 or higher
- Red Hat Enterprise Linux 7.6, 7.7, 7.8, 8.2
- Python Library for PowerMax (PyU4V) 9.1.0.0 or higher
- Please follow Py4UV installation instructions on https://pyu4v.readthedocs.io/
The modules are written in such a way that all requests are idempotent and hence fault-tolerant. It essentially means that the result of a successfully performed request is independent of the number of times it is executed.
- Volume module
- Host module
- Host group module
- Snapshot module
- Maskingview module
- Port module
- Port group module
- Storage group module
- SRDF module
- RDF group module
- Gather facts module
git clone https://github.com/dell/ansible-powermax.git
cd ansible-powermax/dellemc_ansible
- mkdir -p /usr/lib/python2.7/site-packages/ansible/module_utils/storage/dell
- cp utils/* /usr/lib/python2.7/site-packages/ansible/module_utils/storage/dell
- mkdir -p /usr/lib/python2.7/site-packages/ansible/modules/storage/dellemc
- cp powermax/library/* /usr/lib/python2.7/site-packages/ansible/modules/storage/dellemc/
- cp doc_fragments/dellemc_powermax.py /usr/lib/python2.7/site-packages/ansible/plugins/doc_fragments/
- mkdir -p /usr/lib/python3.5/site-packages/ansible/module_utils/storage/dell
- cp utils/* /usr/lib/python3.5/site-packages/ansible/module_utils/storage/dell
- mkdir -p /usr/lib/python3.5/site-packages/ansible/modules/storage/dellemc
- cp powermax/library/* /usr/lib/python3.5/site-packages/ansible/modules/storage/dellemc/
- cp doc_fragments/dellemc_powermax.py /usr/lib/python3.5/site-packages/ansible/plugins/doc_fragments/
- Export the SSL certificate from the intended storage array in .crt format.
- Copy the certificate to this "/usr/local/share/ca-certificates" path of the host.
- Import the SSL certificate to host using the command "sudo update-ca-certificates".
- Set the "REQUESTS_CA_BUNDLE" environment variable to the path of the SSL certificate using the command "export REQUESTS_CA_BUNDLE=/usr/local/share/ca-certificates/<<Certificate_Name>>"
Check documentation from each module's file in /ansible-powermax/dellemc_ansible/powermax/library/
Check examples from each module's file in /ansible-powermax/dellemc_ansible/powermax/library/
Each module returns the updated state and details of the entity, for example, if you are using the Volume module, all calls will return the updated details of the volume. Sample result is shown in each module's documentation.