How do I install or upgrade CDRouter, CDRouter-Multiport, or the CDRouter Demo?
Installation UpgradeCDRouter Installation and Upgrade Instructions
Installing CDRouter is easy! If you are a new or existing customer, or have downloaded the CDRouter Demo, just follow these simple instructions to complete your installation. If you are not an existing customer and are interested in learning more about CDRouter and trying the CDRouter Demo, please visit the following web page:
http://www.qacafe.com/cdrouter/download-cdrouter.htm
Installing CDRouter is as simple as running our automated installer program. If you have never installed CDRouter before or are unfamiliar with Linux, this article will walk you through each of the steps necessary to download and run the CDRouter installer program on your system.
If you are already running CDRouter, you can upgrade or downgrade to any version of CDRouter using the same procedure and still have access to all of your existing configurations and test results.
You will also learn how to register and install the CDRouter license file to activate CDRouter on your system. This is only required for first-time installations or when a license is renewed or extended with one or more add-on modules (CDRouter TR-069, CDRouter IKE, CDRouter IPv6, CDRouter Storage, or CDRouter Multiport).
Before we begin:
-
Before installing CDRouter, be sure that you have an appropriate host machine. Please read the System Requirements article in our Knowledge Base before proceeding: What equipment will I need to run CDRouter?
-
If you are running tests from the CDRouter Storage or Nmap add-ons, you must update your Linux kernel to version 2.6.35 or newer. If you are using the CDRouter IPv6 add-on and have a kernel earlier than 2.6.35, you must manually deactivate IPv6 at boot-time due to a kernel bug.
-
TCL version 8.5 must be installed in order for CDRouter to install and run. If TCL is not installed on your system, please refer to this Knowledge Base article for instructions on installing it: How do I install TCL on my system?
-
If you are installing versions older than 7.0 of CDRouter or CDRouter-Multiport, please read this Knowledge Base article to understand the differences in the installation procedure that may pertain to your version: How do I install older versions of CDRouter?
Install CDRouter in three easy steps
Step 1: Download the CDRouter installer
If you don’t already have the CDRouter installer, download it from our Customer Lounge. Be sure to choose the correct installer for the product you have purchased, CDRouter or CDRouter-Multiport. This is shown in the QA Cafe purchase invoice you received. If you are installing the CDRouter Demo, a direct link to the installer will be provided to you.
For each variant of CDRouter, the installer file is named as follows (where X.Y-Z indicates the version number):
CDRouter - cdrouter-base_X.Y-Z.bin
CDRouter-Multiport - cdrouter-mp_X.Y-Z.bin
CDRouter Demo - cdrouter-demo_X.Y-Z.bin.
(Note: Installers for earlier versions of CDRouter follow a different naming convention.)
The installation instructions are identical for all three variants of CDRouter, and the installer contains the entire software application and all required components.
Step 2: Make the installer executable
Once downloaded to your Linux host, make the installer executable:
Note: You may need root-level access to perform this step. Root-level access can be obtained by logging in as root or issuing the sudo su command.
Step 3: Run the installer
The installer contains additional binary packages for the Red Hat, Debian, Fedora, Ubuntu, and openSUSE Linux distributions and will automatically install the correct files for your Linux distribution along with CDRouter.
If you are upgrading an existing CDRouter system, Congratulations! You're Done!
If this is a new system or if your CDRouter license has been upgraded or renewed, proceed to the next section to install and activate the license file on your system.
Activate your CDRouter license
Step 1: Register your system-id
For every new CDRouter license purchased, each Linux system that CDRouter will be installed on must first be registered with QA Cafe. This is a one-time process for each new license and allows you to install and update the license file on your CDRouter system. Your CDRouter system must be registered and have a valid license installed before you can begin to use CDRouter.
You can register a system in our Customer Lounge using the system ID generated during installation. If you do not have your system ID, you can find it by issuing the following command:
(Note: the system ID is not available until after CDRouter has been installed using the procedure above).
Once a system is registered, a license file will be created for it which can then be automatically downloaded and installed by CDRouter.
Note: CDRouter Demo users will obtain a Demo-specific license file from the QA Cafe Sales Team which is valid for 30 days. Demo users do not need to register their system IDs with QA Cafe and can skip this step.
Step 2: Download and Install the license file
Once your system has been registered with QA Cafe, you must update that system with a valid license file.
You can have CDRouter automatically download and install its license file over the Internet by running the command buddy -update-license as root. This is the recommended method to activate your CDRouter license and keep it current.
If you CDRouter system does not have access to the Internet, the license file for that system can be downloaded directly from our Customer Lounge. Each license is identified by the system ID of the system registered with it, and will display a "cdrouter.lic" or "cdr-mp.lic" link, for CDRouter and CDRouter-Multiport licenses, respectively. You can also obtain your license file by contacting support@qacafe.com and have it emailed to you. If you have any questions about your CDRouter license, please refer to our License FAQ
When you receive the license file, the system ID of your CDRouter system will be included in the filename in order to identify the system it belongs to. If you are not using CDRouter's automatic license installation utility, you must manually rename the license file to 'cdrouter.lic' (for CDRouter) or 'cdr-mp.lic' (for CDRouter-Multiport), and place it in the/etc directory on your CDRouter system.
Example:
Note: The license file for CDRouter Demo does not need to be renamed, and can then be copied or moved to the /etc directory on your Linux host as-is:
Note: CDRouter will not run without a valid license file.
Step 3: Restart
Restart your system to activate your new license file in CDRouter. To verify that your license has been applied, issue the following command:
You should see information pertaining to your license, including the add-ons you've purchased, the effective dates your Maintenance and Support Agreement, and the location of your license file.
That’s it - CDRouter is now installed and ready to use!
If you have problems during the install, please refer to our Knowledge Base or contact support@qacafe.com.
For help getting started with CDRouter, please refer to our Get Started page.
Notes on updating an existing license file or upgrading to a newer release of CDRouter or CDRouter-Multiport
If you would like to upgrade to a newer release of CDRouter or CDRouter-Multiport, simply follow steps 1, 2, 3, and 6 above. There is no need to re-install the license file, unless you've purchased any additional CDRouter add-ons. If you have purchased new CDRouter add-ons, you will have to update your license file. You can do this by following steps 4 and 5 above, or by simply entering the following command in place of steps 4 and 5:
