Spec-Zone.ru › Ansible

Модуль dellemc.openmanage.idrac_reset – сброс iDRAC до заводских настроек

Примечание

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

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

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

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

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

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

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

  • Этот модуль сбрасывает iDRAC до заводских настроек.

Требования

Для выполнения этого модуля на хосте необходимы следующие компоненты.

  • python >= 3.9.6

Параметры

Параметр

Комментарии

ca_path

путь

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

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

custom_defaults_buffer

строка

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

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

Этот параметр применим, когда reset_to_default имеет значение CustomDefaults.

custom_defaults_buffer нельзя использовать одновременно с custom_defaults_file.

custom_defaults_file

строка

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

Имя файла пользовательской конфигурации по умолчанию в формате XML.

Этот параметр применим, когда reset_to_default имеет значение CustomDefaults.

custom_defaults_file нельзя использовать одновременно с custom_defaults_buffer.

default_password

строка

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

Этот параметр применяется только, когда reset_to_default имеет значение All или ResetAllWithRootDefaults.

Этот параметр необходим для отслеживания состояния LifeCycle сервера после выполнения операции сброса. Если этот параметр не указан, состояние LifeCycle после операции сброса не отслеживается.

default_username

строка

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

Этот параметр применяется только, когда reset_to_default имеет значение All или ResetAllWithRootDefaults.

Этот параметр необходим для отслеживания состояния LifeCycle сервера после выполнения операции сброса. Если этот параметр не указан, состояние LifeCycle после операции сброса не отслеживается.

force_reset

логический

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

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

Этот параметр применим только для iDRAC9.

Варианты:

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

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

job_wait_timeout

целое число

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

Время ожидания завершения задания в секундах.

Применяется, если wait_for_idrac имеет значение true.

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

reset_to_default

строка

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

Если это значение не задано, iDRAC перезапускается по умолчанию.

All Отменяет все настройки и сбрасывает учетные данные до значений по умолчанию.

ResetAllWithRootDefaults Отменяет все настройки и сбрасывает имя пользователя до значения root, а пароль — до заводского значения.

Default Отменяет все настройки, но сохраняет настройки пользователя и сети.

CustomDefaults Для всей конфигурации устанавливаются пользовательские значения по умолчанию. Этот параметр поддерживается в версии микропрограммы 7.00.00.00 и более поздних версиях.

Варианты:

  • "Default"
  • "All"
  • "ResetAllWithRootDefaults"
  • "CustomDefaults"

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 ← (по умолчанию)

wait_for_idrac

логический

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

Этот параметр позволяет дождаться сброса iDRAC и готовности контроллера жизненного цикла.

Варианты:

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

x_auth_token

строка

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

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

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

Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

  • Запускайте этот модуль в системе, имеющей прямой доступ к Dell iDRAC.
  • Этот модуль поддерживает адреса IPv4 и IPv6 для idrac_ip.
  • Этот модуль поддерживает check_mode.
  • Если параметр reset_to_default не указан, модуль выполняет штатный перезапуск.
  • Модуль пропускает выполнение, если iDRAC не поддерживает параметры сброса.

Примеры

---
- name: Reset the iDRAC to default and do not wait till the iDRAC is accessible.
  dellemc.openmanage.idrac_reset:
   idrac_ip: "192.168.0.1"
   idrac_user: "user_name"
   idrac_password: "user_password"
   ca_path: "/path/to/ca_cert.pem"
   reset_to_default: "Default"
   wait_for_idrac: false

- name: Reset the iDRAC to All and wait for lifecycle controller status to be ready.
  dellemc.openmanage.idrac_reset:
   idrac_ip: "192.168.0.1"
   idrac_user: "user_name"
   idrac_password: "user_password"
   ca_path: "/path/to/ca_cert.pem"
   reset_to_default: "All"
   wait_for_idrac: true
   default_username: "user_name"
   default_password: "user_password"

- name: Force reset the iDRAC to default.
  dellemc.openmanage.idrac_reset:
   idrac_ip: "192.168.0.1"
   idrac_user: "user_name"
   idrac_password: "user_password"
   ca_path: "/path/to/ca_cert.pem"
   reset_to_default: "Default"
   force_reset: true

- name: Gracefully restart the iDRAC.
  dellemc.openmanage.idrac_reset:
   idrac_ip: "192.168.0.1"
   idrac_user: "user_name"
   idrac_password: "user_password"
   ca_path: "/path/to/ca_cert.pem"

- name: Reset the iDRAC to custom defaults XML and do not wait till the iDRAC is accessible.
  dellemc.openmanage.idrac_reset:
   idrac_ip: "192.168.0.1"
   idrac_user: "user_name"
   idrac_password: "user_password"
   ca_path: "/path/to/ca_cert.pem"
   reset_to_default: "CustomDefaults"
   custom_defaults_file: "/path/to/custom_defaults.xml"

- name: Reset the iDRAC to custom defaults buffer input and do not wait till the iDRAC is accessible.
  dellemc.openmanage.idrac_reset:
   idrac_ip: "192.168.0.1"
   idrac_user: "user_name"
   idrac_password: "user_password"
   ca_path: "/path/to/ca_cert.pem"
   reset_to_default: "CustomDefaults"
   custom_defaults_buffer: "<SystemConfiguration Model=\"PowerEdge R7525\" ServiceTag=\"ABCD123\">\n<Component FQDD=\"iDRAC.Embedded.1\">\n
                               <Attribute Name=\"IPMILan.1#Enable\">Disabled</Attribute>\n </Component>\n\n</SystemConfiguration>"

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

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

Ключ

Описание

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

строка

Состояние операции сброса iDRAC.

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

Пример: "Successfully performed iDRAC reset."

reset_status

словарь

Сведения об операции сброса iDRAC.

Возвращается: если запущена операция сброса.

Пример: {"idracreset": {"Data": {"StatusCode": 204}, "Message": "none", "Status": "Success", "StatusCode": 204, "retval": true}}

Авторы

  • Felix Stephen (@felixs88)
  • Anooja Vardhineni (@anooja-vardhineni)
  • Lovepreet Singh (@singh-lovepreet1)
  • Abhishek Sinha (@ABHISHEK-SINHA10)
  • Rounak Adhikary (@rounak-adhikary)

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

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

© 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_reset_module.html

Spec-Zone.ru

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