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

Примечание

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

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

Для использования в книге задач укажите: community.network.netact_cm_command.

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backupPlanName строка		Указывает имя резервного плана
createBackupPlan логическое	Варианты: no yes	Указывает, включена ли генерация резервного плана.
DN строка		Устанавливает точную область действия операции в виде списка имен выделенных объектов (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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/netact_cm_command_module.html