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 email@example.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)
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 firstname.lastname@example.org for guidance on selecting an appropriate wireless interface for use with CDRouter Demo.
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 email@example.com.
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
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. 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 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
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 firstname.lastname@example.org if you have any questions or concerns.
Thank you and happy testing!