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 seven easy steps. Please feel free to contact us at firstname.lastname@example.org 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)
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 email@example.com for guidance on selecting an appropriate wireless interface for use with CDRouter Demo.
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 firstname.lastname@example.org.
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.
3. Post Install Setup
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:
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 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
directory on the CDRouter Demo system.
6. 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-12.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.
After installation is complete, the CDRouter Demo software will automatically start.
7. 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 email@example.com if you have any questions or concerns.
Thank you and happy testing!