CDRouter Support

How do I update my CDRouter license?

knowledge-base version 11.5

Overview

This guide describes how to update the license file on a CDRouter system. Please see this guide for instructions on installing or upgrading the version of CDRouter running on a system.

The license file contains the following information:

  • The expiration date of the systems’ Maintenance and Support Agreement (MSA)
  • The list of add-ons that have been purchased and that are enabled
  • The unique system ID of the server that the license is locked to

CDRouter licenses are node locked to a single server which is identified by a unique 32-character hex string known as a system ID. License files cannot be transferred.

A valid license must be installed in order to use and run tests with CDRouter. For more information please see the CDRouter license FAQ.

Four installation methods are discussed in this guide:

If the MSA for a system is renewed, or if additional add-ons are purchased, the license file must be updated for the changes to become effective.

For instructions on installing a license file in CDRouter 9.3 or earlier releases, please contact support@qacafe.com.

Automatically install a license file using the web interface

On CDRouter systems with an active internet connection, the current active license can be automatically downloaded and installed directly from the CDRouter web interface.

This can be done by clicking on the Download & Install License button on the System > License page. This is the easiest and fastest way to upgrade a CDRouter license file.

Automatically install a license file using the command line

On CDRouter systems without an active internet connection, the current active license can also be automatically downloaded and installed from the command line using the CDRouter CLI.

First run the command cdrouter-cli -update-license:

$ cdrouter-cli -update-license

INFO: 17:19:29.270| System-id is 0123456789abcdef0123456789abcdef
INFO: 17:19:29.270| Requesting updated cdrouter license from www.qacafe.com
INFO: 17:19:30.354| Installing new license file to /etc/cdrouter.lic
INFO: 17:19:30.355| License update successful

INFO: 17:19:30.355| Please run 'systemctl restart cdrouter' to restart CDRouter
INFO: 17:19:30.355| Note that any tests that are running in CDRouter will be stopped

Then restart CDRouter to activate the new license:

$ systemctl restart cdrouter
Restarting cdrouter...done

Manually install a license file using the web interface

On CDRouter systems without an active internet connection, the current active license can also be installed manually using the drag and drop feature within the web interface.

To utilize this feature, download the appropriate CDRouter license file from the Active Licenses section of the Customer Lounge or obtain a copy via email by contacting support@qacafe.com.

Note that CDRouter license files are named using the convention <system ID>-cdrouter.lic (where <system ID> is the unique system ID of CDRouter system the license is locked to). The system ID of the downloaded license file must match the system ID of the CDRouter instance it is being installed on.

From the System > License page the downloaded CDRouter license file can be installed using the drag and drop feature in the Manual Update section.

Manually install a license file using the command line

CDRouter license files can also be installed manually from the command line as a user with root-level permissions.

To perform a manual installation via the command line, download the appropriate CDRouter license file from the Active Licenses section of the Customer Lounge or obtain a copy via email by contacting support@qacafe.com.

Note that CDRouter license files are named using the convention <system ID>-cdrouter.lic (where <system ID> is the unique system ID of CDRouter system the license is locked to). The system ID of the downloaded license file must match the system ID of the CDRouter instance it is being installed on.

After copying the downloaded license file to the CDRouter system, rename it cdrouter.lic and move or copy it to the /etc directory:

$ mv 0123456789abcdef0123456789abcdef-cdrouter.lic /etc/cdrouter.lic

Next, restart CDRouter to activate the new license file:

$ service cdrouter restart

The output you may see:

Restarting cdrouter...done

or

Redirecting to /bin/systemctl restart cdrouter.service

To verify that the license has been applied, run the following command:

$ cdrouter-cli -info

This should display the most current MSA information and list of add-ons for the system.

Contents

×

About CDRouter

CDRouter is made by QA Cafe, a technology company based in Portsmouth, NH.

Get in touch via our Contact page or by following us on your favorite service: