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

Примечание

Этот модуль входит в коллекцию 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_vsp_one_gad_consistency_group.

Новое в hitachivantara.vspone_block 4.8.0

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

Обзор

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Сведения, необходимые для подключения к системе хранения.
address string / обязательный	IP-адрес или имя хоста системы хранения.
api_token string	Токен для работы с заблокированными ресурсами.
connection_type string	Тип подключения к системе хранения. Варианты: `"direct"` ← (по умолчанию)
password string	Пароль для аутентификации. Это обязательное поле.
username string	Имя пользователя для аутентификации. Это обязательное поле.
secondary_connection_info dictionary / обязательный	Сведения, необходимые для подключения к вторичной системе хранения.
address string / обязательный	IP-адрес или имя хоста вторичной системы хранения.
api_token string	Значение токена блокировки для работы с заблокированными ресурсами.
password string	Пароль для аутентификации. Это поле обязательно для подключения к вторичной системе хранения, если не указан api_token.
username string	Имя пользователя для аутентификации. Это поле обязательно для подключения к вторичной системе хранения, если не указан api_token.
spec dictionary / обязательный	Спецификация задачи для группы согласованности GAD.
consistency_group_ids list / элементы=integer / обязательный	Список идентификаторов групп согласованности. Идентификатор каждой группы согласованности должен быть целым числом в диапазоне от 0 до 1023 включительно.
continue_io_volume string	Том, на котором следует продолжить операции ввода-вывода во время приостановки. Указывает, какой том должен оставаться активным для операций ввода-вывода во время приостановки. Допустимые значения: PRIMARY или SECONDARY. Регистр не учитывается.
copy_pace integer	Скорость копирования для операции повторной синхронизации. Более высокие значения означают более высокую скорость копирования. Допустимые значения — целые числа от 1 до 15. По умолчанию: `3`
io_preference_mode string	Режим предпочтения операций ввода-вывода для операции повторной синхронизации. Определяет, как обрабатываются операции ввода-вывода во время повторной синхронизации. Допустимые значения: KEEP_CURRENT_SETTING, DISABLED или PRIMARY_ENABLED. Регистр не учитывается.
state string	Уровень задачи для группы согласованности GAD. Варианты: `"present"` ← (по умолчанию) `"absent"` `"suspended"` `"resynced"`

Атрибуты

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

Примечания

Примечание

Поддержка типа подключения gateway прекращена начиная с версии 3.4.0. Если вам требуется этот тип подключения, используйте более раннюю версию.
Модули Ansible используют технологию copy group для управления всеми типами пар удалённой репликации (GAD, TC, HUR). Поэтому пары репликации, созданные с помощью инструментов, не использующих технологию copy group, несовместимы с модулями Ansible и не могут управляться ими.
Этот модуль поддерживает пары GAD на основе Fibre Channel, iSCSI, NVMe Fibre Channel и NVMe TCP.
Для конфигураций GAD с одним сервером, кластером и crosspath
1. Перед управлением парой GAD через Ansible Direct Connect необходимо зарегистрировать (или связать) исходную и целевую системы хранения на сервере API исходной системы хранения. Этот шаг необходим, поскольку Ansible использует вызовы REST API на серверной стороне. Если пропустить этот шаг — особенно если вы не знакомы с REST API Hitachi, — при управлении парой GAD через Ansible возникнут ошибки. Инструкции см. в разделе «Управление регистрацией удалённой системы хранения».
1. После создания вторичной группы хостов необходимо вручную добавить её в группу ресурсов VSM.
1. В группы хостов (основную и вторичную) необходимо добавить действительный WWN.
1. Перед выполнением плейбука GAD убедитесь, что удалённые пути и диск кворума настроены правильно, как указано в руководстве пользователя GAD.
1. Для GAD между VSM на основной и вторичной системах хранения необходимо создать общий VSM.
1. Добавьте P-VOL и группу хостов в VSM. Сопоставьте P-VOL с группой хостов.
1. После добавления P-VOL в VSM виртуальный идентификатор P-VOL становится ‘GAD Reserve’ или 65534. Поэтому обновите виртуальный идентификатор P-VOL с помощью задачи Update volume with virtual ldev из плейбука LDEV. Физический и виртуальный идентификаторы P-VOL должны совпадать.
1. Добавьте вторичную группу хостов в VSM.
1. Если P-VOL не имеет имени, S-VOL будет присвоено имя в формате smrha-[ldev_id]. Если P-VOL имеет имя, S-VOL должно иметь такое же имя. (Здесь smrha означает Storage Module Red Hat Ansible.)

Примеры

- name: Suspend GAD pairs using consistency group Ids
  hitachivantara.vspone_block.vsp.hv_gad:
    state: "suspended"
    connection_info:
      address: storage1.company.com
      username: "username"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      consistency_group_ids: [0, 1]
      continue_io_volume: "PRIMARY"

- name: Resync GAD pairs using consistency group Ids
  hitachivantara.vspone_block.vsp.hv_gad:
    state: "swap_resync"
    connection_info:
      address: storage2.company.com
      username: "username"
      password: "password"
    secondary_connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      consistency_group_ids: [0, 1]
      copy_pace: 10
      io_preference_mode: "KEEP_CURRENT_SETTING"

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

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

Ключ	Описание
count integer	Количество пар GAD, полученных и сохранённых в ansible_facts. Возвращается: при успехе Пример: `2`
gad_pairs list / elements=dictionary	Список словарей с подробными свойствами пар GAD. Возвращается: всегда
consistency_group_id integer	Идентификатор группы согласованности, к которой принадлежит пара. Возвращается: при успехе Пример: `2`
copy_pace integer	Скорость операции копирования (1–15). Возвращается: при успехе Пример: `3`
copy_progress_rate integer	Процент выполнения начального копирования. Возвращается: при успехе Пример: `-1`
copy_time integer	Общее время в секундах до перехода в состояние PAIR. Возвращается: при успехе Пример: `0`
created_time string	Время создания пары. Возвращается: при успехе Пример: `"2024-10-01T10:00:00Z"`
data_synchronization_rate integer	Процент синхронизации томов. Возвращается: при успехе Пример: `100`
failure_factor string	Причина сбоя пары GAD, если он произошёл. Возвращается: при успехе Пример: `"NONE"`
io_preference string	Параметры предпочтений ввода-вывода. Возвращается: при успехе Пример: `"DISABLED"`
local_last_updated_time string	Время последнего локального обновления. Возвращается: при успехе Пример: `"2024-10-01T10:05:00Z"`
mirror_unit_number integer	Номер Mirror Unit (MU). Возвращается: при успехе Пример: `0`
pair_operation_mode_for_blocked_quorum_disk string	Поведение при блокировке диска кворума. Возвращается: при успехе Пример: `"QUORUMLESS"`
primary_volume_differential_data_management string	Метод управления данными различий. Возвращается: при успехе Пример: `"HIERARCHICAL"`
primary_volume_id integer	Идентификатор LDEV локального (основного) тома. Возвращается: при успехе Пример: `244`
primary_volume_id_hex string	Шестнадцатеричное представление идентификатора основного тома. Возвращается: при успехе Пример: `"00:00:F4"`
primary_volume_io_mode string	Поведение ввода-вывода хоста (MIRROR, LOCAL, BLOCK). Возвращается: при успехе Пример: `"MIRROR"`
primary_volume_name string	Псевдоним или имя, присвоенное основному тому. Возвращается: при успехе Пример: `"GadTest"`
primary_volume_position string	Роль локального тома (PRIMARY или SECONDARY). Возвращается: при успехе Пример: `"PRIMARY"`
primary_volume_processing_status string	Состояние расширения ёмкости (IDLE, EXPANDING). Возвращается: при успехе Пример: `"IDLE"`
primary_volume_provisioning_type string	Тип выделения ресурсов (INTERNAL, VIRTUAL или EXTERNAL). Возвращается: при успехе Пример: `"VIRTUAL"`
primary_volume_status string	Текущее состояние пары (PAIR, COPY, PSUS и т. д.). Возвращается: при успехе Пример: `"PAIR"`
quorum_disk_id integer	Идентификатор диска кворума, используемого для пары GAD. Возвращается: при успехе Пример: `22`
remote_connection_id dictionary	Информация о подключении к удалённой системе хранения данных. Возвращается: при успехе
path_group_id integer	Идентификатор группы путей, используемой для подключения. Возвращается: при успехе Пример: `0`
storage_model string	Модель удалённой системы хранения (например, RH20ETP). Возвращается: при успехе Пример: `"RH20ETP"`
storage_serial_number string	Серийный номер удалённой системы хранения. Возвращается: при успехе Пример: `"70041"`
secondary_volume_id integer	Идентификатор LDEV тома в удалённой системе хранения. Возвращается: при успехе Пример: `55`
secondary_volume_id_hex string	Шестнадцатеричное представление идентификатора дополнительного тома. Возвращается: при успехе Пример: `"00:00:37"`

Авторы

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