Spec-Zone.ru › Ansible

Модуль dellemc.powerflex.sds — управление SDS в Dell PowerFlex

Примечание

Этот модуль входит в коллекцию dellemc.powerflex (версия 3.0.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 2.0.0.

Параметры

Параметр

Комментарии

fault_set_id

строка

Уникальный идентификатор набора отказоустойчивости.

Не может использоваться вместе с fault_set_name.

fault_set_name

строка

Имя набора отказоустойчивости.

Не может использоваться вместе с fault_set_id.

hostname

псевдонимы: gateway_host

строка / обязательный

IP-адрес или полное доменное имя узла PowerFlex.

password

строка / обязательный

Пароль узла PowerFlex.

performance_profile

строка

Профиль производительности, применяемый к SDS.

Профиль HighPerformance настраивает заранее определенный набор параметров для сценариев, требующих очень высокой производительности.

Значение по умолчанию для API — HighPerformance.

Возможные значения:

  • "Compact"
  • "HighPerformance"

port

целое число

Номер порта для связи с узлом PowerFlex.

По умолчанию: 443

protection_domain_id

строка

Идентификатор домена защиты.

Не может использоваться вместе с protection_domain_name.

protection_domain_name

строка

Имя домена защиты.

Не может использоваться вместе с protection_domain_id.

rfcache_enabled

логическое значение

Включить ли кэш чтения на флеш-накопителе.

Возможные значения:

  • false
  • true

rmcache_enabled

логическое значение

Включить ли кэш чтения в оперативной памяти.

Возможные значения:

  • false
  • true

rmcache_size

целое число

Размер кэша чтения в оперативной памяти (в МБ).

Минимальный размер — 128 МБ.

Максимальный размер — 3911 МБ.

sds_id

строка

Идентификатор SDS.

За исключением операции создания, все остальные операции можно выполнять с помощью sds_id.

Не может использоваться вместе с sds_name.

sds_ip_list

список / элементы=словарь

Словарь IP-адресов и назначенных им ролей для SDS.

При создании SDS необходимо указать как минимум одну пару «IP-адрес — роль».

Роли IP-адресов также можно обновлять.

ip

строка / обязательный

IP-адрес SDS.

role

строка / обязательный

Роль, назначенная IP-адресу SDS.

Возможные значения:

  • "sdsOnly"
  • "sdcOnly"
  • "all"

sds_ip_state

строка

Состояние IP-адреса относительно SDS.

Возможные значения:

  • "present-in-sds"
  • "absent-in-sds"

sds_name

строка

Имя SDS.

Обязательно для операции создания.

Должно быть уникальным в массиве PowerFlex.

Не может использоваться вместе с sds_id.

sds_new_name

строка

Новое имя SDS.

state

строка / обязательный

Состояние SDS.

Возможные значения:

  • "present"
  • "absent"

timeout

целое число

Время, по истечении которого соединение будет разорвано.

Указывается в секундах.

По умолчанию: 120

username

строка / обязательный

Имя пользователя узла PowerFlex.

validate_certs

псевдонимы: verifycert

логическое значение

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

true — указывает, что сертификат SSL следует проверять.

false — указывает, что сертификат SSL не следует проверять.

Возможные значения:

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

Примечания

Примечание

  • Максимальное количество IP-адресов, которые можно связать с SDS, — 8.
  • Требуется как минимум 1 IP-адрес для связи SDS и 1 для связи SDC.
  • Если существует только 1 IP-адрес, ему должна быть назначена роль ‘all’; в противном случае 1 IP-адресу можно назначить роль ‘all’, а остальным — роль ‘sdcOnly’; либо 1 IP-адресу должна быть назначена роль ‘sdsOnly’, а остальным — роль ‘sdcOnly’.
  • Одному или нескольким 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.

Возвращается: при успешном выполнении

numOfIoBuffers

integer

Количество буферов ввода-вывода.

Возвращается: при успешном выполнении

numRestarts

integer

Количество перезапусков.

Возвращается: при успешном выполнении

onVmWare

boolean

Работает ли в среде VMware.

Возвращается: при успешном выполнении

perfProfile

string

Профиль производительности.

Возвращается: при успешном выполнении

port

integer

Порт SDS.

Возвращается: при успешном выполнении

protectionDomainId

string

Идентификатор домена защиты.

Возвращается: при успешном выполнении

protectionDomainName

string

Имя домена защиты.

Возвращается: при успешном выполнении

raidControllers

integer

Количество RAID-контроллеров.

Возвращается: при успешном выполнении

rfcacheEnabled

boolean

Включён ли кэш RF.

Возвращается: при успешном выполнении

rfcacheErrorApiVersionMismatch

boolean

Ошибка кэша RF из-за несовпадения версии API.

Возвращается: при успешном выполнении

rfcacheErrorDeviceDoesNotExist

boolean

Ошибка кэша RF: устройство не существует.

Возвращается: при успешном выполнении

rfcacheErrorInconsistentCacheConfiguration

boolean

Ошибка кэша RF из-за несогласованной конфигурации кэша.

Возвращается: при успешном выполнении

rfcacheErrorInconsistentSourceConfiguration

boolean

Ошибка кэша RF из-за несогласованной конфигурации источника.

Возвращается: при успешном выполнении

rfcacheErrorInvalidDriverPath

boolean

Ошибка кэша RF из-за недопустимого пути к драйверу.

Возвращается: при успешном выполнении

rfcacheErrorLowResources

boolean

Ошибка кэша RF из-за нехватки ресурсов.

Возвращается: при успешном выполнении

rmcacheEnabled

boolean

Включён ли кэш оперативной памяти для чтения.

Возвращается: при успешном выполнении

rmcacheFrozen

boolean

Кэш RM заморожен.

Возвращается: при успешном выполнении

rmcacheMemoryAllocationState

boolean

Состояние выделения памяти для кэша RM.

Возвращается: при успешном выполнении

rmcacheSizeInKb

integer

Размер кэша RM в КБ.

Возвращается: при успешном выполнении

rmcacheSizeInMb

integer

Размер кэша RM в МБ.

Возвращается: при успешном выполнении

sdsConfigurationFailure

string

Ошибка конфигурации SDS.

Возвращается: при успешном выполнении

sdsDecoupled

string

SDS отсоединён.

Возвращается: при успешном выполнении

sdsReceiveBufferAllocationFailures

string

Сбои выделения буфера приёма SDS.

Возвращается: при успешном выполнении

sdsState

string

Состояние SDS.

Возвращается: при успешном выполнении

softwareVersionInfo

string

Сведения о версии программного обеспечения SDS.

Возвращается: при успешном выполнении

Авторы

  • Rajshree Khare (@khareRajshree)
  • Trisha Datta (@trisha-dell)

Ссылки коллекции

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API