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.
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.gzfile 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.
Note: An account is required
If you are not logged in, you will see a log in prompt instead:
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¶
.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
Change drive on the command prompt into the new folder. You can see two files, one is the dependency tarball file and the other is the install bash script file.
4. 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.
Run the following command for the installation:
This installs the CAS Manager and all the other dependencies.