Spec-Zone.ru › Ansible

Модуль hitachivantara.vspone_block.vsp.hv_remote_copy_group — управление группой удаленного копирования в блочных системах хранения VSP.

Примечание

Этот модуль входит в коллекцию hitachivantara.vspone_block (версия 4.8.1).

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

Чтобы установить её, используйте: ansible-galaxy collection install hitachivantara.vspone_block. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: hitachivantara.vspone_block.vsp.hv_remote_copy_group.

Добавлено в hitachivantara.vspone_block 3.2.0

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

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

  • - Этот модуль позволяет разделять, выполнять разделение со сменой ролей, повторную синхронизацию, повторную синхронизацию со сменой ролей, перехват управления и удаление группы удаленного копирования в блочных системах хранения VSP. - Поддерживаются различные операции с парами удаленного копирования в зависимости от указанного уровня задачи. - Модуль поддерживает следующие типы репликации: HUR, TC, GAD. - Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/remote_copy_group.yml

Требования

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

  • python >= 3.9

Параметры

Параметр

Комментарии

connection_info

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

Информация, необходимая для установления подключения к системе хранения.

address

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

IP-адрес или имя хоста системы хранения.

api_token

string

Токен для работы с заблокированными ресурсами.

password

string

Пароль для аутентификации. Это обязательное поле.

username

string

Имя пользователя для аутентификации. Это обязательное поле.

secondary_connection_info

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

Информация, необходимая для установления подключения к вторичной системе хранения.

address

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

IP-адрес или имя хоста вторичной системы хранения.

api_token

string

Значение токена блокировки для работы с заблокированными ресурсами.

password

string

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

username

string

Имя пользователя для аутентификации во вторичной системе хранения. Это обязательное поле, если api_token не указан.

spec

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

Спецификация задачи для группы удаленного копирования.

consistency_group_id

integer

Для TC укажите идентификатор группы согласованности десятичным числом от 0 до 255. Необязательный параметр для задач Resync Remote Copy Group for TC /Resync Remote Copy Group for GAD /Swap-Resync Remote Copy Group for TC /Swap-Resync Remote Copy Group for GAD.

copy_group_name

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

Имя группы копирования; требуется для всех операций. Требуется для задач Split remote copy group for HUR /Split remote copy group for TC /Split Remote Copy Group for GAD /Resync Remote Copy Group for HUR /Resync Remote Copy Group for TC /Resync Remote Copy Group for GAD /Swap-Split Remote Copy Group for all replication types [HUR, TC, GAD] /Swap-Resync Remote Copy Group for HUR /Swap-Resync Remote Copy Group for TC /Swap-Resync Remote Copy Group for GAD /Delete remote copy group /Takeover Remote Copy Group for HUR replication type.

copy_pace

integer

Для TC укажите десятичное число от 1 до 15, задающее размер копируемых дорожек. Чем больше указанное значение, тем выше скорость копирования. Необязательный параметр для задач Resync Remote Copy Group for TC /Swap-Resync Remote Copy Group for TC.

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

do_data_suspend

boolean

Для UR укажите, следует ли принудительно останавливать операции с журналом при увеличении объёма обращений к нему. Необязательный параметр для задачи Split remote copy group for HUR.

Варианты:

  • false
  • true

do_failback

boolean

Укажите, следует ли выполнять возврат при сбое в каскадной конфигурации 3DC. Если задано значение true, выполняется возврат. Если задано значение false, возврат не выполняется. Если значение не указано, предполагается false.

Варианты:

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

do_pvol_write_protect

boolean

Для TC укажите, следует ли принудительно отключить операции записи для P-VOL. Необязательный параметр для задач Split remote copy group for HUR /Split remote copy group for TC.

Варианты:

  • false
  • true

failback_mirror_unit_number

integer

Укажите номер MU (зеркального устройства) тома, для которого выполняется возврат. Этот атрибут можно указать, только если атрибут do_failback имеет значение true.

fence_level

string

Задаёт уровень ограждения первичного тома и определяет, будет ли хосту запрещён доступ к первичному тому или он сможет продолжать обращаться к нему, если пара приостановлена из-за ошибки. Необязательный параметр для задачи Resync Remote Copy Group for TC.

Варианты:

  • "NEVER"
  • "DATA"
  • "STATUS"

is_consistency_group

boolean

Для TC укажите значение в зависимости от того, зарегистрирована ли пара в группе согласованности.

Если пара не зарегистрирована в группе согласованности

true — зарегистрировать пару в группе согласованности.

false — оставить пару без изменений, не регистрируя её в группе согласованности.

Если пара зарегистрирована в группе согласованности

true — оставить пару зарегистрированной в группе согласованности.

false — отменить регистрацию пары в группе согласованности, переведя её в незарегистрированное состояние.

Необязательный параметр для задачи Resync Remote Copy Group for TC

/Resync Remote Copy Group for GAD

/Swap-Resync Remote Copy Group for TC

/Swap-Resync Remote Copy Group for GAD.

Варианты:

  • false
  • true

is_svol_writable

boolean

Является ли svol доступным для записи. Необязательный параметр для задач Split remote copy group for HUR /Split remote copy group for TC.

Варианты:

  • false
  • true

local_device_group_name

string

Имя группы устройств в локальной системе хранения. Необязательный параметр для задач Split remote copy group for HUR /Split Remote Copy Group for GAD /Resync Remote Copy Group for HUR /Resync Remote Copy Group for TC /Resync Remote Copy Group for GAD /Swap-Split Remote Copy Group for all replication types [HUR, TC, GAD] /Swap-Resync Remote Copy Group for HUR /Swap-Resync Remote Copy Group for TC /Swap-Resync Remote Copy Group for GAD /Delete remote copy group. Обязательный параметр для задачи Split remote copy group for TC.

remote_device_group_name

string

Имя группы устройств в удалённой системе хранения. Необязательный параметр для задач Split remote copy group for HUR /Split remote copy group for TC /Split Remote Copy Group for GAD /Resync Remote Copy Group for HUR /Resync Remote Copy Group for TC /Resync Remote Copy Group for GAD /Swap-Split Remote Copy Group for all replication types [HUR, TC, GAD] /Swap-Resync Remote Copy Group for HUR /Swap-Resync Remote Copy Group for TC /Swap-Resync Remote Copy Group for GAD /Delete remote copy group. Обязательный параметр для задачи Takeover Remote Copy Group for HUR replication type.

replication_type

string

Тип репликации: UR, TC или GAD. Необязательный параметр для задач Split remote copy group for HUR /Split remote copy group for TC /Resync Remote Copy Group for HUR /Resync Remote Copy Group for TC /Swap-Split Remote Copy Group for all replication types [HUR, TC, GAD] /Swap-Resync Remote Copy Group for HUR /Swap-Resync Remote Copy Group for TC /Takeover Remote Copy Group for HUR replication type. Обязательный параметр для задач Split Remote Copy Group for GAD /Resync Remote Copy Group for GAD /Swap-Resync Remote Copy Group for GAD.

Варианты:

  • "TC"
  • "UR"
  • "GAD"
  • "HUR"

svol_operation_mode

string

Укажите этот атрибут, чтобы принудительно изменить состояние пар S-VOL, например, если произошёл сбой в системе хранения первичного сайта.

state

string

- Уровень задачи для пар группы удаленного копирования. - Допустимые значения: present, absent, split, resync, swap_split, swap_resync, takeover.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"
  • "split"
  • "resync"
  • "swap_split"
  • "swap_resync"
  • "takeover"

storage_system_info

dictionary

Информация о системе хранения. Это необязательное поле.

serial

string

Серийный номер системы хранения.

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: нет

Определяет, должен ли модуль работать в режиме проверки.

Примечания

Примечание

  • Поддержка типа подключения gateway удалена начиная с версии 3.4.0. Если вам нужен этот тип подключения, используйте более раннюю версию.

Примеры

- name: Split remote copy group for HUR
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: split
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: hur
      is_svol_writable: false
      do_data_suspend: false

- name: Resync remote copy group for HUR
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: resync
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: hur

- name: Swap split remote copy group for HUR
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: swap_split
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: hur

- name: Swap resync remote copy group for HUR
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: swap_resync
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: hur

- name: Delete remote copy group for HUR
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: absent
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1

- name: Split remote copy group for TrueCopy
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: split
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: TC
      is_svol_writable: false
      do_pvol_write_protect: false

- name: Resync remote copy group for TrueCopy
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: resync
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: TC
      is_consistency_group: true
      consistency_group_id: 47
      fence_level: NEVER
      copy_pace: 3

- name: Swap split remote copy group for TrueCopy
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: swap_split
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: TC

