内容 隐藏
1 MOXA CLI 配置工具
2 介绍
3 系统要求
4 支持的型号
5 在 Linux 上安装 MCC_Tool
6 入门
7 用法示例amp支持的功能文件
8 参数说明
9 导出/导入设备的配置
10 文件/资源
10.1 参考

MOXA-标志

MOXA CLI 配置工具

MOXA-CLI-配置-工具-产品

Moxa CLI 配置工具 (MCC_Tool) 是一个命令行工具，提供以下功能来管理现场设备。管理任务可以根据所需的规模（单台设备1个或多台设备1个）跨不同子网执行。

系统要求

MCC_Tool 支持的平台是 Windows 和 Linux。支持以下型号和固件版本：

产品系列/型号 支持固件
NPort 5100A 系列 所有版本
N端口 5110 所有版本
N端口 5130 所有版本
N端口 5150 所有版本
NPort P5150A系列 固件v2.0及以上版本
NPort 5200A 系列 固件v3.0及以上版本
NPort 5200 系列 固件v2.0及以上版本
NPort 5400 系列 固件v2.1及以上版本
NPort 5600 系列 固件v4.2及以上版本
NPort 5600-DT系列 固件v2.2及以上版本
NPort 5600-DTL 系列（停产） 固件v1.2及以上版本
NPort S9450I系列 固件v1.2及以上版本
NPort S9650I系列 固件v2.1及以上版本
NPort IA5100A 型号 固件v2.2及以上版本
NPort IA5200A 型号 固件v2.3及以上版本
NPort IA5400A 型号 固件v2.3及以上版本
NPort IA5000系列 所有版本
NPort 5000AI-M12 系列 所有版本
NPort 6100/6200 系列 固件v2.4及以上版本
NPort 6400/6600 系列 所有版本
MGate 5134 系列 所有版本
MGate 5135/5435 系列 所有版本
MGate 5217 系列 所有版本
MGate MB3180/MB3280/MB3480 系列 固件v2.0及以上版本
MGate MB3170/MB3270 系列 固件v2.1及以上版本
MGate MB3660 系列 固件v2.1及以上版本
MGate 5101-PBM-MN 系列 所有版本
MGate 5103 系列 所有版本
MGate 5105-MB-EIP 系列 固件v2.1及以上版本
MGate 5109 系列 固件v2.2及以上版本
MGate 5111 系列 固件v2.3及以上版本
MGate 5114 系列 所有版本
MGate 5118 系列 所有版本
MGate 5102-PBM-PN 系列 所有版本
MGate W5108/W5208 系列（停产） 固件v2.1及以上版本
ioLogik E1200 系列 固件v2.4及以上版本
ioThinx 4500 系列 所有版本

在 Windows 上安装 MCC_Tool

要在 Windows 上安装 MCC_Tool：

  1. 从以下位置下载适用于 Windows 的 MCC_Tool URL: https://www.moxa.com/support/download.aspx?type=support&id=15923.
  2. 解压下载的文件夹并执行.exe file。 将弹出设置向导，引导您执行后续步骤。
  3. 选择MCC_Tool 应安装的目标位置。
  4. 选择“开始”菜单文件夹以创建程序的快捷方式。
  5. 选择其他任务（如果有）并单击下一步。
  6. 确认之前的选择并准备安装。
  7. 如果您想在退出设置向导后使用 MCC_Tool，请完成设置并选中启动 mcc_tool。

在 Linux 上安装 MCC_Tool

要在 Linux 上安装 MCC_Tool：

  1. 从以下地址下载适用于 Linux 的 MCC_Tool URLs: https://www.moxa.com/support/download.aspx?type=support&id=15925  （Linux x86）和 https://www.moxa.com/support/download.aspx?type=support&id=15924 （Linux x64）。 提供适用于 x86 和 x64 操作系统的版本。

有关如何使用 MCC_Tool 的详细说明，请参阅用户手册。

2.1 版，2023 年 XNUMX 月
www.moxa.com/products

Moxa CLI 配置工具用户手册
本手册中描述的软件是根据许可协议提供的，并且只能根据该协议的条款使用。

版权声明
© 2023 Moxa Inc. 保留所有权利。

商标
MOXA 标志是 Moxa Inc. 的注册商标。
本手册中的所有其他商标或注册标志均属于其各自的制造商

