ibm.spectrum_virtualize.ibm_svc_manage_mirrored_volume module – This module manages mirrored volumes on IBM Spectrum Virtualize family storage systems
Note
This module is part of the ibm.spectrum_virtualize collection (version 2.0.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install ibm.spectrum_virtualize
.
To use it in a playbook, specify: ibm.spectrum_virtualize.ibm_svc_manage_mirrored_volume
.
Note
The ibm.spectrum_virtualize collection has been renamed to ibm.storage_virtualize and will eventually be removed from Ansible. If you use content from ibm.spectrum_virtualize, please update FQCNs in your playbooks and roles! When creating new playbooks or roles, directly use content from ibm.storage_virtualize instead.
New in ibm.spectrum_virtualize 1.4.0
Synopsis
Ansible interface to manage ‘mkvolume’, ‘addvolumecopy’, ‘rmvolumecopy’, and ‘rmvolume’ volume commands.
Parameters
Parameter |
Comments |
---|---|
The hostname or management IP of the Spectrum Virtualize storage system. |
|
Specifies if the volume to be created is compressed. Choices:
|
|
Specifies if the volume to be created is deduplicated. Choices:
|
|
Domain for the Spectrum Virtualize storage system. Valid when hostname is used for the parameter clustername. |
|
Specifies the grain size (in KB) to use when creating the HyperSwap volume. |
|
Path of debug log file. |
|
Specifies the name to assign to the new volume. |
|
REST API password for the Spectrum Virtualize storage system. The parameters username and password are required if not using token to authenticate a user. |
|
Specifies the name of first storage pool to be used when creating a mirrored volume. |
|
Specifies the name of second storage pool to be used when creating a mirrored volume. |
|
Specifies the rsize (buffersize) in %. Defines how much physical space is initially allocated to the thin-provisioned or compressed volume. |
|
Specifies the size of mirrored volume in MB. This can also be used to resize a mirrored volume. When resizing, only mandatory parameters can be passed. |
|
Creates ( Choices:
|
|
Specifies if the volume to be created is thin-provisioned. Choices:
|
|
The authentication token to verify a user on the Spectrum Virtualize storage system. To generate a token, use the ibm_svc_auth module. |
|
Specifies the desired volume type. When the type is When the type is If a “standard” mirrored volume exists and either PoolA or PoolB is specified, the mirrored volume gets converted to a standard volume. Choices:
|
|
REST API username for the Spectrum Virtualize storage system. The parameters username and password are required if not using token to authenticate a user. |
|
Validates certification. Choices:
|
Notes
Note
This module supports
check_mode
.
Examples
- name: Create a HyperSwap volume
ibm.spectrum_virtualize.ibm_svc_manage_mirrored_volume:
clustername: "{{clustername}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
type: "local hyperswap"
name: "vol1"
state: present
poolA: "pool1"
poolB: "pool2"
size: "1024"
- name: Create a thin-provisioned HyperSwap volume
ibm.spectrum_virtualize.ibm_svc_manage_mirrored_volume:
clustername: "{{clustername}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
type: "local hyperswap"
name: "vol2"
state: present
poolA: "pool1"
poolB: "pool2"
size: "1024"
thin: true
- name: Delete a mirrored volume
ibm.spectrum_virtualize.ibm_svc_manage_mirrored_volume:
clustername: "{{clustername}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: "vol2"
state: absent
- name: Create a standard mirror volume
block:
- name: Create Volume
ibm.spectrum_virtualize.ibm_svc_manage_mirrored_volume:
clustername: "{{clustername}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: "vol4"
state: present
type: "standard"
poolA: "pool1"
poolB: "pool3"
- name: Resize an existing mirrored volume
block:
- name: Resize an existing mirrored volume
ibm.spectrum_virtualize.ibm_svc_manage_mirrored_volume:
clustername: "{{clustername}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/playbook.debug
name: "vol1"
state: present
size: "{{new_size}}"