Spec-Zone.ru › Ansible 2.11

dellemc.openmanage.ome_application_network_address – Обновляет конфигурацию сети в OpenManage Enterprise

Примечание

Этот плагин входит в коллекцию dellemc.openmanage (версия 3.0.0).

Для установки используйте: ansible-galaxy collection install dellemc.openmanage

Для использования в книге задач укажите: dellemc.openmanage.ome_application_network_address

Новое в версии 2.1.0: из dellemc.openmanage

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата

Обзор

  • Этот модуль позволяет настроить DNS и сеть IPV4 или IPV6 в OpenManage Enterprise.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • python >= 2.7.5

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
dns_configuration
словарь
Настройки системы доменных имен (DNS).
dns_domain_name
строка
Статическое имя домена DNS
Это применимо, когда use_dhcp_for_dns_domain_name равно false.
dns_name
строка
Имя DNS для hostname
Это применимо, когда register_with_dns равно true.
register_with_dns
логическое значение
    Варианты:
  • no
  • yes
Регистрация/Дерегистрация dns_name на DNS-сервере.
Этот параметр не может быть обновлен, если изменяется конфигурация VLAN.
use_dhcp_for_dns_domain_name
логическое значение
    Варианты:
  • no
  • yes
Получение dns_domain_name с помощью DHCP-сервера.
enable_nic
логическое значение
    Варианты:
  • no
  • yes ←
Включить или отключить конфигурацию сетевой карты (NIC).
hostname
строка / обязательно
Целевой IP-адрес или имя хоста.
interface_name
строка
Если есть несколько интерфейсов, изменения конфигурации сети могут быть применены к одному интерфейсу с помощью имени интерфейса NIC.
Если этот параметр не указан, по умолчанию выбирается основной интерфейс.
ipv4_configuration
словарь
Конфигурация сети IPv4.
Предупреждение Убедитесь, что у вас есть альтернативный интерфейс для доступа к OpenManage Enterprise, так как эти параметры могут изменить текущий IPv4-адрес для hostname.
enable
логическое значение / обязательно
    Варианты:
  • no
  • yes
Включить или отключить доступ к сети с помощью IPv4.
enable_dhcp
логическое значение
    Варианты:
  • no
  • yes
Включить или отключить автоматический запрос получения IPv4-адреса от IPv4 DHCP-сервера.
Если параметр enable_dhcp имеет значение true, OpenManage Enterprise получает конфигурацию IP – IPv4-адрес, маску подсети и шлюз от DHCP-сервера в существующей сети.
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_for_dns_server_names
логическое значение
    Варианты:
  • no
  • yes
Этот параметр позволяет автоматически запрашивать и получать IPv4-адрес DNS-сервера от DHCP-сервера.
Этот параметр применим, когда enable_dhcp равно true.
ipv6_configuration
словарь
Конфигурация сети IPv6.
Предупреждение Убедитесь, что у вас есть альтернативный интерфейс для доступа к OpenManage Enterprise, так как эти параметры могут изменить текущий IPv6-адрес для hostname.
enable
логическое значение / обязательно
    Варианты:
  • no
  • yes
Включить или отключить доступ к сети с помощью IPv6.
enable_auto_configuration
логическое значение
    Варианты:
  • no
  • yes
Включить или отключить автоматический запрос получения IPv6-адреса от IPv6 DHCP-сервера или объявлений маршрутизатора (RA).
Если enable_auto_configuration равно true, OME получает конфигурацию IP – IPv6-адрес, префикс и шлюз от DHCPv6-сервера в существующей сети
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_dhcp_for_dns_server_names
логическое значение
    Варианты:
  • no
  • yes
Этот параметр позволяет автоматически запрашивать и получать IPv6-адрес DNS-сервера от DHCP-сервера.
Этот параметр применим, когда enable_auto_configuration равно true
management_vlan
словарь
Конфигурация VLAN.
Эти настройки применимы для OpenManage Enterprise Modular.
enable_vlan
логическое значение / обязательно
    Варианты:
  • no
  • yes
Включить или отключить VLAN для управления.
Конфигурация VLAN не может быть обновлена, если поле register_with_dns в dns_configuration имеет значение true.
ПРЕДУПРЕЖДЕНИЕ Убедитесь, что сетевой кабель подключен к соответствующему порту после внесения изменений в конфигурацию VLAN. В противном случае изменения конфигурации могут быть неэффективными.
vlan_id
целое число
Идентификатор VLAN.
Этот параметр применим, когда enable_vlan равно true.
password
строка / обязательно
Пароль целевого пользователя.
port
целое число
Значение по умолчанию:
443
Целевой порт HTTPS.
reboot_delay
целое число
Время в секундах, по истечении которого настройки применяются.
Этот параметр не является обязательным.
username
строка / обязательно
Имя пользователя целевого пользователя.

Примечания

Примечание

  • Изменения конфигурации могут быть применены только к одному интерфейсу за раз.
  • Консоли управления системой могут быть недоступны в течение некоторого времени после применения изменений конфигурации.
  • Этот модуль не поддерживает check_mode

Примеры

---
- name: IPv4 network configuration for primary interface
  dellemc.openmanage.ome_application_network_address:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    enable_nic: true
    ipv4_configuration:
      enable: 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_for_dns_server_names: false
      static_preferred_dns_server: 192.168.0.4
      static_alternate_dns_server: 192.168.0.5
    reboot_delay: 5

- name: IPv6 network configuration for primary interface
  dellemc.openmanage.ome_application_network_address:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ipv6_configuration:
      enable: true
      enable_auto_configuration: true
      static_ip_address: 2626:f2f2:f081:9:1c1c:f1f1:4747:1
      static_prefix_length: 10
      static_gateway: 2626:f2f2:f081:9:1c1c:f1f1:4747:2
      use_dhcp_for_dns_server_names: true
      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: Management vLAN configuration for primary interface
  dellemc.openmanage.ome_application_network_address:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    management_vlan:
      enable_vlan: true
      vlan_id: 3344
    dns_configuration:
      register_with_dns: false
    reboot_delay: 1

- name: DNS settings
  dellemc.openmanage.ome_application_network_address:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ipv4_configuration:
      enable: true
      use_dhcp_for_dns_server_names: false
      static_preferred_dns_server: 192.168.0.4
      static_alternate_dns_server: 192.168.0.5
    dns_configuration:
      register_with_dns: true
      use_dhcp_for_dns_domain_name: false
      dns_name: "MX-SVCTAG"
      dns_domain_name: "dnslocaldomain"

- name: Disbale nic interface eth1
  dellemc.openmanage.ome_application_network_address:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    enable_nic: false
    interface_name: eth1

- name: Complete network settings for interface eth1
  dellemc.openmanage.ome_application_network_address:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    enable_nic: true
    interface_name: eth1
    ipv4_configuration:
      enable: 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_for_dns_server_names: false
      static_preferred_dns_server: 192.168.0.4
      static_alternate_dns_server: 192.168.0.5
    ipv6_configuration:
      enable: true
      enable_auto_configuration: true
      static_ip_address: 2626:f2f2:f081:9:1c1c:f1f1:4747:1
      static_prefix_length: 10
      static_gateway: ffff::2607:f2b1:f081:9
      use_dhcp_for_dns_server_names: true
      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"
    reboot_delay: 5

Значения возврата

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

Ключ Возвращаемое значение Описание
error_info
словарь
при ошибке HTTP
Подробная информация об ошибке HTTP.

Пример:
{'error': {'@Message.ExtendedInfo': [{'Message': 'Невозможно обновить конфигурацию адреса, потому что отсутствует зависимое поле для использования DHCP для имени домена DNS, включения DHCP для ipv4 или включения автоконфигурации для ipv6 для валидной конфигурации.', 'MessageArgs': ['Использование DHCP для имени домена DNS, включение DHCP для ipv4 или включение автоконфигурации для ipv6 для валидной конфигурации'], 'MessageId': 'CAPP1304', 'RelatedProperties': [], 'Resolution': 'Убедитесь, что все зависимые поля содержат допустимое содержимое и повторите операцию.', 'Severity': 'Критическая'}], 'code': 'Base.1.0.GeneralError', 'message': 'Произошла общая ошибка. Для получения дополнительной информации см. ExtendedInfo.'}}
job_info
словарь
при успехе
Подробная информация о задаче для обновления в случае, если версия OME >= 3.3.

