Spec-Zone.ru › Ansible 2.11

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
  • диск
Тип прошивки, подлежащей обновлению. Доступны варианты: стойки, 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

Spec-Zone.ru

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