Spec-Zone.ru › Ansible

модуль dellemc.openmanage.ome_device_mgmt_network — настройка сетевых параметров устройств в OpenManage Enterprise Modular

Примечание

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

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

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

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

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

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

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

  • Этот модуль позволяет настраивать сетевые параметры шасси, серверов и модулей ввода-вывода в OpenManage Enterprise Modular.

Требования

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

  • python >= 3.9.6

Параметры

Параметр

Комментарии

ca_path

путь

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

Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.

delay

целое число

Время в секундах, по истечении которого применяются настройки.

Этот параметр применим только к шасси.

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

device_id

целое число

Идентификатор устройства.

Этот параметр нельзя использовать вместе с device_service_tag.

device_service_tag

строка

Тег службы устройства.

Этот параметр нельзя использовать вместе с device_id.

dns_configuration

словарь

Параметры системы доменных имен (DNS).

auto_negotiation

логическое значение

Включает или отключает автосогласование скорости сети.

NOTE: если задать для auto_negotiation значение false и выбрать скорость сетевого порта, шасси может потерять связь с верхним коммутатором стойки или с соседним шасси в режиме MCM. В большинстве случаев рекомендуется задавать для auto_negotiation значение true.

Применимо, если для use_dhcp_for_dns_domain_name задано значение false.

Применимо только к шасси.

Варианты:

  • false
  • true

dns_domain_name

строка

Статическое имя домена DNS.

Применимо, если для use_dhcp_for_dns_domain_name задано значение false.

dns_name

строка

Имя DNS для hostname.

Применимо, если для register_with_dns задано значение true.

network_speed

строка

Скорость сетевого порта.

Применимо, если для auto_negotiation задано значение false.

10_MB для выбора скорости сети 10 МБ.

100_MB для выбора скорости сети 100 МБ.

Применимо только к шасси.

Варианты:

  • "10_MB"
  • "100_MB"

register_with_dns

логическое значение

Регистрирует или отменяет регистрацию dns_name на DNS-сервере.

WARNING Этот параметр нельзя обновить при изменении конфигурации VLAN.

Варианты:

  • false
  • true

use_dhcp_for_dns_domain_name

логическое значение

Получает dns_domain_name с помощью DHCP-сервера.

Варианты:

  • false
  • true

dns_server_settings

словарь

Параметры DNS-сервера.

Применимо только к модулю ввода-вывода.

alternate_dns_server1

строка

Введите IP-адрес первого альтернативного DNS-сервера.

alternate_dns_server2

строка

Введите IP-адрес второго альтернативного DNS-сервера.

preferred_dns_server

строка

Введите IP-адрес предпочтительного DNS-сервера.

enable_nic

логическое значение

Включает или отключает конфигурацию сетевой карты (NIC) устройства.

Этот параметр неприменим к модулю ввода-вывода.

Варианты:

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

hostname

строка / обязательный

IP-адрес или имя хоста OpenManage Enterprise Modular.

ipv4_configuration

словарь

Конфигурация сети IPv4.

WARNING Убедитесь, что у вас есть альтернативный интерфейс для доступа к OpenManage Enterprise Modular, поскольку эти параметры могут изменить текущий адрес IPv4 для hostname.

enable_dhcp

логическое значение

Включает или отключает автоматический запрос на получение адреса IPv4 от сервера протокола динамической конфигурации узла IPv4 (DHCP).

NOTE Если для этого параметра задано значение true, значения, указанные для static_ip_address, static_subnet_mask и static_gateway, не применяются к этим полям. Однако модуль может сообщить об изменениях.

Варианты:

  • false
  • true

enable_ipv4

логическое значение / обязательный

Включает или отключает доступ к сети по протоколу IPv4.

Варианты:

  • false
  • true

static_alternate_dns_server

строка

Статический альтернативный DNS-сервер IPv4.

Этот параметр применим, если для use_dhcp_for_dns_server_names задано значение false.

static_gateway

строка

Статический адрес шлюза IPv4.

Этот параметр применим, если для enable_dhcp задано значение false.

static_ip_address

строка

Статический адрес IPv4.

Этот параметр применим, если для enable_dhcp задано значение false.

