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: 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 II: 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 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

  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.