Exporting and Importing CDRouter Results

Resources can be easily shared between systems using CDRouter’s import and export features. Please see the instructions below for more information on sharing devices, results, configuration files, and test packages between systems.

NOTE: This is the preferred way to share results with the QA Cafe Support Team Sending individual files (eg. logs, packet captures, etc.) will make it more difficult for the support team to analyze and respond to your questions.

Export Format

CDRouter utilizes the .gz archive format for all resources exported from a system. Export archives are designed solely for use by CDRouter’s import tool and are not meant to be opened, read, parsed, or manipulated outside of CDRouter.

Exporting Via the Web Interface

The following resources can be exported from a CDRouter system:

  • Results
  • Packages
  • Configurations
  • Devices

Test Results

The simplest method to export a result is by clicking on the export button for a particular test run -

“Export a Single Result”

You can also export multiple test results from CDRouter’s web interface, go to the Results page, select the test results to export, and click the Export button in the toolbar, as shown in the screenshot below.

“Export Multiple Results”

A result export archive will contain a ‘snapshot’ copy of the test package, configuration, all test logs, and by default all capture files associated with that test run.

To reduce the size of the export archive that is created, capture files can be optionally omitted.

NOTE: When sending test results to the CDRouter Support team, please include packet captures in your export archive.

“Include Capture Files in Results Export”

Test Packages, Configurations, Devices

Individual test packages, configurations, and devices can also be exported directly from their respective pages in the CDRouter Web interface. To export one or more items, select the checkboxes next to the items you want to export, and then click on the Export button in the toolbar.

Note that a test package export archive includes a ‘snapshot’ copy of its associated configuration, and its device as well.

Importing Via the Web Interface

CDRouter’s import tool can be accessed from a number of places within the web interface. To import results, test packages, or configurations:

  • click on the Imports link within the Admin menu
  • click on the Import button on the configurations, packages, or results pages
  • click on the Drag & Drop Here area on the home page

The import process begins when a valid export archive is selected for import or when a valid export archive is dragged and dropped onto the target area. Users have the ability to select certain components and modify attributes such as the name or tags for each component during the import process.

Note that CDRouter will automatically tag all imported configurations, test packages, and test results with the tag import.

There are three steps in the import process, as discussed below.

Choose What/How to Import

There are three ways to import resources into CDRouter:

  • Import via Browser: This option can be used to import files from the local system. Configurations, test packages, or results can be imported using drag and drop. Alternatively, clicking on the drop target will open a local file browser.

  • Import from Filesystem: This option can be used to import resources that have already been manually copied to the CDRouter test system but that have not yet been imported.

  • Import from another CDRouter: This option can be used to automatically import resources from another CDRouter system.

“Choose What to Import”

Select Components to Import

“Select Components to Import”

Finish Up

“Finish Up”

Downloading Raw Test Results

It is also possible to access all of the individual test logs and packet capture files by clicking the Open Log Directory button on the test results page.

“Open Log Directory”

On the Log Directory page you can filter and download files for a specific test, as well as the configuration snapshot file and any other files generated during the test run. Click the Export button to download a .zip archive of all the results files.

“Log Directory”

Multiple resources can be exported in a single archive. This makes it very easy to transfer a collection of configurations, test packages, or results on another system.