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

注意

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

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

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

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

注意

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

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

• netact_cm_command 可用于运行各种配置管理操作。此模块要求目标主机已安装诺基亚 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)

资源链接

• 问题跟踪
• 代码仓库