Spec-Zone.ru › Ansible

dellemc.openmanage.idrac_firmware модуль — Обновление микропрограммы с сетевой папки (CIFS, NFS, HTTP, HTTPS, FTP)

Примечание

Этот модуль является частью коллекции dellemc.openmanage (версия 9.7.0).

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

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

Чтобы использовать его в плейбуке, укажите: dellemc.openmanage.idrac_firmware.

Новинка в dellemc.openmanage 2.1.0

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

Обзор

  • Обновление микропрограммы, подключившись к сетевой папке (CIFS, NFS, HTTP, HTTPS, FTP), содержащей каталог доступных обновлений.
  • Сетевая папка должна содержать валидный репозиторий пакетов обновлений (DUP) и файл каталога, описывающий эти пакеты.
  • На систему применяются все применимые обновления, содержащиеся в репозитории.
  • Эта функция доступна только с лицензией iDRAC Enterprise.

Требования

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

  • omsdk >= 1.2.503
  • python >= 3.9.6

Параметры

Параметр

Комментарии

apply_update

boolean

Если apply_update установлено в значение true, пакеты будут применены.

Если apply_update установлено в значение false, обновления не будут применены, а будет сгенерирован и возвращен отчет каталога пакетов.

Варианты:

  • false
  • true ← (по умолчанию)

ca_path

путь

добавлен в dellemc.openmanage 5.0.0

Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки.

catalog_file_name

строка

Имя файла каталога относительно share_name.

По умолчанию: "Catalog.xml"

idrac_ip

строка / обязательно

IP-адрес iDRAC.

idrac_password

псевдонимы: idrac_pwd

строка / обязательно

Пароль пользователя iDRAC.

Если пароль не указан, используется переменная среды IDRAC_PASSWORD.

Пример: export IDRAC_PASSWORD=password

idrac_port

целое число

Порт iDRAC.

По умолчанию: 443

idrac_user

строка / обязательно

Имя пользователя iDRAC.

Если имя пользователя не указано, используется переменная среды IDRAC_USERNAME.

Пример: export IDRAC_USERNAME=username

ignore_cert_warning

boolean

Указывает, игнорировать ли предупреждения о сертификате при использовании общего ресурса HTTPS. Если установлен параметр true, предупреждения о сертификате будут игнорироваться.

Варианты:

  • false
  • true ← (по умолчанию)

job_wait

boolean

Дожидаться завершения задачи или нет.

Варианты:

  • false
  • true ← (по умолчанию)

proxy_passwd

строка

Пароль для прокси-сервера.

proxy_port

целое число

Порт прокси-сервера.

Требуется, когда proxy_support равно ParametersProxy.

proxy_server

строка

IP-адрес прокси-сервера.

Этот IP-адрес не будет проверен. Задача загрузки будет создана даже для некорректного proxy_server. Пожалуйста, проверьте результаты задачи для получения подробностей об ошибке.

Требуется, когда proxy_support равно ParametersProxy.

proxy_support

строка

Указывает, нужно ли использовать прокси.

Параметры прокси применимы к типам ресурсов HTTP, HTTPS, и FTP.

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

DefaultProxy, iDRAC использует значения прокси, установленные по умолчанию.

Прокси по умолчанию можно установить в атрибутах контроллера жизненного цикла, используя dellemc.openmanage.idrac_attributes.

Off, прокси не будет использоваться.

Для серверов на базе iDRAC8 используйте прокси-сервер с аутентификацией по принципу «имя пользователя/пароль».

Для серверов на базе iDRAC9 убедитесь, что вы используете аутентификацию по принципу «digest» для прокси-сервера, аутентификация по принципу «имя пользователя/пароль» не поддерживается.

Варианты:

  • "ParametersProxy"
  • "DefaultProxy"
  • "Off" ← (по умолчанию)

proxy_type

строка

Тип прокси-сервера.

Требуется, когда proxy_support равно ParametersProxy.

Примечание: прокси SOCKS4 не поддерживает IPv6-адреса.

Варианты:

  • "HTTP"
  • "SOCKS"

proxy_uname

строка

Имя пользователя прокси-сервера.

reboot

boolean

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

Если reboot установлено в значение true, пакеты будут применены немедленно.

Если reboot установлено в значение false, пакеты будут подготовлены и применены при следующем перезапуске.

Пакеты, не требующие перезапуска, применяются немедленно независимо от I (reboot).

Варианты:

  • false ← (по умолчанию)
  • true

share_mnt

строка

Локальный путь монтирования общего ресурса с правами чтения и записи для пользователя ansible.

Этот параметр не применим к общим ресурсам HTTP, HTTPS и FTP.

имя_объёма

строка / обязательно

Путь к сетевому ресурсу с обновлением. Поддерживаются типы ресурсов CIFS, NFS, HTTP, HTTPS и FTP.

пароль_объёма

