1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
# Ansible Collection - ibm.spectrum_virtualize
[](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html )
This collection provides a series of Ansible modules and plugins for interacting with the IBM Spectrum Virtualize family storage products. These products include the IBM SAN Volume Controller, IBM FlashSystem family members built with IBM Spectrum Virtualize (FlashSystem 5xxx, 7xxx, 9xxx), IBM Storwize family, and IBM Spectrum Virtualize for Public Cloud. For more information regarding these products, see [IBM Documentation](https://www.ibm.com/docs/).
## Requirements
- Ansible version 2.9 or higher
## Installation
To install the IBM Spectrum Virtualize collection hosted in Galaxy:
```bash
ansible-galaxy collection install ibm.spectrum_virtualize
```
To upgrade to the latest version of the IBM Spectrum Virtualize collection:
```bash
ansible-galaxy collection install ibm.spectrum_virtualize --force
```
## Usage
### Playbooks
To use a module from the IBM Spectrum Virtualize collection, please reference the full namespace, collection name, and module name that you want to use:
```yaml
---
- name: Using the IBM Spectrum Virtualize collection
hosts: localhost
tasks:
- name: Gather info from storage
ibm.spectrum_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:
```yaml
---
- name: Using the IBM Spectrum Virtualize collection
collections:
- ibm.spectrum_virtualize
gather_facts: no
connection: local
hosts: localhost
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
```
## Supported Resources
### Modules
- ibm_svc_auth - Generates an authentication token for a user on Spectrum Virtualize storage systems
- ibm_svc_complete_initial_setup - Completes the initial setup configuration for LMC systems
- ibm_svc_host - Manages hosts on Spectrum Virtualize storage systems
- ibm_svc_hostcluster - Manages host cluster on Spectrum Virtualize storage systems
- ibm_svc_info - Collects information on Spectrum Virtualize storage systems
- ibm_svc_initial_setup - Manages initial setup configuration on Spectrum Virtualize storage systems
- ibm_svc_manage_callhome - Manages configuration of Call Home feature on Spectrum Virtualize storage systems
- ibm_svc_manage_consistgrp_flashcopy - Manages FlashCopy consistency groups on Spectrum Virtualize storage systems
- ibm_svc_manage_cv - Manages the change volume in remote copy replication on Spectrum Virtualize storage systems
- ibm_svc_manage_flashcopy - Manages FlashCopy mappings on Spectrum Virtualize storage systems
- ibm_svc_manage_ip - Manages IP provisioning on Spectrum Virtualize storage systems
- ibm_svc_manage_migration - Manages volume migration between clusters on Spectrum Virtualize storage systems
- ibm_svc_manage_mirrored_volume - Manages mirrored volumes on Spectrum Virtualize storage systems
- ibm_svc_manage_ownershipgroup - Manages ownership groups on Spectrum Virtualize storage systems
- ibm_svc_manage_portset - Manages IP portset on Spectrum Virtualize storage systems
- ibm_svc_manage_replication - Manages remote copy replication on Spectrum Virtualize storage systems
- ibm_svc_manage_replicationgroup - Manages remote copy consistency groups on Spectrum Virtualize storage systems
- ibm_svc_manage_safeguarded_policy - Manages safeguarded policy configuration on Spectrum Virtualize storage systems
- ibm_svc_manage_sra - Manages the remote support assistance configuration on Spectrum Virtualize storage systems
- ibm_svc_manage_user - Manages user on Spectrum Virtualize storage systems
- ibm_svc_manage_usergroup - Manages user groups on Spectrum Virtualize storage systems
- ibm_svc_manage_volume - Manages standard volumes on Spectrum Virtualize storage systems
- ibm_svc_manage_volumegroup - Manages volume groups on Spectrum Virtualize storage systems
- ibm_svc_mdisk - Manages MDisks for Spectrum Virtualize storage systems
- ibm_svc_mdiskgrp - Manages pools for Spectrum Virtualize storage systems
- ibm_svc_start_stop_flashcopy - Starts or stops FlashCopy mapping and consistency groups on Spectrum Virtualize storage systems
- ibm_svc_start_stop_replication - Starts or stops remote-copy independent relationships or consistency groups on Spectrum Virtualize storage systems
- ibm_svc_vol_map - Manages volume mapping for Spectrum Virtualize storage systems
- ibm_svcinfo_command - Runs svcinfo CLI command on Spectrum Virtualize storage systems over SSH session
- ibm_svctask_command - Runs svctask CLI command(s) on Spectrum Virtualize storage systems over SSH session
- ibm_sv_manage_awss3_cloudaccount - Manages Amazon S3 cloud account configuration on Spectrum Virtualize storage systems
- ibm_sv_manage_cloud_backup - Manages cloud backups on Spectrum Virtualize storage systems
- ibm_sv_manage_fc_partnership - Manages Fibre Channel (FC) partnership on Spectrum Virtualize storage systems
- ibm_sv_manage_fcportsetmember - Manages addition or removal of ports from the Fibre Channel (FC) portsets on Spectrum Virtualize storage systems
- ibm_sv_manage_ip_partnership - Manages IP partnership configuration on Spectrum Virtualize storage systems
- ibm_sv_manage_provisioning_policy - Manages provisioning policy configuration on Spectrum Virtualize storage systems
- ibm_sv_manage_replication_policy - Manages policy-based replication configuration on Spectrum Virtualize storage systems
- ibm_sv_manage_snapshot - Manages snapshots (mutual consistent images of a volume) on Spectrum Virtualize storage systems
- ibm_sv_manage_snapshotpolicy - Manages snapshot policy configuration on Spectrum Virtualize storage systems
- ibm_sv_manage_ssl_certificate - Exports an existing system certificate on to Spectrum Virtualize storage systems
- ibm_sv_manage_truststore_for_replication - Manages certificate trust stores for replication on Spectrum Virtualize family storage systems
- ibm_sv_restore_cloud_backup - Restores cloud backups on Spectrum Virtualize storage systems
- ibm_sv_switch_replication_direction - Switches the replication direction on Spectrum Virtualize storage systems
### 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](https://www.ibm.com/privacy) 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 Spectrum Virtualize Ansible collection leverage REST APIs to connect to the IBM Spectrum Virtualize storage 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 Spectrum Virtualize storage 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
1. IBM Spectrum Virtualize Ansible Collection releases follow a quarterly release cycle.
2. IBM Spectrum Virtualize Ansible Collection releases follow [semantic versioning](https://semver.org/).
3. IBM Spectrum Virtualize Ansible modules deprecation cycle is aligned with [Ansible](https://docs.ansible.com/ansible/latest/dev_guide/module_lifecycle.html).
## 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 Spectrum Virtualize Ansible Collection maintainers can follow the [Maintainer guidelines](https://docs.ansible.com/ansible/devel/community/maintainers.html).
## License
GNU General Public License v3.0
|
