Spec-Zone.ru › Ansible

Модуль dellemc.powerflex.sdt — управление SDT (также называется целью NVMe) в Dell PowerFlex

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.powerflex.sdt.

Добавлено в dellemc.powerflex 2.6.0

  • Краткое описание
  • Требования
  • Параметры
  • Атрибуты
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управление SDT (также называется целью NVMe) в системе хранения PowerFlex включает создание SDT, получение сведений о SDT, управление IP-адресами и ролями SDT, изменение атрибутов SDT и удаление SDT.
  • Поддерживаются только версии PowerFlex 4.5 и выше.

Требования

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

  • Система хранения Dell PowerFlex версии 3.6 или более поздней.
  • PyPowerFlex 2.0.0.

Параметры

Параметр

Комментарии

discovery_port

integer

Порт обнаружения SDT.

hostname

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

string / обязательный

IP-адрес или FQDN хоста PowerFlex.

maintenance_mode

string

Состояние режима обслуживания SDT.

Варианты:

  • "active"
  • "inactive"

nvme_port

integer

Порт NVMe SDT.

password

string / обязательный

Пароль хоста PowerFlex.

port

integer

Номер порта для обмена данными с хостом PowerFlex.

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

protection_domain_name

string

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

sdt_ip_list

list / elements=dictionary

Словарь IP-адресов и соответствующих им ролей SDT.

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

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

ip

string / обязательный

IP-адрес SDT.

role

string / обязательный

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

Варианты:

  • "StorageOnly"
  • "HostOnly"
  • "StorageAndHost"

sdt_name

string / обязательный

Имя SDT.

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

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

sdt_new_name

string

Новое имя SDT; используется только для переименования SDT.

Используется только при обновлении. Игнорируется при создании.

state

string

Состояние SDT.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

storage_port

integer

Порт хранения SDT.

timeout

integer

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

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

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

username

string / обязательный

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

validate_certs

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

boolean

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

true — указывает, что SSL-сертификат необходимо проверять.

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

Варианты:

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

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Выполняет задачу для проверки без выполнения действий на целевом компьютере.

diff_mode

Поддержка: полная

Выполняет задачу, чтобы сообщить о внесённых или предполагаемых изменениях.

Примечания

Примечание

  • Для каждого SDT необходимо настроить IP-адреса и их роли.
  • Одним и тем же целевым IP-адресам можно назначить роли хранения и хоста.
  • Кроме того, можно назначить роль хранения одному целевому IP-адресу, а для роли хоста добавить другой целевой IP-адрес.
  • На каждой цели NVMe необходимо настроить обе роли.
  • Модули коллекции «dellemc.powerflex» предназначены для поддержки платформы хранения Dell PowerFlex.

Примеры

- name: Create SDT
  dellemc.powerflex.sdt:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    sdt_name: "sdt_example"
    sdt_ip_list:
      - ip: "172.169.xx.xx"
        role: "StorageAndHost"
      - ip: "172.169.yy.yy"
        role: "StorageAndHost"
    protection_domain_name: "PD1"
    storage_port: 12200
    nvme_port: 4420
    discovery_port: 8009
    state: "present"

- name: Rename SDT
  dellemc.powerflex.sdt:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    sdt_name: "sdt_example"
    sdt_new_name: "sdt_new_example"
    state: "present"

- name: Modify SDT port
  dellemc.powerflex.sdt:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    sdt_name: "sdt_example"
    nvme_port: 4421
    discovery_port: 8008
    state: "present"

- name: Change maintenance mode
  dellemc.powerflex.sdt:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    sdt_name: "sdt_example"
    maintenance_mode: "active"
    state: "present"

- name: Set IP and role to SDT
  dellemc.powerflex.sdt:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    sdt_name: "sdt_example"
    sdt_ip_list:
      - ip: "172.169.xx.xx"
        role: "StorageAndHost"
      - ip: "172.169.zz.zz"
        role: "StorageAndHost"
    state: "present"

- name: Remove SDT
  dellemc.powerflex.sdt:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    sdt_name: "sdt_example"
    state: "absent"

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

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

Ключ

Описание

changed

boolean

Указывает, был ли изменён ресурс.

