# Configure Trilio VM

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

{% hint style="info" %}
Recommended and tested browsers are: Chrome and Firefox.
{% endhint %}

## Accessing the Trilio Dashboard

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

**User**: admin\
**Password**: password

{% hint style="info" %}
You will be prompted to change the Web-UI password on first login.
{% endhint %}

## 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 the information about the Trilio Appliance operating details.

* **Virtual IP Address**
  * The Trilio Appliance uses this IP address for all communication with RHV.
  * Format: IP/Netmask
  * Example: 10.10.0.2/24

{% hint style="warning" %}
The Trilio Appliance for RHV does not yet support multi-node installations. It is an actively worked on feature, that gets integrated step by step.
{% endhint %}

* **TVM Appliance IP**
  * The first interface in the interface list of the Trilio Appliance will get this IP address assigned. Further is the TrilioVault Appliance hostname set.
  * Format: IP=hostname
  * Example: 10.10.0.1=rhv-tvm

{% hint style="danger" %}
The Virtual IP and the TVM Appliance IP can not be the same address. The configuration fails upon using the same IPs for both values.
{% endhint %}

* **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>

{% hint style="warning" %}
A preconfigured DNS Server is required, when using FQDN. The Trilio Appliance local host file gets overwritten during configuration. The configuration will fail when the FQDN is not resolvable by a DNS Server.
{% endhint %}

* **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

{% hint style="danger" %}
The`Invalid Credentials` error message will be displayed when the Trilio Appliance cannot reach the RHV Manager or credentials given are incorrect.
{% endhint %}

### Backup Storage Configuration information

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

* **Backup Storage**
  * Predefined as NFS

{% hint style="info" %}
Trilio for RHV currently only supports NFS. The addition of S3 compatible Storage solutions gets delivered in a future version.
{% endhint %}

* **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&#x20;

### 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 Trilio Appliance
  * Format: FQDN
  * Example: rhv-tvm.trilio.demo
* **Certificate**
  * Certificate provided by the Trilio 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.

{% hint style="warning" %}
Trilio will not create any workloads or backups without a valid license file.
{% endhint %}

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.

Stay patient during the configuration, as this may easily take a few more minutes.

After the configurator has succeeded or failed, is the Ansible playbook shown. Use the possibilities to expand and collapse each task for troubleshooting failed configurations.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trilio.io/rhv/4.0/deployment-guide/configure-triliovault-vm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
