Release Notes

Anyware Trust Center 23.04

All release notes for Anyware Trust Center Documentation and Downloads for Anyware Trust Center

This is a private beta release of the Anyware Trust Center. Availability of this release is by invitation; contact us for more information.

Deploying the Anyware Trust Center

These instructions will guide you through creating a VM, downloading the installer, and deploying an Anyware Trust Center on a single machine.

Deploy a VM

First, create a new VM that will host the Anyware Trust Center.

The Trust Center requires:

RHEL 8 or Rocky Linux 8
8 vCPUs
32GB RAM
120GB+, with 80GB +free disk space available on /var
IP network accessible by your endpoints, with DNS configured as described next. The Anyware Trust Center does not support connections via raw IP addresses.

Choose an FQDN

The Trust Center requires a FQDN for connections. You'll use this value in multiple locations during setup, so record the value and be ready to copy it.

Create DNS Records

Once the machine is up, create the following DNS A records that point to it. In each of these entries, <domain> is the FQDN you chose in the previous step.

trust-center.<domain>
endpoint-connector.<domain>
ota.<domain>
register.<domain>

In addition, if you wish to support automatic Trust Center discovery by endpoints, you will need to create a CNAME record redirecting "anywaretrustcenter" to "register.<domain>"

Download and Install the Anyware Trust Center

To install the Anyware Trust Center, you must have an account on our support site (https://help.teradici.com). You can create one from the login screen if you don't already have one.

To download the installer:

Go to https://docs.teradici.com/find/product/anyware-trusted-endpoints/2023.04/anyware-trust-center.
If you are not already logged in, click Log in to download to log in.
Click on .
Accept the license agreement:
Paste in your FQDN, recorded earlier, in the Trust Center Hostname (FQDN) field, and click Get installation script:

Note: You can leave the FQDN field blank; if you do, the installation command will still be generated, but you will have to manually replace the placeholder value with the actual FQDN before executing it.
Copy the entire command displayed next. There are two parts, and both are required: a curl command that downloads the installation script, and another command that executes it.

A valid Trust Center download link will look like this:
```
curl -sSL https://dl.teradici.com/{token}/trust-center/raw/names/trust-center-tgz/versions/23.04.0/trust-center_23.04.0.tar.gz | tar -xz && sudo ./trust-center-ctl install --fqdn {trust-center-FQDN} --token {jwt token}
```
Copy the entire link, which will be used on the Trust Center VM when it is set up.

Important: The generated command is valid for 2 hours, after which installation will fail. If that occurs, return to the download page and generate a new command.

When executed, the command will do the following:
- Downloads the installer executable in an archive format
- Unzips the installer
- Runs the installer as a root user, passing in 2 required flags:
  - fqdn - the value must be a valid fully qualified domain name, and should point to the location where the Trust Center is installed.
  - token - this value is provided by support, and should not be modified. It is also only valid for 2 hours.

Installing the Anyware Trust Center

On the Trust Center machine, navigate to a working directory. You can create a new one or use an existing one to install the Trust Center.
Navigate to your working directory using a terminal window (command line).
Paste the download link you copied previously into the terminal window and press Enter to execute it.

The installation will take up to 15 minutes to complete; there will be periods of time where the process stops printing messages to the terminal and may appear to hang. This is normal.

After Installing

Once installation is complete, you can set up your Management Console to interact and manage Trusted Zero Clients through your Trust Center.

Refer to the API documentation installed with the Trust Center for complete details.

Note: the administrator password is now automatically generated by the Trust Center installer, and has the ability to create service account keys. The Trust Center API documentation does not show this yet. The generated password is placed in a file in your installation working directory:

<current folder>/config.yaml

global:
  images:
    registry: "docker.cloudsmith.io/teradici/trust-center"
    username: "teradici/trust-center"
    password: <repository password>
  tc:
    domain: <your domain>
    password: <this is the auto-generated password>
    endpointUpdate: 
      accessKey: <repository password>
      repository: "teradici/trusted-zero-client"

Upgrading to a New Version

To upgrade the current running installation of the Trust Center, obtain a newer download link from the website. Make sure the package version is newer than your installed version. Download links look like this:

curl -sSL https://dl.teradici.com/{a token}/trust-center/raw/names/trust-center-tgz/versions/23.04.1/trust-center_23.04.1.tar.gz

In this example, the command will download version 23.04.1 of the Trust Center.

Then:

Download the new package to the same installation directory you used for your original installation.
Open a terminal window and navigate to your installation directory
Run the following command:
```
./trust-center-ctl upgrade
```

Troubleshooting

Support Bundle

If you encounter problems while running the Anyware Trust Center, you can generate a support bundle to help us diagnose and troubleshoot the issue. Support bundles capture the state of the Trust Center and related services and log files.

To generate a support bundle:

Open a terminal window and navigate to your Trust Center installation directory.
Run the following command:
```
sudo ./trust-center-ctl diagnose --support-bundle
```
The support bundler will generate an archive and place it in your working directory.
Provide this generated support bundle to our support team.