Spec-Zone.ru › Ansible

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.

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

Пример: export OME_PASSWORD=пароль

port

целое число

Порт HTTPS OpenManage Enterprise или OpenManage Enterprise Modular.

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

reboot_type

строка

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

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

Применимо, когда schedule равен RebootNow.

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

GracefulReboot выполняет плавную перезагрузку без принудительного выключения.

PowerCycle выполняет цикл питания для жесткой перезагрузки устройства.

Варианты:

  • "GracefulReboot"
  • "GracefulRebootForce" ← (по умолчанию)
  • "PowerCycle"

schedule

строка

Выберите график для обновления микропрограммного обеспечения.

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

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

Варианты:

  • "RebootNow" ← (по умолчанию)
  • "StageForNextReboot"

timeout

целое число

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

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

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

имя_пользователя

строка

Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular.

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

Пример: export OME_USERNAME=имя_пользователя

validate_certs

булево

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

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

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

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

Варианты:

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

x_auth_token

строка

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

Токен аутентификации.

Если x_auth_token не указан, используется переменная среды OME_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

Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}

msg

строка

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

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

Пример: "Successfully submitted the firmware update job."

update_status

словарь

Подробная информация о задании обновления прошивки и процессе выполнения из OME.

Возвращается: при успешном выполнении

Пример: {"Builtin": false, "CreatedBy": "user", "Editable": true, "EndTime": "None", "Id": 11117, "JobDescription": "dup test", "JobName": "Firmware Update Task", "JobStatus": {"Id": 1111, "Name": "New"}, "JobType": {"Id": 5, "Internal": false, "Name": "Update_Task"}, "LastRun": "None", "LastRunStatus": {"Id": 1111, "Name": "NotRun"}, "NextRun": "None", "Params": [{"JobId": 11111, "Key": "signVerify", "Value": "true"}, {"JobId": 11112, "Key": "stagingValue", "Value": "false"}, {"JobId": 11113, "Key": "complianceUpdate", "Value": "false"}, {"JobId": 11114, "Key": "operationName", "Value": "INSTALL_FIRMWARE"}], "Schedule": "startnow", "StartTime": "None", "State": "Enabled", "Targets": [{"Data": "DCIM:INSTALLED#701__NIC.Mezzanine.1A-1-1=1234567654321", "Id": 11115, "JobId": 11116, "TargetType": {"Id": 1000, "Name": "DEVICE"}}], "UpdatedBy": "None", "Visible": true}

Авторы

  • Felix Stephen (@felixs88)
  • Jagadeesh N V (@jagadeeshnv)
  • Abhishek Sinha (@ABHISHEK-SINHA10)

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

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

© 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

Spec-Zone.ru

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