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,
  • 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 Internet-connected Machine

  1. Run the following command to prepare a Darksite Trust Center bundle for upgrade:

    sudo ./trust-center-ctl prepare upgrade
    

    Example output of running TC Prepare command:

    TC preparation output

  2. Transfer the following files to the bare VM using the SCP command:

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

Step III: Preparing 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
23.12 24.03
24.03 24.07
24.07 24.10
24.10 25.03

Step IV: 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

  2. (Upgrading from 24.10 to 25.03 only) Set the enableSync variable to "True". This is necessary for trust-center-ctl to connect to Cloudsmith.

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

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

    3. Set enableSync to "True", and save your changes.

Logs

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

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