Spec-Zone.ru › Ansible

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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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-адреса от сервера DHCP.

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

Варианты:

  • false
  • true

enable_ipv4

boolean / required

Включить или отключить доступ к сети с использованием IPv4.

Choices:

  • false
  • true

static_alternate_dns_server

string

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

Эта опция применима, когда use_dhcp_for_dns_server_names имеет значение false.

static_gateway

string

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

Эта опция применима, когда enable_dhcp имеет значение false.

static_ip_address

string

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

Эта опция применима, когда enable_dhcp имеет значение false.

static_preferred_dns_server

string

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

Эта опция применима, когда use_dhcp_for_dns_server_names имеет значение false.

static_subnet_mask

string

Статический адрес маски подсети IPv4

Эта опция применима, когда enable_dhcp имеет значение false.

use_dhcp_to_obtain_dns_server_address

boolean

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

Эта опция применима, когда enable_dhcp имеет значение true.

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

Choices:

  • false
  • true

ipv6_configuration

dictionary

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

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

enable_auto_configuration

boolean

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

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

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

Choices:

  • false
  • true

enable_ipv6

boolean / required

Включить или отключить доступ к сети с использованием IPv6.

Choices:

  • false
  • true

static_alternate_dns_server

string

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

Эта опция применима, когда use_dhcp_for_dns_server_names имеет значение false.

static_gateway

string

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

Эта опция применима, когда enable_auto_configuration имеет значение false.

static_ip_address

string

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

Эта опция применима, когда enable_auto_configuration имеет значение false.

static_preferred_dns_server

string

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

Эта опция применима, когда use_dhcp_for_dns_server_names имеет значение false.

static_prefix_length

integer

Статическая длина префикса IPv6

Эта опция применима, когда enable_auto_configuration имеет значение false.

use_dhcpv6_to_obtain_dns_server_address

boolean

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

Эта опция применима, когда enable_auto_configuration имеет значение true

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

Choices:

  • false
  • true

management_vlan

dictionary

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

enable_vlan

boolean / обязательно

Включить или отключить 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=пароль

port

целое число

Порт HTTPS OpenManage Enterprise Modular.

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

timeout

целое число

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

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

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

username

строка

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

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

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

validate_certs

boolean

добавлено в 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

словарь

Подробности 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

строка

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

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

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

Авторы

  • Jagadeesh N V(@jagadeeshnv)

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

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

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

Spec-Zone.ru

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