CDRouter Support

Preparation and Installation of the CDRouter Demo

quick-start-guide version 13.3

Welcome to the World of CDRouter!

Thank you for exploring CDRouter for your CPE testing needs! This page will help you get prepared to run CDRouter Demo in seven easy steps. Please feel free to contact us at if you have questions at any point.

1. Select a Platform

You will need to provide and configure a suitable ‘bare-metal’ system to install the CDRouter Demo software. (virtual machines are not supported)

Hardware Requirements

You will need an x86_64 platform with at least three (3) Ethernet interfaces; one interface that may be used for remote access and the other two are used for testing, connected to your CPE device or system (DUT).

CDRouter Demo may be configured to use most 802.11 a/b/g/n/ac wireless interfaces that are natively supported by the Linux kernel. If needed, you may contact for guidance on selecting an appropriate wireless interface for use with CDRouter Demo.

Software Requirements

For the best experience, we require installing the Rocky Linux 8 operating system. We suggest getting the ‘GNOME (Workstation)’ ISO image and writing the ISO to a bootable 4GB (or greater) USB drive. You can download the ‘GNOME (Workstation)’ Rocky Linux ISO file from the link below:

Rocky Linux 8 download mirror (right-click this link to have the option to open in a new tab or window)

Creating and booting from a USB drive is not covered here. There are several ways that this may be accomplished. If you have difficulty doing this task, feel free to reach out the support team for help

2. Install Rocky Linux

Booting from the USB stick will start Rocky Linux. When the Desktop appears, the option to run the Rocky Linux installation program will be displayed -

Select ‘Install to Hard Drive’ to begin the installation.

You may need to perform a few tasks, such as partitioning the hard drive, choosing a password for the root user, or adding an additional user. These tasks are left up to your discretion.

Once you’ve made the appropriate decisions, you may ‘Begin Installation’.

NOTE: Leaving all other choices with the default settings should be fine.

After installation is complete, you should reboot and remove the USB drive from your system.

3. Post Install Setup

Disable Firewalls

The CDRouter UI is browser based, so after installing Rocky Linux, it is necessary to configure the OS to disable both selinux and firewalld.

Note: all command line instructions assume that you are logged and using a terminal window from within the graphical user interface of the Rocky Linux operating system.

a) As the root user, edit the selinux config file /etc/selinux/config. Within this file change the value for SELINUX from enforcing to disabled.

# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
#     enforcing - SELinux security policy is enforced.
#     permissive - SELinux prints warnings instead of enforcing.
#     disabled - No SELinux policy is loaded.
SELINUX=disabled                                         <--------------
# SELINUXTYPE= can take one of these two values:
#     targeted - Targeted processes are protected,
#     mls - Multi Level Security protection.

b) Also as the root user, disable firewalld -

# systemctl disable firewalld

Network Interface Configuration

In order for CDRouter to use two of the interfaces for testing, other applications can not control the interfaces. Please see the page at the link below for information on the proper configuration of network interfaces within the system:

Reboot System

After these post install steps, please reboot your system to have the changes above take affect, and then continue with the next step below.

4. Log In to the CDRouter Customer Lounge

Once your CDRouter Demo request is approved, the sales team will notify you via email that your account on the CDRouter Customer Lounge has been created. Once you have received this email you will be able to log in to the CDRouter Customer Lounge using your registered email address. This is the same email address that you will use to receive unlimited technical support.

Note that the Customer Lounge utilizes passwordless authentication. When you enter your email address and click the Continue button a login link will be sent to your registered email address. You must click on the link in this email to log in to the Customer Lounge.

5. Install and Start CDRouter

Download the CDRouter Demo binary from the Customer Lounge by clicking on the software download icon on the Software Downloads tab.

To install the CDRouter Demo software, use the yum command to install the downloaded rpm from the directory it has been copied to as a user with root-level access on the system.

yum install cdrouter-demo-13.0.0-1.qacafe.x86_64.rpm

Note that the specific filename will contain the current version number of the CDRouter Demo software downloaded, and may be different than the example above.

Download the demo license from the Customer Lounge by clicking on the license download icon on the Active Licenses tab.

The downloaded license file should be placed in the /usr/cdrouter-data/etc directory on the CDRouter Demo system. Restart CDRouter to apply the license.

systemctl restart cdrouter

6. Connect to the CDRouter UI

At this point, the CDRouter UI can be accessed locally by opening a browser and entering the appropriate URL:


The system can also be accessed remotely using the management IP of the system:


If you are having trouble getting to this page, you can try restarting the CDRouter software:

systemctl restart cdrouter

Next Step (Using CDRouter Demo)

Once your CDRouter Demo system is up and running, you are ready to begin to start testing. Follow the link below to our Knowledge Base article which will guide you on how to run your first test:

Additional Help and Resources

We want you to be successful using CDRouter, so please don’t hesitate to contact the CDRouter Support Team at if you have any questions or concerns.

Thank you and happy testing!



About CDRouter

QA Cafe CDRouter is a comprehensive and powerful test automation solution focused on feature, security, and performance testing for broadband and enterprise edge gateways, Wi-Fi and mesh systems, and other CPE.

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