Configuring the Trilio Controller Cluster

The Trilio Appliance requires configuration to work with the chosen RHV environment. A Web-UI provides access to the Trilio Appliance dashboard and configurator.

Recommended and tested browsers are Google Chrome, Microsoft Edge, and Mozilla Firefox.

Setup the local host file

To access the Trilio Dashboard after a fresh deployment it is required to setup a local DNS entry. This is required as Kubernetes is working using FQDNs instead of IPs.

The following entry needs to be done in the hostfile of the local system:

<Ingress-IP> tvault.com

Accessing the Trilio Dashboard

Enter the Trilio IP or FQDN into the browser to reach the Trilio Appliance landing page.

User: admin Password: password

You will be prompted to change the Web-UI password on first login.

After the password has been changed you will be logged out and have to login using the new password.

Details needed for the Trilio Appliance configurator

Upon login into the Trilio Appliance, the shown page is the configurator. The configurator requires some information about the Trilio Appliance, RHV and Backup Storage.

Trilio Nodes information

The Trilio Appliance needs to be integrated into an existing environment to be able to operate correctly. This block asks for information about the Trilio Appliance operating details.

  • Name Servers

    • The DNS server the Trilio appliance will use.

    • Format: Comma separated list of IPs

    • Example: 8.8.8.8,10.10.10.10

  • Domain Search Order

    • The domain the Trilio Appliance will use.

    • Format: Comma separated list of domain names

    • Example: trilio.demo,trilio.io

  • NTP Servers

    • NTP Servers the Trilio Appliance will use.

    • Format: Comma separated list of NTP Servers (FQDN and IP supported)

    • Example: 0.pool.ntp.org,10.10.10.10

  • Timezone

    • Timezone the Trilio will use.

    • Format: predefined list

    • Example: UTC

RHV Credentials information

The Trilio appliance integrates with one RHV environment. This block asks for the information required to access and connect with the RHV Cluster.

  • RHV Engine URL

    • URL of the RHV-Manager used to authenticate

    • Format: URL (FQDN and IP supported)

    • Example: https://rhv-manager.trilio.demo

A preconfigured DNS Server is required, when using FQDN. The TrilioVault Appliance local host file gets overwritten during configuration. The configuration will fail when the FQDN is not resolvable by a DNS Server.

  • RHV Username

    • admin-user to authenticate against the RHV-Manager

    • Format: user@domain

    • Example: admin@internal

  • Password

    • The password to validate the RHV Username against the RHV-Manager

    • Format: String

    • Example: password

TheInvalid Credentials error message will be displayed when the TrilioVault Appliance cannot reach the RHV Manager or credentials given are incorrect.

Backup Storage Configuration information

This block asks for the necessary details to configure the Backup Storage.

  • Backup Storage

    • NFS or S3

In the case of NFS

  • NFS Export

    • Full path to the NFS Volume used as Backup Storage

    • Format: Comma separated list of NFS paths

    • Example: 10.10.100.20:/rhv_backup

  • NFS Options

    • Options used by the Trilio NFS client to connect to the NFS Volume

    • Format: NFS Options

    • Example: nolock,soft,timeo=180,intr

    Note:- Make sure the NFS server supports the NFSv3 as Trilio Mounts the NFS share explicitly with NFSv3

In the case of S3

  • Amazon or Ceph or Local Ceph

    • Amazon expects to connect to AWS services

    • Ceph allows connecting to any S3 bucket that is either not using SSL or a trusted SSL certificate

    • Local Ceph allows connecting to any S3 that is either not using SSL or a self-signed certificate

  • [Ceph and Local Ceph only] Use SSL

    • Activate when the S3 endpoint is secured

  • Access Key

    • Access Key necessary to login into the S3 storage

    • format: access key

    • example: SFHSAFHPFFSVVBSVBSZRF

  • Secret Key

    • Secret Key necessary to login into the S3 storage

    • format: secret key

    • example: bfAEURFGHsnvd3435BdfeF

  • Region

    • Configured Region for the S3 Bucket

      • use us-east-1 for Ceph and Local Ceph

    • format: String

    • example: us-east-1

  • [Ceph and Local Ceph only] Endpoint URL

    • URL to be used to reach and access the provided S3 compatible storage

    • format: URL

    • example: https://objects.trilio.io

  • Bucket Name

    • Name of the bucket to be used as Backup target

    • format: string

    • example: Trilio-backup

  • [Local Ceph with active SSL only] Cert

    • Upload area for the certificate to be used when connecting with the S3 storage

    • format: certificate

Trilio Certificate information

Trilio is integrating into the RHV Cluster as an additional service, following the RHV communication paradigms. These require that the Trilio Appliance is using SSL and that the RHV-Manager does trust the Trilio Appliance.

Trilio offers to possibilities how these required certificates can be provided. Either Trilio generates a complete fresh self-signed certificate or a certificate is provided.

In both cases is the FQDN required, to which the certificate is pointing to.

Please see below example in case of a provided certificate.

  • FQDN

    • FQDN to reach the TrilioVault Appliance

    • Format: FQDN

    • Example: rhv-tvm.trilio.demo

  • Certificate

    • Certificate provided by the TrilioVault appliance upon request

    • Format: Certificate file

    • Example: rhv-tvm.crt

  • Private Key

    • Private Key used to verify the provided certificate

    • Format: private key file

    • Example: rhv-tvm.key

Trilio License

It is possible to directly provide the Trilio Appliance with the license file that is going to be used by it.

Trilio will not create any workloads or backups without a valid license file.

It is not necessary to provide the License file directly through the configurator. It is also possible to provide the license afterwards through the Trilio License tab in the Trilio dashboard.

The Trilio License tab can also be used to verify and update the currently installed license.

Submit and Configuration

After filling out every block of the configurator, hit the submit button to start the configuration.

The configurator asks one more time for confirmation before starting.

While the configurator is running the live output from the ansible playbooks is shown. Some of the tasks can take multiple minutes until they are finished without an update to the output.

Wait until the configurator has either finished or failed.

Update or delete the local DNS entry

Once the Trilio Controller Cluster is successfully configured the FQDN will have been changed to the one used for production.

It is recommended to delete the setup localhost entry and use a full-fledged DNS entry in a DNS server now.

Last updated