Модуль dellemc.openmanage.redfish_firmware_rollback — выполнение отката микропрограммы компонента по имени компонента

Примечание

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

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

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

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

Добавлено в dellemc.openmanage 8.2.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

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

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
baseuri string / обязательный	IP-адрес целевого контроллера управления вне диапазона. Например: <ipaddress>:<port>.
ca_path path добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.
name string / обязательный	Имя или регулярное выражение для поиска компонента; учитывается регистр. Указанное имя должно соответствовать поддерживаемому компоненту для отката. Список компонентов, для которых доступен откат на iDRAC9 и более поздних версиях, см. по адресу https://I(idrac_ip/redfish/v1/UpdateService/FirmwareInventory?$expand=*($levels=1)’
password string	Пароль целевого контроллера управления вне диапазона. Если пароль не указан, используется переменная среды `IDRAC_PASSWORD`. Пример: export IDRAC_PASSWORD=password
reboot boolean	Перезагрузить сервер, чтобы применить предыдущую версию микропрограммы. `true` перезагружает сервер, чтобы откатить микропрограмму до доступной версии. `false` планирует откат микропрограммы до следующего перезапуска. Если reboot имеет значение `false`, некоторые компоненты обновляются немедленно, и сервер может перезагрузиться. Поэтому модуль должен дождаться, пока сервер снова станет доступен. Варианты: `false` `true` ← (по умолчанию)
reboot_timeout integer	Время ожидания в секундах. В течение этого времени модуль ожидает перезагрузки сервера. По умолчанию: `900`
timeout integer добавлено в dellemc.openmanage 5.0.0	Тайм-аут на уровне сокета в секундах. По умолчанию: `30`
username string	Имя пользователя целевого контроллера управления вне диапазона. Если имя пользователя не указано, используется переменная среды `IDRAC_USERNAME`. Пример: export IDRAC_USERNAME=username
validate_certs boolean добавлено в dellemc.openmanage 5.0.0	Если `false`, сертификаты SSL не проверяются. Настраивайте `false` только в контролируемых вами средах, где используются самоподписанные сертификаты. До версии коллекции `5.0.0` значение validate_certs по умолчанию — `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token string добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `IDRAC_X_AUTH_TOKEN`. Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Запускайте этот модуль в системе, имеющей прямой доступ к API Redfish.
Для компонентов, не требующих перезагрузки, откат микропрограммы выполняется независимо от того, имеет ли reboot значение true или false.
Этот модуль поддерживает адреса IPv4 и IPv6.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Rollback a BIOS component firmware
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: "BIOS"

- name: Rollback all NIC cards with a name starting from 'Broadcom Gigabit'.
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1:443"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: "Broadcom Gigabit Ethernet.*"

- name: Rollback all the component firmware except BIOS component.
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1:443"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: "(?!BIOS).*"

- name: Rollback all the available firmware component.
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1:443"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: ".*"

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

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

Ключ	Описание
error_info dictionary	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "InstanceID value provided for the update operation is invalid", "MessageArgs": [], "MessageArgs@odata.count": 0, "MessageId": "IDRAC.2.8.SUP024", "RelatedProperties": [], "RelatedProperties@odata.count": 0, "Resolution": "Enumerate inventory, copy the InstanceID value and provide that value for the update operation.", "Severity": "Warning"}], "code": "Base.1.12.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information"}}
msg string	Общий статус отката микропрограммы. Возвращается: всегда Пример: `"Successfully completed the job for firmware rollback."`
status list / elements=string	Сведения о задании отката микропрограммы и ходе его выполнения, полученные от iDRAC. Возвращается: при успешном выполнении Пример: `[{"ActualRunningStartTime": "2023-08-04T12:26:55", "ActualRunningStopTime": "2023-08-04T12:32:35", "CompletionTime": "2023-08-04T12:32:35", "Description": "Job Instance", "EndTime": "TIME_NA", "Id": "JID_911698303631", "JobState": "Completed", "JobType": "FirmwareUpdate", "Message": "Job completed successfully.", "MessageArgs": [], "MessageId": "PR19", "Name": "Firmware Rollback: Firmware", "PercentComplete": 100, "StartTime": "2023-08-04T12:23:50", "TargetSettingsURI": null}]`

Авторы

Felix Stephen (@felixs88)
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/redfish_firmware_rollback_module.html