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 логическое значение |
| Регистрация/Дерегистрация dns_name на DNS-сервере. Этот параметр не может быть обновлен, если изменяется конфигурация VLAN. | |
| use_dhcp_for_dns_domain_name логическое значение |
| Получение dns_domain_name с помощью DHCP-сервера. | |
| enable_nic логическое значение |
| Включить или отключить конфигурацию сетевой карты (NIC). | |
| hostname строка / обязательно | Целевой IP-адрес или имя хоста. | ||
| interface_name строка | Если есть несколько интерфейсов, изменения конфигурации сети могут быть применены к одному интерфейсу с помощью имени интерфейса NIC. Если этот параметр не указан, по умолчанию выбирается основной интерфейс. | ||
| ipv4_configuration словарь | Конфигурация сети IPv4.
Предупреждение Убедитесь, что у вас есть альтернативный интерфейс для доступа к OpenManage Enterprise, так как эти параметры могут изменить текущий IPv4-адрес для hostname. | ||
| enable логическое значение / обязательно |
| Включить или отключить доступ к сети с помощью IPv4. | |
| enable_dhcp логическое значение |
| Включить или отключить автоматический запрос получения 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 логическое значение |
| Этот параметр позволяет автоматически запрашивать и получать IPv4-адрес DNS-сервера от DHCP-сервера. Этот параметр применим, когда enable_dhcp равно true. | |
| ipv6_configuration словарь | Конфигурация сети IPv6.
Предупреждение Убедитесь, что у вас есть альтернативный интерфейс для доступа к OpenManage Enterprise, так как эти параметры могут изменить текущий IPv6-адрес для hostname. | ||
| enable логическое значение / обязательно |
| Включить или отключить доступ к сети с помощью IPv6. | |
| enable_auto_configuration логическое значение |
| Включить или отключить автоматический запрос получения 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 логическое значение |
| Этот параметр позволяет автоматически запрашивать и получать IPv6-адрес DNS-сервера от DHCP-сервера. Этот параметр применим, когда enable_auto_configuration равно true | |
| management_vlan словарь | Конфигурация VLAN. Эти настройки применимы для OpenManage Enterprise Modular. | ||
| enable_vlan логическое значение / обязательно |
| Включить или отключить 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