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 results, configuration files, and test packages between systems.
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 are are not meant to be opened, read, parsed, or manipulated outside of
Exporting Via the Web Interface
The following resources can be exported from a CDRouter system:
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.
To export one or more 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.
A result export archive will contain a 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.
Sending individual files (eg. logs, packet captures, etc.) will make it more difficult for the support team to analyze and respond to your questions.
A result can also be exported by clicking on the Export icon for that particular test run.
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 copy of its associated configuration, and 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 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.
Select Components to Import
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.
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.