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

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

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

Описание

netact_cm_command можно использовать для выполнения различных операций управления конфигурацией. Этот модуль требует, чтобы на целевых хостах была установлена система управления сетями Nokia NetAct. Модуль будет использовать командную строку конфигуратора в 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
  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	Командная строка	Исходное значение параметра name, переданное в команду Пример: /opt/oss/bin/racclimx.sh -op Upload -opsName Uploading_testi -DN PLMN-PLMN/MRBTS-746

Статус

Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется как обратная совместимость.

Автор

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