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 строка	Сообщение вывода команды	Сообщение вывода, генерируемое модулем netact_cm_command.
original_message строка	Командная строка	Исходное имя параметра, которое было передано. Пример: /opt/oss/bin/racclimx.sh -op Upload -opsName Uploading_testi -DN PLMN-PLMN/MRBTS-746

Статус

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

Авторы

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.7/modules/netact_cm_command_module.html