псевдонимы: пароль_рес

строка

Пароль пользователя сетевого ресурса. Этот параметр обязателен для сетевого ресурса CIFS.

пользователь_объёма

строка

Пользователь сетевого ресурса в формате ‘пользователь@домен’ или ‘домен\\пользователь’, если пользователь входит в домен, иначе ‘пользователь’. Этот параметр обязателен для сетевого ресурса CIFS.

timeout

целое число

добавлен в dellemc.openmanage 5.0.0

Таймаут уровня сокета в секундах.

По умолчанию: 30

validate_certs

булево

добавлен в dellemc.openmanage 5.0.0

Если false, сертификаты SSL не будут валидироваться.

Настройте false только на сайтах под собственным контролем, где используются самозаверяющие сертификаты.

До версии сборки 5.0.0, validate_certs был false по умолчанию.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Запускайте этот модуль с системы, имеющей прямой доступ к Dell iDRAC.
  • Модуль сообщит об успехе на основании статуса родительской задачи обновления прошивки iDRAC, если нет отдельных задач компонентов.
  • Для серверов с прошивкой iDRAC 5.00.00.00 и более поздними версиями, если репозиторий содержит неподдерживаемые пакеты, то модуль вернёт успешное выполнение с соответствующим сообщением.
  • Этот модуль поддерживает IPv4 и IPv6 адреса для idrac_ip и имя_объёма.
  • Этот модуль поддерживает check_mode

Примеры

---
- name: Update firmware from repository on a NFS Share
  dellemc.openmanage.idrac_firmware:
       idrac_ip: "192.168.0.1"
       idrac_user: "user_name"
       idrac_password: "user_password"
       ca_path: "/path/to/ca_cert.pem"
       share_name: "192.168.0.0:/share"
       reboot: true
       job_wait: true
       apply_update: true
       catalog_file_name: "Catalog.xml"

- name: Update firmware from repository on a CIFS Share
  dellemc.openmanage.idrac_firmware:
       idrac_ip: "192.168.0.1"
       idrac_user: "user_name"
       idrac_password: "user_password"
       ca_path: "/path/to/ca_cert.pem"
       share_name: "full_cifs_path"
       share_user: "share_user"
       share_password: "share_password"
       reboot: true
       job_wait: true
       apply_update: true
       catalog_file_name: "Catalog.xml"

- name: Update firmware from repository on a HTTP
  dellemc.openmanage.idrac_firmware:
       idrac_ip: "192.168.0.1"
       idrac_user: "user_name"
       idrac_password: "user_password"
       ca_path: "/path/to/ca_cert.pem"
       share_name: "http://downloads.dell.com"
       reboot: true
       job_wait: true
       apply_update: true

- name: Update firmware from repository on a HTTPS
  dellemc.openmanage.idrac_firmware:
       idrac_ip: "192.168.0.1"
       idrac_user: "user_name"
       idrac_password: "user_password"
       ca_path: "/path/to/ca_cert.pem"
       share_name: "https://downloads.dell.com"
       reboot: true
       job_wait: true
       apply_update: true

- name: Update firmware from repository on a HTTPS via proxy
  dellemc.openmanage.idrac_firmware:
       idrac_ip: "192.168.0.1"
       idrac_user: "user_name"
       idrac_password: "user_password"
       ca_path: "/path/to/ca_cert.pem"
       share_name: "https://downloads.dell.com"
       reboot: true
       job_wait: true
       apply_update: true
       proxy_support: ParametersProxy
       proxy_server: 192.168.1.10
       proxy_type: HTTP
       proxy_port: 80
       proxy_uname: "proxy_user"
       proxy_passwd: "proxy_pwd"

- name: Update firmware from repository on a FTP
  dellemc.openmanage.idrac_firmware:
       idrac_ip: "192.168.0.1"
       idrac_user: "user_name"
       idrac_password: "user_password"
       ca_path: "/path/to/ca_cert.pem"
       share_name: "ftp://ftp.mydomain.com"
       reboot: true
       job_wait: true
       apply_update: true

Возвращаемые значения

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

Ключ

Описание

сообщ

строка

Общий статус обновления прошивки.

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

Пример: "Successfully updated the firmware."

статус_обновления

словарь

Подробности о задаче обновления прошивки и процессе из iDRAC.

Возвращается: успех

Пример: {"InstanceID": "JID_XXXXXXXXXXXX", "JobStartTime": "NA", "JobState": "Completed", "Message": "Job completed successfully.", "MessageId": "REDXXX", "Name": "Repository Update", "Status": "Success"}

Авторы

  • Rajeev Arakkal (@rajeevarakkal)
  • Felix Stephen (@felixs88)
  • Jagadeesh N V (@jagadeeshnv)

Ссылки на сборку

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

© 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/dellemc/openmanage/idrac_firmware_module.html

Spec-Zone.ru

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