hpe.nimble.hpe_nimble_group – Manage the HPE Nimble Storage group
Note
This plugin is part of the hpe.nimble collection (version 1.1.4).
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 hpe.nimble
.
To use it in a playbook, specify: hpe.nimble.hpe_nimble_group
.
New in version 1.0.0: of hpe.nimble
Requirements
The below requirements are needed on the host that executes this module.
Ansible 2.9 or later
Python 3.6 or later
HPE Nimble Storage SDK for Python
HPE Nimble Storage arrays running NimbleOS 5.0 or later
Parameters
Parameter |
Comments |
---|---|
Whether alarm feature is enabled. Choices:
|
|
From email address to use while sending emails. Case insensitive email address. |
|
Minimum level of alert to be notified. Choices:
|
|
Comma-separated list of email addresses to receive emails. Comma separated email list. |
|
Specify whether to allow HPE Nimble Storage to use Google Analytics in the GUI. HPE Nimble Storage uses Google Analytics to gather data related to GUI usage. The data gathered is used to evaluate and improve the product. Choices:
|
|
Whether to allow support tunnel. Choices:
|
|
Whether automatic switchover of Group management services feature is enabled. Choices:
|
|
Whether autoclean unmanaged snapshots feature is enabled. Choices:
|
|
Unit for unmanaged snapshot time to live. |
|
Whether to send autosupport. Choices:
|
|
Enable or disable Common Criteria mode. Choices:
|
|
Change name of the existing group. |
|
Check if the group Management Service can be migrated to the group Management Service backup array. Choices:
|
|
Unix epoch time local to the group. Seconds since last epoch. Example- 3400. |
|
Newly created volumes are exported under iSCSI Group Target or iSCSI Volume Target. Choices:
|
|
Default limit for a volume space usage as a percentage of volume size. Volume will be taken offline/made non-writable on exceeding its limit. Percentage as integer from 0 to 100. |
|
IP addresses for this group’s dns servers. |
|
Domain name for this group. String of alphanumeric characters, valid range is from 2 to 255; Each label must be between 1 and 63 characters long; - and . are allowed after the first and before the last character. |
|
Whether FC is enabled on this group. Choices:
|
|
Can be used with halt or merge flag. Halt remaining arrays when one or more is unreachable. Ignore warnings and forcibly merge specified group with this group. Choices:
|
|
Snapshot Time-to-live(TTL) configured at group level for automatic deletion of unmanaged snapshots. Value 0 indicates unlimited TTL. |
|
Is group_target enabled on this group. Choices:
|
|
Iscsi target name for this group. String of up to 255 alphanumeric, hyphenated, colon, or period-separated characters; but cannot begin with hyphen, colon or period. This type is used for the group target name. |
|
Halt all arrays in the group. Choices:
|
|
HPE Nimble Storage IP address. |
|
Whether iSCSI is enabled on this group. Choices:
|
|
Whether iSNS is enabled. Choices:
|
|
Port number for iSNS Server. Positive integer value up to 65535 representing TCP/IP port. |
|
Hostname or IP Address of iSNS Server. |
|
Level of the test alert. Choices:
|
|
Should the banner be displayed before the user credentials are prompted or after prompting the user credentials. Choices:
|
|
The message for the login banner that is displayed during user login activity. String upto 2048 characters. |
|
This will reset the banner to the version of the installed NOS. When login_banner_after_auth is specified, login_banner_reset can not be set to true. |
|
Perform group merge with the specified group. Choices:
|
|
Migrate the group Management Service to the current group Management Service backup array. Choices:
|
|
Name of the group. |
|
Either IP address or hostname of the NTP server for this group. Plain string. |
|
HPE Nimble Storage password. |
|
Password to authenticate with HTTP Proxy Server. |
|
Proxy Port of HTTP Proxy Server. Integer value between 0-65535 representing TCP/IP port. |
|
Hostname or IP Address of HTTP Proxy Server. Setting this attribute to an empty string will unset all proxy settings. |
|
Username to authenticate with HTTP Proxy Server. HTTP proxy server username, string up to 255 characters, special characters ([, ], `, ;, ampersand, tab, space, newline) are not allowed. |
|
Reboot all arrays in the group. Choices:
|
|
All the replication bandwidth limits on the system. All the throttles for the partner. |
|
Whether to send alert to Support. Choices:
|
|
Skip check for secondary management IP address. Choices:
|
|
Whether SMTP Server requires authentication. Choices:
|
|
Password to authenticate with SMTP Server. |
|
Username to authenticate with SMTP Server. |
|
Level of encryption for SMTP. Choices:
|
|
Port number of SMTP Server. |
|
Community string to be used with SNMP. |
|
Whether to accept SNMP get commands. Choices:
|
|
Port number to which SNMP get requests should be sent. |
|
Name of the SNMP administrator. Plain string. |
|
Location of the group. Plain string. |
|
Whether to enable SNMP traps. Choices:
|
|
Hostname or IP Address to send SNMP traps. |
|
Port number of SNMP trap host. |
|
IP address of the source group. |
|
Name of the source group. |
|
Source group encryption passphrase. Encryption passphrase. String with size from 8 to 64 printable characters. |
|
Password of the source group. |
|
Username of the source group. |
|
The group operation. Choices:
|
|
Is syslogd enabled on this system. Choices:
|
|
Port number for syslogd server. |
|
Hostname of the syslogd server. |
|
Is Target Driven Zoning (TDZ) enabled on this group. Choices:
|
|
Target Driven Zoning (TDZ) prefix for peer zones created by TDZ. |
|
Generate a test alert. Choices:
|
|
Timezone in which this group is located. Plain string. |
|
Enable or disable TLSv1.0 and TLSv1.1. Choices:
|
|
The amount of time in seconds that the user session is inactive before timing out. User inactivity timeout in second, valid range is from 1 to 43200. |
|
HPE Nimble Storage user name. |
|
Perform group merge validation. Choices:
|
|
The amount of time in seconds to validate Microsoft VSS application synchronization before timing out. VSS validation timeout in second, valid range is from 1 to 3600. |
|
Are vVol enabled on this group. Choices:
|
Examples
- name: Update group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
send_alert_to_support: "{{ send_alert_to_support }}"
alert_to_email_addrs: "{{ alert_to_email_addrs }}"
state: "present"
- name: Reboot group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
state: "present"
reboot: true
- name: Halt group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
state: "present"
halt: true
- name: Validate merge group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
src_group_ip: "{{ src_group_ip }}"
src_password: "{{ src_password }}"
skip_secondary_mgmt_ip: "{{ skip_secondary_mgmt_ip }}"
src_passphrase: "{{ src_passphrase }}"
state: "present"
validate_merge: true
- name: Merge group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
src_group_ip: "{{ src_group_ip }}"
src_password: "{{ src_password }}"
skip_secondary_mgmt_ip: "{{ skip_secondary_mgmt_ip }}"
src_passphrase: "{{ src_passphrase }}"
state: "present"
merge: true
- name: Test alert group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
level: "{{ level }}"
state: "present"
test_alert: true
- name: Migrate group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
state: "present"
migrate: true
- name: Check migrate group
hpe.nimble.hpe_nimble_group:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
name: "{{ name }}"
state: "present"
check_migrate: true
Authors
HPE Nimble Storage Ansible Team (@ar-india) <nimble-dcs-storage-automation-eng@hpe.com>