Upgrading the Anyware Trust Center on a Darksite¶

This topic provides detailed information for performing an upgrade on a Trust Center Darksite.

Upgrading on Trust Center Darksite is similar to upgrading on 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 Trust Center Darksite, and
Upload OTA packages to a Trust Center Darksite.

Step I: Preparing a Trust Center Bundle¶

You can use the same internet-connected machine to prepare the original Darksite install. Before you begin, you must prepare an installation bundle as described in Bundler System Requirements.

Note: Upgrade compatibility

The version upgrade compatibilities follow the same guidelines as a normal Trust Center install. Only attempt to upgrade a Trust Center by one major release, for which the Anyware team currently provides support.

Current Trust Center Version	Allowed Upgrade Trust Center Version
23.12	24.03
24.03	24.07
24.07	24.10

Step II: Prepare the Internet-connected Machine¶

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

trust-center-ctl prepare upgrade

Example output of running TC Prepare command:

Step III: Upgrade Trust Center¶

To upgrade an existing Trust Center Darksite, run the following command:

trust-center-ctl upgrade darksite

Example output of running TC Upgrade Darksite command:

Step IV: Upload OTA packages to Trust Center Darksite¶

Since Trust Center Darksite cannot access external internet, OTA updates cannot be retrieved automatically. To manage the firmware available within Trust Center, use the trust-centre-ctl as follows:

Run this command to list available firmware in the Trust Center Darksite:

sudo ./trust-center-ctl firmware list --token {token}
Run the following command to download firmware:

sudo ./trust-center-ctl firmware download --token {token} <names of releases to download e.g. "24.10.0">
Copy tc_firmware.tar.gz to the Trust Center server.
Run the following command to upload firmware (use ---help to see available flags):

sudo ./trust-center-ctl firmware upload --file tc_firmware.tar.gz --ca-file <Path to the CA certificate file for the Trust Center Management API>

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 installation or TC prepare log file
/var/log/teradici/trust-center-ctl/upgrade_<timestamp>.log	Trust Center upgrade or TC prepare log file
/var/log/teradici/trust-center-ctl/darksite_<timestamp>.log	Trust Center Darksite install or upgrade Darksite log file