Spec-Zone.ru › Ansible

Модуль dellemc.powerflex.replication_consistency_group — управление группами согласованности репликации на Dell PowerFlex

Примечание

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

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

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

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

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

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

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

  • Управление группами согласованности репликации в системе хранения PowerFlex включает получение сведений, создание, изменение, создание снимков, приостановку, возобновление, заморозку, разморозку, активацию, переключение при отказе, обращение репликации, восстановление, синхронизацию, переключение, деактивацию и удаление группы согласованности репликации.

Требования

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

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

Параметры

Параметр

Комментарии

activity_mode

string

Режим активности RCG.

Этот параметр поддерживается для версии 3.6 и выше.

Варианты:

  • "Active"
  • "Inactive"

create_snapshot

boolean

Создавать ли снимок группы согласованности репликации.

Варианты:

  • false
  • true

force

boolean

Принудительно переключить RCG.

Варианты:

  • false
  • true

hostname

aliases: gateway_host

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

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

is_consistent

boolean

Согласованность RCG.

Варианты:

  • false
  • true

new_rcg_name

string

Новое имя RCG.

password

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

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

pause_mode

string

Режим приостановки.

Обязателен, если для параметра pause задано значение true.

Варианты:

  • "StopDataTransfer"
  • "OnlyTrackChanges"

port

integer

Номер порта, через который осуществляется связь с хостом PowerFlex.

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

protection_domain_id

string

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

Несовместим с protection_domain_name.

protection_domain_name

string

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

Несовместим с protection_domain_id.

rcg_id

string

Идентификатор группы согласованности репликации.

Несовместим с rcg_name.

rcg_name

string

Имя группы согласованности репликации.

Уникально в пределах массива PowerFlex.

Несовместим с rcg_id.

rcg_state

string

Указывает действие для RCG.

Выполнить переключение при отказе для RCG.

Обратить репликацию RCG.

Восстановить RCG.

Переключить RCG.

Приостановить или возобновить RCG.

Заморозить или разморозить RCG.

Синхронизировать RCG.

Варианты:

  • "failover"
  • "reverse"
  • "restore"
  • "switchover"
  • "sync"
  • "pause"
  • "resume"
  • "freeze"
  • "unfreeze"

remote_peer

dictionary

Удаленная одноранговая система.

hostname

aliases: gateway_host

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

IP-адрес или FQDN шлюзового хоста удаленной одноранговой системы.

password

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

Пароль шлюзового хоста удаленной одноранговой системы.

port

integer

Номер порта, через который осуществляется связь со шлюзовым хостом удаленной одноранговой системы.

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

protection_domain_id

string

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

Несовместим с protection_domain_name.

protection_domain_name

string

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

Несовместим с protection_domain_id.

timeout

integer

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

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

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

username

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

Имя пользователя шлюзового хоста удаленной одноранговой системы.

validate_certs

aliases: verifycert

boolean

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

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

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

Варианты:

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

rpo

integer

Желаемое значение RPO в секундах.

state

string

Состояние группы согласованности репликации.

Варианты:

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

target_volume_access_mode

string

Режим доступа к целевому тому.

Варианты:

  • "ReadOnly"
  • "NoAccess"

timeout

integer

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

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

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

username

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

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

validate_certs

aliases: verifycert

boolean

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

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

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

Варианты:

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

Примечания

Примечание

  • Поддерживается режим check_mode.
  • Операция создания снимка не поддерживает идемпотентность.
  • После некоторых операций обновления RCG возникает задержка перед отображением итогового состояния RCG.
  • В версии 3.6 и выше при поступлении барьера согласованности группа согласованности репликации возвращается в согласованный режим после переключения в несогласованный режим. Поэтому повторная установка несогласованного режима возвращает значение changed: true.
  • В версии 3.0.0 параметры pause и freeze удалены. Вместо них используйте параметр «rcg_state».
  • Модули коллекции «dellemc.powerflex» предназначены для поддержки платформы хранения Dell PowerFlex.

Примеры

- name: Get RCG details
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "{{rcg_name}}"

- name: Create a snapshot of the RCG
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_id: "{{rcg_id}}"
    create_snapshot: true
    state: "present"

- name: Create a replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rpo: 60
    protection_domain_name: "domain1"
    activity_mode: "active"
    remote_peer:
      hostname: "{{hostname}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      port: "{{port}}"
      protection_domain_name: "domain1"