Возвращается: always

Пример: false

sdt_details

dictionary

Сведения о SDT.

Возвращается: если SDT существует

Пример: {"authenticationError": "None", "certificateInfo": {"issuer": "/GN=MDM/CN=CA-804696a4dbe1d90f/L=Hopkinton/ST=Massachusetts/C=US/O=EMC/OU=ASD", "subject": "/GN=sdt-comp-0/CN=host41/L=Hopkinton/ST=Massachusetts/C=US/O=EMC/OU=ASD", "thumbprint": "07:1E:FC:48:03:42:E6:45:14:1D:AA:97:1F:4F:B9:B2:B4:11:99:09", "validFrom": "Oct 8 02:35:00 2024 GMT", "validFromAsn1Format": "241008023500Z", "validTo": "Oct 7 03:35:00 2034 GMT", "validToAsn1Format": "341007033500Z"}, "discoveryPort": 8009, "faultSetId": null, "id": "917d28ed00000000", "ipList": [{"ip": "172.169.xx.xx", "role": "StorageAndHost"}, {"ip": "172.169.yy.yy", "role": "StorageAndHost"}], "links": [{"href": "/api/instances/Sdt::917d28ed00000000", "rel": "self"}, {"href": "/api/instances/Sdt::917d28ed00000000/relationships/Statistics", "rel": "/api/Sdt/relationship/Statistics"}, {"href": "/api/instances/ProtectionDomain::b4787fa100000000", "rel": "/api/parent/relationship/protectionDomainId"}], "maintenanceState": "NoMaintenance", "mdmConnectionState": "Connected", "membershipState": "Joined", "name": "Sdt-pf460-svm-1", "nvmePort": 4420, "persistentDiscoveryControllersNum": 0, "protectionDomainId": "b4787fa100000000", "protectionDomainName": "PD1", "sdtState": "Normal", "softwareVersionInfo": "R4_5.2100.0", "storagePort": 12200, "systemId": "804696a4dbe1d90f"}

authenticationError

string

Указывает на ошибку аутентификации.

Возвращается: success

certificateInfo

dictionary

Сведения о сертификате.

Возвращается: success

issuer

string

Издатель сертификата.

Возвращается: success

subject

string

Субъект сертификата.

Возвращается: success

thumbprint

string

Отпечаток сертификата.

Возвращается: success

validFrom

string

Дата и время начала действия сертификата.

Возвращается: success

validFromAsn1Format

string

Дата начала действия в формате ASN.1.

Возвращается: success

validTo

string

Дата и время окончания действия сертификата.

Возвращается: success

validToAsn1Format

string

Дата окончания действия в формате ASN.1.

Возвращается: success

discoveryPort

integer

Порт обнаружения.

Возвращается: success

faultSetId

string

Идентификатор набора отказоустойчивости.

Возвращается: success

id

string

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

Возвращается: success

ipList

list / elements=string

Список IP-адресов SDS.

Возвращается: success

ip

string

IP-адрес, используемый SDS.

Возвращается: success

role

string

Роль IP-адреса SDS.

Возвращается: success

links

list / elements=string

Ссылки SDS.

Возвращается: success

href

string

URL экземпляра SDS.

Возвращается: success

rel

string

Связь SDS с различными объектами.

Возвращается: success

maintenanceState

string

Состояние обслуживания.

Возвращается: success

mdmConnectionState

string

Состояние подключения MDM.

Возвращается: success

membershipState

string

Состояние членства.

Возвращается: success

name

string

Имя SDS.

Возвращается: success

nvmePort

integer

Порт NVMe.

Возвращается: success

persistentDiscoveryControllersNum

integer

Количество постоянных контроллеров обнаружения.

Возвращается: success

protectionDomainId

string

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

Возвращается: success

protectionDomainName

string

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

Возвращается: success

sdtState

string

Состояние SDS.

Возвращается: success

softwareVersionInfo

string

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

Возвращается: success

storagePort

integer

Порт хранения.

Возвращается: success

systemId

string

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

Возвращается: success

Авторы

  • Yuhao Liu (@RayLiu7)

Ссылки на коллекцию

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

© 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/sdt_module.html

Spec-Zone.ru

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