netapp.storagegrid.na_sg_grid_ha_group module – Manage high availability (HA) group configuration on StorageGRID.
Note
This module is part of the netapp.storagegrid collection (version 21.13.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 netapp.storagegrid
.
To use it in a playbook, specify: netapp.storagegrid.na_sg_grid_ha_group
.
Note
The netapp.storagegrid collection is considered unmaintained and will be removed from Ansible 11. See the discussion thread for more information.
New in netapp.storagegrid 21.10.0
Synopsis
Create, Update, Delete HA Groups on NetApp StorageGRID.
Parameters
Parameter |
Comments |
---|---|
The url to the StorageGRID Admin Node REST API. |
|
The authorization token for the API request |
|
Description of the HA Group. |
|
CIDR for the gateway IP and VIP subnet. |
|
HA Group ID. May be used for modify or delete operation. |
|
A set of StorageGRID node interface pairs. The primary interface is specified first, followed by the other interface pairs in failover order. |
|
The interface to bind to. eth0 corresponds to the Grid Network, eth1 to the Admin Network, and eth2 to the Client Network. |
|
Name of the StorageGRID node. |
|
Name of the HA Group. |
|
Whether the specified HA Group should exist. Choices:
|
|
Should https certificates be validated? Choices:
|
|
A list of virtual IP addresses. |
Notes
Note
The modules prefixed with
na_sg
are built to manage NetApp StorageGRID.
Examples
- name: create HA Group
netapp.storagegrid.na_sg_grid_ha_group:
api_url: "https://<storagegrid-endpoint-url>"
auth_token: "storagegrid-auth-token"
validate_certs: false
state: present
name: Site1-HA-Group
description: "Site 1 HA Group"
gateway_cidr: 192.168.50.1/24
virtual_ips: 192.168.50.5
interfaces:
- node: SITE1-ADM1
interface: eth2
- node: SITE1-G1
interface: eth2
- name: add VIP to HA Group
netapp.storagegrid.na_sg_grid_ha_group:
api_url: "https://<storagegrid-endpoint-url>"
auth_token: "storagegrid-auth-token"
validate_certs: false
state: present
name: Site1-HA-Group
description: "Site 1 HA Group"
gateway_cidr: 192.168.50.1/24
virtual_ips: 192.168.50.5,192.168.50.6
interfaces:
- node: SITE1-ADM1
interface: eth2
- node: SITE1-G1
interface: eth2
- name: rename HA Group
netapp.storagegrid.na_sg_grid_ha_group:
api_url: "https://<storagegrid-endpoint-url>"
auth_token: "storagegrid-auth-token"
validate_certs: false
state: present
ha_group_id: 00000000-0000-0000-0000-000000000000
name: Site1-HA-Group-New-Name
description: "Site 1 HA Group"
gateway_cidr: 192.168.50.1/24
virtual_ips: 192.168.50.5
interfaces:
- node: SITE1-ADM1
interface: eth2
- node: SITE1-G1
interface: eth2
- name: delete HA Group
netapp.storagegrid.na_sg_grid_ha_group:
api_url: "https://<storagegrid-endpoint-url>"
auth_token: "storagegrid-auth-token"
validate_certs: false
state: absent
name: Site1-HA-Group
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Returns information about the StorageGRID HA Group. Returned: success Sample: |