dellemc.openmanage.ome_firmware модуль – Обновление прошивки на устройствах PowerEdge и их компонентах через OpenManage Enterprise
Примечание
Этот модуль является частью коллекции dellemc.openmanage (версия 9.7.0).
Эта коллекция, возможно, уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля требуются дополнительные условия, см. Требования для подробностей.
Для использования в playbook укажите: dellemc.openmanage.ome_firmware.
Новая функция в dellemc.openmanage 2.0.0
Обзор
- Этот модуль обновляет прошивку устройств PowerEdge и всех её компонентов через OpenManage Enterprise.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 3.9.6
Параметры
Параметр | Комментарии |
|---|---|
baseline_name строка | Введите имя базовой конфигурации для обновления микропрограммного обеспечения всех устройств или списка устройств, которые не соответствуют требованиям. Этот параметр взаимоисключающий с параметрами dup_file и device_group_names. |
ca_path путь добавлен в dellemc.openmanage 5.0.0 | Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки. |
components список / элементы=строка | Список компонентов, которые необходимо обновить. Если не указано, учитываются все применимые компоненты. Этот параметр чувствителен к регистру. Это применимо к параметрам device_service_tag, device_id и baseline_name. По умолчанию: |
device_group_names список / элементы=строка | Введите имя группы устройств, содержащей устройства, на которых необходимо обновить микропрограммное обеспечение. Этот параметр взаимоисключающий с параметрами device_id и device_service_tag. |
device_id список / элементы=целое число | Список идентификаторов целевых устройств. Можно использовать либо device_id, либо device_service_tag, либо оба вместе. Этот параметр взаимоисключающий с параметрами device_group_names и devices. |
device_service_tag список / элементы=строка | Список тегов сервиса целевых устройств. Можно использовать либо device_id, либо device_service_tag, либо оба вместе. Этот параметр взаимоисключающий с параметрами device_group_names и devices. |
devices список / элементы=словарь | Этот параметр позволяет выбрать компоненты на каждом устройстве для обновления микропрограммного обеспечения. Этот параметр взаимоисключающий с параметрами dup_file, device_group_names, device_id и device_service_tag. |
|
components список / элементы=строка |
Целевые компоненты для обновления. Если не указано, учитываются все применимые компоненты устройства. По умолчанию: |
|
id целое число |
Идентификатор целевого устройства для обновления. Этот параметр взаимоисключающий с параметром service_tag. |
|
service_tag строка |
Тег сервиса целевого устройства для обновления. Этот параметр взаимоисключающий с параметром id. |
dup_file путь | Путь к файлу Dell Update Package (DUP), содержащему микропрограммное обеспечение или драйверы, необходимые для обновления целевого устройства системы или отдельных компонентов устройства. Взаимоисключающий с параметрами baseline_name, components и devices. |
hostname строка / обязательно | IP-адрес или имя хоста OpenManage Enterprise или OpenManage Enterprise Modular. |
password строка | Пароль OpenManage Enterprise или OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды Пример: export OME_PASSWORD=пароль |
port целое число | Порт HTTPS OpenManage Enterprise или OpenManage Enterprise Modular. По умолчанию: |
reboot_type строка добавлен в dellemc.openmanage 8.3.0 | Этот параметр предоставляет варианты перезагрузки сервера сразу после обновления микропрограммного обеспечения. Применимо, когда schedule равен
Варианты:
|
schedule строка | Выберите график для обновления микропрограммного обеспечения. Если выбран Если выбран Варианты:
|
timeout целое число добавлен в dellemc.openmanage 5.0.0 | Таймаут уровня сокета в секундах. По умолчанию: |
имя_пользователя строка | Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды Пример: export OME_USERNAME=имя_пользователя |
validate_certs булево добавлено в dellemc.openmanage 5.0.0 | Если Настраивайте До версии сборки Варианты:
|
x_auth_token строка добавлено в dellemc.openmanage 9.3.0 | Токен аутентификации. Если x_auth_token не указан, используется переменная среды Пример: export OME_X_AUTH_TOKEN=x_auth_token |
Примечания
Примечание
- Запускайте этот модуль с системы, имеющей прямой доступ к Dell OpenManage Enterprise.
- Этот модуль поддерживает
check_mode.
Примеры
---
- name: Update firmware from DUP file using device ids
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
device_id:
- 11111
- 22222
dup_file: "/path/Chassis-System-Management_Firmware_6N9WN_WN64_1.00.01_A00.EXE"
- name: Update firmware from a DUP file using a device service tags
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
device_service_tag:
- KLBR111
- KLBR222
dup_file: "/path/Network_Firmware_NTRW0_WN64_14.07.07_A00-00_01.EXE"
- name: Update firmware from a DUP file using a device group names
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
device_group_names:
- servers
dup_file: "/path/BIOS_87V69_WN64_2.4.7.EXE"
- name: Update firmware using baseline name
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
- name: Stage firmware for the next reboot using baseline name
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
schedule: StageForNextReboot
- name: "Update firmware using baseline name and components."
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
components:
- BIOS
- name: Update firmware of device components from a DUP file using a device ids in a baseline
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
device_id:
- 11111
- 22222
components:
- iDRAC with Lifecycle Controller
- name: Update firmware of device components from a baseline using a device service tags under a baseline
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
device_service_tag:
- KLBR111
- KLBR222
components:
- IOM-SAS
- name: Update firmware using baseline name with a device id and required components
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
devices:
- id: 12345
components:
- Lifecycle Controller
- id: 12346
components:
- Enterprise UEFI Diagnostics
- BIOS
- name: "Update firmware using baseline name with a device service tag and required components."
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
devices:
- service_tag: ABCDE12
components:
- PERC H740P Adapter
- BIOS
- service_tag: GHIJK34
components:
- OS Drivers Pack
- name: "Update firmware using baseline name with a device service tag or device id and required components."
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
devices:
- service_tag: ABCDE12
components:
- BOSS-S1 Adapter
- PowerEdge Server BIOS
- id: 12345
components:
- iDRAC with Lifecycle Controller
- name: "Update firmware using baseline name and components and perform Powercycle."
dellemc.openmanage.ome_firmware:
hostname: "192.168.0.1"
username: "username"
password: "password"
ca_path: "/path/to/ca_cert.pem"
baseline_name: baseline_devices
components:
- BIOS
reboot_type: PowerCycle
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
error_info словарь | Подробная информация об ошибке HTTP. Возвращается: при ошибке HTTP Пример: |
msg строка | Общий статус обновления прошивки. Возвращается: всегда Пример: |
update_status словарь | Подробная информация о задании обновления прошивки и процессе выполнения из OME. Возвращается: при успешном выполнении Пример: |
Ссылки на сборку
© 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/ome_firmware_module.html