static_preferred_dns_server

строка

Статический предпочтительный DNS-сервер IPv4.

Этот параметр применим, если для use_dhcp_for_dns_server_names задано значение false.

static_subnet_mask

строка

Статическая маска подсети IPv4.

Этот параметр применим, если для enable_dhcp задано значение false.

use_dhcp_to_obtain_dns_server_address

логическое значение

Этот параметр позволяет автоматически запрашивать и получать адрес IPv4 DNS-сервера от DHCP-сервера.

Этот параметр применим, если для enable_dhcp задано значение true.

NOTE Если для этого параметра задано значение true, значения, указанные для static_preferred_dns_server и static_alternate_dns_server, не применяются к этим полям. Однако модуль может сообщить об изменениях.

Варианты:

  • false
  • true

ipv6_configuration

словарь

Конфигурация сети IPv6.

WARNING Убедитесь, что у вас есть альтернативный интерфейс для доступа к OpenManage Enterprise Modular, поскольку эти параметры могут изменить текущий адрес IPv6 для hostname.

enable_auto_configuration

логическое значение

Включает или отключает автоматический запрос на получение адреса IPv6 от DHCP-сервера IPv6 или из объявлений маршрутизатора (RA).

Если для enable_auto_configuration задано значение true, OpenManage Enterprise Modular получает конфигурацию IP (адрес IPv6, префикс и адрес шлюза) от DHCPv6-сервера в существующей сети.

NOTE Если для этого параметра задано значение true, значения, указанные для static_ip_address, static_prefix_length и static_gateway, не применяются к этим полям. Однако модуль может сообщить об изменениях.

Варианты:

  • false
  • true

enable_ipv6

логическое значение / обязательный

Включает или отключает доступ к сети по протоколу IPv6.

Варианты:

  • false
  • true

static_alternate_dns_server

строка

Статический альтернативный DNS-сервер IPv6.

Этот параметр применим, если для use_dhcp_for_dns_server_names задано значение false.

static_gateway

строка

Статический адрес шлюза IPv6.

Этот параметр применим, если для enable_auto_configuration задано значение false.

static_ip_address

строка

Статический адрес IPv6.

Этот параметр применим, если для enable_auto_configuration задано значение false.

static_preferred_dns_server

строка

Статический предпочтительный DNS-сервер IPv6.

Этот параметр применим, если для use_dhcp_for_dns_server_names задано значение false.

static_prefix_length

целое число

Длина статического префикса IPv6.

Этот параметр применим, если для enable_auto_configuration задано значение false.

use_dhcpv6_to_obtain_dns_server_address

логическое значение

Этот параметр позволяет автоматически запрашивать и получать адрес IPv6 DNS-сервера от DHCP-сервера.

Этот параметр применим, если для enable_auto_configuration задано значение true.

NOTE Если для этого параметра задано значение true, значения, указанные для static_preferred_dns_server и static_alternate_dns_server, не применяются к этим полям. Однако модуль может сообщить об изменениях.

Варианты:

  • false
  • true

management_vlan

словарь

Конфигурация VLAN.

enable_vlan

логическое значение / обязательный

Включает или отключает VLAN для управления.

Конфигурацию VLAN нельзя обновить, если для поля register_with_dns в разделе dns_configuration задано значение true.

WARNING После изменения конфигурации VLAN убедитесь, что сетевой кабель подключен к нужному порту. В противном случае изменения конфигурации VLAN могут не примениться.

Варианты:

  • false
  • true

vlan_id

целое число

Идентификатор VLAN.

Допустимые идентификаторы VLAN: от 1 до 4000 и от 4021 до 4094.

Этот параметр применим, если для enable_vlan задано значение true.

password

строка

Пароль OpenManage Enterprise Modular.

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

Пример: export OME_PASSWORD=password

port

целое число

Порт HTTPS OpenManage Enterprise Modular.

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

timeout

целое число

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

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

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

username

строка

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

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

Пример: export OME_USERNAME=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 Modular.
  • Этот модуль поддерживает check_mode.

Примеры

