Модуль hitachivantara.vspone_block.vsp.hv_hur — управление парами HUR в блочных системах хранения данных 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_hur.

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

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info словарь / обязательный	Информация, необходимая для подключения к системе хранения данных.
address строка / обязательный	IP-адрес или имя узла системы хранения данных.
api_token строка	Токен для работы с заблокированными ресурсами.
connection_type строка	Тип подключения к системе хранения данных. Варианты: `"direct"` ← (по умолчанию)
password строка	Пароль для аутентификации. Это обязательное поле.
username строка	Имя пользователя для аутентификации. Это обязательное поле.
secondary_connection_info словарь	Информация, необходимая для подключения к вторичной системе хранения данных.
address строка / обязательный	IP-адрес или имя узла вторичной системы хранения данных.
api_token строка	Значение токена блокировки для работы с заблокированными ресурсами.
password строка	Пароль для аутентификации во вторичной системе хранения данных, если api_token не указан.
username строка	Имя пользователя для аутентификации во вторичной системе хранения данных, если api_token не указан.
spec словарь / обязательный	Спецификация задачи для пар HUR.
allocate_new_consistency_group логическое значение	Укажите, следует ли выделить новую группу согласованности. Варианты: `false` ← (по умолчанию) `true`
begin_secondary_volume_id строка	Укажите начальный идентификатор LDEV для диапазона LDEV вторичного тома. Обязателен для задачи «Создание пары HUR с использованием диапазона идентификаторов вторичного тома». Если это поле указано, необходимо также указать end_secondary_volume_id. Если это поле не указано, модули Ansible попытаются создать SVOL с тем же идентификатором, что и у PVOL, если он доступен; в противном случае будет использован первый доступный идентификатор LDEV.
consistency_group_id целое число	Идентификатор группы согласованности. Необязателен для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-NVMe», «Создание пары HUR-ISCSI», «Создание пары HUR и отладочного результата», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата».
copy_group_name строка	Имя группы копирования. Обязательно для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR в существующей группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-NVMe», «Создание пары HUR-ISCSI», «Создание пары HUR с provisioned_secondary_volume_id», «Создание пары HUR с provisioned_secondary_volume_id и группами хостов», «Разделение пары HUR», «Повторная синхронизация пары HUR», «Обмен с разделением пары HUR», «Обмен с повторной синхронизацией пары HUR», «Удаление пары HUR», «Расширение пары HUR», «Переключение на вторичный том в паре HUR», «Создание пары HUR и отладочного результата», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата».
copy_pair_name строка	Имя пары копирования. Обязательно для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR в существующей группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-NVMe», «Создание пары HUR-ISCSI», «Создание пары HUR с provisioned_secondary_volume_id», «Создание пары HUR с provisioned_secondary_volume_id и группами хостов», «Разделение пары HUR», «Повторная синхронизация пары HUR», «Обмен с разделением пары HUR», «Обмен с повторной синхронизацией пары HUR», «Удаление пары HUR», «Расширение пары HUR», «Переключение на вторичный том в паре HUR», «Создание пары HUR и отладочного результата», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата».
do_delta_resync_suspend логическое значение	Укажите, следует ли включить приостановку дельта-синхронизации. Варианты: `false` `true`
do_initial_copy логическое значение	Выполнить первоначальное копирование. Необязательное поле при создании. Варианты: `false` `true` ← (по умолчанию)
enable_delta_resync логическое значение	Укажите, следует ли включить дельта-синхронизацию. Варианты: `false` ← (по умолчанию) `true`
end_secondary_volume_id строка	Укажите конечный идентификатор LDEV для диапазона LDEV вторичного тома. Обязателен для задачи «Создание пары HUR с использованием диапазона идентификаторов вторичного тома». Если это поле указано, необходимо также указать begin_secondary_volume_id. Если это поле не указано, модули Ansible попытаются создать SVOL с тем же идентификатором, что и у PVOL, если он доступен; в противном случае будет использован первый доступный идентификатор LDEV.
fence_level строка	Задает уровень ограждения первичного тома и определяет, будет ли хосту запрещен доступ к первичному тому или он сможет продолжать работу с ним, если пара приостановлена из-за ошибки. Необязательное поле. Варианты: `"ASYNC"` ← (по умолчанию)
is_consistency_group логическое значение	Укажите, следует ли включить группу согласованности. Варианты: `false` ← (по умолчанию) `true`
is_data_reduction_force_copy логическое значение	Принудительное копирование для сокращения объема данных. Необязательный параметр для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR-NVMe» и «Создание пары HUR-ISCSI». Варианты: `false` `true` ← (по умолчанию)
is_new_group_creation логическое значение	Укажите, следует ли включить создание новой группы. Варианты: `false` `true`
is_svol_readwriteable логическое значение	Укажите, следует ли разрешить чтение и запись вторичного тома. Необязательно для задачи «Разделение пары HUR». Варианты: `false` `true`
local_device_group_name строка	Имя локальной группы устройств. Необязательно для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-NVMe», «Создание пары HUR-ISCSI», «Разделение пары HUR», «Повторная синхронизация пары HUR», «Обмен с разделением пары HUR», «Обмен с повторной синхронизацией пары HUR», «Удаление пары HUR», «Создание пары HUR и отладочного результата», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата».
mirror_unit_number псевдонимы: mirror_unit_id целое число	Идентификатор блока зеркалирования. Необязателен для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-NVMe», «Создание пары HUR-ISCSI», «Создание пары HUR с provisioned_secondary_volume_id», «Создание пары HUR с provisioned_secondary_volume_id и группами хостов», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата». Варианты: `0` `1` `2` `3`
new_volume_size строка	Новый размер тома. Обязателен для задачи «Расширение пары HUR».
path_group_id целое число	Необязателен для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR-NVMe» и «Создание пары HUR-ISCSI». Укажите идентификатор группы путей в диапазоне от 0 до 255. Если вы не уверены, не используйте этот параметр. Если значение не указано или равно 0, будет использован наименьший идентификатор в заданной группе путей.
primary_volume_id строка	Идентификатор первичного тома. Обязателен для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR в существующей группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-NVMe», «Создание пары HUR-ISCSI», «Создание пары HUR с provisioned_secondary_volume_id», «Создание пары HUR с provisioned_secondary_volume_id и группами хостов», «Создание пары HUR и отладочного результата», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата».
primary_volume_journal_id целое число	Идентификатор журнала первичного тома. Обязателен для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-ISCSI», «Создание пары HUR с provisioned_secondary_volume_id», «Создание пары HUR с provisioned_secondary_volume_id и группами хостов», «Создание пары HUR и отладочного результата», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата». Необязателен для задачи «Создание пары HUR-NVMe».
provisioned_secondary_volume_id строка	Идентификатор подготовленного вторичного тома, который требуется использовать для создания пары HUR. Обязателен для задач «Создание пары HUR с provisioned_secondary_volume_id» и «Создание пары HUR с provisioned_secondary_volume_id и группами хостов».
remote_device_group_name строка	Имя удаленной группы устройств. Необязательно для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR-NVMe», «Создание пары HUR-ISCSI», «Разделение пары HUR», «Повторная синхронизация пары HUR», «Обмен с разделением пары HUR», «Обмен с повторной синхронизацией пары HUR», «Удаление пары HUR», «Создание пары HUR и отладочного результата», «Создание пары HUR-iSCSI и отладочного результата» и «Создание пары HUR-NVMe и отладочного результата». Обязательно для задачи «Переключение на вторичный том в паре HUR».
secondary_hostgroup словарь	Устаревший параметр. Используйте secondary_hostgroups.
lun_id целое число	Идентификатор LUN можно указать вместе с группой хостов во вторичной системе хранения данных.
name строка / обязательный	Имя группы хостов во вторичной системе хранения данных.
port_id псевдонимы: port строка / обязательный	Идентификатор порта группы хостов во вторичной системе хранения данных. Поле port устарело; вместо него следует использовать port_id.
secondary_hostgroups список / elements=dictionary	Список объектов групп хостов для вторичного тома. Обязателен для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR в существующей группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома» и «Создание пары HUR с provisioned_secondary_volume_id и группами хостов». Необязателен для задачи «Создание пары HUR и отладочного результата».
lun_id целое число	Идентификатор LUN группы хостов во вторичной системе хранения данных. Необязателен для задач «Создание пары HUR в новой группе копирования» и «Создание пары HUR в существующей группе копирования». Обязателен для задачи «Создание пары HUR с provisioned_secondary_volume_id и группами хостов».
name строка / обязательный	Имя группы хостов во вторичной системе хранения данных. Обязательно для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR в существующей группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR с provisioned_secondary_volume_id и группами хостов» и «Создание пары HUR и отладочного результата».
port_id псевдонимы: port строка / обязательный	Идентификатор порта группы хостов во вторичной системе хранения данных. Обязателен для задач «Создание пары HUR в новой группе копирования», «Создание пары HUR в существующей группе копирования», «Создание пары HUR с использованием диапазона идентификаторов вторичного тома», «Создание пары HUR с provisioned_secondary_volume_id и группами хостов» и «Создание пары HUR и отладочного результата». Поле port устарело; вместо него следует использовать port_id.
secondary_iscsi_targets список / elements=dictionary	Список целей iSCSI на вторичном устройстве хранения данных. Обязателен для задачи «Создание пары HUR-ISCSI». Необязателен для задачи «Создание пары HUR-iSCSI и отладочного результата».
lun_id целое число	Идентификатор LUN. Обязателен для задач «Создание пары HUR-ISCSI» и «Создание пары HUR-iSCSI и отладочного результата».
name строка / обязательный	Имя цели iSCSI. Обязательно для задач «Создание пары HUR-ISCSI» и «Создание пары HUR-iSCSI и отладочного результата».
port_id псевдонимы: port строка / обязательный	Идентификатор порта. Обязателен для задач «Создание пары HUR-ISCSI» и «Создание пары HUR-iSCSI и отладочного результата». Поле port устарело; вместо него следует использовать port_id.
secondary_nvm_subsystem словарь	Сведения о подсистеме NVM вторичного тома. Обязателен для задачи «Создание пары HUR-NVMe». Необязателен для задачи «Создание пары HUR-NVMe и отладочного результата».
name строка / обязательный	Имя подсистемы NVM во вторичной системе хранения данных. Обязательно для задач «Создание пары HUR-NVMe» и «Создание пары HUR-NVMe и отладочного результата».

