Spec-Zone.ru › Ansible

netapp.ontap.na_ontap_firmware_upgrade модуль — Обновление микропрограммы NetApp ONTAP для SP, стеллажей, ACP и дисков.

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные условия, см. Требования для получения подробной информации.

Для использования в книге задач укажите: netapp.ontap.na_ontap_firmware_upgrade.

Новое в netapp.ontap 2.9.0

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Обновление микропрограммы процессора ONTAP
  • Рекомендуемая процедура: 1. Загрузка пакета микропрограммы с сайта поддержки NetApp 2. Копирование пакета на веб-сервер 3. Загрузка пакета с веб-сервера с помощью данного модуля
  • После загрузки пакета микропрограммы для диска, стеллажа, ACP или другого ресурса, ONTAP автоматически обновит соответствующие ресурсы в фоновом режиме.
  • Это может занять некоторое время.
  • Для процессора службы требуется перезагрузка узла для применения обновлений.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

  • Ansible 2.9 или новее — рекомендуется 2.12 или новее.
  • Python3 — рекомендуется 3.9 или новее.
  • При использовании ZAPI, netapp-lib 2018.11.13 или новее (установка с помощью «pip install netapp-lib»), сильно рекомендуется netapp-lib 2020.3.12, так как он предоставляет лучшую отчетность об ошибках при подключении.
  • Физическая или виртуальная кластеризованная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздней версии

Параметры

Параметр

Комментарии

cert_filepath

string

added in netapp.ontap 20.6.0

путь к файлу SSL-сертификата клиента (.pem).

не поддерживается с python 2.6.

clear_logs

boolean

Очистить журналы на устройстве после обновления. Значение по умолчанию — true.

Не используется, если force_disruptive_update имеет значение False.

Не поддерживается с REST, если установлено значение false.

Варианты:

  • false
  • true ← (default)

disk_fw

string

прошивка диска, на которую необходимо обновить.

Не используется, если force_disruptive_update имеет значение False (ONTAP автоматически выберет прошивку)

Не поддерживается с REST.

fail_on_502_error

boolean

added in netapp.ontap 20.6.0

Загрузка прошивки может занять некоторое время, если веб-сервер работает медленно и если в кластере много узлов.

ONTAP разорвет соединение ZAPI через 5 минут с ошибкой 502 Bad Gateway, даже если загрузка все еще выполняется.

По умолчанию этот модуль игнорирует эту ошибку и предполагает, что загрузка выполняется, поскольку ONTAP не предоставляет возможности проверить состояние.

При установке этого параметра в значение true модуль сообщит о 502 как об ошибке.

Не поддерживается с REST, если установлено значение true.

Варианты:

  • false ← (default)
  • true

feature_flags

dictionary

added in netapp.ontap 20.5.0

Включить или отключить новую функцию.

Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость.

Поддерживаемые ключи и значения могут меняться без предварительного уведомления. Неизвестные ключи игнорируются.

firmware_type

string

Тип прошивки, которую необходимо обновить. Варианты включают shelf, ACP, service-processor и disk.

Для обновления прошивки полки операция является асинхронной и, следовательно, не возвращает ошибок, которые могут возникнуть во время процесса загрузки.

Обновление прошивки полки является идемпотентным, если предоставлен shelf_module_fw.

Обновление прошивки диска является идемпотентным, если предоставлен disk_fw.

В режиме проверки обновление прошивки SP, ACP, disk и shelf не является идемпотентным.

Эта операция будет обновлять прошивку только на полках/дисках, которые не имеют последней версии прошивки.

Для нормальных операций выберите один из вариантов storage или service-processor.

Тип storage включает acp, shelf и disk, и ONTAP автоматически определит, что делать.

С REST модуль не проверяет соответствие пакета типу прошивки. ONTAP определяет тип автоматически.

С REST, storage загружает любую прошивку, включая прошивку service-processor.

С REST, service-processor разблокирует параметры перезагрузки SP.

Варианты:

  • "storage" ← (default)
  • "service-processor"
  • "shelf"
  • "acp"
  • "disk"

force_disruptive_update

boolean

added in netapp.ontap 20.5.0

Если установлено в False, и указан URL, обновление выполняется без прерываний. Если URL не указан, операция не выполняется.

Не устанавливайте это значение в True, если это не предписано технической поддержкой NetApp.

Это приведет к принудительному обновлению, даже если ресурс не готов к нему, и может привести к сбоям.

Не поддерживается с REST, если установлено значение true.

Варианты:

  • false ← (default)
  • true

force_ontap_version

string

added in netapp.ontap 21.23.0

Переопределить версию ONTAP кластера при использовании REST.

Поведение не определено, если версия не соответствует целевому кластеру.

Это предоставляется в качестве временного решения, когда версию кластера невозможно прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Это должно быть в формате 9.10 или 9.10.1, где каждый элемент является целым числом.

Когда use_rest установлено в значение auto, это может привести к переключению на ZAPI в зависимости от версии и возможностей платформы.

Игнорируется с ZAPI.

hostname

string / required

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределить порт по умолчанию (80 или 443) этим портом

https

boolean

Включить и отключить https.

Игнорируется при использовании REST, так как поддерживается только https.

Игнорируется при использовании проверки подлинности с помощью SSL-сертификата, так как это требует SSL.

Варианты:

  • false ← (default)
  • true

install_baseline-image

boolean

Установить версию, поставляемую с ONTAP, если этот параметр установлен в true. В противном случае, для указания пакета, который необходимо установить, необходимо использовать package.

Не используется, если force_disruptive_update имеет значение False (ONTAP автоматически выберет прошивку)

Не поддерживается с REST, если установлено значение true.

