dellemc.powerflex.sds module – Manage SDS on Dell PowerFlex
Note
This module is part of the dellemc.powerflex collection (version 1.6.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 dellemc.powerflex.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: dellemc.powerflex.sds.
New in dellemc.powerflex 1.1.0
Synopsis
Managing SDS on PowerFlex storage system includes creating new SDS, getting details of SDS, adding/removing IP to/from SDS, modifying attributes of SDS, and deleting SDS.
Requirements
The below requirements are needed on the host that executes this module.
A Dell PowerFlex storage system version 3.5 or later.
Ansible-core 2.12 or later.
PyPowerFlex 1.6.0.
Python 3.9, 3.10 or 3.11.
Parameters
Parameter |
Comments |
|---|---|
IP or FQDN of the PowerFlex host. |
|
The password of the PowerFlex host. |
|
Performance profile to apply to the SDS. The HighPerformance profile configures a predefined set of parameters for very high performance use cases. Default value by API is Choices:
|
|
Port number through which communication happens with PowerFlex host. Default: |
|
The ID of the protection domain. Mutually exclusive with protection_domain_name. |
|
The name of the protection domain. Mutually exclusive with protection_domain_id. |
|
Whether to enable the Read Flash cache. Choices:
|
|
Whether to enable the Read RAM cache. Choices:
|
|
Read RAM cache size (in MB). Minimum size is 128 MB. Maximum size is 3911 MB. |
|
The ID of the SDS. Except create operation, all other operations can be performed using sds_id. Mutually exclusive with sds_name. |
|
Dictionary of IPs and their roles for the SDS. At least one IP-role is mandatory while creating a SDS. IP-roles can be updated as well. |
|
IP address of the SDS. |
|
Role assigned to the SDS IP address. Choices:
|
|
State of IP with respect to the SDS. Choices:
|
|
The name of the SDS. Mandatory for create operation. It is unique across the PowerFlex array. Mutually exclusive with sds_id. |
|
SDS new name. |
|
State of the SDS. Choices:
|
|
Time after which connection will get terminated. It is to be mentioned in seconds. Default: |
|
The username of the PowerFlex host. |
|
Boolean variable to specify whether or not to validate SSL certificate.
Choices:
|
Notes
Note
The maximum limit for the IPs that can be associated with an SDS is 8.
There needs to be at least 1 IP for SDS communication and 1 for SDC communication.
If only 1 IP exists, it must be with role ‘all’; else 1 IP can be with role ‘all’and other IPs with role ‘sdcOnly’; or 1 IP must be with role ‘sdsOnly’ and others with role ‘sdcOnly’.
There can be 1 or more IPs with role ‘sdcOnly’.
There must be only 1 IP with SDS role (either with role ‘all’ or ‘sdsOnly’).
SDS can be created with RF cache disabled, but, be aware that the RF cache is not always updated. In this case, the user should re-try the operation.
The check_mode is not supported.
The modules present in the collection named as ‘dellemc.powerflex’ are built to support the Dell PowerFlex storage platform.
Examples
- name: Create SDS
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
protection_domain_name: "domain1"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "all"
sds_ip_state: "present-in-sds"
state: "present"
- name: Create SDS with all parameters
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node1"
protection_domain_name: "domain1"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "sdcOnly"
sds_ip_state: "present-in-sds"
rmcache_enabled: true
rmcache_size: 128
performance_profile: "HighPerformance"
state: "present"
- name: Get SDS details using name
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
state: "present"
- name: Get SDS details using ID
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_id: "5718253c00000004"
state: "present"
- name: Modify SDS attributes using name
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
sds_new_name: "node0_new"
rfcache_enabled: true
rmcache_enabled: true
rmcache_size: 256
performance_profile: "HighPerformance"
state: "present"
- name: Modify SDS attributes using ID
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_id: "5718253c00000004"
sds_new_name: "node0_new"
rfcache_enabled: true
rmcache_enabled: true
rmcache_size: 256
performance_profile: "HighPerformance"
state: "present"
- name: Add IP and role to an SDS
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "sdcOnly"
sds_ip_state: "present-in-sds"
state: "present"
- name: Remove IP and role from an SDS
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "sdcOnly"
sds_ip_state: "absent-in-sds"
state: "present"
- name: Delete SDS using name
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
state: "absent"
- name: Delete SDS using ID
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_id: "5718253c00000004"
state: "absent"
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
|---|---|
Whether or not the resource has changed. Returned: always Sample: |
|
Details of the SDS. Returned: When SDS exists Sample: |
|
Indicates authentication error. Returned: success |
|
Information about certificate. Returned: success |
|
Configured DRL mode. Returned: success |
|
DRL mode. Returned: success |
|
Fault set ID. Returned: success |
|
FGL metadata cache size. Returned: success |
|
FGL metadata cache state. Returned: success |
|
FGL concurrent writes. Returned: success |
|
SDS ID. Returned: success |
|
SDS IP list. Returned: success |
|
IP present in the SDS. Returned: success |
|
Role of the SDS IP. Returned: success |
|
Last time SDS was upgraded. Returned: success |
|
SDS links. Returned: success |
|
SDS instance URL. Returned: success |
|
SDS’s relationship with different entities. Returned: success |
|
Maintenance state. Returned: success |
|
Maintenance type. Returned: success |
|
MDM connection state. Returned: success |
|
Membership state. Returned: success |
|
Name of the SDS. Returned: success |
|
Number of IO buffers. Returned: success |
|
Number of restarts. Returned: success |
|
Presence on VMware. Returned: success |
|
Performance profile. Returned: success |
|
SDS port. Returned: success |
|
Protection Domain ID. Returned: success |
|
Protection Domain Name. Returned: success |
|
Number of RAID controllers. Returned: success |
|
Whether RF cache is enabled or not. Returned: success |
|
RF cache error for API version mismatch. Returned: success |
|
RF cache error for device does not exist. Returned: success |
|
RF cache error for inconsistent cache configuration. Returned: success |
|
RF cache error for inconsistent source configuration. Returned: success |
|
RF cache error for invalid driver path. Returned: success |
|
RF cache error for low resources. Returned: success |
|
Whether Read RAM cache is enabled or not. Returned: success |
|
RM cache frozen. Returned: success |
|
RM cache memory allocation state. Returned: success |
|
RM cache size in KB. Returned: success |
|
RM cache size in MB. Returned: success |
|
SDS configuration failure. Returned: success |
|
SDS decoupled. Returned: success |
|
SDS receive buffer allocation failures. Returned: success |
|
SDS state. Returned: success |
|
SDS software version information. Returned: success |