---
- name: Network settings for chassis
  dellemc.openmanage.ome_device_mgmt_network:
    hostname: 192.168.0.1
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag: CHAS123
    ipv4_configuration:
      enable_ipv4: true
      enable_dhcp: false
      static_ip_address: 192.168.0.2
      static_subnet_mask: 255.255.254.0
      static_gateway: 192.168.0.3
      use_dhcp_to_obtain_dns_server_address: false
      static_preferred_dns_server: 192.168.0.4
      static_alternate_dns_server: 192.168.0.5
    ipv6_configuration:
      enable_ipv6: true
      enable_auto_configuration: false
      static_ip_address: 2626:f2f2:f081:9:1c1c:f1f1:4747:1
      static_prefix_length: 10
      static_gateway: ffff::2607:f2b1:f081:9
      use_dhcpv6_to_obtain_dns_server_address: false
      static_preferred_dns_server: 2626:f2f2:f081:9:1c1c:f1f1:4747:3
      static_alternate_dns_server: 2626:f2f2:f081:9:1c1c:f1f1:4747:4
    dns_configuration:
      register_with_dns: true
      use_dhcp_for_dns_domain_name: false
      dns_name: "MX-SVCTAG"
      dns_domain_name: "dnslocaldomain"
      auto_negotiation: false
      network_speed: 100_MB

- name: Network settings for server
  dellemc.openmanage.ome_device_mgmt_network:
    hostname: 192.168.0.1
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag: SRVR123
    ipv4_configuration:
      enable_ipv4: true
      enable_dhcp: false
      static_ip_address: 192.168.0.2
      static_subnet_mask: 255.255.254.0
      static_gateway: 192.168.0.3
      use_dhcp_to_obtain_dns_server_address: false
      static_preferred_dns_server: 192.168.0.4
      static_alternate_dns_server: 192.168.0.5
    ipv6_configuration:
      enable_ipv6: true
      enable_auto_configuration: false
      static_ip_address: 2626:f2f2:f081:9:1c1c:f1f1:4747:1
      static_prefix_length: 10
      static_gateway: ffff::2607:f2b1:f081:9
      use_dhcpv6_to_obtain_dns_server_address: false
      static_preferred_dns_server: 2626:f2f2:f081:9:1c1c:f1f1:4747:3
      static_alternate_dns_server: 2626:f2f2:f081:9:1c1c:f1f1:4747:4

- name: Network settings for I/O module
  dellemc.openmanage.ome_device_mgmt_network:
    hostname: 192.168.0.1
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag: IOM1234
    ipv4_configuration:
      enable_ipv4: true
      enable_dhcp: false
      static_ip_address: 192.168.0.2
      static_subnet_mask: 255.255.254.0
      static_gateway: 192.168.0.3
    ipv6_configuration:
      enable_ipv6: true
      enable_auto_configuration: false
      static_ip_address: 2626:f2f2:f081:9:1c1c:f1f1:4747:1
      static_prefix_length: 10
      static_gateway: ffff::2607:f2b1:f081:9
    dns_server_settings:
      preferred_dns_server: 192.168.0.4
      alternate_dns_server1: 192.168.0.5

- name: Management VLAN configuration of chassis using device id
  dellemc.openmanage.ome_device_mgmt_network:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id: 12345
    management_vlan:
      enable_vlan: true
      vlan_id: 2345
    dns_configuration:
      register_with_dns: false

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

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

Ключ

Описание

error_info

dictionary

Подробности ошибки HTTP.

Возвращается: при ошибке HTTP

Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the request because IPV4 Settings Capability is not Supported does not exist or is not applicable for the resource URI.", "MessageArgs": ["IPV4 Settings Capability is not Supported"], "MessageId": "CGEN1004", "RelatedProperties": [], "Resolution": "Check the request resource URI. Refer to the OpenManage Enterprise-Modular User's Guide for more information about resource URI and its properties.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}

msg

string

Общий статус операции настройки сети.

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

Пример: "Successfully applied the network settings."

Авторы

  • Jagadeesh N V(@jagadeeshnv)
  • Bhavneet Sharma (@Bhavneet-Sharma)

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

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

© 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/ome_device_mgmt_network_module.html

Spec-Zone.ru

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