paths list / elements=string	Информация о путях Host NQN в целевой системе хранения. Обязательный параметр для задач создания пары HUR-NVMe / создания пары HUR-NVMe и проверки результатов.
secondary_pool_id integer	Идентификатор динамического пула в целевой системе хранения, где будет создан целевой том. Обязательный параметр для задач создания пары HUR в новой группе копирования / создания пары HUR в существующей группе копирования / создания пары HUR с использованием диапазона идентификаторов целевых томов / создания пары HUR-NVMe / создания пары HUR-ISCSI / создания пары HUR и проверки результатов / создания пары HUR-iSCSI и проверки результатов / создания пары HUR-NVMe и проверки результатов.
secondary_storage_serial_number integer	Серийный номер целевой системы хранения.
secondary_volume_journal_id integer	Идентификатор журнала целевого тома. Обязательный параметр для задач создания пары HUR в новой группе копирования / создания пары HUR с использованием диапазона идентификаторов целевых томов / создания пары HUR-ISCSI / создания пары HUR с provisioned_secondary_volume_id / создания пары HUR с provisioned_secondary_volume_id и группами хостов / создания пары HUR и проверки результатов / создания пары HUR-iSCSI и проверки результатов / создания пары HUR-NVMe и проверки результатов. Необязательный параметр для задачи создания пары HUR-NVMe.
should_delete_svol boolean	Укажите true, чтобы удалить SVOL. Необязательный параметр для задачи удаления пары HUR. Варианты: `false` ← (по умолчанию) `true`
state string	Уровень задачи для пар HUR. Варианты: `"present"` ← (по умолчанию) `"absent"` `"split"` `"resync"` `"resize"` `"expand"` `"swap_split"` `"swap_resync"` `"takeover"`
storage_system_info dictionary	Информация о системе хранения. Это необязательное поле.
serial string	Серийный номер системы хранения.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Определяет, следует ли запускать модуль в режиме проверки.

