Spec-Zone.ru › Ansible

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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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

логическое значение

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

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

Допустимые значения:

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

ca_path

путь

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

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

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

логическое значение

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

Допустимые значения:

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

job_wait

логическое значение

Определяет, нужно ли ожидать завершения задания.

Допустимые значения:

  • 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 использует заданные по умолчанию значения прокси.

Прокси-сервер по умолчанию можно настроить в атрибутах Lifecycle Controller с помощью dellemc.openmanage.idrac_attributes.

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

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

Для серверов на базе iDRAC9 используйте для прокси-сервера дайджест-аутентификацию; базовая аутентификация не поддерживается.

Допустимые значения:

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

proxy_type

строка

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

Этот параметр обязателен, если для proxy_support задано значение ParametersProxy.

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

Допустимые значения:

  • "HTTP"
  • "SOCKS"

proxy_uname

строка

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

reboot

логическое значение

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

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

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

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

Допустимые значения:

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

share_mnt

строка

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

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

share_name

строка / обязательный параметр

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

share_password

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

строка

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

share_user

строка

Имя пользователя сетевого ресурса в формате ‘user@domain’ или ‘domain\\user’, если пользователь входит в домен; в противном случае укажите ‘user’. Этот параметр обязателен для сетевого ресурса 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 и share_name.
  • Этот модуль поддерживает 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

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

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

Ключ

Описание

msg

строка

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

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

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

update_status

словарь

Сведения о задании обновления микропрограммы и ходе его выполнения, полученные от 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)
  • Sakshi Makkar (@Sakshi-dell)

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

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/openmanage/idrac_firmware_module.html

Spec-Zone.ru

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