Skip to content

Installing Anyware Manager - Darksite Installation

In cases where Anyware 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 must 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 Anyware Manager, you must remove all legacy Anyware Manager scripts and tarball files.

RHEL/Rocky Linux OS version

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

Before you begin

Follow the prerequisite steps in the Anyware Manager System Requirements section 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 takes 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 follow the steps below:

  1. To download the Anyware Manager installation package, select the Downloads and scripts option from the Anyware Manager support site.

    Alt text

    If you see a login button instead, click it to log into the site and then proceed.

  2. Read and accept the HP End User License Agreement.

  3. 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.

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

Run the following command to extract the downloaded .tar.gz file on the target darksite machine:

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. 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 ./install.sh

Enter Admin Password

After executing this command, please enter the admin password for Anyware Manager When prompted.

This installs the Anyware Manager and all the other dependencies.

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

Installation Errors

The Darksite installation could fails due to a package conflicting or checksum error if there is an existing package already present on the target machine. To resolve this, you need to delete the conflicting package and re-run the installation script.

5. Upgrading Anyware Manager to version 23.01 and later (Optional)

If you have Anyware Manager 22.09 installed then upgrading to Anyware Manager 23.01 and later, requires you to perform a series of additional steps. They are as follows:

  1. Perform all actions in step 1 to step 4 mentioned above.

    Installation Warning Message

    After performing step 4, the system displayed a warning message that says An instance of Anyware Manager is installed or previous data is still on disk, if you would like to upgrade you need to run the upgrade command instead, but if you would like to remove and install a new instance you will need to pass --clear to the install command.

  2. To complete the installation process, run the anyware-manager upgrade command.

The upgrade and install is now successful.