Примечания

Примечание

Выходные параметры entitlement_status, subscriber_id и partner_id удалены в версии 3.4.0. Они устарели в связи с упрощением внутреннего API и больше не поддерживаются.
Тип подключения gateway удален начиная с версии 3.4.0. Если вам требуется этот тип подключения, используйте более раннюю версию.
Модули Ansible используют технологию групп копирования для управления всеми типами пар удаленной репликации (GAD, TC, HUR). Поэтому пары репликации, созданные средствами, не использующими технологию групп копирования, несовместимы с модулями Ansible. В результате модули Ansible не могут управлять парами репликации, созданными без использования технологии групп копирования.
Прежде чем управлять парой HUR через Ansible Direct Connect, необходимо зарегистрировать (или объединить в пару) исходную и целевую системы хранения на сервере API исходной системы хранения. Этот шаг необходим, поскольку Ansible использует вызовы REST API во внутреннем интерфейсе. Если пропустить этот шаг — особенно если вы не знакомы с REST API Hitachi, — при управлении парой HUR через Ansible возникнут ошибки. Инструкции см. в разделе «Управление регистрацией удаленной системы хранения».
Для создания пары HUR в новой группе копирования, в существующей группе копирования и с использованием диапазона идентификаторов целевых томов
1. Если имя P-VOL не задано, S-VOL получит имя в формате smrha-[ldev_id]. Если P-VOL имеет имя, S-VOL следует присвоить такое же имя. (Здесь smrha означает Storage Module Red Hat Ansible.)
Для расширения пары HUR
1. Сначала увеличивается размер S-VOL, а затем P-VOL. Если пара находится в состоянии PAIR, перед изменением размера она разделяется. После завершения операции изменения размера пара синхронизируется повторно.
1. Чтобы использовать этот API, включите режим системных параметров (SOM) 1198 и отключите SOM 1199 на обеих системах хранения — основной и целевой.

