Skip to content

Upgrading Anyware Manager (Darksite Upgrade)

In cases where Anyware Manager needs to be updated 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 upgrade to a new darksite version of Anyware Manager, you must remove all legacy Anyware Manager scripts and tarball files.

Prerequisite Steps

Follow the prerequisite steps outlined here: Anyware 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.

RHEL/Rocky Linux OS version

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

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 2.2 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 Anyware Manager.
  • RedHat Package Manager (RPM) dependencies: A yum repo that contains all RPM dependencies required to install Anyware Manager. Only the dependencies that are missing will be installed but this package contains all system requirements.
  • Anyware Manager container images: A .tar.gz file containing all Anyware Manager container images required for running the Anyware 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 Anyware 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 anyware-manager-offline_Linux.tar.gz

That creates a new folder called anyware-manager-offline_VERSION_linux.

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. Upgrade using Anyware Manager Darksite

4. a. Upgrade from CAS Manager to Anyware Manager

Updating from CAS Manager to Anyware Manager

This step is only required when updating from an older CAS Manager version to a new Anyware Manager version. You can skip this step if it does not match your use case.

  1. Unpack the anyware-manager-offline-deps.tar.gz by running the following command in order to run the transitional commands:
$ sudo tar zxvf anyware-manager-offline-deps.tar.gz
  1. Run the installation of the transition CAS Manager in the following order:
$ sudo dnf install -y anyware-manager/cas-manager-k3s.rpm 
$ sudo dnf install -y anyware-manager/cas-manager-selinux.rpm 
$ sudo dnf install -y anyware-manager/cas-manager.rpm

4. b. Install Anyware Manager Darksite

Checking and Removing Anyware Manager Repository Files

Anyware 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-anyware-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:

sudo ./

This installs the Anyware Manager and all the other dependencies.

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.