MOXA NPort 5150 CLI 配置工具
产品信息
规格
- 支持的平台： Windows、Linux
- 支持的机型： 各种型号，包括 NPort、MGate、ioLogik 和 ioThinx 系列
- 支持的固件： 固件版本因型号而异
产品使用说明
在 Windows 上安装 MCC_Tool
- 从此链接下载适用于 Windows 的 MCC_Tool。
- 解压文件夹并执行.exe file。安装向导将指导您完成安装过程。
- 选择MCC_Tool安装的目标位置。
- 选择开始菜单文件夹来创建快捷方式。
- 如果需要，选择任何“附加任务”，然后单击“下一步”。
- 确认您的选择并继续安装。
- 完成设置并选中启动 MCC_Tool 的选项（如果需要）。
常问问题
问：什么是MCC_Tool？
A: MCC_Tool 是 Moxa 提供的命令行工具，用于管理支持各种型号和固件版本的现场设备。
问：在哪里可以找到MCC_Tool的技术支持？
A: 您可以在此处找到技术支持信息 www.moxa.com/support.
- 本手册中描述的软件是根据许可协议提供的，并且只能根据该协议的条款使用。
版权声明
- © 2024 Moxa Inc. 保留所有权利。
商标
- MOXA 标志是 Moxa Inc. 的注册商标。
- 本手册中的所有其他商标或注册商标均属于其各自的制造商。
免责声明
- 本文档中的信息如有更改，恕不另行通知，并不代表 Moxa 的承诺。
- Moxa 按原样提供本文档，不提供任何明示或暗示的保证，包括但不限于其特定用途。
- Moxa 保留随时对本手册或本手册中描述的产品和/或程序进行改进和/或更改的权利。
- 本手册中提供的信息旨在保证其准确性和可靠性。但是，Moxa 对其使用或因使用本手册而导致的侵犯第三方权利的行为不承担任何责任。
- 本产品可能包含无意的技术或印刷错误。 定期对此处的信息进行更改以更正此类错误，并且这些更改已合并到该出版物的新版本中。
技术支持联系信息
介绍
- Moxa CLI 配置工具 (MCC_Tool) 是一个命令行工具，提供以下功能来管理现场设备。
- 报告固件版本
- 升级固件
- 导入/导出配置 files
- 密码更改
- 可以根据所需的规模（1 个设备用于单个设备或 1 个设备用于多个设备）并跨不同的子网网络执行管理任务。
系统要求
支持的平台
- Windows 7 及更高版本。
- Linux内核2.6及更高版本。
支持的型号
| 产品系列/型号 | 支持固件 |
| NPort 5100A 系列 | 固件v1.4及以上版本 |
| N端口 5110 | 固件v2.0.62及以上版本 |
| N端口 5130 | 固件v3.9及以上版本 |
| N端口 5150 | 固件v3.9及以上版本 |
| NPort P5150A系列 | 固件v1.4及以上版本 |
| NPort 5200A 系列 | 固件v1.4及以上版本 |
| NPort 5200 系列 | 固件v2.12及以上版本 |
| NPort 5400 系列 | 固件v3.13及以上版本 |
| NPort 5600 系列 | 固件v3.9及以上版本 |
| NPort 5600-DT系列 | 固件v2.6及以上版本 |
| NPort 5600-DTL 系列（停产） | 固件v1.5及以上版本 |
| NPort S9450I系列 | 固件v1.1及以上版本 |
| NPort S9650I系列 | 固件v1.1及以上版本 |
| NPort IA5100A 型号 | 固件v1.3及以上版本 |
| NPort IA5200A 型号 | 固件v1.3及以上版本 |
| NPort IA5400A 型号 | 固件v1.4及以上版本 |
| NPort IA5000系列 | 固件v1.7及以上版本 |
| NPort 5000AI-M12 系列 | 固件v1.3及以上版本 |
| NPort 6100/6200 系列 | 固件v1.13及以上版本 |
| NPort 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 的安装目标位置。
- 步骤 3： 选择“开始”菜单文件夹以创建程序的快捷方式。
- 步骤 4： 选择其他任务（如果有）并单击下一步。
- 步骤 5： 确认之前的选择并准备安装。
- 步骤 6： 如果您想在退出设置向导后使用 MCC_Tool，请完成设置并选中启动 mcc_tool。
- 步骤 7： 使用-h命令提示帮助信息。
在 Linux 上安装 MCC_Tool
- 步骤 1： 下载适用于 Linux 的 MCC_Tool URL: 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 操作系统的版本。
- 步骤 2： 访问保存下载的位置 file 并解压它。 对于前amp勒。
- 步骤 3： 执行解压文件夹中的MCC_Tool，使用-h命令获取该工具所有可用的功能和选项命令。
入门
本章介绍 MCC_Tool 支持哪些功能以及用户如何使用主要功能和可选功能的组合来管理 Moxa 的边缘设备。
超过view 支持的功能和命令结构
用户将能够通过执行一组命令行来完成以下任务。
- 通过设备的 IP 地址或 IP 地址指定的一系列设备报告固件版本。
- 通过设备的IP地址或IP地址指定的一系列设备将固件升级到设备。
- 通过 IP 地址或 IP 地址指定的设备范围导出/导入设备的配置。
- 重新启动命令：
- a. 重启多个设备的特定端口列表。
- b. 通过设备的IP地址或IP地址指定的一系列设备重新启动设备。
- 通过设备的 IP 地址或 IP 地址指定的设备范围更改设备现有用户的密码。
笔记 由于型号和固件差异，以下功能可能无法使用。
- 重启设备的多个端口
- 更改现有用户的密码（用户“admin”除外）
- 导出配置 file 使用预共享密钥参数
- 您可以参考功能支持表来了解更多详细信息。
- 主要功能定义如下。
| 命令 | 功能 |
| -fw | 执行“固件相关”操作。 |
| -cfg | 执行“配置相关”操作。 |
| -pw | 执行“密码相关”操作。 |
| -关于 | 执行“重启相关”操作。 |
主要功能必须与可选命令配合使用才能执行管理任务。
可选命令如下表所列：
| 命令 | 功能 |
| -r | 报告固件版本。 |
| -向上 | 升级固件。 |
| -前任 | 导出配置 file. |
| -我是 | 导入配置 file. |
| -ch | 更改密码。 |
| -的 | 重启设备。 |
| -sp | 重新启动端口。 |
| -i | 设备IP地址。 |
| -il | IP 地址列表每行包含 1 个 IP 地址。 |
| 命令 | 功能 |
| -d | 设备清单。 |
| -f | File 进行导入或升级。 |
| -nd | 包含新密码设置的设备列表。 |
| -u | 用于登录的设备的用户帐户。 |
| -p | 设备的登录密码。 |
| -新的 | 特定用户的新密码。 |
| -dk | 导入/导出配置的密钥。 |
| -ps | 特定的串行端口需要重新启动。 |
| -o | 输出 file 姓名。 |
| -l | 导出结果日志 file. |
| -n | 保留配置导入的网络设置。 |
| -编号 | 执行完命令后不要重启设备。 |
| -打印 | 打印升级固件命令的处理消息 |
| -t | 超时（秒）。 |
设备列表
- 如上一节所述，MCC_Tool 支持对单个或多个设备的管理任务。通过 MCC_Tool 管理多个设备需要设备列表。
- MCC_Tool 包括一个 example file 一个设备列表，在Linux下名为DeviceList，在Windows下名为DeviceList.txt。
设备列表的格式为：
笔记
- 要导入配置，请识别 CfgFile 和关键列。
- 要导出配置，请在 Key 栏下输入预共享密钥（此功能仅适用于 NPort 产品）。
- 要升级固件，请在Fw下输入固件名称File 柱子。
- 要重新启动特定端口，请在端口栏下输入特定端口（此功能仅适用于NPort设备服务器产品）。
支持产品系列
- 为了便于维护，MCC Tool通过独立的产品线插件分离出设备支持列表，从1200版本开始包含E4500_型号、I1.1_型号、MGate型号、NPort_型号。
- 将来，您可以更新插件以支持新的产品型号。
功能支持表
由于固件差异，部分功能在某些型号上无法使用；用户可参考下表了解功能支持范围。
| N端口 6000 系列 | N端口IA5000A/5000A 系列 | MGate 3000 系列 | ioLogic E1200 系列 | ioThinx 4500 系列 | |
| 报告固件版本 |  |
|
|
|
|
| 升级固件 | |
· 不支持帐户管理（-u） | |||
| 导出设备的配置 | |
· 不支持帐户管理（-u）
· 不支持 file 解密（-dk） |
|||
| 导入设备的配置 | |
· 不支持帐户管理（-u）
· 不支持 file 解密（-dk） |
· 不支持帐户管理（-u） · 不支持 file 解密（-dk） · 不允许设备拒绝重启（-nr） |
||
| N端口 6000 系列 | N端口IA5000A/5000A 系列 | MGate 3000 系列 | ioLogic E1200 系列 | ioThinx 4500 系列 | |
| 重新启动特定串行端口 | |
· 不支持帐户管理（-u） | · 不支持该命令 | ||
| 重启设备 | |
· 不支持帐户管理（-u） | |||
| 设置密码 | |
· 不支持帐户管理（-u） | · 不支持帐户管理（-u）
· 不允许设备拒绝重启（-nr） |
||
用法示例amp支持的功能文件
报告固件版本
报告通过 IP 地址列表指定的单个设备或一系列设备的固件版本。除非输出 file 已指定。
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 秒 |
Examp乐： 获取IP.list中设备的固件版本并输出到DeviceList file
MCC_Tool –fw –r –il IP.list –o 设备列表
生成的日志应该包含下列内容：
笔记 您可以使用此命令生成设备列表以供其他功能使用。PWD 和 Key 列下的输出值为虚拟值，用户在使用设备列表执行其他功能命令时需要输入设备的密码和密钥信息。其他突出显示的列在执行特定命令（例如导入配置）时需要分配值 file或固件升级。
升级固件并重启设备
- 密码必须由命令参数或设备列表指定 file 在升级固件并重新启动特定设备（或同时重新启动多个设备）之前。
- 升级固件后，用户应使用搜索命令检查设备是否重启成功。
参数说明：
| 命令功能 | 评论 | |
| -fw | 执行固件相关的操作 | |
| -向上 | 升级固件版本 | |
| -i | 设备的IP地址（192.168.1.1） | |
| -u | 用于登录的设备的用户帐户。
*此选项可能仅适用于具有用户帐户管理的型号。 |
仅NPort 6000系列支持该命令功能。 |
| -p | 设备登录密码 | |
| -d | 设备列表 | |
| -f | 固件 file 待升级 | |
| -l | 导出结果日志 file | |
| -t | 超时（1~1200秒）
默认值：800 秒 |
|
| -打印 | 打印升级过程状态消息 | |
Examp乐： 使用设备列表升级固件并将结果捕获到导入日志中
MCC_Tool –fw –u –d 设备列表 –l 结果日志
result_log 应包含以下项目：
导出/导入设备的配置
- 通过设备列表导出/导入特定设备或一系列设备的设备配置 file。 密码必须由参数或设备列表指定 file.
- 设备配置存储在单独的 files，使用设备类型、IP 地址和 file 创建日期作为 file姓名。 结果日志直接打印在屏幕上，或者用户可以指定一个result_log file 为了它。
参数说明：
| 命令 | 功能 | 评论 |
| -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 秒 |
Examp乐： 使用设备列表导出配置并将结果导出到结果日志
MCC_Tool –cfg –ex –d DeviceList –l result_log
result_log 应该包含以下项目：
Examp乐： 将配置导入到设备列表（重新启动设备）并将结果导出到结果日志 MCC_Tool –cfg –im –d DeviceList –l result_log
result_log 应包含以下项目：
Examp乐： 将配置导入到设备列表而无需重新启动设备，并将结果导出到结果日志 MCC_Tool –cfg –im –d DeviceList –nr –l result_log
重启特定串口或整个设备
为单个设备或设备列表指定的一系列设备重新启动特定端口或设备本身 file。 密码必须由参数或设备列表指定 file。 设备配置存储在单独的 files，使用设备类型、IP 地址和 file 创建日期作为 file姓名。 结果日志直接打印在屏幕上，或者用户可以指定一个result_log file 为了它。
参数说明：
| 命令 | 功能 | 评论 |
| -关于 | 执行与重启相关的操作。 | |
| -sp | 重启设备的特定串口。此选项可能仅适用于支持重启端口的型号 | MGate 和 ioLogik 设备不支持重启特定的端口功能。 |
| -的 | 重启设备 | |
| -ps | 用于重新启动指定应重新启动哪些串行端口的特定端口 | MGate 和 ioLogik 设备不支持重启特定的端口功能。 |
| -i | 设备IP地址（192.168.1.1） | |
| -u | 设备登录用户账户
*此选项可能仅适用于具有用户帐户管理的型号 |
仅NPort 6000系列支持该命令功能。 |
| -p | 设备登录密码 | |
| -d | 设备列表 | |
| -l | 导出结果日志 file | |
| -t | 超时（1~120秒）
重启设备，默认值为15秒 重启端口，默认值为10 秒 |
Examp乐： 使用设备列表重新启动端口并将结果导出到结果日志
MCC_Tool –re –sp –d 设备列表 –l 结果日志
result_log 应包含以下项目：
设备2（NPort 5）的串口8-10、1和6650已重新启动。
Examp乐： 使用设备列表重新启动设备并将结果导出到结果日志
MCC_Tool –re –de –d 设备列表 –l result_log
result_log 应该包含以下项目：
更改设备上的用户密码
设置IP地址指定的目标设备的密码。 当前密码必须由参数或设备列表指定 file.
参数说明：
| 命令 | 功能 | 评论 |
| -pw | 执行与密码相关的操作 | |
| -ch | 更改密码 | |
| -npw | 特定用户的新密码 | |
| -i | 设备的IP地址（192.168.1.1） | |
| -u | 设备登录用户账户
*此选项可能仅适用于具有用户帐户管理的型号 |
仅 NPort 6000
系列支持该命令功能。 |
| -p | 设备登录密码（旧密码） | |
| -d | 设备列表 | |
| -nd | 具有新密码设置的设备列表 | 使用-nd 命令时，用户需要在设备列表中指定一个新密码。 |
| -l | 导出结果日志 file | |
| -编号 | 更改密码后请勿重新启动设备。 | MGate 和 ioLogik 设备不支持此命令。 |
| -t | 超时（1~120秒）
默认值：60 秒 |
- Examp乐： 设置新密码为“5678”然后重启设备使之生效，并在屏幕上打印结果 MCC_Tool –pw 5678 –i 192.168.1.1 –u admin –p moxa
- Examp乐： 从设备列表中设置新密码然后重启设备使其生效，并将结果导出到结果日志MCC_Tool –pw DeviceList_New –d DeviceList –l result_log
result_log 应包含以下项目：
显示支持型号列表
- 显示MCC工具支持的型号。
- MCC_工具-ml
更新插件
- 用户可以更新 MCC Tool 的插件来支持新的型号，这些型号可能不包含在当前版本中。命令如下。此功能在 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 不支持设备的固件版本。请
将设备升级到支持的固件版本（参考“支持型号”部分） |
| -17 | 设备仍为默认状态。请创建密码，然后执行导入。 |
| 其他价值 | 联系莫莎 |
文件/资源
 |
MOXA NPort 5150 CLI 配置工具 [pdf] 用户手册 NPort 5150、NPort 5100 系列、NPort 5200 系列、NPort 5150 CLI 配置工具、NPort 5150 CLI、配置工具 |