- name: Swap resync remote copy group for TrueCopy
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: swap_resync
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: TC

- name: Delete remote copy group for TrueCopy
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: absent
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1

- name: Split remote copy group for GAD
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: split
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: GAD

- name: Resync remote copy group for GAD
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: resync
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: GAD
      is_consistency_group: true
      consistency_group_id: 47

- name: Swap split remote copy group for GAD
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: swap_split
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: GAD

- name: Swap resync remote copy group for GAD
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: swap_resync
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      remote_device_group_name: remote_copy_group_remote_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: GAD

- name: Delete remote copy group for GAD
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: absent
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1

- name: Takeover remote copy group for HUR
  hitachivantara.vspone_block.vsp.hv_remote_copy_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: takeover
    spec:
      local_device_group_name: remote_copy_group_local_device_group_name_1
      copy_group_name: remote_copy_group_copy_group_name_1
      replication_type: hur

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

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

Ключ

Описание

remote_copy_group_info

dictionary

Объект вновь созданной группы удалённого копирования.

Возвращается: при успехе

copy_group_name

string

Имя группы копирования.

Возвращается: при успехе

Пример: "copygroupname001"

copy_pairs

list / elements=dictionary

Список пар копирования в группе копирования.

Возвращается: при успехе

consistency_group_id

integer

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

Возвращается: при успехе

Пример: 51

copy_group_name

string

Имя группы копирования.

Возвращается: при успехе

Пример: "copygroupname001"

copy_pair_name

string

Имя пары копирования.

Возвращается: при успехе

Пример: "copypairname00190"

fence_level

string

Уровень защиты от рассогласования.

Возвращается: при успехе

Пример: "ASYNC"

pvol_difference_data_management

string

Управление данными различий PVOL.

Возвращается: при успехе

Пример: "S"

pvol_i_o_mode

string

Режим ввода-вывода PVOL.

Возвращается: при успехе

pvol_journal_id

integer

Идентификатор журнала PVOL.

Возвращается: при успехе

Пример: 37

pvol_ldev_id

integer

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

Возвращается: при успехе

Пример: 1872

pvol_processing_status

string

Состояние обработки PVOL.

Возвращается: при успехе

Пример: "N"

pvol_status

string

Состояние PVOL.

Возвращается: при успехе

Пример: "PSUS"

pvol_storage_device_id

string

Идентификатор устройства хранения PVOL.

Возвращается: при успехе

Пример: "900000040014"

quorum_disk_id

string

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

Возвращается: при успехе

remote_mirror_copy_pair_id

string

Идентификатор пары удалённого зеркального копирования.

Возвращается: при успехе

Пример: "900000040015,copygroupname001,copygroupname001P_,copygroupname001S_,copypairname00190"

replication_type

string

Тип репликации.

Возвращается: при успехе

Пример: "UR"

svol_difference_data_management

string

Управление данными различий SVOL.

Возвращается: при успехе

Пример: "S"

svol_i_o_mode

string

Режим ввода-вывода SVOL.

Возвращается: при успехе

svol_journal_id

integer

Идентификатор журнала SVOL.

Возвращается: при успехе

Пример: 40

svol_ldev_id

integer

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

Возвращается: при успехе

Пример: 2180

svol_processing_status

string

Состояние обработки SVOL.

Возвращается: при успехе

Пример: "N"

svol_status

string

Состояние SVOL.

Возвращается: при успехе

Пример: "SSUS"

svol_storage_device_id

string

Идентификатор устройства хранения SVOL.

Возвращается: при успехе

Пример: "900000040015"

local_device_group_name

string

Имя локальной группы устройств.

Возвращается: при успехе

Пример: "copygroupname001P_"

mu_number

integer

Номер MU.

Возвращается: при успехе

Пример: 1

remote_device_group_name

string

Имя удалённой группы устройств.

Возвращается: при успехе

Пример: "copygroupname001S_"

remote_mirror_copy_group_id

string

Идентификатор группы удалённого зеркального копирования.

Возвращается: при успехе

Пример: "900000040015,copygroupname001,copygroupname001P_,copygroupname001S_"

remote_storage_device_id

string

Идентификатор удалённого устройства хранения.

Возвращается: при успехе

Пример: "900000040015"

Авторы

  • Hitachi Vantara, LTD. (@hitachi-vantara)

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

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

© 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/hitachivantara/vspone_block/vsp.hv_remote_copy_group_module.html

Spec-Zone.ru

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