免责声明

  • 本文档中的信息如有更改，恕不另行通知，并不代表 Moxa 的承诺。
  • Moxa 按原样提供本文档，不作任何明示或暗示的保证，包括但不限于其特定用途。 Moxa 保留随时对本手册或本手册中描述的产品和/或程序进行改进和/或更改的权利。
  • 本手册中提供的信息旨在准确可靠。 但是，Moxa 对其使用或因使用可能导致的任何对第三方权利的侵犯不承担任何责任。
  • 本产品可能包含无意的技术或印刷错误。 定期对此处的信息进行更改以更正此类错误，并且这些更改已合并到该出版物的新版本中。

技术支持联系信息
www.moxa.com/support

介绍

Moxa CLI 配置工具 (MCC_Tool) 是一个命令行工具，提供以下功能来管理现场设备。

  • 报告固件版本
  • 升级固件
  • 导入/导出配置 files
  • 密码更改

管理任务可以根据所需的规模（单台设备1个或多台设备1个）跨不同子网执行。

系统要求

支持的平台

  • Windows 7 及更高版本。
  • Linux内核2.6及更高版本。

支持的型号

产品系列/型号 支持固件
端口 5100A 系列 固件v1.4及以上版本
端口 5110 固件v2.0.62及以上版本
端口 5130 固件v3.9及以上版本
端口 5150 固件v3.9及以上版本
端口 P5150A系列 固件v1.4及以上版本
端口 5200A 系列 固件v1.4及以上版本
端口 5200 系列 固件v2.12及以上版本
端口 5400 系列 固件v3.13及以上版本
端口 5600 系列 固件v3.9及以上版本
端口 5600-DT系列 固件v2.6及以上版本
端口 5600-DTL 系列（停产） 固件v1.5及以上版本
端口 S9450I系列 固件v1.1及以上版本
端口 S9650I系列 固件v1.1及以上版本
端口 IA5100A 型号 固件v1.3及以上版本
端口 IA5200A 型号 固件v1.3及以上版本
端口 IA5400A 型号 固件v1.4及以上版本
端口 IA5000系列 固件v1.7及以上版本
端口 5000AI-M12系列 固件v1.3及以上版本
端口 6100/6200系列 固件v1.13及以上版本
端口 6400/6600系列 固件v1.13及以上版本
产品系列/型号 支持固件
MGate 5134 系列 所有版本
MGate 5135/5435系列 所有版本
MGate 5217 系列 所有版本
MGate MB3180/MB3280/MB3480系列 固件v2.0及以上版本
MGate MB3170/MB3270系列 固件v3.0及以上版本
MGate MB3660系列 固件v2.0及以上版本
MGate 5101-PBM-MN系列 固件v2.1及以上版本
MGate 5103 系列 固件v2.1及以上版本
MGate 5105-MB-EIP系列 固件v4.2及以上版本
MGate 5109 系列 固件v2.2及以上版本
MGate 5111 系列 固件v1.2及以上版本
MGate 5114 系列 固件v1.2及以上版本
MGate 5118 系列 固件v2.1及以上版本
MGate 5102-PBM-PN系列 固件v2.2及以上版本
MGate W5108/W5208 系列（停产） 固件v2.3及以上版本
产品系列/型号 支持固件
ioLogik E1200 系列 固件v2.4及以上版本
ioThinx 4500 系列 所有版本

在 Windows 上安装 MCC_Tool

  • 第 1 步：下载适用于 Windows 的 MCC_Tool URL: https://www.moxa.com/support/download.aspx?type=support&id=15923。解压文件夹并执行.exe file。 将弹出设置向导，引导您执行后续步骤。
  • 步骤 2：选择 MCC_Tool 的安装目标位置。MOXA-CLI-配置-工具-图- (1)
  • 步骤 3：选择开始菜单文件夹以创建程序的快捷方式。MOXA-CLI-配置-工具-图- (2)
  • 步骤 4：选择其他任务（如果有）并单击下一步。MOXA-CLI-配置-工具-图- (3)
  • 第五步：确认之前的选择并准备安装。MOXA-CLI-配置-工具-图- (4)
  • 步骤 6：完成设置，如果您想在退出设置向导后使用 MCC_Tool，请选中 Launch mcc_toolMOXA-CLI-配置-工具-图- (5)
  • 第七步：使用-h命令提示帮助信息MOXA-CLI-配置-工具-图- (6)

