Spec-Zone.ru › Ansible 2.10

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
строка
    Варианты:
  • service-processor
  • shelf
  • acp
  • disk
Тип прошивки, которую нужно обновить. Доступны варианты 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

Spec-Zone.ru

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