netapp.ontap.na_ontap_firmware_upgrade – Обновление прошивки NetApp ONTAP для SP, модулей, ACP и дисков.
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 21.1.1).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Чтобы использовать его в плейбуке, укажите: netapp.ontap.na_ontap_firmware_upgrade.
Новое в версии 2.9.0: of netapp.ontap
Обзор
- Обновление прошивки процессора ONTAP.
- Рекомендуемая процедура: 1. скачать пакет прошивки с сайта поддержки NetApp; 2. скопировать пакет на веб-сервер; 3. скачать пакет с веб-сервера с помощью данного модуля.
- После загрузки пакета прошивки для дисков, модулей, ACP, ONTAP автоматически обновит соответствующие ресурсы в фоновом режиме.
- Это может занять некоторое время.
- Для процессора обслуживания (service processor) обновление требует перезагрузки узла для применения изменений.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- Ansible 2.9
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает более подробное сообщение об ошибках для проблем с подключением.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Для включения 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 строка |
| Тип прошивки, подлежащей обновлению. Доступны варианты: стойки, ACP, процессор сервиса и диск. Для обновления прошивки стойки операция асинхронна, и поэтому не возвращает ошибки, которые могут возникнуть во время процесса загрузки. Обновление прошивки стойки идемпотентно, если указан shelf_module_fw. Обновление прошивки диска идемпотентно, если указан disk_fw. В режиме проверки обновление прошивки SP, ACP, диска и стойки не является идемпотентным. Данная операция обновит прошивку только на стойках/дисках, не имеющих последнюю версию прошивки. Для обычных операций, выберите один из вариантов: хранилище или процессор сервиса. Тип хранилище включает ACP, стойку и диск, и 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. Если этот параметр не указан, прошивка будет загружена на все узлы кластера. и ресурсы будут обновлены в фоновом режиме на все узлы, за исключением процессора сервиса. Для процессора сервиса обновление произойдёт автоматически при перезагрузке каждого узла. | |
| 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 |
| Перезагрузить процессор сервиса перед загрузкой пакета. Доступно только если '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 строка | Значение по умолчанию: "present" | Нужно ли обновлять указанную прошивку ONTAP. |
| update_type строка | Тип обновления прошивки. Доступны варианты: serial_full, serial_differential, network_full. Не используется, если force_disruptive_update — False (ONTAP автоматически выберет прошивку). | |
| use_rest строка | Значение по умолчанию: "auto" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае используется ZAPI. always — всегда использовать REST API never — всегда использовать ZAPI auto — попробовать использовать 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.
Примеры
- 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 строка | всегда | Возвращает дополнительную информацию в случае успеха. |
Авторы
- Команда Ansible NetApp (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/netapp/ontap/na_ontap_firmware_upgrade_module.html