Примеры

- name: Create a HUR pair in new copy group
  hitachivantara.vspone_block.vsp.hv_hur:
    state: "present"
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      copy_group_name: hur_copy_group_name_1
      copy_pair_name: hur_copy_pair_name_1
      primary_volume_id: 234
      secondary_pool_id: 0
      primary_volume_journal_id: 11
      secondary_volume_journal_id: 12
      local_device_group_name: hur_copy_group_name_1P_
      remote_device_group_name: hur_copy_group_name_1S_
      consistency_group_id: 0
      secondary_hostgroups:
        - name: hg_1
          port_id: CL1-A
          lun_id: 5
      mirror_unit_number: 0

- name: Create a HUR pair in existing copy group
  hitachivantara.vspone_block.vsp.hv_hur:
    state: "present"
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      copy_group_name: "hur_copy_group_name_1"
      copy_pair_name: "hur_copy_pair_name_2"
      primary_volume_id: 334
      secondary_pool_id: 0
      secondary_hostgroups:
        - name: hg_1
          port_id: CL1-A

- name: Split HUR pair
  hitachivantara.vspone_block.vsp.hv_hur:
    state: "split"
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      local_device_group_name: hur_local_device_group_name_3
      remote_device_group_name: hur_remote_device_group_name_3
      copy_group_name: hur_copy_group_name_3
      copy_pair_name: hur_copy_pair_name_3
      is_svol_readwriteable: true

- name: Resync HUR pair
  hitachivantara.vspone_block.vsp.hv_hur:
    state: "resync"
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      local_device_group_name: hur_local_device_group_name_3
      remote_device_group_name: hur_remote_device_group_name_3
      copy_group_name: hur_copy_group_name_3
      copy_pair_name: hur_copy_pair_name_3

- name: Delete HUR pair
  hitachivantara.vspone_block.vsp.hv_hur:
    state: "absent"
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      local_device_group_name: hur_local_device_group_name_3
      remote_device_group_name: hur_remote_device_group_name_3
      copy_group_name: hur_copy_group_name_3
      copy_pair_name: hur_copy_pair_name_3

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

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

Ключ	Описание
hur_info dictionary	Объект вновь созданной пары HUR. Возвращается: при успешном выполнении
consistency_group_id integer	Идентификатор группы согласованности. Возвращается: при успешном выполнении Пример: `51`
copy_group_name string	Имя группы копирования. Возвращается: при успешном выполнении Пример: `"snewar_hur_copy_group_12"`
copy_pair_name string	Имя пары копирования. Возвращается: при успешном выполнении Пример: `"snewar_hur_copy_pair_12"`
copy_rate integer	Устарело. Скорость копирования. Возвращается: при успешном выполнении Пример: `-1`
fence_level string	Настройка уровня ограждения. Возвращается: при успешном выполнении Пример: `"ASYNC"`
local_device_group_name string	Имя локальной группы устройств, для которой извлекаются сведения о паре TrueCopy. Возвращается: при успешном выполнении Пример: `"hur_bulk_cg_1P_"`
mirror_unit_id integer	Устарело. Используйте mirror_unit_number. Возвращается: при успешном выполнении Пример: `1`
mirror_unit_number integer	Номер модуля зеркалирования. Возвращается: при успешном выполнении Пример: `1`
primary_journal_id integer	Идентификатор основного журнала. Возвращается: при успешном выполнении Пример: `25`
primary_journal_pool integer	Устарело. Используйте primary_journal_id. Возвращается: при успешном выполнении Пример: `25`
primary_volume_id integer	Идентификатор основного тома. Возвращается: при успешном выполнении Пример: `6442`
primary_volume_id_hex string	Шестнадцатеричное представление идентификатора основного тома. Возвращается: при успешном выполнении Пример: `"00:19:2A"`
primary_volume_status string	Состояние основного тома. Возвращается: при успешном выполнении Пример: `"PAIR"`
primary_volume_storage_id string	Устарело. Используйте primary_volume_storage_serial_number. Возвращается: при успешном выполнении Пример: `"810050"`
primary_volume_storage_serial_number string	Серийный номер системы хранения для основного тома. Возвращается: при успешном выполнении Пример: `"810050"`
pvol_status string	Устарело. Используйте primary_volume_status. Возвращается: при успешном выполнении Пример: `"PAIR"`
pvol_storage_device_id string	Устарело. Идентификатор устройства хранения PVOL. Возвращается: при успешном выполнении Пример: `"A34000810050"`
remote_device_group_name string	Имя удаленной группы устройств, для которой извлекаются сведения о паре TrueCopy. Возвращается: при успешном выполнении Пример: `"hur_bulk_cg_1S_"`
remote_mirror_copy_pair_id string	Устарело. Идентификатор пары копирования удаленного зеркала. Возвращается: при успешном выполнении Пример: `"A34000810050,spcA34000810045A34000810050,spcA34000810045A34000810050,spcA34000810050A34000810045,spc-7331-6442"`
secondary_journal_id integer	Идентификатор целевого журнала. Возвращается: при успешном выполнении Пример: `25`
secondary_journal_pool integer	Устарело. Используйте secondary_journal_id. Возвращается: при успешном выполнении Пример: `25`
secondary_volume_id integer	Идентификатор целевого тома. Возвращается: при успешном выполнении Пример: `7331`
secondary_volume_id_hex string	Шестнадцатеричное представление идентификатора целевого тома. Возвращается: при успешном выполнении Пример: `"00:1C:A3"`
secondary_volume_storage_id string	Устарело. Используйте secondary_volume_storage_serial_number. Возвращается: при успешном выполнении Пример: `"810045"`
secondary_volume_storage_serial_number string	Серийный номер системы хранения для целевого тома. Возвращается: при успешном выполнении Пример: `"810045"`
svol_status string	Состояние SVOL. Возвращается: при успешном выполнении Пример: `"PAIR"`
svol_storage_device_id string	Устарело. Идентификатор устройства хранения SVOL. Возвращается: при успешном выполнении Пример: `"A34000810045"`

Авторы

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_hur_module.html