Skip to content

Installing the License Server in an Offline Environment

Offline Environments

The method you will use to install the HP Anyware License Server in an offline environment depends on whether you can open a temporary internet connection to the License Server machine.

Important: Migrating from RHEL 7 to RHEL 8

If you have currently deployed a HP Anyware License Server on RHEL 7 and wish to upgrade to RHEL 8, do not upgrade the operating system in place. Updating the operating system could invalidate your licenses. See Migrating from RHEL 7 to RHEL 8 for a supported migration path.

Caution: Do not install more than one type of license server on the same machine

The HP Anyware License Server version 24.03 cannot be installed on the same machine as the HP Anyware License Server 1.x or an NVIDIA GRID License Server.

Before you Begin

Before you begin installing, read the password rules.

Note: Default password

The default password in new installations is 1P@ssw0rd!, where the leading 1 is a numeral one and 0 is a zero. When setting the password on a clean installation, use this as your curent password. Change the default password immediately. Until the default password is changed, commands can be issued to the license server without your knowledge.

Installing With a Temporary Internet Connection

  1. Open the internet connection on the License Server machine.

  2. SSH into your License Server machine.

  3. For RHEL/CentOS 7, install wget and yum-utils (skip this step for RHEL/Rocky Linux 8):

    sudo yum install wget
    sudo yum install yum-utils
    
  4. Install the pcoip-license-server repository, using the shell script available here. The script will discover your operating system and configure the repo appropriately.

  5. Install Java:

    • For RHEL/CentOS 7:
      sudo yum install java-11-openjdk
      
    • For RHEL/Rocky Linux 8:
      sudo dnf install java-11-openjdk
      sudo dnf install tzdata-java
      
  6. Install the license server:

    • For RHEL/CentOS 7:
      sudo yum install -y pcoip-license-server
      
    • For RHEL/Rocky Linux 8:
      sudo dnf install -y pcoip-license-server
      
  7. Wait for the HP Anyware License Server to start (about 30-60 seconds).

  8. Verify that the HP Anyware License Server is running by using the following command:

    sudo systemctl status flexnetls-TERADICI
    
  9. Set your HP Anyware License Server administrative password:

    sudo pcoip-set-password
    

    You will be prompted for the old and new passwords.

  10. Remove the internet connection.

  11. If you need to change the HP Anyware License Server's listening port, see Configuring the License Server's Listening Port.

The HP Anyware License Server starts automatically when it is installed.

Installing With No Internet Connection

If you cannot open an internet connection on the License Server machine, you must create a temporary machine to download the License Server software and its dependencies and then manually transfer and install them.

  1. Create a disposable internet-connected RHEL (or CentOS) machine for downloading and inspecting packages. This machine should be identical to the license server machine.

  2. SSH into the new temporary machine.

  3. Install the Teradici repository by running the shell script available here. The script will discover your operating system and configure the repo appropriately.

  4. Create a new directory to hold the downloaded package manager files. In the following examples, we are creating folders in your user home directory (~/).

    cd ~/
    
    mkdir ./rpms/
    mkdir ./updates/
    
  5. Download the required updates to the new /updates/ folder:

    • RHEL/CentOS 7
    sudo yum update -y --downloadonly --downloaddir=./updates
    
    • RHEL/Rocky Linux 8
    sudo dnf update -y --downloadonly --downloaddir=./updates
    
  6. Install the dependencies from the /updates/ folder:

    • RHEL/Rocky Linux 8.7

      cd ~/updates/
      sudo dnf install --disablerepo="*" -y *
      
      cd ~
      
  7. Download the RPM packages to the new /rpms/ folder:

    • RHEL/CentOS 7
    sudo yum install --downloadonly --downloaddir=./rpms pcoip-license-server -y
    
    • RHEL/Rocky Linux 8
    sudo dnf install --downloadonly --downloaddir=./rpms pcoip-license-server -y
    cd ~
    sudo dnf install --downloadonly --downloaddir=./rpms tzdata-java -y
    
  8. Transfer the RPMs directory containing the packages to your license server machine using any acceptable method, such as a USB flash drive.

    The temporary machine is no longer needed

    The temporary machine can be safely destroyed at this point.

  9. Connect to the license server machine using a console.

  10. Install the updates from the updates/ directory you transferred earlier. The following example assumes the updates/ directory is in the user home directory; if you put it somewhere else, modify these instructions accordingly:

    • RHEL/CentOS 7
    cd ~/updates/
    sudo yum install --disablerepo="*" -y *
    
    • RHEL/Rocky Linux 8
    cd ~/updates/
    sudo dnf install --disablerepo="*" -y *
    
  11. Install the HP Anyware License Server from the rpms/ directory you transferred earlier. The following example assumes the rpms/ directory is in the user home directory:

    • RHEL/CentOS 7
    cd ~/rpms/
    sudo yum install --disablerepo="*" -y *
    
    • RHEL/Rocky Linux 8
    cd ~/rpms/
    sudo dnf install --disablerepo="*" -y *
    

    Note: Time Required for Installation

    When installing the HP Anyware License Server offline, installation times of up to 10 minutes are possible. This is expected behavior.

  12. Set your HP Anyware License Server administrative password:

    sudo pcoip-set-password
    
    You will be prompted for the old and new passwords.

  13. If you need to change the HP Anyware License Server's listening port, see Configuring the License Server's Listening Port.

The HP Anyware License Server starts automatically when it is installed.

Do not modify the trusted storage database

The HP Anyware License Server installs a trusted storage database in /var/opt/flexnetls/TERADICI.

If the contents of this directory are moved or modified, the license server will consider the trusted storage corrupted. The server will log an error and refuse to start.