Overview
This guide provides instructions for installing CDRouter. These instructions may 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 UI 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
Specific releases of CDRouter, including engineering releases, may be installed manually using the drag and drop feature located on the System > Upgrade page within the web UI.
To utilize this feature, download the appropriate CDRouter rpm from the Software Downloads section of the QA Cafe Customer Lounge. Then drag and drop the rpm file onto the target in the Manual Upgrade section of System > Upgrade page.
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).
Manual installation using the command line
Specific releases of CDRouter may also 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 the Software Downloads section of the QA Cafe 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).
The instructions for manually installing CDRouter using the command line vary based on the type of installation (upgrade, downgrade, reinstall, offline).
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 may be installed.
Please copy the CDRouter rpm to the system and select the appropriate set of instructions below to complete the installation.
Install or upgrade to a newer release using rpm files
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
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
If the system is online, reinstall CDRouter using this command:
yum clean all
yum reinstall cdrouter-12.0.0-1.qacafe.x86_64.rpm
Install or upgrade to a newer release using rpm files (offline)
If the system is offline, install or upgrade CDRouter using this command
yum clean all
yum install -C cdrouter-12.0.0-1.qacafe.x86_64.rpm