Варианты:

  • false ← (default)
  • true

key_filepath

string

added in netapp.ontap 20.6.0

путь к файлу ключа SSL-клиента.

node

string

Узел, на котором находится устройство.

Не требуется, если присутствует package_url и force_disruptive_update имеет значение False.

Если этот параметр не указан, прошивка будет загружена на все узлы в кластере,

и ресурсы будут обновлены в фоновом режиме на всех узлах, за исключением процессора обслуживания.

Для процессора обслуживания обновление произойдет автоматически при перезагрузке каждого узла.

ontapi

integer

Версия API ONTAP для использования

package

string

Имя файла пакета, содержащего прошивку, которая будет установлена. Необязательно, если -baseline истинно.

Не используется, если force_disruptive_update равно False.

Не поддерживается с REST.

package_url

string

added in netapp.ontap 20.5.0

URL файла пакета, содержащего прошивку для загрузки.

После загрузки файла пакета на узел обновление прошивки будет происходить автоматически в фоновом режиме.

Для SP обновление будет происходить автоматически при перезагрузке узла.

Для SP обновление будет происходить автоматически, если включено автоматическое обновление (рекомендуемый параметр).

password

aliases: pass

string

Пароль для указанного пользователя.

reboot_sp

boolean

added in netapp.ontap 20.7.0

Перезагрузить процессор обслуживания перед загрузкой пакета.

Доступно только если «firmware_type» равно «service-processor».

По умолчанию True, если не установлено, когда «firmware_type» равно «service-processor».

Установите это явно в true, чтобы избежать предупреждения, и в false, чтобы не перезагружать SP.

Настоятельно рекомендуется перезагрузить SP перед загрузкой.

Choices:

  • false
  • true

reboot_sp_after_download

boolean

added in netapp.ontap 21.15.0

Перезагрузить процессор обслуживания после загрузки пакета.

Доступно только если «firmware_type» равно «service-processor».

Choices:

  • false
  • true

rename_package

string

added in netapp.ontap 20.7.0

Переименовать пакет.

Доступно только если «firmware_type» равно «service-processor».

Не поддерживается с REST.

replace_package

boolean

added in netapp.ontap 20.7.0

Заменить локальный пакет.

Доступно только если «firmware_type» равно «service-processor».

Не поддерживается с REST, если установлено значение false.

Choices:

  • false
  • true

server_password

string

added in netapp.ontap 21.15.0

Пароль для аутентификации на сервере пакетов прошивки.

Игнорируется с ZAPI.

server_username

string

added in netapp.ontap 21.15.0

Имя пользователя для аутентификации на сервере пакетов прошивки.

Игнорируется с ZAPI.

shelf_module_fw

string

Прошивка модуля полки, которую необходимо обновить.

Не используется, если force_disruptive_update равно False (ONTAP автоматически выберет прошивку)

Не поддерживается с REST.

state

string

Следует ли обновлять указанную прошивку ONTAP или нет.

Default: "present"

update_type

string

Тип обновления прошивки, которое необходимо выполнить. Варианты включают serial_full, serial_differential, network_full.

Не используется, если force_disruptive_update равно False (ONTAP автоматически выберет прошивку)

Не поддерживается с REST.

use_rest

string

Использовать ли REST или ZAPI.

always – всегда будет использовать REST API, если модуль поддерживает REST. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST.

never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI.

auto – будет пытаться использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае возвращается к ZAPI.

Default: "auto"

username

aliases: user

string

Это может быть учетная запись в масштабе кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM.

Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. базовая аутентификация, использующая имя пользователя и пароль,
  2. аутентификация с помощью SSL-сертификата, использующая файл клиентского SSL-сертификата и, необязательно, файл закрытого ключа.

Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация сертификатов.

validate_certs

boolean

Если установлено значение no, SSL-сертификаты проверяться не будут.

Это должно быть установлено только в False используется на лично контролируемых сайтах, использующих самозаверяющие сертификаты.

Choices:

  • false
  • true ← (default)

Примечания

Примечание

  • Модули с префиксом na_ontap созданы для поддержки платформы хранения ONTAP.
  • https включен по умолчанию и рекомендуется. Чтобы включить http в кластере, необходимо выполнить следующие команды «set -privilege advanced;»; «system services web modify -http-enabled true;»

Примеры

- name: firmware upgrade
  netapp.ontap.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
  netapp.ontap.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
  netapp.ontap.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
  netapp.ontap.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
  netapp.ontap.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
  netapp.ontap.na_ontap_firmware_upgrade:
    state: present
    node: vsim1
    firmware_type: acp
    package_url: "{{ web_link }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: shelf firmware upgrade
  netapp.ontap.na_ontap_firmware_upgrade:
    state: present
    firmware_type: shelf
    package_url: "{{ web_link }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: disk firmware upgrade
  netapp.ontap.na_ontap_firmware_upgrade:
    state: present
    firmware_type: disk
    package_url: "{{ web_link }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: any firmware upgrade (REST)
  netapp.ontap.na_ontap_firmware_upgrade:
    state: present
    package_url: "{{ web_link }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: SP firmware upgrade with reboots (REST)
  netapp.ontap.na_ontap_firmware_upgrade:
    state: present
    package_url: "{{ web_link }}"
    firmware_type: service-processor
    reboot_sp_: true
    reboot_sp_after_download: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Ключ

Описание

msg

строка

Возвращает дополнительную информацию в случае успеха.

Возвращается: всегда

Авторы

  • Команда NetApp Ansible (@carchi8py)

Ссылки на коллекцию

  • Отслеживание ошибок
  • Главная страница
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_firmware_upgrade_module.html

Spec-Zone.ru

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