MOXA NPort 5150 CLI Configuration Tool User Manual

MOXA NPort 5150 CLI Configuration Tool

Product Information

Specifications

• Supported Platforms: Windows, Linux
• Supported Models: Various models including NPort, MGate, ioLogik, and ioThinx series
• Supported Firmware: Firmware versions vary depending on the model

Product Usage Instructions

Installing MCC_Tool on Windows

1. Download MCC_Tool for Windows from this link.
2. Unzip the folder and execute the .exe file. The setup wizard will guide you through the installation process.
3. Select the destination location for MCC_Tool installation.
4. Select the Start Menu Folder to create shortcuts.
5. Choose any Additional Tasks if needed and click Next.
6. Confirm your selections and proceed with the installation.
7. Complete the setup and check the option to launch MCC_Tool if desired.

FAQ

Q: What is MCC_Tool?

A: MCC_Tool is a command line tool provided by Moxa for managing field devices with various supported models and firmware versions.

Q: Where can I find technical support for MCC_Tool?

A: You can find technical support information at www.moxa.com/support.

• The software described in this manual is furnished under a license agreement and may be used only under the terms of that agreement.

Copyright Notice

• © 2024 Moxa Inc. All rights reserved.

Trademarks

• The MOXA logo is a registered trademark of Moxa Inc.
• All other trademarks or registered marks in this manual belong to their respective manufacturers.

Disclaimer

• Information in this document is subject to change without notice and does not represent a commitment on the part of Moxa.
• Moxa provides this document as is, without warranty of any kind, either expressed or implied, including, but not limited to, its particular purpose.
• Moxa reserves the right to make improvements and/or changes to this manual, or to the products and/or the programs described in this manual, at any time.
• The information provided in this manual is intended to be accurate and reliable. However, Moxa assumes no responsibility for its use, or any infringements on the rights of third parties that may result from its use.
• This product might include unintentional technical or typographical errors. Changes are periodically made to the information herein to correct such errors, and these changes are incorporated into new editions of the publication.

Technical Support Contact Information

www.moxa.com/support

Introduction

• Moxa CLI Configuration Tool (MCC_Tool) is a command line tool that provides the following functions to manage field devices.
• Report firmware versions
• Upgrade firmware
• Import/export configuration files
• Password changes
• Management tasks can be performed according to a desired scale (1 for a single device or 1 for multiple devices) and across different subnet networks.

System Requirements

Supported Platforms

• Windows 7 and later versions.
• Linux kernel 2.6 and later versions.

Supported Models

Installing MCC_Tool on Windows

• Step 1: Download MCC_Tool for Windows on URL: https://www.moxa.com/support/download.aspx?type=support&id=15923. Unzip the folder and execute the .exe file. The setup wizard will pop up to direct you to the next steps.
• Step 2: Select the destination location where MCC_Tool should be installed.
• Step 3: Select the Start Menu Folder to create the program’s shortcuts.
• Step 4: Select Additional Tasks if any and click Next.
• Step 5: Confirm the previous selection and prepare to install.
• Step 6: Complete setup and check Launch mcc_tool if you want to use MCC_Tool after exiting the setup wizard.
• Step 7: Use the –h command to prompt help information.

Installing MCC_Tool on Linux

1. Step 1: Download MCC_Tool for Linux on URL: https://www.moxa.com/support/download.aspx?type=support &id=15925 (Linux x86) and https://www.moxa.com/support/download.aspx?type=support &id=15924 (Linux x64).
   • Versions for x86 and x64 OS are available.
2. Step 2: Access the location where you save the downloaded file and unzip it. For example.
3. Step 3: Execute MCC_Tool in the unzipped folder and use the –h command to get all the available functions and option commands of the tool.

Getting Started

This chapter covers what functions are supported by MCC_Tool and how users could use a combination of main and optional functions to manage Moxa’s edge devices.

Overview Supported Functions and Command Structure

Users will be able to achieve the following tasks by executing a set of command lines.

1. Report firmware version through a device’s IP address or a range of devices specified by IP addresses.
2. Upgrade firmware to a device through a device’s IP address or a range of devices specified by IP addresses.
3. Export/Import the device’s configuration through an IP address and or a range of devices specified by IP addresses.
4. Restart command for:
   • a. Restart a list of specific ports of multiple devices.
   • b. Restart a device through a device’s IP address or a range of devices specified by IP addresses.
5. Change the password for an existing user of a device through the device’s IP address or a range of devices specified by IP addresses.

NOTE Due to model and firmware differences, the following functions may NOT work.

1. Restart multiple ports of a device
2. Change the password for an existing user (expect the user ”admin”)
3. Export configuration file with pre-shared key parameters

• You may refer to the Function Support Table to learn more details.
• The main functions are defined below.

Main functions must be used in conjunction with optional commands to perform management tasks.

Optional commands are listed in the table below:

Device List

• As mentioned in a previous section, MCC_Tool supports management tasks to a device or a range of devices. Managing multiple devices via MCC_Tool requires device list(s).
• MCC_Tool includes an example file of a device list, named DeviceList under Linux and DeviceList.txt under Windows.

The format of the device list is:

NOTE

1. To import the configuration, please identify the CfgFile and Key columns.
2. To export configuration, please input the pre-shared key under the Key column (This function only works on NPort products).
3. To upgrade firmware, please input the firmware name under the FwFile column.
4. To restart a specific port, please input the specific port under the Port column (This function only works on the NPort device server products).

Support Product Series

• Because of easy maintenance, MCC Tool separates the device support list by independent product line plugin, which includes the E1200_model, I4500_model, MGate model, and NPort_model since version 1.1.
• In the future, you may update the plugin to support new product models.

Function Support Table

Due to firmware differences, some functions are not available for certain models; users may refer to the table below for function support coverage.

 | NPort 6000 Series| NPort IA5000A/5000A Series| MGate 3000 Series| ioLogik E1200 Series| ioThinx 4500 Series
---|---|---|---|---|---
Report firmware versions| | | | |
Upgrade firmware| | ·         Does not support account management (-u)
Export the device’s configuration| | ·         Does not support account management (-u)

·         Does not support file decryption (-dk)

Import the device’s configuration| | ·         Does not support account management (-u)

·         Does not support file decryption (-dk)

|

·         Does not support account management (-u)

·         Does not support file decryption (-dk)

·         Does not allow the device to reject to restart (-nr)

 | NPort 6000 Series| NPort IA5000A/5000A Series| MGate 3000 Series| ioLogik E1200 Series| ioThinx 4500 Series
---|---|---|---|---|---
Restart specific serial port(s)| | ·         Does not support account management (-u)| ·         Does not support this command
Restart the devices| | ·         Does not support account management (-u)|
Set password| | ·         Does not support account management (-u)| · Does not support account management (-u)

·         Does not allow a device to reject to restart (-nr)

|

Usage Examples of Supported Functions

Report Firmware Versions

Report the firmware version of an individual device or a range of devices specified through an IP address list. Output is directed to the screen unless an output file is specified.

Example of the IP address list file of Moxa devices:

• 192.168.1.1;
• 192.168.1.2;
• 192.168.1.3;

Parameters Description:

Default value: 10 seconds

Example: Obtain firmware version of devices at IP.list and output to DeviceList file

MCC_Tool –fw –r –il IP.list –o DeviceList

The resulting log should include the items below:

NOTE You may use this command to generate the Device List for other function usage. The output value under the PWD and Key columns are dummy values, where the user will need to input the password and key information of the device when executing other function commands with the device list. Other columns highlighted will need to be assigned values when executing specific commands, such as import configuration files or firmware upgrades.

Upgrade Firmware and Restart the Device

• The password(s) must be specified by a command parameter or by the DeviceList file before upgrading the firmware and restarting a specific device (or multiple devices at the same time).
• After upgrading firmware, users should use search the command to check whether the device reboots successfully or not.

Parameters Description:

*This option may only work with the models that have user account management.

| Only the NPort 6000 Series supports this command function.
-p| The device’s password for login|  
-d| Device list|  
-f| Firmware file to be upgraded|  
-l| Export result log file|  
-t| Timeout (1~1200 seconds)

Default value: 800 seconds

|
-print| Print upgrade process status message|  

Example: Upgrade firmware using a device list and capture the results in an import log

MCC_Tool –fw –u –d DeviceList –l result_log

The result_log should include the items below:

Export/Import Device’s Configuration

• Export/Import the device configuration for a specific device or a range of devices through the device list file. The password must be specified by parameter or by the device list file.
• Device configurations are stored in individual files, using device type, IP address, and file create date as the filename. The result log is directly printed on the screen, or the user can specify a result_log file for it.

Parameters Description:

*This option may only work with the models

that have user account management.

| Only the NPort 6000 Series supports this

command function.

-p| The device’s password for login|  
 | When Exporting configuration:|
 | The command decrypts the exported file with|
 | the pre-shared key.|
 | ·        If this parameter is not used, the exported file will be encrypted by the pre-shared key set on the firmware of the device.

·        If this parameter is used, the exported file will be decrypted to a clear-txt file for editing.

When Importing Configuration:

|
 | If the configuration file needs to be|
-dk| imported is encrypted, the command is needed with a pre-shared key.

·        If the import configuration file is without -n, the MCC tool will ignore -dk (won’t return -11).

·        If the import configuration file is with – n, the MCC tool will use the pre-shared key to decrypt the encrypted file. Therefore, if the key is wrong for decrypting the file, MCC tool will return -10. However, if the file is in plain text, and the user inputs

a pre-shared key, it will ignore the key (won’t return 10).*

(by parameter -dk or the key column in the device list file)

| Only the NPort 6000 Series supports this command function.
 | *This option may only work with the models|
 | that support encrypted configuration files.|
-f| The configuration file to be imported| Only for the import configuration function
-n| Keep original network parameters (includes

IP, subnet mask, gateway, and DNS)

| Only for the import configuration function
-nr| Do not reboot the device after importing the configuration file| Only for import configuration function. MGate, ioLogik, and ioThinx devices do not support this command.
-l| Export result log file|  
-t| Timeout (1~120 seconds)

Export function Default value: 30 seconds Import function Default value: 60 seconds

|

Example: Export the configuration using a device list and export the results to a result log

MCC_Tool –cfg –ex –d DeviceList –l result_log

The result_log should include the following items:

Example: Import the configuration to a device list (with the restart of the units) and export the results to a result log MCC_Tool –cfg –im –d DeviceList –l result_log

The result_log should include the items below:

Example: Import the configuration to a device list without restarting the units and export the results to a result log MCC_Tool –cfg –im –d DeviceList –nr –l result_log

Restart Specific Serial Ports or the Whole Devices

Restart the specific port(s) or the device itself for an individual device or a range of devices specified by the device list file. The password must be specified by a parameter or by the device list file. Device configurations are stored in individual files, using device type, IP address, and file create date as the filename. The result log is directly printed on the screen, or users can specify a result_log file for it.

Parameters Description:

*This option may only work with the models that have user account management

| Only the NPort 6000 Series supports this command function.
-p| The device’s password for login|  
-d| Device list|  
-l| Export result log file|  
-t| Timeout (1~120 seconds)

Restart the device, the default value is 15 seconds

Restart the port, the default value is 10

seconds

|

Example: Restart the port using a device list and export the results to a result log

MCC_Tool –re –sp –d DeviceList –l result_log

The result_log should include the items below:

The serial ports 2-5, 8 and 10 of device 1 (NPort 6650) have been restarted.

Example: Restart the device using a device list and export the results to a result log

MCC_Tool –re –de –d DeviceList –l result_log

The result_log should include the following items:

Change the User’s Password on the Device

Set the password of the target device specified by an IP address. The current password must be specified by a parameter or by the Device List file.

Parameters’ Description:

*This option may only work with the models that have user account management

| Only the NPort 6000

Series supports this command function.

-p| The device’s password for login (old password)|  
-d| Device list|  
-nd| The Device list with new password settings| The user will need to assign a new password in the Device List when using -nd command.
-l| Export result log file|  
-nr| Don’t reboot the device after changing the password.| MGate and ioLogik devices do not support this command.
-t| Timeout (1~120 seconds)

Default value: 60 seconds

|

• Example: Set the new password as “5678” then restart the device to make it effective, and print the result on the screen MCC_Tool –pw 5678 –i 192.168.1.1 –u admin –p moxa
• Example: Set a new password from a device list and then restart the device to make it effective, and export the results to a result log MCC_Tool –pw DeviceList_New –d DeviceList –l result_log

The result_log should include the items below:

Show Support Model List

• Show the supported models of the MCC Tool.
• MCC_Tool -ml

Update Plugin

• Users may update the Plugin for the MCC Tool to support new models, which may not be included in the current version. The command is as follows below. This function is supported by MCC_Tool version 1.1 and later.
• MCC_Tool -install “path of the plugin”

Error Code Explanation

The MCC_Tool has the same error code for all the command options, please refer to the below sheet for all the details.

If the target file path exists, please make sure you have the privilege to the target path

-5| The action timed out
-6| Import failed
-7| Firmware upgrade failed
-8| Exceeds the length of the new password
-9| Fail to set restart port index
-10| The cipher key for decrypting the configuration file is mismatched
-11| Invalid parameters E.g.,

1.      Input parameters are not described above

2.      The parameters do not work for some devices (e.g., -u for the MGate MB3000 Series, which does not support the user account function, or -dk for the NPort 5000A Series, which does not support the pre-shared key function)

3.      Using the device list file should not input -i, -u, -p, or -npw

-12| Unsupported command E.g., executing restart specific port command (MCC_Tool -re -sp) for the MGate MB3000 Series will get the error code -12
-13| A lack of information in the device list If a specific NPort only exists in the device_list_new_password but not in the device_list (original device list with old password), then an error will occur.
-14| A lack of information in the new password list If there is no new password in the device_list_new_password but the device exists in the original device list, then an error will occur.
-15| Not executable due to an error of other devices in the list
-16| The MCC_Tool does not support the firmware version of the device. Please

upgrade the device to the supported firmware version (a reference to the “Support Models” section)

-17| The device is still in the default state. Please create a password and then execute the import.
Other value| Contact Moxa

www.moxa.com/products

Documents / Resources

| MOXA NPort 5150 CLI Configuration Tool [pdf] User Manual
NPort 5150, NPort 5100 Series, NPort 5200 Series, NPort 5150 CLI Configuration Tool, NPort 5150 CLI, Configuration Tool
---|---

References

• Moxa - Products
• Moxa - Support
• Moxa - Support
• Moxa - Support
• Moxa - Support

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>