Overview
This guide provides instructions for installing CDRouter. These instructions can be used to upgrade, downgrade, or install a specific release of CDRouter on a new or existing system.
Three installation methods are discussed in this guide:
- Automatic installation using the web interface
- Manual installation using the web interface
- Manual installation using the command line
This guide does not cover the CDRouter Demo. Installation instructions for the CDRouter Demo can be found here: Preparation and Installation of the CDRouter Demo.
Note that an active and valid license file is also needed in order to use CDRouter. Please see this guide for information on installing or updating a CDRouter license file.
Please feel free to contact support@qacafe.com for assistance with any of the instructions provided in this guide.
Automatic installation using the web interface
On CDRouter systems with an active internet connection, a notification banner will be displayed within the main header of the CDRouter web interface whenever a new release is available.
Clicking on the link in the notification banner will open the System > Upgrade page. Enter your email address and click the Check for Updates… button. If a newer release of CDRouter is available, follow the instructions provided on the page to automatically download and install it. This is the easiest and fastest way to upgrade a CDRouter system to the latest release.
Note: you must be running CDRouter 11.8.2 or greater in order to use this installation method. If you are running an earlier version of CDRouter, you must use the Manual installation using the command line method at the end of this document.
Manual installation using the web interface
On CDRouter systems without an active internet connection, or to upgrade or downgrade to a specific release of CDRouter, the drag and drop feature within the web interface may be used.
To utilize this feature, download the appropriate CDRouter rpm or binary from the Software Downloads section of the Customer Lounge.
Note that CDRouter installation files are named using the convention
cdrouter_X.Y.Z-1_x86_64.bin or cdrouter-X.Y.Z-1.qacafe.x86_64.rpm (where
X.Y.Z indicates the release number). Note that CDRouter 12.0 and subsequent
releases are distributed as rpm files; earlier releases are distributed as
binary files.
From the System > Upgrade page within CDRouter’s web interface, the downloaded installer can be installed using drag and drop in Manual Upgrade section.
Note: you must be running CDRouter 11.8.2 or greater in order to use this installation method with rpm files. If you are running an earlier version of CDRouter, you must use the “Manual installation using the command line” method below.
Manual installation using the command line
Specific releases of CDRouter can be installed manually from the command line as a user with root-level permissions.
To perform a manual installation via the command line, download the appropriate CDRouter rpm or binary from the Software Downloads section of the Customer Lounge.
Note that CDRouter installation files are named using the convention
cdrouter_X.Y.Z-1_x86_64.bin or cdrouter-X.Y.Z-1.qacafe.x86_64.rpm (where
X.Y.Z indicates the release number). Note that CDRouter 12.0 and subsequent
releases are distributed as rpm files; earlier releases are distributed as
binary files.
The instructions for manually installing CDRouter using the command line vary based on the installer file type (.rpm or .bin) and the type of installation (upgrade, downgrade, reinstall).
Note that additional dependencies may be required when installing CDRouter using rpm files. If the system is online these dependencies will be installed automatically by the package manager. If the system is offline, we recommend temporarily putting it online during the installation process so that the necessary dependencies can be installed.
Please copy the downloaded installer to the system and select the appropriate set of instructions below to complete the manual installation.
Install or upgrade to a newer release using rpm files (.rpm)
If the system is online, install or upgrade CDRouter using this command:
yum clean all
yum install cdrouter-12.0.0-1.qacafe.x86_64.rpm
Downgrade to an older release using rpm files (.rpm)
If the system is online, downgrade CDRouter using this command:
yum clean all
yum downgrade cdrouter-12.0.0-1.qacafe.x86_64.rpm
Reinstall the same release using rpm files (.rpm)
If the system is online, reinstall CDRouter using this command:
yum clean all
yum reinstall cdrouter-12.0.0-1.qacafe.x86_64.rpm
Upgrading, downgrading, or reinstalling using binary files (.bin)
Make the binary executable using this command:
$ chmod 755 cdrouter_11.2.1-1_x86_64.bin
Upgrade, downgrade, or reinstall CDRouter using this command:
$ ./cdrouter_11.2.1-1_x86_64.bin
