Skip to content

Upgrading the Darksite Trust Center

Upgrading Darksite Trust Center is similar to upgrading an internet-connected Trust Center. However, since there is no internet access within a Darksite, you must do the following:

  • Prepare the Trust Center installation bundle, on an internet-connected VM. See Requirements for more information.
  • Run the prepare command on an internet-connected machine with necessary content to perform the upgrade,
  • Upgrade an existing Darksite Trust Center, and
  • Upload OTA packages on a Darksite Trust Center.

Step I: Updating the Trust Center config.yaml File

Previously, Darksite bundles were downloaded from dl.anyware.hp.com and required multiple IP addresses to be allowlisted. Darksite bundles are now available through the prod.onboarding.hydra.teradici.com subdomain, and requires only the following two US-based IP addresses:

  • 166.117.189.248
  • 166.117.55.125

Before upgrading, you must update the download domain in your existing Trust Center Darksite installation's config.yaml file to this new domain.

  1. Go to the folder where Trust Center is installed.

  2. Open the config.yaml in a text editor.

  3. Replace the docker.cloudsmith.io domain with docker.prod.onboarding.hydra.teradici.com.

  4. Save your changes.

Step II: Prepare the Trust Center Bundle

You can use an internet-connected machine to prepare for a darksite installation. Before you begin, you must prepare an installation bundle as described in Bundler System Requirements.

Info

The version upgrade compatibilities follow the same guidelines as an internet-connected Trust Center install. Only attempt to upgrade a Trust Center by one major release, for which the Anyware team currently provides support. The upgrade compatibility process will be revised in the future, removing the need for incremental upgrades.

Current Trust Center Version Allowed Upgrade Trust Center Version
24.03 24.07
24.07 24.10
24.10 25.03
25.03 25.06

To prepare the Trust Center Bundle

  1. Go to the download website.

  2. If you are not already logged in, click Log in to download and authenticate your session.

  3. Click Downloads and scripts.

  4. Read and accept the End-User License Agreement. Once the agreement has been accepted, the download form is shown:

    Download upgrade script

  5. Provide your chosen FQDN—recorded earlier—in the Trust Center Hostname (FQDN) field, and click Get installation script.

    Note: FQDN field is optional

    The FQDN value is required to run the installer, but you do not have to supply it here. If you leave this field blank, you must manually add the actual FQDN to the script command before executing it.

  6. Under Upgrade Anyware Trust Center, copy the entire command displayed. There are two parts, and both are required: a curl command that downloads the installation script, and second command that executes the script.

    Important: This script is time-limited

    The generated command is valid for 1 hour. If the token expires before you run it, return to the download page and generate a new command. **The time limit applies to running the _prepare_ command, not installing the package**. Once you have successfully generated the installation bundle, you can install the package at any time.

  7. Paste the command copied earlier and run it to prepare a Trust Center Darksite bundle for upgrade.

    Example output of running TC Prepare command:

    TC preparation output

  8. Transfer the following files to the Darksite VM using USB mass storage, DVD or other medium:

    • anyware-trust-center-bundle.tar.gz
    • anyware-trust-center-bundle.sha
    • trust-center-ctl

Step III: Upgrade Trust Center

  1. To upgrade an existing Darksite Trust Center, run the following command on the Darksite machine:

    sudo ./trust-center-ctl upgrade darksite

    Example output of running a Darksite Upgrade command:

    TC upgrade output

Step IV: After Upgrade

To upgrade Trusted Zero Clients, refer to Darksite Firmware Updates.

Logs

The following table lists the logs and the locations where they are available.

Location Description
/var/log/teradici/trust-center-ctl/install_<timestamp>.log Trust Center log for internet-connected or Darksite installation.
/var/log/teradici/trust-center-ctl/upgrade_<timestamp>.log Trust Center log for internet-connected or Darksite upgrade.
/var/log/teradici/trust-center-ctl/prepare_<timestamp>.log Prepare log for installation or upgrade of Darksite Trust Center.