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

Примечание

Этот модуль является частью коллекции community.network (версия 5.0.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

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

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

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

Псевдонимы: network.netact.netact_cm_command

Параметры

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

Авторы

Harri Tuominen (@hatuomin)

Ссылки на коллекцию

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