Пример:
{'Builtin': False, 'CreatedBy': 'system', 'Editable': True, 'EndTime': None, 'Id': 14902, 'JobDescription': 'Общее задание выполнения OME', 'JobName': 'OMERealtime_Task', 'JobStatus': {'Id': 2080, 'Name': 'Новый'}, 'JobType': {'Id': 207, 'Internal': True, 'Name': 'OMERealtime_Task'}, 'LastRun': None, 'LastRunStatus': {'Id': 2080, 'Name': 'Новый'}, 'NextRun': None, 'Params': [{'JobId': 14902, 'Key': 'Nmcli_Update', 'Value': '{"interfaceName":"eth0","profileName":"eth0","enableNIC":true, "ipv4Configuration":{"enable":true,"enableDHCP":true,"staticIPAddress":"", "staticSubnetMask":"","staticGateway":"","useDHCPForDNSServerNames":true, "staticPreferredDNSServer":"","staticAlternateDNSServer":""}, "ipv6Configuration":{"enable":false,"enableAutoConfiguration":true,"staticIPAddress":"", "staticPrefixLength":0,"staticGateway":"","useDHCPForDNSServerNames":false, "staticPreferredDNSServer":"","staticAlternateDNSServer":""}, "managementVLAN":{"enableVLAN":false,"id":0},"dnsConfiguration":{"registerWithDNS":false, "dnsName":"","useDHCPForDNSDomainName":false,"dnsDomainName":"","fqdndomainName":"", "ipv4CurrentPreferredDNSServer":"","ipv4CurrentAlternateDNSServer":"", "ipv6CurrentPreferredDNSServer":"","ipv6CurrentAlternateDNSServer":""}, "currentSettings":{"ipv4Address":[],"ipv4Gateway":"","ipv4Dns":[],"ipv4Domain":"", "ipv6Address":[],"ipv6LinkLocalAddress":"","ipv6Gateway":"","ipv6Dns":[], "ipv6Domain":""},"delay":0,"primaryInterface":true,"modifiedConfigs":{}}'}], 'Schedule': 'startnow', 'StartTime': None, 'State': 'Включено', 'Targets': [], 'UpdatedBy': None, 'Visible': True}
msg
строка
всегда
Общий статус изменения конфигурации сетевого адреса.

Пример:
Конфигурация сетевого адреса успешно обновлена
network_configuration
словарь
при успехе
Обновленная конфигурация сетевого адреса приложения.

Пример:
{'Delay': 0, 'DnsConfiguration': {'DnsDomainName': '', 'DnsName': 'MX-SVCTAG', 'RegisterWithDNS': False, 'UseDHCPForDNSDomainName': True}, 'EnableNIC': True, 'InterfaceName': 'eth0', 'Ipv4Configuration': {'Enable': True, 'EnableDHCP': False, 'StaticAlternateDNSServer': '', 'StaticGateway': '192.168.0.2', 'StaticIPAddress': '192.168.0.3', 'StaticPreferredDNSServer': '192.168.0.4', 'StaticSubnetMask': '255.255.254.0', 'UseDHCPForDNSServerNames': False}, 'Ipv6Configuration': {'Enable': True, 'EnableAutoConfiguration': True, 'StaticAlternateDNSServer': '', 'StaticGateway': '', 'StaticIPAddress': '', 'StaticPreferredDNSServer': '', 'StaticPrefixLength': 0, 'UseDHCPForDNSServerNames': True}, 'ManagementVLAN': {'EnableVLAN': False, 'Id': 1}, 'PrimaryInterface': True}


Авторы

  • Jagadeesh N V(@jagadeeshnv)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/dellemc/openmanage/ome_application_network_address_module.html

Spec-Zone.ru

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