- name: Modify replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rpo: 60
    target_volume_access_mode: "ReadOnly"
    activity_mode: "Inactive"
    is_consistent: true

- name: Rename replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    new_rcg_name: "rcg_test_rename"

- name: Pause replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "pause"
    pause_mode: "StopDataTransfer"

- name: Resume replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "resume"

- name: Freeze replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "freeze"

- name: UnFreeze replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "unfreeze"

- name: Failover replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "failover"

- name: Reverse replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "reverse"

- name: Restore replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "restore"

- name: Switchover replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "switchover"

- name: Synchronize replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "sync"

- name: Delete replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    state: "absent"

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

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

Ключ

Описание

changed

boolean

Изменился ли ресурс.

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

Пример: false

replication_consistency_group_details

dictionary

Сведения о группе согласованности репликации.

Возвращается: если группа согласованности репликации существует

Пример: {"abstractState": "Ok", "activeLocal": true, "activeRemote": true, "currConsistMode": "Consistent", "disasterRecoveryState": "None", "error": 65, "failoverState": "None", "failoverType": "None", "freezeState": "Unfrozen", "id": "aadc17d500000000", "inactiveReason": 11, "lastSnapCreationRc": "SUCCESS", "lastSnapGroupId": "e58280b300000001", "lifetimeState": "Normal", "localActivityState": "Active", "name": "test_rcg", "pauseMode": "None", "peerMdmId": "6c3d94f600000000", "protectionDomainId": "b969400500000000", "remoteActivityState": "Active", "remoteDisasterRecoveryState": "None", "remoteId": "2130961a00000000", "remoteMdmId": "0e7a082862fedf0f", "remoteProtectionDomainId": "4eeb304600000000", "remoteProtectionDomainName": "domain1", "replicationDirection": "LocalToRemote", "rpoInSeconds": 30, "snapCreationInProgress": false, "targetVolumeAccessMode": "NoAccess", "type": "User"}

abstractState

string

Абстрактное состояние группы согласованности репликации.

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

activeLocal

boolean

Активна ли локальная группа согласованности репликации.

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

activeRemote

boolean

Активна ли удалённая группа согласованности репликации

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

currConsistMode

string

Текущий режим согласованности группы согласованности репликации.

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

disasterRecoveryState

string

Состояние аварийного восстановления локальной группы согласованности репликации.

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

error

integer

Код ошибки группы согласованности репликации.

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

failoverState

string

Состояние переключения при отказе группы согласованности репликации.

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

failoverType

string

Тип переключения при отказе группы согласованности репликации.

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

freezeState

string

Состояние заморозки группы согласованности репликации.

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

id

string

Идентификатор группы согласованности репликации.

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

inactiveReason

integer

Причина неактивности группы согласованности репликации.

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

lastSnapCreationRc

integer

Код возврата последнего снимка группы согласованности репликации.

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

lastSnapGroupId

string

Идентификатор последнего снимка группы согласованности репликации.

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

lifetimeState

string

Состояние жизненного цикла группы согласованности репликации.

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

localActivityState

string

Состояние активности локальной группы согласованности репликации.

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

name

string

Название группы согласованности репликации.

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

pauseMode

string

Состояние жизненного цикла группы согласованности репликации.

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

peerMdmId

string

Идентификатор однорангового MDM группы согласованности репликации.

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

protectionDomainId

string

Идентификатор домена защиты группы согласованности репликации.

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

remoteActivityState

string

Состояние активности удалённой группы согласованности репликации..

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

remoteDisasterRecoveryState

string

Состояние аварийного восстановления удалённой группы согласованности репликации.

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

remoteId

string

Идентификатор удалённой группы согласованности репликации.

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

remoteMdmId

string

Идентификатор удалённого MDM группы согласованности репликации.

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

remoteProtectionDomainId

string

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

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

remoteProtectionDomainName

string

Название удалённого домена защиты.

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

replicationDirection

string

Направление репликации группы согласованности репликации.

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

rpoInSeconds

integer

Значение RPO группы согласованности репликации в секундах.

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

snapCreationInProgress

boolean

Выполняется ли создание снимка группы согласованности репликации.

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

targetVolumeAccessMode

string

Режим доступа к целевому тому группы согласованности репликации.

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

type

string

Тип группы согласованности репликации.

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

Авторы

  • Trisha Datta (@Trisha-Datta)
  • Jennifer John (@Jennifer-John)

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

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

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

Spec-Zone.ru

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