在 Linux 上安装 MCC_Tool

入门

本章介绍 MCC_Tool 支持哪些功能以及用户如何使用主要功能和可选功能的组合来管理 Moxa 的边缘设备

超过view
支持的功能和命令结构
用户将能够通过执行一组命令行来完成以下任务。

  1. 通过设备的 IP 地址或 IP 地址指定的一系列设备报告固件版本。
  2. 通过设备的IP地址或IP地址指定的一系列设备将固件升级到设备。
  3. 通过 IP 地址和/或 IP 地址指定的一系列设备导出/导入设备的配置。
  4. 重新启动命令：
    1. 重启多个设备的特定端口列表。
    2. 通过设备的IP地址或IP地址指定的一系列设备重新启动设备。
  5. 通过设备的 IP 地址或 IP 地址指定的一系列设备来更改设备现有用户的密码。

笔记
由于型号和固件差异，以下功能可能无法使用：

  1. 重启设备的多个端口
  2. 更改现有用户的密码（用户“admin”除外）
  3. 导出配置 file 具有预共享关键参数 您可以参考第11页的功能支持表以了解更多详细信息

主要功能定义如下

命令 功能
-fw 执行“固件相关”操作。
-cfg 执行“配置相关”操作。
-pw 执行“密码相关”操作。
-关于 执行“重启相关”操作。

主要功能必须与可选命令结合使用才能执行管理任务。下表列出了可选命令

命令 功能
-r 报告固件版本。
-向上 升级固件。
-前任 导出配置 file.
-我是 导入配置 file.
-ch 更改密码。
-的 重启设备。
-sp 重新启动端口。
-i 设备IP地址。
-il IP 地址列表每行包含 1 个 IP 地址。
命令 功能
-d 设备清单。
-f File 进行导入或升级。
-nd 包含新密码设置的设备列表。
-u 用于登录的设备的用户帐户。
-p 设备的登录密码。
-npw 特定用户的新密码。
-dk 导入/导出配置的密钥。
-ps 特定串口需要重启。
-o 输出 file 姓名。
-l 导出结果日志 file.
-n 保留配置导入的网络设置。
-编号 执行完命令后不要重新启动设备。
-打印 打印升级固件命令的处理消息
-t 超时（秒）。

设备列表
如上一节所述，MCC_Tool 支持对一个设备或一系列设备的管理任务。 通过 MCC_Tool 管理多个设备需要设备列表。 MCC_Tool 包括一个 example file 设备列表，在 Linux 下名为 DeviceList，在 Windows 下名为 DeviceList.txt。 设备列表的格式为：MOXA-CLI-配置-工具-图- (9)

笔记

  1. 要导入配置，请识别 CfgFile 和关键列。
  2. 要导出配置，请在密钥栏输入预共享密钥（此功能仅适用于 NPort 产品）。
  3. 如需升级固件，请在Fw下输入固件名称File 柱子。
  4. 如需重启特定端口，请在端口栏输入特定端口（此功能仅适用于NPort设备服务器产品）

支持产品系列
由于维护方便，MCC Tool从1200版本开始，通过独立的产品线插件分离了设备支持列表，其中包括E4500_model、I1.1_model、MGate model、NPort_model。 未来您可能会更新插件以支持新的产品型号。

功能支持表
由于固件差异，部分机型无法使用部分功能；用户可参考下表了解功能支持范围

N端口 6000

系列

 N端口IA5000A/5000A

系列

 MGate 3000

系列

 ioLogic E1200

系列

 ioThinx 4500

系列
报告固件 P P P P P
版本
升级固件 P ·         不支持帐户管理（-u）
导出设备的

配置

 P ·         不支持帐户管理（-u）

·         不支持 file 解密（-dk）
 

导入设备配置

  

 

P

 ·         不支持帐户管理（-u）

·         不支持 file 解密（-dk）

 ·         不支持帐户管理（-u）

·         不支持 file 解密（-dk）

·         不允许设备拒绝重新启动 (-nr)
N端口 6000

系列

 N端口IA5000A/5000A

系列

 MGate 3000 ioLogik E1200

