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 |
| Тип связи 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 строка |
| Указывает тип связи 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