Tranfer All CDRouter Data to a New System

Introduction

If you have recently upgraded your CDRouter system hardware to a new NTA platform, this article will help you transfer all existing configuration data and test results from the old, to the new system.

The details within this article will be useful whether you received new hardware due to an RMA process or from the hardware upgrade program.

For more information on the NTA3000 hardware upgrade program, please contact sales@qacafe.com

Background

The CDRouter database and all test data, including configuration files, packages, devices, and test results are stored in a central location on the system. This is where CDRouter stores all the test data generated.

The test ‘data’ resides in the /usr/cdrouter-data directory and its subdirectories, which is mounted on the system’s dedicated ‘data’ hard drive. By following the tools and process outlined below, you can efficiently copy all this data to your new system.

Setup Requirements

Performing the actions mentioned in the bullets below will make the data transfer process simpler.

  • Both the old and new NTA hardware platforms should be powered on. The management interface of both systems should be connected to the same network to avoid congestion while CDRouter data is being transferred.

  • Open a ssh terminal window on each system as the root user.

  • Make sure there are no tests running on either system by stopping the CDRouter software on each system with the command -

service cdrouter stop
  • Make note of the IP Address used on the new NTA hardware. If you are unsure of the current IP address currently being used, you can use one of these commands -

For NTA3000:

ip address show dev mgmt1

For NTA1000:

ip address show dev eth0

Data Transfer Steps

In the ssh terminal window connected to your old NTA platform use the following rsync command -

rsync -av --exclude="*.lic" /usr/cdrouter-data/* root@<IP_of_new_NTA>:/usr/cdrouter-data/

For example:

rsync -av --exclude="*.lic" /usr/cdrouter-data/* root@10.2.37.112:/usr/cdrouter-data/

This command will copy over all your data (configuration files, packages, results, packet captures, etc.)

(If the transfer gets unexpectedly interrupted, re-running the rsync command again will allow the transfer to continue where it left off before the interruption.)

Configuration Migration

This step only applies if you have transferred data from the NTA1000 platform to the NTA3000 platform.

Many of the test interface names are different on the NTA3000. This means that CDRouter configuration files that are transferred from an NTA1000 platform will need to be modified.

To help with this task, the CDRouter development team created the cdrouter-migrate utility to help change the interface names within your configuration files to the new interface names.

After you have transferred your data, please use the cdrouter-migrate tool, located on the NTA3000 system to convert/migrate your configuration files.

Cleanup

After the data transfer (and optionally the migration) are complete, reboot both systems.

Once both systems are running again, you may validate the successful transfer by using the CDRouter web interface on the new NTA. The contents should appear identical to what was on your old system.

If you used the cdrouter-migrate tool to convert your CDRouter configuration files, please consult the interface mapping table to see how the interfaces names were changed.

Also note that any custom testpaths configured in the CDRouter database will produce warnings until you have manually copied the custom test modules from the old system to the new NTA. Go to the Preferences page in the CDRouter web interface if you need to update or delete any custom testpaths.

If you encounter any problems while using any of the utility programs, please contact support@qacafe.com for assistance.