系列                 系列

 ioThinx 4500

系列
重新启动特定串行端口  

P

 ·         不支持帐户管理（-u）  

·         不支持该命令
重新启动 P ·         不支持帐户管理（-u）  
设备
 

设置密码

  

P

 ·         不支持帐户管理（-u） ·         不支持帐户管理（-u）

·         不允许设备拒绝重新启动 (-nr)

  

用法示例amp支持的功能文件

报告固件版本

报告单个设备或通过 IP 地址列表指定的一系列设备的固件版本。
输出定向到屏幕，除非输出 file 已指定。

  • MCC_Tool –fw –r –i [IP 地址] –o [输出_file]
  • MCC_Tool –fw –r –il [IP 地址列表] –o [输出_file]
  • MCC_Tool –fw –r –il [IP 地址列表] –o [输出_file] –t [超时值]

ExampIP地址列表文件 file Moxa 设备数量：

  • 192.168.1.1；
  • 192.168.1.2；
  • 192.168.1.3；

参数说明

命令 功能
-fw 执行固件相关的操作
-r 报告固件版本
-i 设备的IP地址（192.168.1.1）
-il 每行包含 1 个 IP 地址的 IP 地址列表
-o 输出 file name（可以生成设备列表 file)
-l 导出结果日志 file
-t 超时（1~120秒）

默认值：10 秒

Example：获取IP.list处设备的固件版本并输出到DeviceList file MCC_Tool –fw –r –il IP.list –o 设备列表

结果日志应包括以下项目：MOXA-CLI-配置-工具-图- (10)

笔记
您可以使用此命令生成设备列表以供其他功能使用。 PWD 和 Key 列下的输出值为虚拟值，用户在使用设备列表执行其他功能命令时需要输入设备的密码和密钥信息。 其他突出显示的列在执行特定命令时需要赋值，例如导入配置 file 或固件升级。

升级固件并重启设备
密码必须由命令参数或设备列表指定 file 在升级固件并重新启动特定设备（或同时多个设备）之前。 升级固件后，用户应使用search命令检查设备是否重启成功。

  • MCC_Tool –fw –up –i [IP 地址] –u [用户] –p [密码] –f [固件_file] –l [结果日志]
  • MCC_Tool –fw –up –d [设备列表] –l [结果日志]
  • MCC_Tool –fw –up –d [设备列表] –l [结果日志] –t [超时值]

参数说明：

命令 功能 评论
-fw 执行固件相关的操作  
-向上 升级固件版本  
-i 设备的IP地址（192.168.1.1）  
 

-u

 用于登录的设备的用户帐户。

*此选项可能仅适用于

具有用户帐户管理功能的型号。

 仅 NPort 6000 系列支持此功能

命令功能。
-p 设备的登录密码  
-d 设备列表  
-f 固件 file 待升级  
-l 导出结果日志 file  
-t 超时（1~1200秒）

默认值：800 秒

  
-打印 打印升级过程状态消息  

Example：使用设备列表升级固件并在导入日志中捕获结果 MCC_Tool –fw –u –d DeviceList –l result_log

result_log 应包含以下项目：MOXA-CLI-配置-工具-图- (11)

导出/导入设备的配置

通过设备列表导出/导入特定设备或一系列设备的设备配置 file。 密码必须由参数或设备列表指定 file。 设备配置存储在单独的 files，使用设备类型、IP 地址和 file 创建日期作为 file姓名。 结果日志直接打印在屏幕上，或者用户可以指定一个result_log file 为了它。

  • MCC_Tool –cfg –ex –i [IP 地址] –u [用户] –p [密码] –dk [密钥] –l [结果日志]
  • MCC_Tool –cfg –ex –d [设备列表] –l [结果日志]
  • MCC_Tool –cfg –ex –d [设备列表] –l [结果日志] –t [超时值]
  • MCC_Tool –cfg –im –i [IP 地址] –u [用户] –p [密码] –dk [密钥] –f [cfg_file] –l [结果日志] –n –nr
  • MCC_Tool –cfg –im –d [设备列表] –l [结果日志] –n –nr
  • MCC_Tool –cfg –im –d [设备列表] –l [结果日志] –t [超时值]

参数说明：

