Installation of RHV extensions

TrilioVault extends the ovirt-imageio services running on the RHV-Manager and the RHV hosts, to provide the parallel download of disks from multiple RHV hosts.

The imageio extensions are installed through the TrilioVault GUI using Ansible inventory files as input.

Every time the RHV environment gets updated or a new RHV host is getting added to the RHV Cluster it is necessary to rerun the installation of the ovirt-imageio extensions.

Preparing the inventory files

The TrilioVault Appliance is running Ansible playbooks in the background to install the RHV extensions.

Like most Ansible playbooks does the TrilioVault Appliance require inventory files to know which roles have to run on which hosts and how to gain the required access.

Two (2) inventory files are required for the TrilioVault Appliance.

  1. Inventory file containing the RHV-Manager

  2. Inventory file containing the RHV Hosts

These can be created in two ways.

Using password authentication

The first supported method to allow Ansible to access the RHV hosts and the RHV Manager is the classic user password authentication.

To use password authentication edit the files using the following format:

<Server_IP> ansible_user=root password=xxxxx

One entry per RHV Host in daemon file and one entry per RHV Manager in the proxy file are required.

An example for an inventory file using password authentication is shown below:

[hosts]
172.16.1.13 ansible_user=root ansible_ssh_pass="Password"
172.16.1.14 ansible_user=root ansible_ssh_pass="Password"
172.16.1.15 ansible_user=root ansible_ssh_pass="Password"

Using passwordless authentication (SSH keys)

The second supported method to Allow Ansible to access the RHV hosts and the RHV Manager is utilizing SSH keys to provide passwordless authentication.

For this method, it is necessary to prepare the TrilioVault Appliance and the RHV Cluster Nodes as well as the RHV Manager.

The provided service account rhv_nw is not able to perform the necessary steps on the TrilioVault Appliance. These tasks require root privileges.

The recommended method from Trilio is:

  1. Use ssh-keygen to generate a key pair

  2. Add the private key to /root/.ssh/ on the TrilioVault Appliance

  3. Add the public key to /root/.ssh/authorized_keys file on each RHV host and the RHV Manager

Once the TrilioVault Appliance can access the nodes without password, edit the inventory files using the following format:

<Server_IP> ansible_user=root

One entry per RHV Host in the daemon file and one entry per RHV Manager in the proxy file are required.

An example for an inventory file using passwordless authentication is shown below:

[hosts]
172.16.1.13 ansible_user=root
172.16.1.14 ansible_user=root
172.16.1.15 ansible_user=root

Starting the installation

To install the RHV extension log in to the TrilioVault appliance GUI using the admin account.

Choose Configure RHV Host to install the RHV extensions for the RHV Hosts. Choose Configure RHV Manager to install the RHV extensions for the RHV Manager.

Upload the prepared inventory files to the provided upload areas.

Do not mix RHV Hosts and RHV Manager in the same inventory file. The configurator will not make a difference and install the extensions according to the chosen installation on any host provided in the inventory files.

Click configure to start the installation.

During the installation is the live output from the ansible playbooks shown. Some of the tasks can take up to a few minutes to complete without updating the playbook output. Wait till the playbook has succeeded or failed.

‚Äč