Skip to content

Installing CAS Manager - Darksite Installation

In cases where CAS Manager needs to be installed in a darksite (ie, an environment where there is no internet access, also known as airgap or offline environment) you will need to download the darksite dependency files, transfer them to the target darksite machine, and then run the darksite installation script.

Legacy Scripts and Tarball Files

Before you install a new darksite version of CAS Manager, you must remove all legacy CAS Manager scripts and tarball files.

Prerequisite Steps

RHEL/Rocky Linux OS version

For CAS Manager Darksite installation, the minimum RHEL/Rocky Linux operating system version is 8.5.

Follow the prerequisite steps outlined here: CAS Manager System Requirements to prepare your target machine. It is important to read and address all the prerequisites outlined. Once you have completed these steps and prepared the target machine, return to this page and continue with the installation.

Download and Transfer Dependencies

Once you have addressed all the prerequisite steps, you need to download and transfer the dependencies files.

The combined dependencies will take up 1.8 GB approximately. You must ensure you have a media device that can transfer all required components to the target darksite virtual machine; these components can be removed from the target virtual machine once installation is complete. The required packages and dependencies to complete a darksite installation are:

  • Darksite installation bash script: A bash script that will set up and install required components as well as the CAS Manager.
  • RedHat Package Manager (RPM) dependencies: A yum repo that contains all RPM dependencies required to install CAS Manager. Only the dependencies that are missing will be installed but this package contains all system requirements.
  • CAS Manager container images: A .tar.gz file containing all CAS Manager container images required for running the CAS Manager to be loaded onto the system.

All of the packages and dependencies are bundled in a tar archive file.

1. Downloading the File

Once you have access to a virtual machine with internet access, download the darksite installation package directly as a tar.gz file from teradici.com CAS Manager product release and follow the steps below:

  • Click the Downloads and scripts button.

    Downloads and scripts

    Note: An account is required

    If you are not logged in, you will see a log in prompt instead:

    Log in to download

    You can create an account when you click this button if you do not already have one.

  • Read and accept the Teradici End User License Agreement.

  • To download the darksite package, click Download linux Under Darksite packages.

2. Transferring the File

Once you have downloaded the .tar.gz file, transfer it to the target darksite machine. For system requirements of the target virtual machine, see here.

To transfer the file you can copy it onto a media device, such as a USB drive or a DVD, and then connect that device to the target darksit machine. You can also connect the target darksite machine to another machine via SSH or FTP, and complete a network file transfer. This method may not be viable for some darksite networks.

3. Extracting the File

Once the .tar.gz file has been transferred to the target darksite machine, extract the downloaded file by running the following command:

sudo tar xzvf cas-manager-offline_Linux.tar.gz

After you extract the .tar.gz file you will get two files in the current folder:

  • cas-manager-offline-install-<version-number>.sh is the installation bash script.
  • cas-manager-offline-dep-<version-number>.tar.gz contains the RPM dependencies and CAS Manager images.

Install CAS Manager Darksite

Checking and Removing CAS Manager Repository Files

CAS Manager Darksite doesn't need to download images from online repository, this usually works as expected on a clean VM without additional step here. However, if there is repository set by the flags or repository file, the installer will try to download from what the target is set to. To avoid this you must make sure the relevant repository files are removed from the VM.

  • To check if the repository present in the system, run sudo ls -la /etc/yum.repos.d
  • If you have any repository name that start from teradici-cas-manager, you need to remove them by running sudo rm /etc/yum.repos.d/NAME_OF_THE_REPO.

To install CAS Manager, simply run the installation script. The script requirements are that the .tar.gz files are in the current directory (ie, same folder the script is in and run from) and it must be run as root user:

cd /path/to/offline/files/
sudo bash cas-manager-offline-install_<version-number>.sh

The command above will replace steps 1-3 in either the External Configuration or Default Configuration installation steps. Please follow the steps after this with the configuration you wish to use.