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

Новая версия 2.5.

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backupPlanName -		Указывает имя резервного плана
createBackupPlan boolean	Варианты: 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
  netact_cm_command:
    operation: "Upload"
    opsname: 'Uploading_test'
    dn: "PLMN-PLMN/MRBTS-746"
    extra_opts: '-btsContentInUse true'

- name: Provision
  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
  netact_cm_command:
    operation: "Export"
    opsname: 'Export_test'
    planName: 'mySiteTemplate'
    type: 'actual'
    fileName: 'exportTest.xml'
- fetch:
    src: /var/opt/nokia/oss/global/racops/export/exportTest.xml
    dest: fetched

- name: Import
  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
  netact_cm_command:
    name: fail me

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

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

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

Статус

Для этого модуля не гарантируется обратная совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Харри Туоминен (@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.9/modules/netact_cm_command_module.html