CDRouter Support

Preparation and Installation of the CDRouter Demo

quick-start-guide version 11.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 in six easy steps. Please feel free to contact us at support@qacafe.com 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 support@qacafe.com for guidance on selecting an appropriate wireless interface for use with CDRouter Demo.

Software Requirements

For the best experience, we require installing the CentOS 7 operating system. We suggest downloading the ‘Everything’ ISO image and writing the ISO to a bootable 16GB (or greater) USB stick. You can retreive the ‘Everything’ CentOS ISO file from one of the mirrors at the link below:

Current CentOS 7 download mirrors (right-click this link to have the option to open in a new tab or window)

Creating and booting from a USB stick 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 support@qacafe.com.

2. Install CentOS

Booting from the USB stick will start the CentOS installation program.

During the CentOS installation wizard, you will have a chance to select additional software. We strongly recommend selecting GNOME Desktop on the Software Selection page. This will install additonal software packages that are used by the CDRouter Demo and it will provide a Desktop GUI to navigate around the system more easily.

Select SOFTWARE SELECTION

Select the ‘GNOME Desktop’ radio button as the ‘Base Environment’-

Verify that ‘GNOME Desktop’ is selected as the SOFTWARE SELECTION -

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

Post Install Setup

Disable Firewalls

The CDRouter UI is browser based, so after installing CentOS, 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 CentOS 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.
SELINUXTYPE=targeted

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.

3. 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.

4. Install the CDRouter License File

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

The downloaded license file (cdr-DEMO.lic) should be placed in the /etc directory on the CDRouter Demo system.

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.

The downloaded CDRouter Demo binary should be an executable installer (if it is not, the first command below will make it executable). To install the CDRouter Demo software, run the downloaded binary from the directory it has been copied to as a user with root-level access on the system.

# chmod 755 cdrouter-demo_11.2.1-1_x86_64.bin 

# ./cdrouter-demo_11.2.1-1_x86_64.bin

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.

After installation is complete, the CDRouter Demo software will automatically start.

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:

https://localhost/

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

https://<CDRouter-Management-IP>/

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 support@qacafe.com if you have any questions or concerns.

Thank you and happy testing!

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: