community.network.netact_cm_command 模块 – 在诺基亚核心网和无线网络中管理网络配置数据

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.network。

要在 playbook 中使用它，请指定：community.network.netact_cm_command。

注意

community.network 集合已被弃用，并将从 Ansible 12 中移除。请参阅 讨论主题 以了解更多信息。

已弃用

在以下版本中移除：

版本 6.0.0

原因：

此集合及其中的所有内容均未维护且已弃用。

替代方案：

未知。

摘要

  • netact_cm_command 可用于运行各种配置管理操作。此模块要求目标主机已安装 Nokia NetAct 网络管理系统。模块将访问 NetAct 中的配置器命令行界面，以将网络配置上传到 NetAct，运行配置导出、计划导入和配置供应操作。要设置操作范围，请定义区分名称 (DN) 或工作集 (WS) 或维护区域 (MR) 作为输入

别名：network.netact.netact_cm_command

参数

参数

注释

backupPlanName

字符串

指定备份计划名称

createBackupPlan

布尔值

指定是否启用备份计划生成。

选项

  • false

  • true

DN

字符串

以网络中受管理对象的区分名称 (DN) 列表的形式设置操作的确切范围。可以提供单个 DN 或 DN 列表（以逗号分隔的列表，不含空格）。或者，如果没有提供 DN 或 DN 列表，则必须提供工作集 (WS) 或维护区域 (MR) 作为参数来设置操作范围。

extra_opts

字符串

要为操作设置的额外选项。有关额外选项的更多信息，请查看诺基亚 NetAct 用户文档中的“配置管理 > 配置管理操作程序 > 命令行操作”。

fileFormat

字符串

指示文件格式。

选项

  • "RAML2"

  • "CSV"

  • "XLSX"

fileName

字符串

指定文件名。适用于导入和导出操作。

inputFile

字符串

指定导入操作的计划文件位置的完整路径。必须填写此参数 (inputFile) 或 fileName 参数。如果两者都存在，则使用 inputFile。

MR

字符串

将操作范围设置为分配给维护区域 (MR) 的网络元素。值可以设置为包括维护区域集合 (MRC) 信息的 MR ID（例如 MRC-FIN1/MR-Hel）。可以提供多个 MR（以逗号分隔的列表，不含空格）。此参数的值将在给定 MRC 下的 MR ID 中搜索。如果没有匹配项，则会在所有 MR 名称中搜索。或者，如果没有提供 MR ID 或 MR ID 列表，则必须提供区分名称 (DN) 或工作集 (WS) 作为参数来设置操作范围。

operation

别名：op

字符串 / 必需

支持的操作允许用户上传网络中的实际配置，导入和配置准备好的计划，或导出参考或实际配置以供规划使用。Provision_Mass_Modification 启用将相同的参数配置到多个网络元素。此操作仅支持一次修改一个对象类。使用此选项，NetAct 配置器将使用给定的范围和选项创建并配置计划到网络。

选项

  • "upload"

  • "provision"

  • "import"

  • "export"

  • "Provision_Mass_Modification"

opsName

字符串

用户指定的作业名称

planName

字符串

指定计划名称。

typeOption

别名：type

字符串

指定导出操作的类型。

选项

  • "plan"

  • "actual"

  • "reference"

  • "template"

  • "siteTemplate"

verbose

字符串

NetAct 配置器将打印更多信息

WS

字符串

将操作范围设置为使用 NetAct 中的一个或多个预定义工作集 (WS)。工作集包含用户根据定义的条件选择的网络元素。可以提供单个 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"

状态

  • 此模块将在 6.0.0 版中移除。[已弃用]

  • 有关更多信息，请参阅 已弃用。

作者

  • Harri Tuominen (@hatuomin)