MXOMigrationTool User Guide
Version 1.1, March 2024

www.moxa.com/products© 2024 Moxa Inc. All rights reserved.

MXOMigrationTool User Guide
The software described in this manual is furnished under a license agreement and may be used only in accordancewith 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/orchanges to this manual, or to the products and/or the programs described in this manual, at any time.
Information provided in this manual is intended to be accurate and reliable. However, Moxa assumes noresponsibility for its use, or for 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 periodicallymade to the information herein to correct such errors, and these changes are incorporated into new
editions of the publication.

Technical Support Contact Informationwww.moxa.com/support

Table of Contents
1.

2.

3.

4.

5.

Introduction ......................................................................................................................................... 4
Why You Should Migrate ......................................................................................................................... 4
Benefits of Migration ....................................................................................................................... 4
Risks of Not Migrating ..................................................................................................................... 4
User Scenarios ...................................................................................................................................... 5
MXview v3.2.8 (or Later Versions) Users ........................................................................................... 5
MXview v3.x to v3.2.6 Users............................................................................................................ 5
MXview v2.x Users ......................................................................................................................... 5
What’s New in MXview One .................................................................................................................. 6
Differences between MXview One and MXview ........................................................................................... 6
MXview One Features ............................................................................................................................. 6
Migration Options and Procedures ........................................................................................................ 7
MXview v3.2.8 (or Later Versions) Users: Use MXOMigrationTool ................................................................. 7
MXview v3.x to v3.2.6 Users: Use MXOMigrationTool or Install MXview One ................................................ 15
Method 1: Use MXOMigrationTool ................................................................................................... 15
Method 2: Install MXview One........................................................................................................ 24
MXview v2.x Users: Install MXview One.................................................................................................. 26
Items to Check After Migration .............................................................................................................. 28
Migration Scopes and Limitations ....................................................................................................... 30
Migration Scopes ................................................................................................................................. 30
Migration Limitations ............................................................................................................................ 31
Version Requirement .................................................................................................................... 31
Licenses ...................................................................................................................................... 31
Function Settings Migration ........................................................................................................... 31
User Password ............................................................................................................................. 33
Troubleshooting.................................................................................................................................. 35
Export Backup Files Failure ................................................................................................................... 35
Import Backup Files Failure ................................................................................................................... 35

1. Introduction

MXOMigrationTool provides you with a convenient way to migrate settings from MXview to MXview One.
If you are currently using MXview and want to switch to MXview One, we recommend that you use
MXOMigrationTool to migrate your settings, free of charge.

NOTE
Currently, we only support the migration from MXview v3.2.8 (or later versions) to MXview One
v1.2.0 (or later versions). Refer to the product release note for detailed information on which versions
are supported by MXview and MXview One.

Why You Should Migrate
Benefits of Migration
If you are currently an MXview user, we highly recommend that you switch to MXview One to enjoy thefollowing benefits:
1.

Supports new devices: MXview One supports all the devices supported by MXview, and will also
support any new networking devices developed by Moxa in the future.

2.

Supports more add-on modules: MXview One supports both the MXview Power add-on module andthe MXview Wireless add-on module.

3.

Supports new functions: MXview One can be managed by MXview One Central Manager and will
support new functions developed in the future.

4.

Supports more operating systems: MXview One supports both the Windows and Linux operating
systems.

Risks of Not Migrating
If you do not migrate to MXview One, you can still use MXview, but you may encounter the following risks:
1.

MXview only supports existing features
New functions developed in the future will only be supported by MXview One.

2.

MXview will not support new devices
New networking devices developed by Moxa in the future will only be supported by MXview One.

MXOMigrationTool User Guide

4

User Scenarios
Use the migration operations described below for the version of MXview that you are currently using.

MXview v3.2.8 (or Later Versions) Users
For users of MXview v3.2.8 or later versions, we suggest that you install MXview One on a second
computer, and then use MXOMigrationTool to export the backup files from MXview and import them into
MXview One. Refer to MXview v3.2.8 (or Later Versions) Users: Use MXOMigrationTool for details.

MXview v3.x to v3.2.6 Users
MXview v3.x to v3.2.6 users can choose one of the following methods to migrate the settings.
•

Method 1: Use MXOMigrationTool
Upgrade to MXview v3.2.8 (or later versions) on your current computer, install MXview One on asecond computer, and then use MXOMigrationTool to export the backup files from MXview and importthem into MXview One.

•

Method 2: Install MXview One
Install MXview One on a second computer and manually configure the settings without using
MXOMigrationTool.

Refer to MXview v3.x to v3.2.6 Users: Use MXOMigrationTool or Install MXview One for details.

MXview v2.x Users
Because MXview v2.x cannot be upgraded to MXview v3.2.8 (or later versions), we suggest that MXview
v2.x users install MXview One on a second computer and then manually configure the settings without using
MXOMigrationTool. Refer to MXview v2.x Users: Install MXview One for details.

NOTE
To minimize risks, we recommend using two separate computers during the migration process. Install
MXview One on a different computer from MXview, and then uninstall MXview only after confirming that
MXview One is functioning properly.

MXOMigrationTool User Guide

5

2. What’s New in MXview One

Differences between MXview One and MXview
Add-onModulesOS

Difference
Wireless
Power
Windows
Linux
LicenseMXview One




•
•
•

Other Differences•

Single node license (Qty: # ofdevices)
Add-on license (Wireless, Power)
Supports MXview One Central
Manager (multiple sitemanagement)
Main platform to support Moxa
devices

MXview
See Note••Fixed number of node
licenses (Qty: 50,
100, ...)
Add-on license (Wireless)Note: Currently, MXview supports MXview Wireless v1.0. New versions of MXview Wireless developed in the
future may not be supported by MXview.

MXview One Features•

Add-on Module: MXview One supports both the MXview Wireless add-on module and the MXview
Power add-on module.

•

Operating System: MXview One supports both Windows and Linux.

•

License: MXview One provides a single node license and an add-on license. If you are an MXview
One user, you can purchase node licenses based on the number of devices you have on your network.
To obtain wireless or power related functions, you can also purchase an add-on license to access theMXview Wireless add-on module or MXview Power add-on module.

•

Other features: Supports MXview One Central Manager
MXview One supports MXview One Central Manager, which is a centralized platform that helps
you manage MXview One sites located in different areas.
 Main platform to support Moxa devices
MXview One supports the devices supported by MXview and will also support new networking
devices developed by Moxa in the future.

MXOMigrationTool User Guide

6

3. Migration Options and Procedures

MXview v3.2.8 (or Later Versions) Users: Use
MXOMigrationTool
If you are running MXview v3.2.8 (or later versions) on your current computer, we suggest that you install
MXview One on a second computer, use MXOMigrationTool to export the backup files from MXview, andthen import them into MXview One.

Preparation
1.
2.

Prepare a second computer, separate from the computer running MXview.
Perform the following operations on the second computer:a. Install MXview One v1.2.0 (or later versions).
i.

Open a web browser and visit Moxa's website (https://www.moxa.com).

ii.

Search for and navigate to the MXview One product web page.

iii.

On the Resources tab, download the MXview One v1.2.0 (or later versions) software
package and start the installation.

iv.

After completing the installation, you should be able to access the MXview One service.

b. Open MXview One and activate either the trial license or an MXview One license that you havealready purchased.
c. Download MXOMigrationTool.
i.

Open a web browser and visit Moxa's website (https://www.moxa.com).

ii.

Search for and navigate to the MXview or MXview One product web page.

iii.

On the Resources tab, download the version of MXOMigrationTool that runs on your MXview
One operating system.

iv.

After completing the download process, you will see a zip folder with MXOMigrationTool inside.

WARNING
MXview and MXview One cannot be installed on the same computer simultaneously due to compatibility
issues.
3.

Back up events and logs in MXview on your current computer: Job Log:i.

Navigate to Menu > Migrations > Maintenance Scheduler and click the Show log (

)

icon.

MXOMigrationTool User Guide

7

ii.

When the Job Log window appears, click Save.

iii.

MXview will download the job log record as a txt file.

 All Events:i.

Navigate to Menu > Event > All Events and click the Export (ii.

Select Export CSV to export the event records on this page or select Export All Events to
CSV to export the event records on all pages.

iii.

MXview will export the event records as a csv file.

) icon.

 Syslog Viewer:

4.

i.

Navigate to Menu > Event > Syslog Viewer and click the Export (ii.

Select Export CSV to export the syslog records on this page or select Export All Syslog to
CSV to export the syslog records on all pages.

iii.

MXview will export the syslog records as a csv file.

) icon.

Download MXOMigrationTool to your current computer.
a. Open a web browser and visit Moxa's website (https://www.moxa.com).
b. Search for and navigate to the MXview or MXview One product web page.
c. On the Resources tab, download MXOMigrationTool for the Windows operating system.
d. After completing the download process, you will see a zip folder with MXOMigrationTool inside.

MXOMigrationTool User Guide

8

Migration Steps
Step 1: Export backup files from MXview v3.2.8 (or later versions) on
your current computer.
1.

Open File Explorer. Copy %MXviewpro_data%\nms-platform\runtime\generic-processor\bin, paste it
into the directory search panel, and then press Enter to navigate to the folder.

2.

Unzip the MXOMigrationTool zip folder that you downloaded, and then open it.

3.

Copy MXOMigrationTool from inside the folder and paste it into the folder from Step 1-1.

4.

Double-click MXOMigrationTool to execute it. Choose Export from MXview and then press Enter.

5.

Choose Existing MXview Scheme (http or https) and press Enter.

6.

Enter the Existing MXview Service Port of the existing MXview scheme you have chosen, and thenpress Enter.
Default port numbers are:
 http: 80
 https: 443

MXOMigrationTool User Guide

9

7.

Enter the Existing MXview Username (default: admin) and press Enter.

8.

Enter the Existing MXview Password (default: moxa) and press Enter.

9.

When the Confirm command appears, enter y and press Enter to export the backup files.

10. Once the backup files have been successfully exported, you will see an ‘Export success’ message on
the command line, and the backup files will be stored in the data folder.

MXOMigrationTool User Guide

10

Step 2: Import backup files to MXview One v1.2.0 (or later versions) on
the second computer.
[For the Windows version of MXview One]
1.

Open File Explorer. Copy %MXviewpro_data%\nms-platform\runtime\generic-processor\bin, paste it
into the directory search panel, and then press Enter to navigate to the folder.

2.

Unzip the MXOMigrationTool zip folder that you downloaded, and then open it.

3.

Copy both MXOMigrationTool from inside the folder and the data folder exported from Step 1-10,
and then paste them into the folder from Step 2-1.

4.

Double-click MXOMigrationTool to execute it. Choose Import to MXview One and press Enter.

MXOMigrationTool User Guide

11

5.

Choose New MXview One Scheme (http or https) and press Enter.

6.

Enter the New MXview One Service Port of the new MXview One scheme you have chosen, and thenpress Enter.
Default port numbers are:
 http: 80
 https:443

7.

Enter the New MXview One Username (default: admin) and then press Enter.

8.

Enter the New MXview One Password (default: moxa) and then press Enter.

9.

The Confirm command appears. Enter y and press Enter to import the backup files.

MXOMigrationTool User Guide1210. Once the backup files have been successfully imported, you will see an ‘Import success’ message on
the command line, and the settings will be displayed in MXview One.

NOTE
Scan Range cannot be migrated from MXview to MXview One via MXOMigrationTool. You will need tomanually configure the settings in MXview One to align with MXview.

MXOMigrationTool User Guide

13

[For the Linux version of MXview One]
1.

Copy these two files and paste them into the /usr/mxview/generic-processor/bin directory.
 MXOMigrationTool
Unzip the zip folder that you downloaded and open it to access MXOMigrationTool.
 data folder
The folder exported from Step 1-10.

2.

Execute MXOMigrationTool by executing the following commands sequentially in the Terminal
window.
 cd /usr/mxview/generic-processor/bin
 ./MXOMigrationTool

NOTE
If you do not have permission to execute MXOMigrationTool, please enter the sudo ./MXOMigrationToolcommand into the Terminal to execute it.
3.

Choose Import to MXview One and then press Enter.

4.

Choose New MXview One Scheme (http or https) and then press Enter.

5.

Enter the New MXview One Service Port of the new MXview One scheme you have chosen, and thenpress Enter.
Default port numbers are:
 http: 80
 https: 443

MXOMigrationTool User Guide

14

6.

Enter the New MXview One Username (default: admin) and then press Enter.

7.

Enter the New MXview One Password (default: moxa) and then press Enter.

8.

The Confirm command appears. Enter y and press Enter to import the backup files.

9.

Once the backup files have been successfully imported, you will see an ‘Import success’ message on
the command line and the settings will be displayed in MXview One.

NOTE
Scan Range cannot be migrated from MXview to MXview One via MXOMigrationTool. You will need tomanually configure the settings in MXview One to align with MXview.

MXview v3.x to v3.2.6 Users: Use
MXOMigrationTool or Install MXview One
If you are running MXview v3.x to v3.2.6 on your current computer, you can choose one of the following
methods to migrate the settings.

Method 1: Use MXOMigrationTool
Preparation
1.
2.

Prepare a second computer, separate from the computer running MXview.
Perform the following operations on the second computer:a. Install MXview One v1.2.0 (or later versions).
i.

Open a web browser and visit Moxa's website (https://www.moxa.com).

ii.

Search for and navigate to the MXview One product web page.

iii.

On the Resources tab, download the MXview One v1.2.0 (or later versions) software
package and start the installation.

iv.

After completing the installation, you should be able to access the MXview One service.

b. Open MXview One and activate the trial license or an MXview One license that you have alreadypurchased.

MXOMigrationTool User Guide15

c. Download MXOMigrationTool.
i.

Open a web browser and visit Moxa's website (https://www.moxa.com).

ii.

Search for and navigate to the MXview or MXview One product web page.

iii.

On the Resources tab, download the version of MXOMigrationTool based on your MXview
One operating system.

iv.

After completing the download process, you will see a zip folder with MXOMigrationTool inside.

WARNING
MXview and MXview One cannot be installed on the same computer simultaneously due to compatibility
issues.
3.

Upgrade your MXview to MXview v3.2.8 (or later versions) on your current computer:a. Open a web browser and visit Moxa's website (https://www.moxa.com).
b. Search for and navigate to the MXview product web page.
c. On the Resources tab, download the MXview v3.2.8 (or later versions) software package andstart the installation.
d. After completing the installation, the settings from MXview v3.x will automatically be stored anddisplayed in MXview v3.2.8 (or later versions).

NOTE
If you are concerned about potential issues during the upgrade process, we recommend taking one of thefollowing actions to ensure that your current settings and configurations are not lost:••4.

Back up the database settings in MXview before upgrading to MXview v3.2.8 (or later versions).
Install MXview One on another computer and manually configure the settings without using
MXOMigrationTool. Refer to Method 2: Install MXview One for details.
Back up events and logs in Mxview on your current computer: Job Log:i.

Navigate to Menu > Migrations > Maintenance Scheduler and click the Show log (

)

icon.

MXOMigrationTool User Guide

16

ii.

When the Job Log window appears, click Save.

iii.

MXview will download the job log as a txt file.

 All Events:i.

Navigate to Menu > Event > All Events and click the Export (ii.

Select Export CSV to export the event records on this page or select Export All Events to
CSV to export the event records on all pages.

iii.

MXview will export the event records as a csv file.

) icon.

 Syslog Viewer:

5.

i.

Navigate to Menu > Event > Syslog Viewer and click the Export (ii.

Select Export CSV to export the syslog records on this page or select Export All Syslog to
CSV to export the syslog records on all pages.

iii.

MXview will export the syslog records as a csv file.

) icon.

Download MXOMigrationTool to your current computer.
a. Open a web browser and visit Moxa's website (https://www.moxa.com).
b. Search for and navigate to the MXview or MXview One product web page.
c. On the Resources tab, download MXOMigrationTool for the Windows operating system.
d. After completing the download process, you will see a zip folder with MXOMigrationTool inside.

MXOMigrationTool User Guide

17

Migration Steps
Step 1: Export backup files from MXview v3.2.8 (or later versions) on
your current computer.
1.

Open File Explorer. Copy %MXviewpro_data%\nms-platform\runtime\generic-processor\bin, paste it
into the directory search panel, and then press Enter to navigate to the folder.

2.

Unzip the MXOMigrationTool zip folder that you downloaded and then open it.

3.

Copy MXOMigrationTool inside the folder and paste it into the folder from Step 1-1.

4.

Double-click MXOMigrationTool to execute it. Choose Export from MXview and then press Enter.

5.

Choose Existing MXview Scheme (http or https) and then press Enter.

6.

Enter the Existing MXview Service Port of the existing MXview scheme you have chosen, and thenpress Enter.
Default port numbers are:
 http: 80
 https: 443

MXOMigrationTool User Guide

18

7.

Enter the Existing MXview Username (default: admin) and then press Enter.

8.

Enter the Existing MXview Password (default: moxa) and then press Enter.

9.

The Confirm command appears. Enter y and press Enter to export the backup files.

10. Once the backup files have been successfully exported, you will see an ‘Export success’ message on
the command line, and the backup files will be stored in the data folder.

MXOMigrationTool User Guide

19

Step 2: Import backup files to MXview One v1.2.0 (or later versions) on
the second computer.
[For the Windows version of MXview One]
1.

Open File Explorer. Copy %MXviewpro_data%\nms-platform\runtime\generic-processor\bin, paste it
into the directory search panel, and then press Enter to navigate to the folder.

2.

Unzip the MXOMigrationTool zip folder that you downloaded and then open it.

3.

Copy both MXOMigrationTool from inside the folder and the data folder exported from Step 1-10,
and then paste them into the folder from Step 2-1.

4.

Double-click MXOMigrationTool to execute it. Choose Import to MXview One and then press Enter.

MXOMigrationTool User Guide

20

5.

Choose New MXview One Scheme (http or https) and then press Enter.

6.

Enter the New MXview One Service Port of the new MXview One scheme you have chosen and thenpress Enter.
Default port numbers are:
 http: 80
 https: 443

7.

Enter the New MXview One Username (default: admin) and then press Enter.

8.

Enter the New MXview One Password (default: moxa) and then press Enter.

9.

When the Confirm command appears, enter y and press Enter to import the backup files.

MXOMigrationTool User Guide21

10. Once the backup files have been successfully imported, you will see an ‘Import success’ message on
the command line, and the settings will be displayed in MXview One.

NOTE
Scan Range cannot be migrated from MXview to MXview One via MXOMigrationTool. You will need tomanually configure the settings in MXview One to align with MXview.

[For the Linux version of MXview One]
1.

Copy the following two files and paste them into the /usr/mxview/generic-processor/bin directory.
 MXOMigrationTool
Unzip the zip folder that you downloaded and then open it to access MXOMigrationTool.
 data folder
The folder that was exported in Step 1-10.

MXOMigrationTool User Guide

22

2.

Execute MXOMigrationTool by executing the following command lines sequentially in the Terminal
window.
 cd /usr/mxview/generic-processor/bin
 ./MXOMigrationTool

NOTE
If you do not have permission to execute MXOMigrationTool, please enter sudo ./MXOMigrationToolcommand in Terminal to execute it.
3.

Choose Import to MXview One and then press Enter.

4.

Choose New MXview One Scheme (http or https) and then press Enter.

5.

Enter the New MXview One Service Port of the new MXview One scheme you have chosen and thenpress Enter.
The default port numbers are:
 http: 80
 https: 443

6.

Enter the New MXview One Username (default: admin) and then press Enter.

MXOMigrationTool User Guide

23

7.

Enter the New MXview One Password (default: moxa) and then press Enter.

8.

When the Confirm command appears, enter y and press Enter to import the backup files.

9.

Once the backup files have been successfully imported, you will see an ‘Import success’ message on
the command line and the settings will be displayed in MXview One.

NOTE
Scan Range cannot be migrated from MXview to MXview One via MXOMigrationTool. You will need tomanually configure the settings in MXview One to align with MXview.

Method 2: Install MXview One
Preparation1.

Prepare a second computer separate from MXview.

2.

Perform the following operations on the second computer:a. Install MXview One v1.2.0 (or later versions).
i.

Open a web browser and visit Moxa's website (https://www.moxa.com).

ii.

Search for and navigate to the MXview One product web page.

iii.

On the Resources tab, download the MXview One v1.2.0 (or later versions) software
package and then start the installation.

iv.

After completing the installation, you should be able to access the MXview One service.

b. Open MXview One and activate the trial license or an MXview One license that you have alreadypurchased.

WARNING
MXview and MXview One cannot be installed on the same computer simultaneously due to compatibility
issues.

MXOMigrationTool User Guide

24

3.

Back up events and logs in MXview on your current computer: Job Log:i.

Navigate to Menu > Migrations > Maintenance Scheduler and then click the Show log (

)

icon.

ii.

When the Job Log window appears, click Save.

iii.

MXview will download the job log as a txt file.

 All Events:i.

Navigate to Menu > Event > All Events and then click the Export (ii.

Select Export CSV to export the event records on this page or select Export All Events to
CSV to export the event records on all pages.

iii.

MXview will export the event records as a csv file.

MXOMigrationTool User Guide) icon.

25

 Syslog Viewer:i.

Navigate to Menu > Event > Syslog Viewer and then click the Export (ii.

Select Export CSV to export the syslog records on this page or select Export All Syslog to
CSV to export the syslog records on all pages.

iii.

MXview will export the syslog records as a csv file.

) icon.

Migration Steps
Step 1:On the second computer, open the function page in MXview One and manually configure thesettings to align with MXview.

Step 2:

Repeat Step 1 until you have completed the manual configuration of all the functions you want tomigrate.

Step 3:After ensuring that MXview One is functioning properly without any issues, you can choose touninstall MXview.

MXview v2.x Users: Install MXview One
Since MXview v2.x cannot be upgraded to MXview v3.2.8 (or later versions), if you are running MXview
v2.x on your current computer, we suggest that you install MXview One on a second computer andmanually configure the settings.

Preparation
1.
2.

Prepare a second computer separate from MXview.
Perform the following operations on the second computer:a. Install MXview One v1.2.0 (or later versions).
i.

Open a web browser and visit Moxa's website (https://www.moxa.com).

ii.

Search for and navigate to the MXview One product web page.

iii.

On the Resources tab, download the version of MXview One v1.2.0 (or later versions)software package that runs on your operating system and then start the installation.

iv.

After completing the installation, you should be able to access the MXview One service.

b. Open MXview One and activate the trial license or an MXview One license that you have alreadypurchased.

WARNING
MXview and MXview One cannot be installed on the same computer simultaneously due to compatibility
issues.

MXOMigrationTool User Guide

26

3.

Backup events and logs in MXview on your current computer: Job Log:i.

Navigate to Menu > Migrations > Maintenance Scheduler and then click the Show log (

)

icon.

ii.

When the Job Log window appears, click Save.

iii.

MXview will download the job log as a txt file.

 All Events:i.

Navigate to Menu > Event > All Events and then click the Export (ii.

Select Export CSV to export the event records on this page or select Export All Events to
CSV to export the event records on all pages.

iii.

MXview will export the event records as a csv file.

) icon.

 Syslog Viewer:i.

Navigate to Menu > Event > Syslog Viewer and then click the Export (MXOMigrationTool User Guide) icon.

27

ii.

Select Export CSV to export the syslog records on this page or select Export All Syslog to
CSV to export the syslog records on all pages.

iii.

MXview will export the syslog records as a csv file.

Migration Steps
Step 1:On the second computer, open the function page in MXview One and manually configure thesettings to align with MXview.

Step 2:

Repeat Step 1 until you have completed the manual configuration of all functions that you want
to migrate.

Step 3:After ensuring that MXview One is functioning properly without any issues, you can choose touninstall MXview.

Items to Check After Migration
If you want to verify whether the function settings have been successfully transferred from MXview toMXview One, you can open the corresponding function pages of the following items in both MXview and
MXview One and check the consistency of the configuration values.
•

Number of devices displayed in the Topology.

•

Link connection between each device displayed in the Topology.

•

SNMP settings in each device.

•

Polling interval settings.

MXOMigrationTool User Guide

28

•

Preference settings (e.g., Link color, Button label, Device icon, Device alias).

MXOMigrationTool User Guide29

4. Migration Scopes and Limitations

Migration Scopes
The function settings that can and cannot be migrated are listed in the following table.
( means the settings can be migrated.)
Main
Function

Sub FunctionGroup

DeviceTopology

Link

Features

Migration

The relationship between each group
Group Icon
The relationship between a device and its group
SNMP Settings
Polling Settings
Advanced Settings
Device Alias
Device Icon
Severity Threshold
Packet Error Rate
SFP Threshold
Port Label


















Background Image
Preferences
Device Configuration Center
Migrations

Maintenance Scheduler

Job Settings
Job LogLanguage
All Events
Syslog Viewer
Event

Login

Notification Management

ActionNotification

Custom Event
Username
Password

Scan Range
Integration

API Key Management
Embedded Web Widget

See Note 1

See Note 1
See Note 1

See Note 2

See Note 3
See Note 4•Note 1: To preserve event and log records that cannot be migrated, we recommend that you export thesettings as a backup file in MXview. However, please be aware that these backup files cannot be
reimported into the system.

•

Note 2: If the OID was added via OID import manager, it can also be migrated to MXview One but will
be unable to function properly.

•

Note 3: For security and privacy concerns, we do not assist with password migrations.
MXOMigrationTool will randomly generate a new password for each account. You should reset all ofthese passwords manually. Refer to the User Password section for details.

•

Note 4: We suggest that you manually configure the settings in MXview One.

MXOMigrationTool User Guide30

Migration Limitations
Version Requirement
Currently, we only support migration from MXview v3.2.8 (or later versions) to MXview One v1.2.0(or later versions). Refer to the product release notes for detailed information on which versions aresupported by MXview and MXview One.

Licenses
Licenses for MXview cannot be transferred or used with MXview One. Be sure to purchase an MXview One
license once you have decided to access our MXview One service.

Function Settings Migration
For function settings that cannot be migrated, we recommend the following solutions:•

Job Log: Export the data as a TXT file.
a. Open MXview and navigate to Menu > Migrations > Maintenance Scheduler and then click theShow log () icon.

b. When the Job Log window appears, click Save.

c. MXview will download the job log as a txt file.

MXOMigrationTool User Guide

31•All Events: Export the data as a CSV file.
a. Open MXview and navigate to Menu > Event > All Events, and then click the Export () icon.

b. Select Export CSV to export the event records on this page or select Export All Events to CSV toexport the event records on all pages.
c. MXview will export the event records as a csv file.
•

Syslog Viewer: Export the data as a CSV file.
a. Open MXview and navigate to Menu > Event > Syslog Viewer, and then click the Export (

)

icon.

b. Select Export CSV to export the syslog records on this page or select Export All Syslog to CSV toexport the syslog records on all pages.
c. MXview will export the syslog records as a csv file.
•

Scan Range: We suggest that you manually configure the settings in MXview One to align with
MXview.
a. Open MXview on your current computer and then navigate to Menu > Network > Scan Range toview the scan range settings.

b. Open MXview One on the second computer and navigate to Menu > Device Discovery.

MXOMigrationTool User Guide32

c. In MXview One, click the Add () icon. The Add Scan Range window will appear.

d. Configure the settings to align with the values in MXview.

User Password
For security and privacy concerns, we do not assist with password migrations. MXOMigrationTool will
randomly generate a new password for each account that you can reset. Refer to the following steps toreset the passwords:
Step 1:

Step 2:After importing the backup files to MXview One, view the following users folder specific to yourcomputer's operation system.
•

Windows: %MXviewpro_data%\nms-platform\runtime\generic-processor\bin•Linux: /usr/mxview/generic-processor/bin

Open the users folder. You will see TXT files that hold randomly generated new passwords foreach account.

MXOMigrationTool User Guide

33

Step 3:

Send the new passwords to the corresponding users.

Step 4:Once users receive the new password for their account, they can choose to reset the password.

Step 5:To reset the password, log in to MXview One with the username and new password.

Step 6:

Click Change Password in the top-right list.

Step 7:

When the Change Password window appears, specify a new password.

Step 8:

Click Apply to reset the password.

MXOMigrationTool User Guide34

5. TroubleshootingThis chapter describes how to solve problems that you might encounter while using MXOMigrationTool.

Export Backup Files Failure
If you fail to export backup files from MXview on your current computer, please export the backup files
again.

Import Backup Files Failure
If you fail to import backup files to MXview One on the new computer, take the following steps:
Step 1:

Uninstall MXview One on the new computer.

Step 2:

Reinstall MXview One on the new computer.

Step 3:

Import the backup files again.

MXOMigrationTool User Guide

35