命令 功能 评论
-cfg 执行配置相关的操作  
-前任 导出配置 file  
-我是 导入配置 file  
-i 设备 IP地址（192.168.1.1）  
-d 设备 列表  
命令 功能 评论
 

-u

 用于登录的设备用户帐户

*此选项可能仅适用于具有用户帐户管理的型号。

 仅 NPort 6000

系列支持该命令功能。
-p 设备的登录密码  
  导出配置时：  
  该命令解密导出的 file 和  
  预共享密钥。  
  ·         如果不使用该参数，则导出的 file 将通过设备固件上设置的预共享密钥进行加密。

·         如果使用该参数，则导出的 file 将被解密为clear-txt file 进行编辑。

导入配置时：

  
  如果配置 file 这需要  
 

-dk

 导入是加密的，该命令需要使用预共享密钥。

·         如果导入配置 file 如果没有-n，mcc工具将忽略-dk（不会返回-11）。

·         如果导入配置 file 与-n一起，mcc工具将使用预共享密钥来解密加密的 file。因此，如果解密密钥错误 file，mcc工具将返回-10。然而，如果 file 是纯文本的，并且用户输入

预共享密钥，它将忽略该密钥（不会返回-10）。*

（通过参数-dk或设备列表中的关键列 file)

 仅NPort 6000系列支持该命令功能。
  *此选项可能仅适用于型号  
  支持加密配置 files.  
-f 配置 file 被进口 仅限进口

配置功能
-n 保留原始网络参数（包括

IP、子网掩码、网关和 DNS）

 仅限进口

配置功能
 

 

-编号

  

导入配置后请勿重启设备 file

 仅用于导入配置功能。 MGate、ioLogik 和 ioThinx 设备不支持

支持这个命令。
-l 导出结果日志 file  
 

-t

 超时（1~120秒）

导出功能默认值：30秒

导入功能 默认值：60 秒

  

Example：使用设备列表导出配置并将结果导出到结果日志
MCC_Tool –cfg –ex –d DeviceList –l result_log

result_log应包含以下内容MOXA-CLI-配置-工具-图- (12)

Example：将配置导入到设备列表（重新启动设备）并将结果导出到结果日志
MCC_Tool –cfg –im –d DeviceList –l result_log

result_log 应包含以下项目MOXA-CLI-配置-工具-图- (13)

Example：将配置导入到设备列表中，无需重新启动设备，并将结果导出到结果日志中
MCC_Tool –cfg –im –d DeviceList –nr –l result_log

重启特定串口或整个设备

为单个设备或设备列表指定的一系列设备重新启动特定端口或设备本身 file。 密码必须由参数或设备列表指定 file。 设备配置存储在单独的 files，使用设备类型、IP 地址和 file 创建日期作为 file姓名。 结果日志直接打印在屏幕上，或者用户可以指定一个result_log file 为了它。

  • MCC_Tool –re –sp –ps [1-4,7] –I [ip 地址] –u [用户] –p [密码]–l [结果日志]
  • MCC_Tool –re –sp –d [设备列表] –l [结果日志]
  • MCC_Tool –re –sp –d [设备列表] –l [结果日志] –t [超时值]
  • MCC_Tool –re –de –I [IP 地址] –u [用户] –p [密码] –l [结果日志]
  • MCC_Tool –re –de –d [设备列表] –l [结果日志]
  • MCC_Tool –re –de –d [设备列表] –l [结果日志] –t [超时值]

参数说明：

命令 功能 评论
-关于 执行与重启相关的操作。  
 

-sp

 重启设备的特定串口。此选项可能仅适用于

支持重启端口的机型

 MGate 和 ioLogik 设备不支持重启

具体端口功能。
-的 重启设备  
 

-ps

 用于重新启动特定端口

指定应重新启动哪些串行端口

 MGate 和 ioLogik 设备

不支持重启特定端口功能。
-i 设备IP地址（192.168.1.1）  
 

-u

 用于登录的设备用户帐户

*此选项可能仅适用于具有用户帐户管理的型号

 仅 NPort 6000 系列

支持该命令功能。
-p 设备的登录密码  
-d 设备列表  
-l 导出结果日志 file  
 

 

-t

 超时（1~120秒）

重启设备，默认15秒

重启端口，默认值为10

秒

  

