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.
-
Go to the folder where Trust Center is installed.
-
Open the
config.yaml
in a text editor. -
Replace the
docker.cloudsmith.io
domain withdocker.prod.onboarding.hydra.teradici.com
. -
Save your changes.
Step II: Prepare the Internet-connected Machine¶
-
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:
-
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¶
-
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:
-
(Upgrading from 24.10 to 25.03 only) Set the
enableSync
variable to "True". This is necessary fortrust-center-ctl
to connect to Cloudsmith.-
Go to the directory where Trust Center is installed.
-
Open the config.yaml file in a text editor.
-
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_ |
Trust Center log for internet-connected or Darksite installation. |
/var/log/teradici/trust-center-ctl/upgrade_ |
Trust Center log for internet-connected or Darksite upgrade. |
/var/log/teradici/trust-center-ctl/prepare_ |
Prepare log for installation or upgrade of Darksite Trust Center. |