dellemc.powerflex.sds модуль – Управление SDS на Dell PowerFlex

Примечание

Этот модуль входит в коллекцию dellemc.powerflex (версия 2.5.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install dellemc.powerflex. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.

Чтобы использовать его в книге задач, укажите: dellemc.powerflex.sds.

Новый в dellemc.powerflex 1.1.0

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управление SDS на хранилище PowerFlex включает создание новых SDS, получение данных о SDS, добавление/удаление IP-адресов в/из SDS, изменение атрибутов SDS и удаление SDS.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

Хранилище Dell PowerFlex версии 3.6 или более поздней.
PyPowerFlex 1.12.0.

Параметры

Параметр	Комментарии
fault_set_id string	Уникальный идентификатор набора неисправностей. Взаимоисключающий с fault_set_name.
fault_set_name string	Имя набора неисправностей. Взаимоисключающий с fault_set_id.
hostname aliases: gateway_host string / required	IP-адрес или FQDN узла PowerFlex.
password string / required	Пароль узла PowerFlex.
performance_profile string	Профиль производительности для применения к SDS. Профиль HighPerformance настраивает предопределенный набор параметров для сценариев использования с очень высокой производительностью. Значение по умолчанию по API — `HighPerformance`. Варианты: `"Compact"` `"HighPerformance"`
port integer	Номер порта, через который происходит связь с узлом PowerFlex. По умолчанию: `443`
protection_domain_id string	Идентификатор домена защиты. Взаимоисключающий с protection_domain_name.
protection_domain_name string	Имя домена защиты. Взаимоисключающий с protection_domain_id.
rfcache_enabled boolean	Включить ли кэш чтения Flash. Варианты: `false` `true`
rmcache_enabled boolean	Включить ли кэш чтения RAM. Варианты: `false` `true`
rmcache_size integer	Размер кэша чтения RAM (в МБ). Минимальный размер — 128 МБ. Максимальный размер — 3911 МБ.
sds_id string	Идентификатор SDS. За исключением операции создания, все остальные операции могут выполняться с использованием sds_id. Взаимоисключающий с sds_name.
sds_ip_list list / elements=dictionary	Словарь IP-адресов и их ролей для SDS. При создании SDS обязателен хотя бы один IP-роль. IP-роли также могут быть обновлены.
ip string / required	IP-адрес SDS.
role string / required	Роль, назначенная IP-адресу SDS. Варианты: `"sdsOnly"` `"sdcOnly"` `"all"`
sds_ip_state string	Состояние IP относительно SDS. Варианты: `"present-in-sds"` `"absent-in-sds"`
sds_name string	Имя SDS. Обязательно для операции создания. Уникально в пределах массива PowerFlex. Взаимоисключающий с sds_id.
sds_new_name string	Новое имя SDS.
state string / required	Состояние SDS. Варианты: `"present"` `"absent"`
timeout integer	Время, после которого соединение будет разорвано. Указывается в секундах. По умолчанию: `120`
username string / required	Имя пользователя узла PowerFlex.

validate_certs

aliases: verifycert

boolean

Логическая переменная, определяющая, следует ли проверять сертификат SSL.

true - Указывает на необходимость проверки сертификата SSL.

false - Указывает на то, что проверка сертификата SSL не требуется.

Варианты:

false
true ← (по умолчанию)

Примечания

Примечание

Максимальное количество IP-адресов, которые можно связать с SDS, составляет 8.
Для связи SDS требуется как минимум 1 IP-адрес, а для связи SDC – также 1.
Если существует только 1 IP-адрес, он должен иметь роль «all»; иначе 1 IP-адрес может иметь роль «all», а другие – роль «sdcOnly»; или 1 IP-адрес должен иметь роль «sdsOnly», а остальные – роль «sdcOnly».
Может быть 1 или более IP-адресов с ролью «sdcOnly».
Должен быть только 1 IP-адрес с ролью SDS (либо с ролью «all», либо «sdsOnly»).
SDS можно создать с отключенным кешем RF, но следует помнить, что кеш RF не всегда обновляется. В этом случае пользователю следует повторить операцию.
Поддерживается check_mode.
Модули, присутствующие в коллекции под названием «dellemc.powerflex», разработаны для поддержки платформы хранения Dell PowerFlex.

Примеры

- 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"
    fault_set_name: "faultset1"
    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"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `false`
sds_details dictionary	Подробная информация о SDS. Возвращается: Когда SDS существует Пример: {"authenticationError": "None", "certificateInfo": null, "configuredDrlMode": "Volatile", "drlMode": "Volatile", "faultSetId": null, "fglMetadataCacheSize": 0, "fglMetadataCacheState": "Disabled", "fglNumConcurrentWrites": 1000, "id": "8f3bb0cc00000002", "ipList": [{"ip": "10.47.xxx.xxx", "role": "all"}], "lastUpgradeTime": 0, "links": [{"href": "/api/instances/Sds::8f3bb0cc00000002", "rel": "self"}, {"href": "/api/instances/Sds::8f3bb0cc00000002/relationships /Statistics", "rel": "/api/Sds/relationship/Statistics"}, {"href": "/api/instances/Sds::8f3bb0cc00000002/relationships /SpSds", "rel": "/api/Sds/relationship/SpSds"}, {"href": "/api/instances/Sds::8f3bb0cc00000002/relationships /Device", "rel": "/api/Sds/relationship/Device"}, {"href": "/api/instances/ProtectionDomain::9300c1f900000000", "rel": "/api/parent/relationship/protectionDomainId"}], "maintenanceState": "NoMaintenance", "maintenanceType": "NoMaintenance", "mdmConnectionState": "Connected", "membershipState": "Joined", "name": "node0", "numOfIoBuffers": null, "numRestarts": 2, "onVmWare": true, "perfProfile": "HighPerformance", "port": 7072, "protectionDomainId": "9300c1f900000000", "protectionDomainName": "domain1", "raidControllers": null, "rfcacheEnabled": true, "rfcacheErrorApiVersionMismatch": false, "rfcacheErrorDeviceDoesNotExist": false, "rfcacheErrorInconsistentCacheConfiguration": false, "rfcacheErrorInconsistentSourceConfiguration": false, "rfcacheErrorInvalidDriverPath": false, "rfcacheErrorLowResources": false, "rmcacheEnabled": true, "rmcacheFrozen": false, "rmcacheMemoryAllocationState": "AllocationPending", "rmcacheSizeInKb": 131072, "rmcacheSizeInMb": 128, "sdsConfigurationFailure": null, "sdsDecoupled": null, "sdsReceiveBufferAllocationFailures": null, "sdsState": "Normal", "softwareVersionInfo": "R3_6.0.0"}
authenticationError string	Указывает на ошибку аутентификации. Возвращается: успешно
certificateInfo string	Информация о сертификате. Возвращается: успешно
configuredDrlMode string	Настроенный режим DRL. Возвращается: успешно
drlMode string	Режим DRL. Возвращается: успешно
faultSetId string	Идентификатор набора неисправностей. Возвращается: успешно
fglMetadataCacheSize integer	Размер кэша метаданных FGL. Возвращается: успешно
fglMetadataCacheState string	Состояние кэша метаданных FGL. Возвращается: успешно
fglNumConcurrentWrites integer	Одновременная запись FGL. Возвращается: успешно
id string	Идентификатор SDS. Возвращается: успешно
ipList list / elements=string	Список IP-адресов SDS. Возвращается: успешно
ip string	IP-адрес, присутствующий в SDS. Возвращается: успешно
role string	Роль IP-адреса SDS. Возвращается: успешно
lastUpgradeTime string	Последнее время обновления SDS. Возвращается: успешно
links list / elements=string	Ссылки SDS. Возвращается: успешно
href string	URL экземпляра SDS. Возвращается: успешно
rel string	Связь SDS с различными объектами. Возвращается: успешно
maintenanceState string	Состояние обслуживания. Возвращается: успешно
maintenanceType string	Тип обслуживания. Возвращается: успешно
mdmConnectionState string	Состояние соединения MDM. Возвращается: успешно
membershipState string	Состояние членства. Возвращается: успешно

name string	Имя SDS. Возвращается: success
numOfIoBuffers integer	Количество буферов ввода-вывода. Возвращается: success
numRestarts integer	Количество перезапусков. Возвращается: success
onVmWare boolean	Наличие на VMware. Возвращается: success
perfProfile string	Профиль производительности. Возвращается: success
port integer	Порт SDS. Возвращается: success
protectionDomainId string	Идентификатор домена защиты. Возвращается: success
protectionDomainName string	Имя домена защиты. Возвращается: success
raidControllers integer	Количество контроллеров RAID. Возвращается: success
rfcacheEnabled boolean	Включен ли кэш RF. Возвращается: success
rfcacheErrorApiVersionMismatch boolean	Ошибка кэша RF из-за несоответствия версии API. Возвращается: success
rfcacheErrorDeviceDoesNotExist boolean	Ошибка кэша RF: устройство не существует. Возвращается: success
rfcacheErrorInconsistentCacheConfiguration boolean	Ошибка кэша RF: несогласованная конфигурация кэша. Возвращается: success
rfcacheErrorInconsistentSourceConfiguration boolean	Ошибка кэша RF: несогласованная конфигурация источника. Возвращается: success
rfcacheErrorInvalidDriverPath boolean	Ошибка кэша RF: неверный путь к драйверу. Возвращается: success
rfcacheErrorLowResources boolean	Ошибка кэша RF: недостаточно ресурсов. Возвращается: success
rmcacheEnabled boolean	Включен ли кэш Read RAM. Возвращается: success
rmcacheFrozen boolean	Кэш RM заморожен. Возвращается: success
rmcacheMemoryAllocationState boolean	Состояние выделения памяти кэша RM. Возвращается: success
rmcacheSizeInKb integer	Размер кэша RM в КБ. Возвращается: success
rmcacheSizeInMb integer	Размер кэша RM в МБ. Возвращается: success
sdsConfigurationFailure string	Ошибка конфигурации SDS. Возвращается: success

sdsDecoupled string	Разъединение SDS. Возвращено: успех
sdsReceiveBufferAllocationFailures string	Неудачные операции выделения буфера приема SDS. Возвращено: успех
sdsState string	Состояние SDS. Возвращено: успех
softwareVersionInfo string	Информация о версии ПО SDS. Возвращено: успех

Авторы

Раджшри Кхаре (@khareRajshree)
Трисха Датта (@trisha-dell)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/powerflex/sds_module.html