Example：使用设备列表重新启动端口并将结果导出到结果日志 MCC_Tool –re –sp –d DeviceList –l result_log

result_log 应包含以下项目：MOXA-CLI-配置-工具-图- (14)

设备2（NPort 5）的串口8-10、1和6650已重新启动。

Example：使用设备列表重新启动设备并将结果导出到结果日志 MCC_Tool –re –de –d DeviceList –l result_log

result_log应包含以下内容MOXA-CLI-配置-工具-图- (15)

更改设备上的用户密码
设置IP地址指定的目标设备的密码。 当前密码必须由参数或设备列表指定 file.

  • MCC_Tool –pw –ch –i [IP 地址] –u [用户] –p [旧密码] –npw [新密码]
  • MCC_Tool –pw –ch –d [设备列表] –nd [设备列表新密码] –l [结果日志]
  • MCC_Tool –pw –ch –d [设备列表] –nd [设备列表新密码] –l [结果日志] –t [超时值]

参数说明：

命令 功能 评论
-pw 执行密码相关操作  
-ch 更改密码  
-npw 特定用户的新密码  
-i 设备的IP地址（192.168.1.1）  
 

-u

 用于登录的设备用户帐户

*此选项可能仅适用于

具有用户帐户管理功能的型号

 仅 NPort 6000 系列支持此功能

命令功能。
-p 设备的登录密码（旧

密码）

  
-d 设备列表  
 

-nd

  

具有新密码设置的设备列表

 用户需要在设备列表中指定一个新密码

使用-nd命令。
-l 导出结果日志 file  
 

-编号

 更改密码后请勿重新启动设备。 MGate 和 ioLogik 设备不支持此功能

命令。
-t 超时（1~120秒）

默认值：60 秒

  

Example：设置新密码为“5678”，然后重启设备使其生效，并在屏幕上打印结果
MCC_Tool –pw 5678 –i 192.168.1.1 –u admin –p moxa
Example：从设备列表中设置新密码，然后重启设备使其生效，并将结果导出到结果日志中
MCC_Tool –pw DeviceList_New –d DeviceList –l result_log

result_log 应包含以下项目：MOXA-CLI-配置-工具-图- (16)

显示支持型号列表
显示 MCC Tool 支持的型号。 MCC_工具-ml

更新插件
用户可以更新MCC工具的插件以支持新模型，这些模型可能不包含在当前版本中。 命令如下。 MCC_Tool 1.1 及更高版本支持此功能。
MCC_Tool -安装“插件路径”

错误码说明
MCC_Tool 的所有命令选项都有相同的错误代码，请参阅下表了解所有详细信息：

返回值 描述
0 成功的
-1 找不到设备
-2 密码或用户名不匹配
-3 超过密码长度
 

-4

 无法打开 file

如果目标 file 路径存在，请确保您有目标路径的权限
-5 操作超时
-6 导入失败
-7 固件升级失败
-8 超过新密码的长度
-9 设置重启端口索引失败
-10 用于解密配置的密钥 file 不匹配
 

 

-11

 无效参数例如，

1.    输入参数上面没有描述

2.    该参数不适用于某些设备（例如，-u 表示 MGate MB3000 系列，不支持用户帐户功能；-dk 表示 NPort 5000A 系列，不支持预共享密钥功能）

3.    使用设备列表 file 不应输入 -i、-u、-p 或 -npw
 

-12

 不支持的命令

例如，对 MGate MB3000 系列执行重新启动特定端口命令 (MCC_Tool -re -sp) 将收到错误代码 -12
 

-13

 设备列表中缺少信息

如果特定的 NPort 仅存在于 device_list_new_password 中，而不存在于 device_list（具有旧密码的原始设备列表）中，则会发生错误。
 

-14

 新密码列表中缺少信息

如果 device_list_new_password 中没有新密码，但该设备存在于原始设备列表中，则会出现错误。
-15 由于列表中其他设备的错误而无法执行
 

-16

 MCC_Tool 不支持设备的固件版本。请

将设备升级到支持的固件版本（参考“支持型号”部分）
其他价值 联系莫莎

文件/资源

MOXA CLI 配置工具 [pdf] 用户手册
CLI 配置工具、配置工具、CLI 配置、配置

参考

发表评论

您的电子邮件地址不会被公开。 必填字段已标记 *