Spec-Zone.ru › Ansible 2.10

netapp.ontap.na_ontap_snapmirror – NetApp ONTAP или ElementSW Управление SnapMirror

Примечание

Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).

Для его установки используйте: ansible-galaxy collection install netapp.ontap.

Чтобы использовать его в плейбуке, укажите: netapp.ontap.na_ontap_snapmirror.

Введено в версии 2.7.0: of netapp.ontap

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры

Обзор

  • Создание/удаление/изменение/инициализация/разрыв/ресинхронизация/возобновление отношений между томом/сервером SnapMirror для ONTAP/ONTAP
  • Создание/удаление/изменение отношений SnapMirror между томом ElementSW и ONTAP
  • Изменение расписания для отношений SnapMirror для ONTAP/ONTAP и ElementSW/ONTAP
  • Предварительное условие для отношений ElementSW с ONTAP или наоборот — установленное конечное звено SnapMirror для кластера ONTAP с интерфейсом ElementSW
  • Предварительное условие для отношений ElementSW с ONTAP или наоборот — включенный SnapMirror в томе ElementSW
  • Для создания отношений SnapMirror ElementSW/ONTAP должно существовать существующее отношение ONTAP/ElementSW
  • Выполняет ресинхронизацию, если relationship_state=active и текущее состояние зеркалирования отношений snapmirror прервано
  • Выполняет возобновление, если relationship_state=active, текущее состояние отношений snapmirror приостановлено, а состояние зеркала — snapmirrored
  • Выполняет восстановление, если relationship_type=restore, и все остальные операции не будут выполнены во время этой задачи

Требования

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

  • Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
  • Поддержка REST требует ONTAP 9.6 или более поздней версии.
  • Ansible 2.6
  • Сильно рекомендуется использовать Ansible 2.9 или более позднюю версию, так как она обеспечивает новую систему доставки коллекций.
  • Python2 netapp-lib (2017.10.30) или более поздняя версия. Установка с помощью «pip install netapp-lib»
  • Python3 netapp-lib (2018.11.13) или более поздняя версия. Установка с помощью «pip install netapp-lib»
  • netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает лучшую обработку ошибок при подключении.
  • Чтобы включить http в кластере, необходимо выполнить следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
cert_filepath
строка
добавлен в 20.6.0 для netapp.ontap
путь к файлу SSL-сертификата клиента (.pem).
не поддерживается с python 2.6.
connection_type
строка
добавлен в 2.9.0 для netapp.ontap
    Варианты:
  • ontap_ontap ←
  • elementsw_ontap
  • ontap_elementsw
Тип связи SnapMirror.
Предварительное условие для элементовw_ontap или ontap_elementsw: том ElementSW должен иметь опцию enableSnapmirror, установленную в значение true.
Для использования ontap_elementsw, должна существовать связь snapmirror elementsw_ontap.
destination_path
строка
Указывает конечную точку назначения для связи SnapMirror.
destination_volume
строка
Указывает имя целевого тома для SnapMirror.
destination_vserver
строка
Имя целевого vserver для SnapMirror.
feature_flags
словарь
добавлен в 20.5.0 для netapp.ontap
Включить или выключить новую функцию.
Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость.
Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
hostname
строка / обязательно
Имя хоста или IP-адрес экземпляра ONTAP.
http_port
целое число
Переопределить порт по умолчанию (80 или 443) с помощью этого порта
https
логическое значение
    Варианты:
  • нет ←
  • да
Включить и выключить https.
Игнорируется при использовании REST, так как поддерживается только https.
Игнорируется при использовании аутентификации с помощью SSL-сертификата, так как она требует SSL.
identity_preserve
логическое значение
добавлен в 2.9.0 для netapp.ontap
    Варианты:
  • нет
  • да
Указывает, сохраняется ли идентификатор исходного VServer в целевом VServer.
Если этот параметр установлен в значение true, конфигурация исходного VServer также будет реплицирована в целевой.
Если параметр установлен в значение false, то в целевой VServer будут реплицированы только тома и конфигурация RBAC исходного VServer.
initialize
логическое значение
добавлен в 19.11.0 для netapp.ontap
    Варианты:
  • нет
  • да ←
