CDRouter Support

How do I update my CDRouter license?

knowledge-base version 11.0

The CDRouter License File

A valid license file is required to install and run tests with CDRouter. This article explains how to update or reinstall the license file on a CDRouter system.

CDRouter is node locked to a single machine. For more information please see the CDRouter license FAQ.

The license file contains the following information:

  • The expiration date for maintenance and support
  • The list of add-ons that have been purchased and that are enabled
  • The unique system-id of the physical machine that has been registered

Once a system has been registerd with a CDRouter license, it cannot be transferred to another system.

Whenever the maintenance and support agreement (MSA) for a license is renewed, or when additional add- ons are purchased, the license file must be updated for the changes to become effective.

Please note that some changes were made to licensing in CDRouter 10.0. Please select the appropriate set of instructions below based on the version of CDRouter currently installed:

CDRouter 10.0 and Later Instructions

New License

If you are installing CDRouter for the first time or if you do not have a valid license file on the system, CDRouter will display the following warning in the web interface until you download and install a valid license key file:

Click the "Run cdrouter-cli -update-license" link to automatically download and install a valid license file.

Note that if you are installing CDRouter for the first time, you will not be able to download a license file until you have first associated and registered your CDRouter system-id with a CDRouter license record in the Customer Lounge section of the QA Cafe Customer Support website.

For more detailed information on registering your new CDRouter system, please see the CDRouter Installation Guide.

Updating an Existing CDRouter License File

If your CDRouter system already has a valid, active license, the steps below will help you update it. Licenses only need to be updated if you have recently renewed the MSA or if new add-ons have been purchased.

Automatic Method

CDRouter can automatically download and install the appropriate CDRouter license file from the QA Cafe website. You must have access to the Internet for this feature to work.

Web Interface Method

Go to the Admin > System page on CDRouter’s web interface and click the “Update License” link.

Command Line Method

You can also automatically update your license file from the command line by running the "cdrouter-cli -update-license" command as root on your CDRouter system:

# cdrouter-cli -update-license

2016-07-13 10:13:17.007 INFO: System-id is 2df9e2a1f8c359183cf0191a20f2cc5a
2016-07-13 10:13:17.007 INFO: Requesting updated cdrouter license from lounge.qacafe.com
2016-07-13 10:13:17.918 INFO: Backing up original to: /tmp/old_cdrouter.lic
2016-07-13 10:13:17.919 INFO: Installing new license file to /etc/cdrouter.lic
2016-07-13 10:13:17.919 INFO: License update successful

2016-07-13 10:13:17.919 INFO: Please run 'service cdrouter restart' to restart CDRouter
2016-07-13 10:13:17.919 INFO: Note that any tests that are running in CDRouter will be stopped

#

After updating the license key file, you must restart the cdrouter process for the changes to become effective. (Note: this command must be run as root).

# service cdrouter restart
Redirecting to /bin/systemctl restart  cdrouter.service

Manual Method

If your CDRouter system does not have internet access, you may also install the license file manually by downloading it from the Customer Lounge. Be sure to download the license file that matches the CDRouter system-id of the system you are updating.

Once you have downloaded the license file, follow these steps to install it:

  1. Copy the license file to the /etc directory of the CDRouter system.

  2. Change the name of the license file to ‘cdrouter.lic’.

    • Example:

      qacafe@NTA1000:/tmp$ sudo cp cdrouter-1464bf1590f449007486fb0f0e8e8d35.lic /etc
      qacafe@NTA1000:/tmp$ sudo mv /etc/cdrouter-1464bf1590f449007486fb0f0e8e8d35.lic /etc/cdrouter.lic
      
  3. Restart your CDRouter system.

The new license should now be installed.

CDRouter 9.3 and Earlier Instructions

New License

If you are installing CDRouter for the first time or if you do not have a valid license file on the system, CDRouter will display the following warning in the web interface until you download and install a valid license key file:

Click the "Run buddy -update-license" link to automatically download and install a valid license file.

Note that if you are installing CDRouter for the first time, you will not be able to download a license file until you have first associated and registered your CDRouter system-id with a CDRouter license record in the Customer Lounge section of the QA Cafe Customer Support website.

For more detailed information on registering your new CDRouter system, please see the CDRouter Installation Guide.

Updating an Existing CDRouter License File

If your CDRouter system already has a valid, active license, the steps below will help you update it. Licenses only need to be updated if you have recently renewed the MSA or if new add-ons have been purchased.

Automatic Method

CDRouter can automatically download and install the appropriate CDRouter license file from the QA Cafe website. You must have access to the Internet for this feature to work.

Web Interface Method

Go to the Utilities page of CDRouter’s web interface and click the “Update License…” link.

Command Line Method

You can also automatically update your license file from the command line by running the "buddy -update-license" command as root on your CDRouter system:

$ buddy -update-license

Using license installed at: /etc/cdr-mp.lic
Registered to: Com Inc
Upgrade until: 2006-10-22
Licensed to run: cdr-mp 

INFO: 15:31:06| Requesting updated license from qacafe.com
INFO: 15:31:07| Backing up original to: /tmp/old_cdr-mp.lic
INFO: 15:31:07| Installing new license file to /etc/cdr-mp.lic
INFO: 15:31:07| License update successful

After updating the license key file, you must restart the buddyweb process for the changes to become effective. (Note: this command must be run as root).

$ service buddyweb restart
Restarting buddyweb...done

Manual Method

If your CDRouter system does not have internet access, you may also install the license file manually by downloading it from the Customer Lounge. Be sure to download the license file that matches the CDRouter system-id of the system you are updating.

Once you have downloaded the license file, follow these steps to install it:

  1. Copy the license file to the /etc directory of the CDRouter system.

  2. Depending on the type of license you purchased, change the name of the license file to ‘cdrouter.lic’ for CDRouter or ‘cdr-mp.lic’ for CDRouter Multiport.

    Example:

    • For CDRouter systems:

      qacafe@NTA1000:/tmp$ sudo cp cdrouter-1464bf1590f449007486fb0f0e8e8d35.lic /etc
      qacafe@NTA1000:/tmp$ sudo mv /etc/cdrouter-1464bf1590f449007486fb0f0e8e8d35.lic /etc/cdrouter.lic
      
    • For CDRouter Multiport systems:

      qacafe@NTA1000:/tmp$ sudo cp cdr-mp-1464bf1590f449007486fb0f0e8e8d35.lic /etc
      qacafe@NTA1000:/tmp$ sudo mv /etc/cdr-mp-1464bf1590f449007486fb0f0e8e8d35.lic /etc/cdr-mp.lic
      
  3. Restart your CDRouter system.

The new license should now be installed.

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: