community.network.netact_cm_command – Управление данными конфигурации сети в сетях Nokia Core и радио

Примечание

Этот плагин входит в сборник community.network (версия 1.3.0).

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

Чтобы использовать его в книге задач, укажите: community.network.netact_cm_command.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

netact_cm_command может использоваться для выполнения различных операций управления конфигурацией. Для этого модуля требуется, чтобы на целевых узлах была установлена система управления сетями Nokia NetAct. Модуль будет обращаться к командной строке Configurator в NetAct для загрузки конфигурации сети в NetAct, запуска экспорта конфигурации, импорта планов и операций по предоставлению конфигурации. Для определения области действия операции укажите Имя различающегося имени (DN) или Рабочий набор (WS) или Регион обслуживания (MR) в качестве входных данных.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backupPlanName строка		Указывает имя резервного плана
createBackupPlan булево	Варианты: нет да	Указывает, включено ли создание резервного плана.
DN строка		Устанавливает точный охват операции в виде списка Имен различающегося имени (DN) управляемых объектов в сети. Можно указать одно или несколько DN (список через запятую без пробелов). В противном случае, если DN или список DN не указаны, в качестве параметра для определения области действия операции необходимо указать рабочий набор (WS) или регион обслуживания (MR).
extra_opts строка		Дополнительные параметры для операций. Обратитесь к документации Nokia NetAct в разделе «Управление конфигурацией» > «Процедуры управления конфигурацией» > «Операции в командной строке» для получения дополнительной информации о дополнительных параметрах.
fileFormat строка	Варианты: RAML2 CSV XLSX	Указывает формат файла.
fileName строка		Указывает имя файла. Действительно для операций импорта и экспорта.
inputFile строка		Указывает полный путь к расположению файла плана для операции импорта. Необходимо заполнить этот параметр (inputFile) или параметр fileName. Если оба параметра присутствуют, используется inputFile.
MR строка		Устанавливает область действия операции для сетевых элементов, назначенных в регион обслуживания (MR). Значение может быть установлено как идентификаторы MR, включая информацию о коллекции регионов обслуживания (MRC) (например, MRC-FIN1/MR-Hel). Можно указать несколько MR (список через запятую без пробелов). Значение этого параметра ищется среди идентификаторов MR в заданной MRC. Если совпадений нет, поиск производится по всем именам MR. В противном случае, если идентификатор MR или список идентификаторов MR не указаны, необходимо указать имя различающегося имени (DN) или рабочий набор (WS) для определения области действия операции.
operation строка / обязательно	Варианты: upload provision import export Provision_Mass_Modification	Поддерживаемые операции позволяют пользователю загружать фактическую конфигурацию из сети, импортировать и предоставлять подготовленные планы или экспортировать эталонную или фактическую конфигурацию для целей планирования. Provision_Mass_Modification позволяет предоставить одни и те же параметры нескольким сетевым элементам. Эта операция поддерживает модификации только для одного класса объектов за раз. С помощью этого варианта NetAct Configurator создаёт и предоставляет план в сеть с заданной областью действия и параметрами. алиасы: op
opsName строка		Имя операции, указанное пользователем
planName строка		Указывает имя плана.
typeOption строка	Варианты: plan actual reference template siteTemplate	Указывает тип операции экспорта. алиасы: type
verbose строка		NetAct Configurator выведет более подробную информацию
WS строка		Устанавливает область действия операции, используя один или несколько предварительно определённых рабочих наборов (WS) в NetAct. Рабочий набор содержит сетевые элементы, выбранные пользователем в соответствии с определёнными критериями. Можно указать одно имя WS или несколько WS (список через запятую без пробелов). В противном случае, если имя WS или список WS не указаны, необходимо указать имя различающегося имени (DN) или регион обслуживания (MR) для определения области действия операции.

Примечания

Примечание

Режим проверки в настоящее время не поддерживается

Примеры

# Pass in a message
- name: Upload
  community.network.netact_cm_command:
    operation: "Upload"
    opsname: 'Uploading_test'
    dn: "PLMN-PLMN/MRBTS-746"
    extra_opts: '-btsContentInUse true'

- name: Provision
  community.network.netact_cm_command:
    operation: "Provision"
    opsname: 'Provision_test'
    dn: "PLMN-PLMN/MRBTS-746"
    planName: 'mySiteTemplate'
    type: 'actual'
    createBackupPlan: true
    backupPlanName: 'myBackupPlanName'

- name: Export and fetching data from target
  community.network.netact_cm_command:
    operation: "Export"
    opsname: 'Export_test'
    planName: 'mySiteTemplate'
    type: 'actual'
    fileName: 'exportTest.xml'
- ansible.builtin.fetch:
    src: /var/opt/nokia/oss/global/racops/export/exportTest.xml
    dest: fetched

- name: Import
  community.network.netact_cm_command:
    operation: "Import"
    opsname: 'Import_test'
    fileFormat: 'CSV'
    type: 'plan'
    fileName: 'myCSVFile'
    planName: 'myPlanName'
    extra_ops: 'enablePolicyPlans true'

# fail the module
- name: Test failure of the module
  community.network.netact_cm_command:
    name: fail me

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

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

Ключ	Возвращённое значение	Описание
changed булево	true, если данные изменены	данные изменены
message строка	Сообщение вывода команды	Сообщение вывода, сгенерированное модулем netact_cm_command
original_message строка	Командная строка	Исходное имя параметра, которое было передано Пример: /opt/oss/bin/racclimx.sh -op Upload -opsName Uploading_testi -DN PLMN-PLMN/MRBTS-746

Авторы

Harri Tuominen (@hatuomin)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/netact_cm_command_module.html