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 five easy steps. Please feel free to contact us at firstname.lastname@example.org if you have questions at any point.
1. Selecting 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. Installing 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
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 your 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. Install a CDRouter License File
A link to download a demo license, valid for 30 days, will be provided in an email from email@example.com.
The license file (cdr-DEMO.lic) should be placed in the
/etc directory, on
the system you installed the CDRouter Demo software.
4. Install and Start CDRouter
A link to download the CDRouter Demo version will be provided in an email from firstname.lastname@example.org.
The downloaded CDRouter Demo file should be an executable binary (If it is not, the first command below will make it executable). To install the CDRouter Demo software, just run the downloaded binary as the root user, in the directory you copied it to, on your system.
# chmod 755 cdrouter-demo_11.0.1-1_x86_64.bin # ./cdrouter-demo_11.0.1-1_x86_64.bin
(Your specific filename will contain the current version number of the CDRouter Demo software)
After installation is complete, CDRouter will automatically start (assuming the license file was installed properly)
5. Connect to the CDRouter UI
At this point, you can access the CDRouter UI by opening a browser and entering the appropriate URL:
or, if you access your system remotely, determine the IP address of the management interface.
If you are having trouble getting to this page, you can try restarting the CDRouter software:
service cdrouter restart
Next Step (Using CDRouter Demo)
Once your CDRouter Demo system is up and running, you are ready to begin using the software. 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 email@example.com the CDRouter Support Team if you have any questions or concerns.
Thank you and happy testing!