qacafe - ip test solutions
Knowledge Base > Installation > How do I install CDRouter, CDRouter-Multiport, or the CDRouter Demo?

How do I install CDRouter, CDRouter-Multiport, or the CDRouter Demo?

Before installing CDRouter, be sure that you have an appropriate host machine. Please read this Knowledge Base article before proceeding: What equipment will I need to run CDRouter?

If you are installing older versions of CDRouter or CDRouter-Multiport, please read this Knowledge Base article: How do I install older versions of CDRouter?

If you plan to install CDRouter on an x86_64 based machine, please read this Knowledge Base article as well: What are the differences between the 32 and 64 bit versions of CDRouter?

Installing CDRouter is easy! If you are a new or existing customer, or have downloaded the CDRouter Demo, just follow the six simple steps below to complete your installation. If you are not an existing customer and are interesting in learning more about CDRouter and trying the CDRouter Demo, please visit the following web page:

http://www.qacafe.com/cdrouter/download-cdrouter.htm

Install CDRouter in six easy steps

Step 1: Download the CDRouter installer

If you don’t already have the CDRouter installer, download it from our Customer Lounge.

The downloaded installer contains the entire software application and all required components.

Note: If you are installing CDRouter, the downloaded installer filename is ‘cdrouter-X.Y.exe’ where X.Y is the version (for example 4.0). Likewise, the CDRouter-Multiport installer filename is ‘cdroutermp-4.0.exe’ and the CDRouter Demo installer filename is ‘cdrouter-DEMO.exe’. The installation instructions are identical for all three variants of CDRouter (CDRouter, CDRouter-Multiport, CDRouter Demo).

Note: TCL must be installed 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?

Step 2: Make the installer executable

The installer contains binary packages for the Red Hat, Debian, Fedora, Ubuntu, and openSUSE Linux distributions. Once downloaded to your Linux host, make the installer executable:

# chmod 755 cdrouter-4.0.exe

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 will automatically install CDRouter and the correct files for your Linux distribution.

# ./cdrouter-4.0.exe

Step 4: Download the license file

License files are bound to the system ID of the Linux host PC that CDRouter is installed on. The system ID for your Linux host is displayed by the installer during the installation process, and can also be obtained by issuing the following command:

# buddy –show-system-id

If you are installing CDRouter on system that is already registered with QA Cafe, the license file for that system can be downloaded directly from our Customer Lounge. If you are installing CDRouter for the first time or if you have purchased additional licenses, you must first register the system(s) that CDrouter will be installed on with QA Cafe. You can register a system in our Customer Lounge using the system ID generated during installation. Once a system is registered, a license file which can then be downloaded and installed will be created for that system.

You can also obtain your license file by contacting support@qacafe.com. If you have additional license questions, please refer to our License FAQ

Note: You must run the installer before issuing the buddy –show-system-id command.

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 skip directly to Step 5.

Step 5: Install the license file

Install the license file by copying it to the /etc directory on your Linux host. When downloaded, the license file includes the system ID of your Linux host in the filename. The license file must first be renamed as ‘cdrouter.lic’ (for CDRouter) or ‘cdr-mp.lic’ (for CDRouter-Multiport). The license file for CDRouter Demo does not need to be renamed. The license file can then be copied or moved to the /etc directory on your Linux host:

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

Note: CDRouter will not run without a valid license file.

Step 6: Restart

Restart your Linux host and verify that your license has been applied. To verify that your license has been applied, issue the following command:

# buddy –show-system-id

You should see the following line if the license file has been installed properly: “Using license installed at: /etc/cdrouter.lic". Note that this will read “Using license installed at: /etc/cdr-mp.lic" for CDRouter-Multiport users.

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:

# buddy –update-license