Указывает, следует ли инициализировать отношение SnapMirror.
Значение по умолчанию True, его можно явно установить в значение False, чтобы избежать инициализации отношения SnapMirror.
key_filepath
строка
добавлен в 20.6.0 для netapp.ontap
путь к файлу закрытого ключа SSL-клиента.
max_transfer_rate
целое число
добавлен в 2.9.0 для netapp.ontap
Указывает верхнюю границу скорости передачи данных в килобайтах в секунду.
Значение по умолчанию — неограничено, его можно явно установить в 0 для неограниченного значения.
ontapi
целое число
Используемая версия ONTAP API
password
строка
Пароль для указанного пользователя.

алиасы: pass
policy
строка
добавлен в 2.8.0 для netapp.ontap
Указывает имя политики SnapMirror, применяемой к этому отношению.
relationship_info_only
логическое значение
добавлен в 20.4.0 для netapp.ontap
    Варианты:
  • нет ←
  • да
Если relationship-info-only установлено в значение true, то удаляется только информация об отношении.
relationship_state
строка
добавлен в 20.2.0 для netapp.ontap
    Варианты:
  • активный ←
  • прерванный
Указывает, следует ли прервать связь SnapMirror или установить связь SnapMirror.
состояние должно быть указано для использования этого параметра.
relationship_type
строка
    Варианты:
  • data_protection
  • load_sharing
  • vault
  • restore
  • transition_data_protection
  • extended_data_protection
Указывает тип связи SnapMirror.
для 'восстановления', если не указан 'source_snapshot', восстанавливается последняя копия снимка момента времени на источнике.
восстановление SnapMirror не идемпотентно.
schedule
строка
Укажите имя текущего расписания, используемого для обновления связи SnapMirror.
Необязательно для создания, изменяемо.
source_hostname
строка
Имя хоста источника или IP-адрес управления для кластера ONTAP или ElementSW.
Требуется для удаления SnapMirror
source_password
строка
Пароль источника для кластера ONTAP или ElementSW.
Необязательно, если он совпадает с паролем назначения.
source_path
строка
Указывает исходную конечную точку связи SnapMirror.
Если источник — том ONTAP, формат должен быть <[vserver:][volume]> или <[[cluster:]//vserver/]volume>
Если источник — том ElementSW, формат должен быть <[Element_SVIP]:/lun/[Element_VOLUME_ID]>
Если источник — том ElementSW, SnapMirror должен быть включен.
source_snapshot
строка
добавлен в 20.6.0 для netapp.ontap
Указывает снимок момента времени из источника для восстановления.
source_username
строка
Имя пользователя источника для кластера ONTAP или ElementSW.
Необязательно, если он совпадает с именем пользователя назначения.
source_volume
строка
Указывает имя исходного тома для SnapMirror.
source_vserver
строка
Имя исходного vserver для SnapMirror.
state
строка
    Варианты:
  • существующий ←
  • отсутствующий
Указывает, должно ли данное отношение существовать.
update
логическое значение
добавлен в 20.2.0 для netapp.ontap
    Варианты:
  • нет
  • да ←
Указывает, следует ли обновить целевую конечную точку отношения SnapMirror только в том случае, если отношение уже существует и активно.
Значение по умолчанию — True.
use_rest
строка
Значение по умолчанию:
"авто"
REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае используется ZAPI.
всегда — всегда использовать REST API
никогда — всегда использовать ZAPI
авто — попробовать использовать REST API
username
строка
Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется API уровня кластера или SVM.
Дополнительную информацию можно найти в документации по адресу https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.
Поддерживаются два метода аутентификации
1. базовая аутентификация с использованием имени пользователя и пароля,
2. аутентификация с помощью SSL-сертификата с использованием файла SSL-сертификата клиента и, необязательно, файла закрытого ключа.
Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.

алиасы: user
validate_certs
логическое значение
    Варианты:
  • нет
  • да ←
Если установлено в no, сертификаты SSL не будут проверены.
Это следует устанавливать в False только на сайтах, контролируемых лично, использующих самозаверяемые сертификаты.

Примечания

Примечание

  • Модули, префикс которых na\_ontap, разработаны для поддержки платформы хранения ONTAP.

Примеры

# creates and initializes the snapmirror
- name: Create ONTAP/ONTAP SnapMirror
  na_ontap_snapmirror:
    state: present
    source_volume: test_src
    destination_volume: test_dest
    source_vserver: ansible_src
    destination_vserver: ansible_dest
    schedule: hourly
    policy: MirrorAllSnapshots
    max_transfer_rate: 1000
    initialize: False
    hostname: "{{ destination_cluster_hostname }}"
    username: "{{ destination_cluster_username }}"
    password: "{{ destination_cluster_password }}"

# creates and initializes the snapmirror between vservers
- name: Create ONTAP/ONTAP vserver SnapMirror
  na_ontap_snapmirror:
    state: present
    source_vserver: ansible_src
    destination_vserver: ansible_dest
    identity_preserve: true
    hostname: "{{ destination_cluster_hostname }}"
    username: "{{ destination_cluster_username }}"
    password: "{{ destination_cluster_password }}"

# existing snapmirror relation with status 'snapmirrored' will be initiailzed
- name: Inititalize ONTAP/ONTAP SnapMirror
  na_ontap_snapmirror:
    state: present
    source_path: 'ansible:test'
    destination_path: 'ansible:dest'
    relationship_state: active
    hostname: "{{ destination_cluster_hostname }}"
    username: "{{ destination_cluster_username }}"
    password: "{{ destination_cluster_password }}"

- name: Delete SnapMirror
  na_ontap_snapmirror:
    state: absent
    destination_path: <path>
    relationship_info_only: True
    source_hostname: "{{ source_hostname }}"
    hostname: "{{ destination_cluster_hostname }}"
    username: "{{ destination_cluster_username }}"
    password: "{{ destination_cluster_password }}"

- name: Break Snapmirror
  na_ontap_snapmirror:
    state: present
    relationship_state: broken
    destination_path: <path>
    source_hostname: "{{ source_hostname }}"
    hostname: "{{ destination_cluster_hostname }}"
    username: "{{ destination_cluster_username }}"
    password: "{{ destination_cluster_password }}"

- name: Restore Snapmirror volume using location (Idempotency)
  na_ontap_snapmirror:
    state: present
    source_path: <path>
    destination_path: <path>
    relationship_type: restore
    source_snapshot: "{{ snapshot }}"
    hostname: "{{ destination_cluster_hostname }}"
    username: "{{ destination_cluster_username }}"
    password: "{{ destination_cluster_password }}"

- name: Set schedule to NULL
  na_ontap_snapmirror:
    state: present
    destination_path: <path>
    schedule: ""
    hostname: "{{ destination_cluster_hostname }}"
    username: "{{ destination_cluster_username }}"
    password: "{{ destination_cluster_password }}"

- name: Create SnapMirror from ElementSW to ONTAP
  na_ontap_snapmirror:
    state: present
    connection_type: elementsw_ontap
    source_path: '10.10.10.10:/lun/300'
    destination_path: 'ansible_test:ansible_dest_vol'
    schedule: hourly
    policy: MirrorLatest
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    source_hostname: " {{ Element_cluster_mvip }}"
    source_username: "{{ Element_cluster_username }}"
    source_password: "{{ Element_cluster_password }}"

- name: Create SnapMirror from ONTAP to ElementSW
  na_ontap_snapmirror:
    state: present
    connection_type: ontap_elementsw
    destination_path: '10.10.10.10:/lun/300'
    source_path: 'ansible_test:ansible_dest_vol'
    policy: MirrorLatest
    hostname: "{{ Element_cluster_mvip }}"
    username: "{{ Element_cluster_username }}"
    password: "{{ Element_cluster_password }}"
    source_hostname: " {{ netapp_hostname }}"
    source_username: "{{ netapp_username }}"
    source_password: "{{ netapp_password }}"

Авторы

  • Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp/ontap/na_ontap_snapmirror_module.html

Spec-Zone.ru

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