netapp.ontap.na_ontap_firmware_upgrade – Обновление микропрограммы NetApp ONTAP для SP, стеллажей, ACP и дисков.
Примечание
Этот плагин входит в коллекцию netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в плейбуке укажите: netapp.ontap.na_ontap_firmware_upgrade.
Введено в версии 2.9.0: модуля netapp.ontap
Обзор
- Обновление микропрограммы процессора ONTAP.
- Рекомендуемая процедура: 1. Скачать пакет микропрограммы с сайта поддержки NetApp. 2. Скопировать пакет на веб-сервер. 3. Скачать пакет с веб-сервера с помощью этого модуля.
- После скачивания пакета микропрограммы для дисков, стеллажей или ACP, ONTAP автоматически обновит соответствующие ресурсы в фоновом режиме.
- Это может занять некоторое время.
- Для процессора обслуживания (service processor) обновление требует перезагрузки узла для вступления в силу.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система 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. | |
| clear_logs булево |
| Очистить логи на устройстве после обновления. Значение по умолчанию — true. Не используется, если force_disruptive_update равно False. |
| disk_fw строка | Прошивка диска, на которую нужно обновить. Не используется, если force_disruptive_update равно False (ONTAP автоматически выберет прошивку). | |
| fail_on_502_error булево добавлен в 20.6.0 для netapp.ontap |
| Загрузка прошивки может занять время, если веб-сервер работает медленно, и в кластере много узлов. ONTAP прервёт подключение ZAPI через 5 минут с ошибкой 502 Bad Gateway, даже если загрузка всё ещё происходит. По умолчанию этот модуль игнорирует эту ошибку и предполагает, что загрузка происходит, так как ONTAP не предоставляет способ проверки статуса. Установив этот параметр в значение true, модуль будет сообщать об ошибке 502. |
| feature_flags словарь добавлен в 20.5.0 для netapp.ontap | Включить или отключить новую функцию. Это может быть использовано для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| firmware_type строка |
| Тип прошивки, которую нужно обновить. Доступны варианты shelf, ACP, service-processor и disk. Для обновления прошивки shelf операция асинхронна и, следовательно, не возвращает ошибки, которые могут возникнуть во время процесса загрузки. Обновление прошивки shelf идемпотентно, если предоставлен shelf_module_fw. Обновление прошивки disk идемпотентно, если предоставлен disk_fw. В режиме проверки обновление прошивки SP, ACP, disk и shelf не является идемпотентным. Данная операция обновит только прошивку на полках/дисках, на которых нет последней версии прошивки. Не используется, если force_disruptive_update равно False (ONTAP автоматически определит тип прошивки). |
| force_disruptive_update булево добавлен в 20.4.1 для netapp.ontap |
| Если установлено в False, и указан URL, обновление не будет прерывистым. Если URL не указан, операция не выполняется.Не устанавливайте это значение в True, если это не указано службой технической поддержки NetApp.Принудительно выполнит обновление, даже если ресурс к нему не готов, что может быть прерывистым. |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт | |
| https булево |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. |
| install_baseline_image булево |
| Установить версию, входящую в комплект ONTAP, если этот параметр установлен в значение true. В противном случае необходимо указать пакет для установки. Не используется, если force_disruptive_update равно False (ONTAP автоматически выберет прошивку). |
| key_filepath строка добавлен в 20.6.0 для netapp.ontap | путь к файлу закрытого ключа SSL-клиента. | |
| node строка | Узел, на котором расположено устройство. Не требуется, если package_url указан и force_disruptive_update равно False. Если этот параметр не указан, прошивка будет загружена на все узлы кластера, и ресурсы будут обновлены в фоновом режиме на всех узлах, за исключением service processor. Для service processor обновление произойдёт автоматически при перезагрузке каждого узла. | |
| ontapi целое число | Версия API ontap для использования | |
| package строка | Имя файла пакета, содержащего прошивку для установки. Не требуется, когда -baseline равно true. Не используется, если force_disruptive_update равно False. | |
| package_url строка добавлен в 20.4.1 для netapp.ontap | URL файла пакета, содержащего прошивку для загрузки. После загрузки файла пакета на узел обновление прошивки произойдёт автоматически в фоновом режиме. Для SP обновление произойдёт автоматически при перезагрузке узла. Для SP обновление произойдёт автоматически, если включена функция автообновления (что рекомендуется). | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| reboot_sp булево добавлен в 20.6.1 для netapp.ontap |
| Перезагрузить service processor перед загрузкой пакета. Доступно только если 'firmware_type' равно 'service-processor'. |
| rename_package строка добавлен в 20.6.1 для netapp.ontap | Переименовать пакет. Доступно только если 'firmware_type' равно 'service-processor'. | |
| replace_package булево добавлен в 20.6.1 для netapp.ontap |
| Заменить локальный пакет. Доступно только если 'firmware_type' равно 'service-processor'. |
| shelf_module_fw строка | Прошивка модуля полки для обновления. Не используется, если force_disruptive_update равно False (ONTAP автоматически выберет прошивку). | |
| state строка | Значение по умолчанию: "настоящий" | Необходимо ли обновлять указанную прошивку ONTAP. |
| update_type строка | Тип обновления прошивки. Доступны варианты serial_full, serial_differential, network_full. Не используется, если force_disruptive_update равно False (ONTAP автоматически выберет прошивку). | |
| use_rest строка | Значение по умолчанию: "авто" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае возвращается к ZAPI. всегда -- всегда использовать REST API никогда -- всегда использовать ZAPI авто -- попытаться использовать REST API |
| username строка | Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или 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.
Примеры
- name: firmware upgrade
na_ontap_firmware_upgrade:
state: present
package_url: "{{ web_link }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: firmware upgrade, confirm successful download
na_ontap_firmware_upgrade:
state: present
package_url: "{{ web_link }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
fail_on_502_error: true
- name: SP firmware upgrade
na_ontap_firmware_upgrade:
state: present
node: vsim1
package: "{{ file name }}"
package_url: "{{ web_link }}"
clear_logs: True
install_baseline_image: False
update_type: serial_full
force_disruptive_update: False
firmware_type: service-processor
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: SP firmware download replace package
tags:
- sp_download
na_ontap_firmware_upgrade:
state: present
node: vsim1
package_url: "{{ web_link }}"
firmware_type: service-processor
replace_package: true
reboot_sp: true
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
https: true
validate_certs: false
- name: SP firmware download rename package
tags:
- sp_download
na_ontap_firmware_upgrade:
state: present
node: vsim1
package_url: "{{ web_link }}"
firmware_type: service-processor
rename_package: SP_FW.zip
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
https: true
validate_certs: false
- name: ACP firmware download and upgrade
na_ontap_firmware_upgrade:
state: present
node: vsim1
firmware_type: acp
force_disruptive_update: False
package_url: "{{ web_link }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: shelf firmware upgrade
na_ontap_firmware_upgrade:
state: present
firmware_type: shelf
shelf_module_fw: 1221
force_disruptive_update: False
package_url: "{{ web_link }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: disk firmware upgrade
na_ontap_firmware_upgrade:
state: present
firmware_type: disk
disk_fw: NA02
force_disruptive_update: False
package_url: "{{ web_link }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| msg строка | всегда | Возвращает дополнительную информацию в случае успеха. |
Авторы
- Команда 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_firmware_upgrade_module.html