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 установлено в значение Если apply_update установлено в значение Варианты:
|
ca_path путь добавлен в dellemc.openmanage 5.0.0 | Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки. |
catalog_file_name строка | Имя файла каталога относительно share_name. По умолчанию: |
idrac_ip строка / обязательно | IP-адрес iDRAC. |
idrac_password псевдонимы: idrac_pwd строка / обязательно | Пароль пользователя iDRAC. Если пароль не указан, используется переменная среды Пример: export IDRAC_PASSWORD=password |
idrac_port целое число | Порт iDRAC. По умолчанию: |
idrac_user строка / обязательно | Имя пользователя iDRAC. Если имя пользователя не указано, используется переменная среды Пример: export IDRAC_USERNAME=username |
ignore_cert_warning boolean | Указывает, игнорировать ли предупреждения о сертификате при использовании общего ресурса HTTPS. Если установлен параметр Варианты:
|
job_wait boolean | Дожидаться завершения задачи или нет. Варианты:
|
proxy_passwd строка | Пароль для прокси-сервера. |
proxy_port целое число | Порт прокси-сервера. Требуется, когда proxy_support равно |
proxy_server строка | IP-адрес прокси-сервера. Этот IP-адрес не будет проверен. Задача загрузки будет создана даже для некорректного proxy_server. Пожалуйста, проверьте результаты задачи для получения подробностей об ошибке. Требуется, когда proxy_support равно |
proxy_support строка | Указывает, нужно ли использовать прокси. Параметры прокси применимы к типам ресурсов
Прокси по умолчанию можно установить в атрибутах контроллера жизненного цикла, используя dellemc.openmanage.idrac_attributes.
Для серверов на базе iDRAC8 используйте прокси-сервер с аутентификацией по принципу «имя пользователя/пароль». Для серверов на базе iDRAC9 убедитесь, что вы используете аутентификацию по принципу «digest» для прокси-сервера, аутентификация по принципу «имя пользователя/пароль» не поддерживается. Варианты:
|
proxy_type строка | Тип прокси-сервера. Требуется, когда proxy_support равно Примечание: прокси SOCKS4 не поддерживает IPv6-адреса. Варианты:
|
proxy_uname строка | Имя пользователя прокси-сервера. |
reboot boolean | Предоставляет возможность немедленного применения обновленных пакетов или их применения при следующем перезапуске. Если reboot установлено в значение Если reboot установлено в значение Пакеты, не требующие перезапуска, применяются немедленно независимо от I (reboot). Варианты:
|
share_mnt строка | Локальный путь монтирования общего ресурса с правами чтения и записи для пользователя ansible. Этот параметр не применим к общим ресурсам HTTP, HTTPS и FTP. |
имя_объёма строка / обязательно | Путь к сетевому ресурсу с обновлением. Поддерживаются типы ресурсов CIFS, NFS, HTTP, HTTPS и FTP. |
пароль_объёма псевдонимы: пароль_рес строка | Пароль пользователя сетевого ресурса. Этот параметр обязателен для сетевого ресурса CIFS. |
пользователь_объёма строка | Пользователь сетевого ресурса в формате ‘пользователь@домен’ или ‘домен\\пользователь’, если пользователь входит в домен, иначе ‘пользователь’. Этот параметр обязателен для сетевого ресурса CIFS. |
timeout целое число добавлен в dellemc.openmanage 5.0.0 | Таймаут уровня сокета в секундах. По умолчанию: |
validate_certs булево добавлен в dellemc.openmanage 5.0.0 | Если Настройте До версии сборки Варианты:
|
Примечания
Примечание
- Запускайте этот модуль с системы, имеющей прямой доступ к 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
Возвращаемые значения
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
сообщ строка | Общий статус обновления прошивки. Возвращается: всегда Пример: |
статус_обновления словарь | Подробности о задаче обновления прошивки и процессе из iDRAC. Возвращается: успех Пример: |
Авторы
- 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