IBM Storage Virtualize Ansible Collection
Description
This collection provides a series of Ansible modules and plugins for interacting with the IBM Storage Virtualize family products. These products include the IBM SAN Volume Controller, IBM FlashSystem family members built with IBM Storage Virtualize (FlashSystem 5xxx, 7xxx, 9xxx), IBM Storwize family, and IBM Storage Virtualize for Public Cloud. For more information regarding these products, see IBM Documentation.
Requirements
- Ansible version 2.16 or higher
- Python 3.10 or higher for controller nodes
Installation
To install the IBM Storage Virtualize collection hosted in Galaxy:
ansible-galaxy collection install ibm.storage_virtualize
To upgrade to the latest version of the IBM Storage Virtualize collection:
ansible-galaxy collection install ibm.storage_virtualize --force
Usage
Playbooks
To use a module from the IBM Storage Virtualize collection, please reference the full namespace, collection name, and module name that you want to use:
---
- name: Using the IBM Storage Virtualize collection
hosts: localhost
gather_facts: false
tasks:
- name: Gather info from storage
ibm.storage_virtualize.ibm_svc_info:
clustername: x.x.x.x
domain:
username: username
password: password
log_path: /tmp/playbook.debug
gather_subset: all
Alternatively, you can add a full namepsace and collection name in the collections element:
---
- name: Using the IBM Storage Virtualize collection
hosts: localhost
gather_facts: false
collections: ibm.storage_virtualize
tasks:
- name: Gather info from storage
ibm_svc_info:
clustername: x.x.x.x
domain:
username: username
password: password
log_path: /tmp/playbook.debug
gather_subset: all
Resources Information
Modules
- ibm_svc_auth - Generates an authentication token for a user on Storage Virtualize systems
- ibm_svc_complete_initial_setup - Completes the initial setup configuration for LMC systems
- ibm_svc_host - Manages hosts on Storage Virtualize systems
- ibm_svc_hostcluster - Manages host cluster on Storage Virtualize systems
- ibm_svc_info - Collects information on Storage Virtualize systems
- ibm_svc_initial_setup - Manages initial setup configuration on Storage Virtualize systems
- ibm_svc_manage_callhome - Manages configuration of Call Home feature on Storage Virtualize systems
- ibm_svc_manage_consistgrp_flashcopy - Manages FlashCopy consistency groups on Storage Virtualize systems
- ibm_svc_manage_cv - Manages the change volume in remote copy replication on Storage Virtualize systems
- ibm_svc_manage_flashcopy - Manages FlashCopy mappings on Storage Virtualize systems
- ibm_svc_manage_ip - Manages IP provisioning on Storage Virtualize systems
- ibm_svc_manage_migration - Manages volume migration between clusters on Storage Virtualize systems
- ibm_svc_manage_mirrored_volume - Manages mirrored volumes on Storage Virtualize systems
- ibm_svc_manage_ownershipgroup - Manages ownership groups on Storage Virtualize systems
- ibm_svc_manage_portset - Manages IP portset on Storage Virtualize systems
- ibm_svc_manage_replication - Manages remote copy replication on Storage Virtualize systems
- ibm_svc_manage_replicationgroup - Manages remote copy consistency groups on Storage Virtualize systems
- ibm_svc_manage_safeguarded_policy - Manages safeguarded policy configuration on Storage Virtualize systems
- ibm_svc_manage_sra - Manages the remote support assistance configuration on Storage Virtualize systems
- ibm_svc_manage_user - Manages user on Storage Virtualize systems
- ibm_svc_manage_usergroup - Manages user groups on Storage Virtualize systems
- ibm_svc_manage_volume - Manages standard volumes on Storage Virtualize systems
- ibm_svc_manage_volumegroup - Manages volume groups on Storage Virtualize systems
- ibm_svc_mdisk - Manages MDisks for Storage Virtualize systems
- ibm_svc_mdiskgrp - Manages pools for Storage Virtualize systems
- ibm_svc_start_stop_flashcopy - Starts or stops FlashCopy mapping and consistency groups on Storage Virtualize systems
- ibm_svc_start_stop_replication - Starts or stops remote-copy independent relationships or consistency groups on Storage Virtualize systems
- ibm_svc_vol_map - Manages volume mapping for Storage Virtualize systems
- ibm_svcinfo_command - Runs svcinfo CLI command on Storage Virtualize systems over SSH session
- ibm_svctask_command - Runs svctask CLI command(s) on Storage Virtualize systems over SSH session
Other Feature Information
- SV Ansible Collection v1.8.0 provides the new 'ibm_svc_complete_initial_setup' module, to complete the automation of Day 0 configuration on Licensed Machine Code (LMC) systems.
For non-LMC systems, login to the user-interface is required in order to complete the automation of Day 0 configuration.
- SV Ansible Collection v1.7.0 provided
Setup and Configuration Automation through different modules. This feature helps user to automate Day 0 configuration.
This feature includes three modules:
- ibm_svc_initial_setup
- ibm_svc_manage_callhome
- ibm_svc_manage_sra
- By proceeding and using these modules, the user acknowledges that IBM Privacy Statement has been read and understood.
Prerequisite
- Paramiko must be installed to use ibm_svctask_command and ibm_svcinfo_command modules.
Limitation
The modules in the IBM Storage Virtualize Ansible collection leverage REST APIs to connect to the IBM Storage Virtualize system. This has following limitations:
1. Using the REST APIs to list more than 2000 objects may create a loss of service from the API side, as it automatically restarts due to memory constraints.
2. It is not possible to access REST APIs using an IPv6 address on a cluster.
3. The Ansible collection can run on all IBM Storage Virtualize system versions above 8.1.3, except versions 8.3.1.3, 8.3.1.4 and 8.3.1.5.
4. At time of release of the SV Ansible v1.8.0 collection, no module is available for non LMC systems to automate license agreements acceptance, including EULA.
User will be presented with a GUI setup wizard upon user-interface login, whether the Ansible modules have been used for initial configuration or not.
Releasing, Versioning, and Deprecation
- IBM Storage Virtualize Ansible Collection releases follow a quarterly release cycle, with details available in the changelog.
- IBM Storage Virtualize Ansible Collection releases follow semantic versioning.
- IBM Storage Virtualize Ansible modules deprecation cycle is aligned with Ansible.
Testing
The tests/ directory contains configuration for running sanity and integration tests using ansible-test.
Contributing
Currently we are not accepting community contributions.
Though, you may periodically review this content to learn when and how contributions can be made in the future.
IBM Storage Virtualize Ansible Collection maintainers can follow the Maintainer guidelines.
Support
This collection is entitled to support through the Ansible Automation Platform (AAP) using the Create issue button on the top right corner. If the collection has been obtained either from Galaxy or GitHub, you can raise a GitHub Issue on this repository for support.
Communication
For more information about communication, see the Ansible communication guide.
License
GNU General Public License v3.0
