1 of 7

Installing Trilio Components

Once the Trilio VM or the Cluster of Trilio VMs has been spun, the actual installation process can begin. This process contains of the following steps:

Install the Trilio dm-api service on the control plane
Install the Trilio datamover service on the compute plane
Install the Trilio Horizon plugin into the Horizon service

How these steps look in detail is depending on the Openstack distribution Trilio is installed in. Each supported Openstack distribution has its own deployment tools. Trilio is integrating into these deployment tools to provide a native integration from the beginning to the end.

Installing on RHOSP13

The Red Hat Openstack Platform Director is the supported and recommended method to deploy and maintain any RHOSP installation.

Trilio is integrating natively into the RHOSP Director. Manual deployment methods are not supported for RHOSP.

Prepare for deployment

Depending whether the RHOSP environment is already installed or is getting installed for the first time different steps are done to be able to deploy Trilio.

Clone triliovault-cfg-scripts repository and upload Trilio puppet module

All commands need to be run as user 'stack'

The following commands upload the Trilio puppet module to the overcloud. The actual upload happens upon the next deployment.

Gitub branches to use:

Trilio 4.0 GA == stable/4.0 Trilio 4.0 SP1 == v4.0maintenance

Update overcloud roles data file to include Trilio services

Trilio contains of multiple services. Add these services to your roles_data.yaml.

In case of uncostomized roles_data.yaml can the default file be found on the undercloud at:

/usr/share/openstack-tripleo-heat-templates/roles_data.yaml

Add the following services to the roles_data.yaml

Trilio Datamover Api Service

This service needs to share the same role as the nova-api service. In case of the pre-defined roles will the nova-api service run on the role Controller. In case of custom defined roles, it is necessary to use the role the nova-api service is using.

Add the following line to the identified role:

Trilio Datamover Service

This service needs to share the same role as the nova-compute service. In case of the pre-defined roles will the nova-compute service run on the role Compute. In case of custom defined roles, it is necessary to use the role the nova-compute service is using.

Add the following line to the identified role:

Prepare Trilio container images

All commands need to be run as user 'stack'

Trilio containers are pushed to 'RedHat Container Registry'. Registry URL: 'registry.connect.redhat.com'. Container pull urls are given below.

Trilio Datamover container: registry.connect.redhat.com/trilio/trilio-datamover:<container-tag> Trilio Datamover Api Container: registry.connect.redhat.com/trilio/trilio-datamover-api:<container-tag> Trilio horizon plugin: registry.connect.redhat.com/trilio/trilio-horizon-plugin:<container-tag>

'4.0.92' is Trilio 4.0 build version. Container tag: 4.0.92-rhosp13 '4.0.115' is Trilio 4.0 SP1 build version. Container tag: 4.0.115-rhosp13

There are three registry methods available in RedHat Openstack Platform.

Remote Registry
Local Registry
Satellite Server

Remote Registry

Follow this section when 'Remote Registry' is used.

For this method it is not necessary to pull the containers in advance. It is only necessary to populate the trilio_env.yaml and overcloud_images.yaml with the RedHat Registry URLs to the right containers.

Populate the trilio_env.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

In the overcloud_images.yaml replace the standard Horizon Container with the Trilio Horizon container. This is necessary to gain access to the Trilio Horizon Dashboard.

Local Registry

Follow this section when 'local registry' is used on the undercloud.

In this case it is necessary to pull the Trilio containers to the undercloud registry. Trilio provides shell scripts which will pull the containers from 'registry.connect.redhat.com' to the undercloud and updates the trilio_env.yaml with the values for the datamover and datamover api containers.

The script assumes that the undercloud container registry is running on port 8787. If the registry is running on a different port, the script needs to be adjusted manually.

The changes can be verified in the trilio_env.yaml.

In the overcloud_images.yaml replace the standard Horizon Container with the Trilio Horizon container. This is necessary to gain access to the Trilio Horizon Dashboard.

Satellite Server

Follow this section when a Satellite Server is used for the container registry.

Pull the Trilio containers on the Red Hat Satellite using the given Red Hat registry URLs.

Populate the trilio_env.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

In the overcloud_images.yaml replace the standard Horizon Container with the Trilio Horizon container. This is necessary to gain access to the Trilio Horizon Dashboard.

Provide environment details in trilio-env.yaml

Provide backup target details and other necessary details in the provided environment file. This environment file will be used in the overcloud deployment to configure Trilio components. Container image names have already been populated in the preparation of the container images. Still it is recommended to verify the container URLs.

The following information are required additionally:

Network for the datamover api
Backup target type {nfs/s3}
In case of NFS

Deploy overcloud with trilio environment

Use the following heat environment file and roles data file in overcloud deploy command:

trilio_env.yaml
roles_data.yaml

To include new environment files use '-e' option and for roles data file use '-r' option. An example overcloud deploy command is shown below:

Verify deployment

On Controller node

Make sure Trilio dmapi and horizon containers are in a running state and no other Trilio container is deployed on controller nodes.

If the containers are in restarting state or not listed by the following command then your deployment is not done correctly. Please recheck if you followed the complete documentation.

On Compute node

Make sure Trilio datamover container is in running state and no other Trilio container is deployed on compute nodes.

Configure Trilio Appliance

Once RHOSP13 Installation steps have completed successfully, follow the instructions below to now configure the Trilio Appliance.

Change the nova user id on the Trilio Nodes

In RHOSP, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all Trilio nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script

Run the Trilio configurator

Follow .

Change the workloadmgr.conf to use the right mountpoint

It is necessary to first configure the Trilio appliance, before the steps of this section can be done.

RHOSP13 is using a different mount point in its datamover containers than other Openstack distribution. It is necessary to adjust the mountpoint of the Trilio Nodes to match this. If the mountpoints are not getting aligned, will files created by the datamover and read by the Trilio appliance not match in their paths and backup and restore processes will fail.

Please follow these steps to align the mountpoints:

Edit /etc/workloadmgr/workloadmgr.conf file
Set parameter 'vault_data_directory' to '/var/lib/nova/triliovault-mounts'
create the directory for the mountpoint

Troubleshooting for overcloud deployment failures

Trilio components will be deployed using puppet scripts.

In case of the overcloud deployment failing does the following command provide the list of errors:

Further commands that can help identifying any errors.

In case of the trilio datamover api container is failing to start or stuck in restart, check these logs:

In case of Trilio datamover container failing to start or being stuck in restart, check these logs:

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

If Cinder backend is Ceph it is necessary to manually add the ceph details to tvault-contego.conf on all compute nodes.

The file can be found here: /var/lib/config-data/puppet-generated/triliodm/etc/tvault-contego/tvault-contego.conf

Add the following information:

The same block of information can be found in the nova.conf file.

Restart the datamover container

Installing on RHOSP16.0

The Red Hat Openstack Platform Director is the supported and recommended method to deploy and maintain any RHOSP installation.

Trilio is integrating natively into the RHOSP Director. Manual deployment methods are not supported for RHOSP.

Prepare for deployment

Depending whether the RHOSP environment is already installed or is getting installed for the first time different steps are done to be able to deploy Trilio.

All commands need to be run as user 'stack'

The following commands upload the Trilio puppet module to the overcloud. The actual upload happens upon the next deployment.

Gitub branches to use:

Trilio 4.0 GA == stable/4.0 Trilio 4.0 SP1 == v4.0maintenance

Update overcloud roles data file to include Trilio services

Trilio contains of multiple services. Add these services to your roles_data.yaml.

In case of uncostomized roles_data.yaml can the default file be found on the undercloud at:

/usr/share/openstack-tripleo-heat-templates/roles_data.yaml

Add the following services to the roles_data.yaml

Trilio Datamover Api Service

Add the following line to the identified role:

Trilio Datamover Service

Add the following line to the identified role:

Prepare Trilio container images

All commands need to be run as user 'stack'

Trilio containers are pushed to 'RedHat Container Registry'. Registry URL: 'registry.connect.redhat.com'. Container pull urls are given below.

'4.0.92' is Trilio 4.0 build version. Container tag: 4.0.92-rhosp16 '4.0.115' is Trilio 4.0 SP1 build version. Container tag: 4.0.115-rhosp16

There are three registry methods available in RedHat Openstack Platform.

Remote Registry
Local Registry
Satellite Server

Remote Registry

Follow this section when 'Remote Registry' is used.

For this method it is not necessary to pull the containers in advance. It is only necessary to populate the trilio_env.yaml file with the Trilio container URLs from Redhat registry.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container
Trilio Horizon Plugin

trilio_env_osp16.yaml will be available in triliovault-cfg-scripts/redhat-director-scripts/

Local Registry

Follow this section when 'local registry' is used on the undercloud.

In this case it is necessary to pull the Trilio containers to the undercloud registry. Trilio provides shell scripts which will pull the containers from 'registry.connect.redhat.com' to the undercloud and updates the trilio_env_osp16.yaml with the values for the datamover and datamover api containers.

The script assumes that the undercloud container registry is running on port 8787. If the registry is running on a different port, the script needs to be adjusted manually.

The changes can be verified using the following commands.

Satellite Server

Follow this section when a Satellite Server is used for the container registry.

Pull the Trilio containers on the Red Hat Satellite using the given Red Hat registry URLs.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

Provide environment details in trilio-env_osp16.yaml

The following information are required additionally:

Network for the datamover api
Backup target type {nfs/s3}
In case of NFS

Deploy overcloud with trilio environment

Use the following heat environment file and roles data file in overcloud deploy command:

trilio_env_osp16.yaml
roles_data.yaml

To include new environment files use '-e' option and for roles data file use '-r' option. An example overcloud deploy command is shown below:

Verify deployment

If the containers are in restarting state or not listed by the following command then your deployment is not done correctly. Please recheck if you followed the complete documentation.

On Controller node

Make sure Trilio dmapi and horizon containers are in a running state and no other Trilio container is deployed on controller nodes.

On Compute node

Make sure Trilio datamover container is in running state and no other Trilio container is deployed on compute nodes.

On the node with Horizon service

Make sure horizon container is in running state. Please note that 'Horizon' container is replaced with Trilio Horizon container. This container will have latest OpenStack horizon + Trilio's horizon plugin.

Configure Trilio Appliance

Once RHOSP16.0 Installation steps have completed successfully, follow the instructions below to now configure the Trilio Appliance

Change the nova user id on the Trilio Nodes

In RHOSP, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all Trilio nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script

Run the Trilio configurator

Follow .

Change the workloadmgr.conf to use the right mountpoint

It is necessary to first configure the Trilio appliance, before the steps of this section can be done.

RHOSP16 is using a different mount point in its datamover containers than other Openstack distribution. It is necessary to adjust the mountpoint of the Trilio Nodes to match this. If the mountpoints are not getting aligned, will files created by the datamover and read by the Trilio appliance not match in their paths and backup and restore processes will fail.

Please follow these steps to align the mountpoints:

Edit /etc/workloadmgr/workloadmgr.conf file
Set parameter 'vault_data_directory' to '/var/lib/nova/triliovault-mounts'
create the directory for the mountpoint

Troubleshooting for overcloud deployment failures

Trilio components will be deployed using puppet scripts.

In case of the overcloud deployment failing does the following command provide the list of errors:

Further commands that can help identifying any errors.

In case of the trilio datamover api container is failing to start or stuck in restart, check these logs:

In case of Trilio datamover container failing to start or being stuck in restart, check these logs:

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

If Cinder backend is Ceph it is necessary to manually add the ceph details to tvault-contego.conf on all compute nodes.

The file can be found here: /var/lib/config-data/puppet-generated/triliodm/etc/tvault-contego/tvault-contego.conf

Add the following information:

The same block of information can be found in the nova.conf file.

Restart the datamover container

Installing on RHOSP16.1

The Red Hat Openstack Platform Director is the supported and recommended method to deploy and maintain any RHOSP installation.

Trilio is integrating natively into the RHOSP Director. Manual deployment methods are not supported for RHOSP.

Prepare for deployment

Depending whether the RHOSP environment is already installed or is getting installed for the first time different steps are done to be able to deploy Trilio.

All commands need to be run as user 'stack'

The following command clones the Trilio configscripts github.

If your backup target is ceph S3 with SSL and SSL certificates are self signed or authorized by private CA, then user needs to provide CA chain certificate to validate the SSL requests. For that, user needs to rename his ca chain cert file to 's3-cert.pem' and copy it into directory - 'triliovault-cfg-scripts/redhat-director-scripts/redhat-director-scripts/puppet/trilio/files'

The following commands upload the Trilio puppet module to the overcloud registry. The actual upload happens upon the next deployment.

Update overcloud roles data file to include Trilio services

Trilio contains of multiple services. Add these services to your roles_data.yaml.

In case of uncostomized roles_data.yaml can the default file be found on the undercloud at:

/usr/share/openstack-tripleo-heat-templates/roles_data.yaml

Add the following services to the roles_data.yaml

Trilio Datamover Api Service

Add the following line to the identified role:

Trilio Datamover Service

Add the following line to the identified role:

Prepare Trilio container images

All commands need to be run as user 'stack'

Trilio containers are pushed to 'RedHat Container Registry'. Registry URL: 'registry.connect.redhat.com'. Container pull urls are given below.

Trilio Datamover container: registry.connect.redhat.com/trilio/trilio-datamover:4.0.116-rhosp16.1 Trilio Datamover Api Container: registry.connect.redhat.com/trilio/trilio-datamover-api:4.0.116-rhosp16.1 Trilio horizon plugin: registry.connect.redhat.com/trilio/trilio-horizon-plugin:4.0.116-rhosp16.1

There are three registry methods available in RedHat Openstack Platform.

Remote Registry
Local Registry
Satellite Server

Remote Registry

Follow this section when 'Remote Registry' is used.

For this method it is not necessary to pull the containers in advance. It is only necessary to populate the trilio_env.yaml file with the Trilio container URLs from Redhat registry.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container
Trilio Horizon Plugin

trilio_env_osp16.yaml will be available in triliovault-cfg-scripts/redhat-director-scripts/

Local Registry

Follow this section when 'local registry' is used on the undercloud.

In this case it is necessary to pull the Trilio containers to the undercloud registry. Trilio provides shell scripts which will pull the containers from 'registry.connect.redhat.com' to the undercloud and updates the trilio_env_osp16.yaml with the values for the datamover and datamover api containers.

The script assumes that the undercloud container registry is running on port 8787. If the registry is running on a different port, the script needs to be adjusted manually.

The changes can be verified using the following commands.

Satellite Server

Follow this section when a Satellite Server is used for the container registry.

Pull the Trilio containers on the Red Hat Satellite using the given Red Hat registry URLs.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

Provide environment details in trilio-env_osp16.yaml

The following information are required additionally:

Network for the datamover api
Backup target type {nfs/s3}
In case of NFS

Deploy overcloud with trilio environment

Use the following heat environment file and roles data file in overcloud deploy command:

trilio_env_osp16.yaml
roles_data.yaml

To include new environment files use '-e' option and for roles data file use '-r' option. An example overcloud deploy command is shown below:

Verify deployment

If the containers are in restarting state or not listed by the following command then your deployment is not done correctly. Please recheck if you followed the complete documentation.

On Controller node

Make sure Trilio dmapi and horizon containers are in a running state and no other Trilio container is deployed on controller nodes.

On Compute node

Make sure Trilio datamover container is in running state and no other Trilio container is deployed on compute nodes.

On the node with Horizon service

Configure Trilio Appliance

Once RHOSP16.1 Installation steps have completed successfully, follow the instructions below to now configure the Trilio Appliance.

Change the nova user id on the Trilio Nodes

In RHOSP, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all Trilio nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script

Run the Trilio configurator

Follow .

Change the workloadmgr.conf to use the right mountpoint

It is necessary to first configure the Trilio appliance, before the steps of this section can be done.

Please follow these steps to align the mountpoints:

Edit /etc/workloadmgr/workloadmgr.conf file
Set parameter 'vault_data_directory' to '/var/lib/nova/triliovault-mounts'
create the directory for the mountpoint

Troubleshooting for overcloud deployment failures

Trilio components will be deployed using puppet scripts.

In case of the overcloud deployment failing does the following command provide the list of errors:

Further commands that can help identifying any errors.

In case of the trilio datamover api container is failing to start or stuck in restart, check these logs:

In case of Trilio datamover container failing to start or being stuck in restart, check these logs:

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

If Cinder backend is Ceph it is necessary to manually add the ceph details to tvault-contego.conf on all compute nodes.

The file can be found here: /var/lib/config-data/puppet-generated/triliodm/etc/tvault-contego/tvault-contego.conf

Add the following information:

The same block of information can be found in the nova.conf file.

Restart the datamover container

Installing on Canonical Openstack Queens and Train

Trilio and Canonical have started a partnership to ensure a native deployment of Trilio using JuJu Charms.

Those JuJu Charms are publicly available as Open Source Charms.

The charms are currently listed as tech-preview. They will be fully supported by Canonical with the next charm release.

Canonical Openstack doesn't require the Trilio Cluster. The required services are installed and managed via JuJu Charms.

The following charms exist:

➡️ Installs and manages Trilio Controller services.
➡️Installs and manages the Trilio Datamover API service.
➡️

The documentation of the charms can be found here:

Installing on Kolla Train

Change the nova user id on the Trilio Nodes

In Kolla, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all compute nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script
Verify that 'nova' user and group id has changed to '42436'

Deploy Trilio Datamover API on all Openstack controller nodes

Trilio Datamover Api container should be deployed on all nodes where nova_api container is running. In standard deployment, we can call these nodes as OpenStack controller nodes.

Pull TrilioVaullt Datamover API container image

The very first step is to pull the container image from docker.io.

Example command for train openstack on ubuntu platform with triliovault 4.0 GA release: docker pull docker.io/trilio/ubuntu-source-trilio-datamover-api:4.0.92-train

Create the Trilio Datamover API configuration

In this part of the process is the configuration file for the Trilio Datamover API created.

The following steps need to be done:

Create config directory
get default config file dmapi.conf
edit dmapi.conf

Create config directory for trilio-datamover-api service

Get the trilio-datamover-api default config file

Edit dmapi.conf

The dmapi.conf located in /etc/kolla/trilio-datamover-api/ needs to be edited to adjust to the Openstack environment.

Nearly all required values can be copied from the nova.conf located at: /etc/kolla/nova-api/

Follow comments inside the dmapi.conf to learn which parameters are the minimum needed.

An example dmapi.conf can be seen here:

Copy nova.conf of nova-api service to trilio-datamover-api directory

Create trilio-datamover-api log directory

For CentOS, we need nova user ownership on datamover api log directory where as for Ubuntu, we need dmapi user's ownership on datmover api log directory.

Add trilio-datamover-api to haproxy.cfg

Run trilio-datamover-api container

Now the trilio-datamover-api container can be deployed and started.

Verify deployment of trilio-datamover-api container

To verify the deployment was successful check the container status using docker ps.

Deploy Trilio Datamover container on all Compute nodes

Trilio Datamover container should be deployed on all nodes where nova_compute container is running. In standard deployment, we can call these nodes as openstack compute nodes.

At this stage it is necessary to know if the deployment shall use NFS or S3 protocol for the backup target.

Pull Trilio Datamover container

The very first step is to pull the container image from docker.io.

Example command for train openstack on ubuntu platform with Trilio 4.0 GA release: docker pull docker.io/trilio/ubuntu-source-trilio-datamover:4.0.92-train

Create the Trilio Datamover configuration

In this part of the process is the configuration file for the Trilio Datamover created.

The following steps need to be done:

Create config directory
copy nova.conf to config directory
get default config file tvault-contego.conf

Create service config directory for trilio-datamover service

Copy nova.conf of nova-compute service to trilio-datamover config directory

Get the trilio-datamover default config file

Edit tvault-contego.conf

Edit /etc/kolla/trilio-datamover/tvault-contego.conf config file to provide NFS/S3 details as per backup storage selected.

In case of NFS backup target, only nfs share details need to provided. No other conf parameters need to edit, unless you know the details of it.

Create trilio-datamover log directory

If Ceph is used for Nova/Cinder Storage

If ceph is getting used for cinder/nova, the correct permissions for ceph.conf and keyrings files need to be assigned. The trilio_datamover container will be using ceph.conf and keyring files with the 'nova' user.

If nova/cinder backend is ceph, you need to add ceph user and keyring details to /etc/kolla/trilio-datamover/tvault-contego.conf file. Add the following sections to the tvault-contego.conf file. In the provided example is ceph's 'cinder' user configured to use for trilio read/write operations.

Mount /etc/ceph on trilio_datamover container in read only mode. Check docker run command provided in the next step. The ceph user (example -'cinder') should have read and write permissions on ceph pool used for nova/cinder backend. Verify nova user (uid - 42436) on trilio_datamover container is able to read ceph user's keyring file and ceph.conf after mounting /etc/ceph on the container. Set appropriate permissions for /etc/ceph/ files on the host itself.

Run trilio-datamover container

If the cloud does not use 'ceph' storage for nova/cinder, remove '/etc/ceph' volume mount option from below commands.

Verify deployment of trilio-datamover container

To verify the deployment was successful check the container status using docker ps.

Installing Trilio Horizon plugin

Trilio Horizon plugin needs to be installed inside the OpenStack horizon container. Once installed, the Trilio dashboard will be visible in OpenStack Horizon.

The following steps need to be done:

Download installation shell script
Run the shell script
Edit Horizon settings

Download the installation shell script

To download the shell script directly into the Horizon container do:

Run the shell script and restart Horizon container

You have to run the script inside the Horizon container as root.

Run the shell script and restart horizon container. This will restart apache service, which may enforce a log out of the container.

Edit Horizon settings

The following line needs to be aded in 'local_settings' of Openstack's Horizon file to enable workloadmanager quota feature in the Horizon dashboard.

Restart the Horizon container

To enable the done changes restart the Horizon container

Known issues for Horizon plugin installation

If OpenStack is based on 'Centos' platform

This issue has not been observed in all CentOS based Kolla Train installations. Please verify before disabling grafana repository.

Grafana yum repository has an issue on the latest horizon containers of OpenStack (not Trilio). To confirm the issue, you can just run yum repolist, it will fail. Use the following command to disable the grafana repository.

If Openstack is based on Ubuntu platform

Trilio horizon install script will ask for horizon's openstack_dashboard directory path if it's not at the default location - /usr/shar/openstack-dashboard

For train ubuntu bionic, it's : /var/lib/kolla/venv/lib/python2.7/site-packages

If Trilio Horizon tabs are not accessible but Openstack Horizon works

If Trilio Horizon tabs are not accessible but OpenStack Horizon is working fine, make sure that endpoints for service 'TrilioVaultWLM' are created correctly. The root cause of this issue is typically, that SSL is enabled on all three endpoint types of 'TrilioVaultWLM' service.

If SSL is enable only on public 'keystone' service endpoints, then create 'TrilioVaultWLM' service endpoints in the same fashion. Endpoints for service 'TrilioVaultWLM' get created during step. If these endpoints need to be edited reconfigure the Trilio.

Enabling Snapshout Mount

To make 'snapshot mount' functionality work, the cloud administrator needs to complete the following steps.

Identify backup target mount point on Trilio VM
install nfs-common on nova_compute and nova_libvirt containers
Mount backup target nfs share on nova_compute and nova_libvirt containers

Identify backup target mount point in Trilio VM

The following command will provide the active mountpoint on the Trilio VM

This example gives the following information:

Backup target is NFS share: 192.168.1.33:/mnt/tvault Mountpoint is: /var/triliovault-mounts/MTkyLjE2OC4xLjMzOi9tbnQvdHZhdWx0

Install nfs-common on nova_compute and nova_libvirt containers

It is necessary to install nfs-common package on both nova_compute and nova_libvirt containers.

Mount the backup target nfs share on 'nova_compute' and 'nova_libvirt' container at exactly same mount point as done on triliovault VM.

Create the mountpoint directory as necessary.

Troubleshoot installation

If any triliovault container is stuck in restarting state the following logs can be checked.

Possible issues for trilio-datamover container failure are for example NFS mount issues or S3 credentials might be wrong. If it's Amazon S3, then network connectivity between compute node and AWS s3 is needed. The docker logs will clearly tell the exact error.

If the above logs do not help OR If containers running well but, backups fail, following service logs will help:

If the Trilio Horizon tabs are not visible on Openstack, verify the following:

Make sure trilio horizon plugin is installed on OpenStack horizon container
Trilio configuration step needs to be completed to see the triliovault dashboard on OpenStack
Make sure correct openstack_dashboard directory got provided and the triliovault horizon plugin files got successfully copied there.

Installing on Ansible Openstack Train

Installing Trilio Datamover-API container

The installation of the Datamover-API, short dmapi, requires to create a new container, in which all necessary packages and the Trilio dmapi code are loaded.

Create the dmapi container on Controller nodes

Create lxc container for hosting dmapi service on controller nodes with below commands.

Prepare the dmapi container for installation

Add nova user and required directory on container controller_dmapi.

Add required packages on container controller_dmapi.

Copy nova.conf file from nova-api container to /etc/nova directory in dmapi container. Run the below command on controller nodes:

Create a new interface with specific ip for dmapi container.

Edit /var/lib/lxc/controller_dmapi/config and add below section as per network bridge available on the controller node.

Restart the container with the below commands.

Install the dmapi service

Download and run the tvault-installation script inside the container.

The script to be executed inside dmapi container, after the following changes have been done: Comment the 2 lines below and add a line below NOVA_VERSION = 20, as nova-manage doesn't work in Ansible Openstack.

Run the script

Verify the installation and set necessary configuration

Verify in dmapi.conf domain name for the nova service user under keystone section. Check field values for project_domain_nameand user_domain_name and update those if not in keystone section

If SSL is enabled then add the following section in dmapi.conf:

Verify below entries are there in keystone policy.json file

file path : /var/lib/lxc/controller_keystone_container/rootfs/etc/keystone

Once verified above checks, start the dmapi service.

Install Trilio Datamover on Compute nodes

Prepare the installation

Activate the virtual environment on the compute node.

After activating the virtual environment, find out the location of compute.filters file.

Download the installation script.

Modify install script to use the same location for creating trilio filters.

Also comment the 2 lines below and add a line below NOVA_VERSION = 20, as nova-manage doesn't work in Ansible Openstack.

Install the Trilio datamover service

Run install script and if you get prompt while installing, choose the default selection.

If non-default values are selected, it will overwrite the current configuration and will impact nova-compute service.

Make sure ExecStart value look like below in /etc/systemd/system/tvault-contego.service file.

Use below commands to restart and verify the service.

Use below command and check if nfs/s3 storage is mounted or not.

Install Horizon Plugin into Horizon service

List running containers on controller nodes and login to horizon container using the below command.

Install curl package on the Horizon container if not present.

Activate virtual environment on horizon container

Download script to install horizon plugin on horizon container and run install script

Install script will ask for the dashboard folder, provide below path

Verify installation using below commands

Haproxy configuration on controller nodes

Refer to the keystone haproxy settings for dmapi haproxy.

Haproxy config file can be found here: /etc/haproxy/haproxy.cfg

A sample configuration is shown below.

Check the syntax of the file and restart the service.

Installing on RHOSP13

The Red Hat Openstack Platform Director is the supported and recommended method to deploy and maintain any RHOSP installation.

Trilio is integrating natively into the RHOSP Director. Manual deployment methods are not supported for RHOSP.

Prepare for deployment

Depending whether the RHOSP environment is already installed or is getting installed for the first time different steps are done to be able to deploy Trilio.

Clone triliovault-cfg-scripts repository and upload Trilio puppet module

All commands need to be run as user 'stack'

The following commands upload the Trilio puppet module to the overcloud. The actual upload happens upon the next deployment.

Gitub branches to use:

Trilio 4.0 GA == stable/4.0 Trilio 4.0 SP1 == v4.0maintenance

Update overcloud roles data file to include Trilio services

Trilio contains of multiple services. Add these services to your roles_data.yaml.

In case of uncostomized roles_data.yaml can the default file be found on the undercloud at:

/usr/share/openstack-tripleo-heat-templates/roles_data.yaml

Add the following services to the roles_data.yaml

Trilio Datamover Api Service

Add the following line to the identified role:

Trilio Datamover Service

Add the following line to the identified role:

Prepare Trilio container images

All commands need to be run as user 'stack'

Trilio containers are pushed to 'RedHat Container Registry'. Registry URL: 'registry.connect.redhat.com'. Container pull urls are given below.

'4.0.92' is Trilio 4.0 build version. Container tag: 4.0.92-rhosp13 '4.0.115' is Trilio 4.0 SP1 build version. Container tag: 4.0.115-rhosp13

There are three registry methods available in RedHat Openstack Platform.

Remote Registry
Local Registry
Satellite Server

Remote Registry

Follow this section when 'Remote Registry' is used.

Populate the trilio_env.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

In the overcloud_images.yaml replace the standard Horizon Container with the Trilio Horizon container. This is necessary to gain access to the Trilio Horizon Dashboard.

Local Registry

Follow this section when 'local registry' is used on the undercloud.

The script assumes that the undercloud container registry is running on port 8787. If the registry is running on a different port, the script needs to be adjusted manually.

The changes can be verified in the trilio_env.yaml.

In the overcloud_images.yaml replace the standard Horizon Container with the Trilio Horizon container. This is necessary to gain access to the Trilio Horizon Dashboard.

Satellite Server

Follow this section when a Satellite Server is used for the container registry.

Pull the Trilio containers on the Red Hat Satellite using the given Red Hat registry URLs.

Populate the trilio_env.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

In the overcloud_images.yaml replace the standard Horizon Container with the Trilio Horizon container. This is necessary to gain access to the Trilio Horizon Dashboard.

Provide environment details in trilio-env.yaml

The following information are required additionally:

Network for the datamover api
Backup target type {nfs/s3}
In case of NFS

Deploy overcloud with trilio environment

Use the following heat environment file and roles data file in overcloud deploy command:

trilio_env.yaml
roles_data.yaml

To include new environment files use '-e' option and for roles data file use '-r' option. An example overcloud deploy command is shown below:

Verify deployment

On Controller node

Make sure Trilio dmapi and horizon containers are in a running state and no other Trilio container is deployed on controller nodes.

If the containers are in restarting state or not listed by the following command then your deployment is not done correctly. Please recheck if you followed the complete documentation.

On Compute node

Make sure Trilio datamover container is in running state and no other Trilio container is deployed on compute nodes.

Configure Trilio Appliance

Once RHOSP13 Installation steps have completed successfully, follow the instructions below to now configure the Trilio Appliance.

Change the nova user id on the Trilio Nodes

In RHOSP, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all Trilio nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script

Run the Trilio configurator

Follow .

Change the workloadmgr.conf to use the right mountpoint

It is necessary to first configure the Trilio appliance, before the steps of this section can be done.

Please follow these steps to align the mountpoints:

Edit /etc/workloadmgr/workloadmgr.conf file
Set parameter 'vault_data_directory' to '/var/lib/nova/triliovault-mounts'
create the directory for the mountpoint

Troubleshooting for overcloud deployment failures

Trilio components will be deployed using puppet scripts.

In case of the overcloud deployment failing does the following command provide the list of errors:

Further commands that can help identifying any errors.

In case of the trilio datamover api container is failing to start or stuck in restart, check these logs:

In case of Trilio datamover container failing to start or being stuck in restart, check these logs:

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

If Cinder backend is Ceph it is necessary to manually add the ceph details to tvault-contego.conf on all compute nodes.

The file can be found here: /var/lib/config-data/puppet-generated/triliodm/etc/tvault-contego/tvault-contego.conf

Add the following information:

The same block of information can be found in the nova.conf file.

Restart the datamover container

Installing on RHOSP16.0

The Red Hat Openstack Platform Director is the supported and recommended method to deploy and maintain any RHOSP installation.

Trilio is integrating natively into the RHOSP Director. Manual deployment methods are not supported for RHOSP.

Prepare for deployment

Depending whether the RHOSP environment is already installed or is getting installed for the first time different steps are done to be able to deploy Trilio.

All commands need to be run as user 'stack'

The following commands upload the Trilio puppet module to the overcloud. The actual upload happens upon the next deployment.

Gitub branches to use:

Trilio 4.0 GA == stable/4.0 Trilio 4.0 SP1 == v4.0maintenance

Update overcloud roles data file to include Trilio services

Trilio contains of multiple services. Add these services to your roles_data.yaml.

In case of uncostomized roles_data.yaml can the default file be found on the undercloud at:

/usr/share/openstack-tripleo-heat-templates/roles_data.yaml

Add the following services to the roles_data.yaml

Trilio Datamover Api Service

Add the following line to the identified role:

Trilio Datamover Service

Add the following line to the identified role:

Prepare Trilio container images

All commands need to be run as user 'stack'

Trilio containers are pushed to 'RedHat Container Registry'. Registry URL: 'registry.connect.redhat.com'. Container pull urls are given below.

'4.0.92' is Trilio 4.0 build version. Container tag: 4.0.92-rhosp16 '4.0.115' is Trilio 4.0 SP1 build version. Container tag: 4.0.115-rhosp16

There are three registry methods available in RedHat Openstack Platform.

Remote Registry
Local Registry
Satellite Server

Remote Registry

Follow this section when 'Remote Registry' is used.

For this method it is not necessary to pull the containers in advance. It is only necessary to populate the trilio_env.yaml file with the Trilio container URLs from Redhat registry.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container
Trilio Horizon Plugin

trilio_env_osp16.yaml will be available in triliovault-cfg-scripts/redhat-director-scripts/

Local Registry

Follow this section when 'local registry' is used on the undercloud.

In this case it is necessary to pull the Trilio containers to the undercloud registry. Trilio provides shell scripts which will pull the containers from 'registry.connect.redhat.com' to the undercloud and updates the trilio_env_osp16.yaml with the values for the datamover and datamover api containers.

The script assumes that the undercloud container registry is running on port 8787. If the registry is running on a different port, the script needs to be adjusted manually.

The changes can be verified using the following commands.

Satellite Server

Follow this section when a Satellite Server is used for the container registry.

Pull the Trilio containers on the Red Hat Satellite using the given Red Hat registry URLs.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

Provide environment details in trilio-env_osp16.yaml

The following information are required additionally:

Network for the datamover api
Backup target type {nfs/s3}
In case of NFS

Deploy overcloud with trilio environment

Use the following heat environment file and roles data file in overcloud deploy command:

trilio_env_osp16.yaml
roles_data.yaml

To include new environment files use '-e' option and for roles data file use '-r' option. An example overcloud deploy command is shown below:

Verify deployment

If the containers are in restarting state or not listed by the following command then your deployment is not done correctly. Please recheck if you followed the complete documentation.

On Controller node

Make sure Trilio dmapi and horizon containers are in a running state and no other Trilio container is deployed on controller nodes.

On Compute node

Make sure Trilio datamover container is in running state and no other Trilio container is deployed on compute nodes.

On the node with Horizon service

Configure Trilio Appliance

Once RHOSP16.0 Installation steps have completed successfully, follow the instructions below to now configure the Trilio Appliance

Change the nova user id on the Trilio Nodes

In RHOSP, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all Trilio nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script

Run the Trilio configurator

Follow .

Change the workloadmgr.conf to use the right mountpoint

It is necessary to first configure the Trilio appliance, before the steps of this section can be done.

Please follow these steps to align the mountpoints:

Edit /etc/workloadmgr/workloadmgr.conf file
Set parameter 'vault_data_directory' to '/var/lib/nova/triliovault-mounts'
create the directory for the mountpoint

Troubleshooting for overcloud deployment failures

Trilio components will be deployed using puppet scripts.

In case of the overcloud deployment failing does the following command provide the list of errors:

Further commands that can help identifying any errors.

In case of the trilio datamover api container is failing to start or stuck in restart, check these logs:

In case of Trilio datamover container failing to start or being stuck in restart, check these logs:

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

If Cinder backend is Ceph it is necessary to manually add the ceph details to tvault-contego.conf on all compute nodes.

The file can be found here: /var/lib/config-data/puppet-generated/triliodm/etc/tvault-contego/tvault-contego.conf

Add the following information:

The same block of information can be found in the nova.conf file.

Restart the datamover container

Installing on Kolla Train

Change the nova user id on the Trilio Nodes

In Kolla, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all compute nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script
Verify that 'nova' user and group id has changed to '42436'

Deploy Trilio Datamover API on all Openstack controller nodes

Trilio Datamover Api container should be deployed on all nodes where nova_api container is running. In standard deployment, we can call these nodes as OpenStack controller nodes.

Pull TrilioVaullt Datamover API container image

The very first step is to pull the container image from docker.io.

Example command for train openstack on ubuntu platform with triliovault 4.0 GA release: docker pull docker.io/trilio/ubuntu-source-trilio-datamover-api:4.0.92-train

Create the Trilio Datamover API configuration

In this part of the process is the configuration file for the Trilio Datamover API created.

The following steps need to be done:

Create config directory
get default config file dmapi.conf
edit dmapi.conf

Create config directory for trilio-datamover-api service

Get the trilio-datamover-api default config file

Edit dmapi.conf

The dmapi.conf located in /etc/kolla/trilio-datamover-api/ needs to be edited to adjust to the Openstack environment.

Nearly all required values can be copied from the nova.conf located at: /etc/kolla/nova-api/

Follow comments inside the dmapi.conf to learn which parameters are the minimum needed.

An example dmapi.conf can be seen here:

Copy nova.conf of nova-api service to trilio-datamover-api directory

Create trilio-datamover-api log directory

For CentOS, we need nova user ownership on datamover api log directory where as for Ubuntu, we need dmapi user's ownership on datmover api log directory.

Add trilio-datamover-api to haproxy.cfg

Run trilio-datamover-api container

Now the trilio-datamover-api container can be deployed and started.

Verify deployment of trilio-datamover-api container

To verify the deployment was successful check the container status using docker ps.

Deploy Trilio Datamover container on all Compute nodes

Trilio Datamover container should be deployed on all nodes where nova_compute container is running. In standard deployment, we can call these nodes as openstack compute nodes.

At this stage it is necessary to know if the deployment shall use NFS or S3 protocol for the backup target.

Pull Trilio Datamover container

The very first step is to pull the container image from docker.io.

Example command for train openstack on ubuntu platform with Trilio 4.0 GA release: docker pull docker.io/trilio/ubuntu-source-trilio-datamover:4.0.92-train

Create the Trilio Datamover configuration

In this part of the process is the configuration file for the Trilio Datamover created.

The following steps need to be done:

Create config directory
copy nova.conf to config directory
get default config file tvault-contego.conf

Create service config directory for trilio-datamover service

Copy nova.conf of nova-compute service to trilio-datamover config directory

Get the trilio-datamover default config file

Edit tvault-contego.conf

Edit /etc/kolla/trilio-datamover/tvault-contego.conf config file to provide NFS/S3 details as per backup storage selected.

In case of NFS backup target, only nfs share details need to provided. No other conf parameters need to edit, unless you know the details of it.

Create trilio-datamover log directory

If Ceph is used for Nova/Cinder Storage

Run trilio-datamover container

If the cloud does not use 'ceph' storage for nova/cinder, remove '/etc/ceph' volume mount option from below commands.

Verify deployment of trilio-datamover container

To verify the deployment was successful check the container status using docker ps.

Installing Trilio Horizon plugin

Trilio Horizon plugin needs to be installed inside the OpenStack horizon container. Once installed, the Trilio dashboard will be visible in OpenStack Horizon.

The following steps need to be done:

Download installation shell script
Run the shell script
Edit Horizon settings

Download the installation shell script

To download the shell script directly into the Horizon container do:

Run the shell script and restart Horizon container

You have to run the script inside the Horizon container as root.

Run the shell script and restart horizon container. This will restart apache service, which may enforce a log out of the container.

Edit Horizon settings

The following line needs to be aded in 'local_settings' of Openstack's Horizon file to enable workloadmanager quota feature in the Horizon dashboard.

Restart the Horizon container

To enable the done changes restart the Horizon container

Known issues for Horizon plugin installation

If OpenStack is based on 'Centos' platform

This issue has not been observed in all CentOS based Kolla Train installations. Please verify before disabling grafana repository.

If Openstack is based on Ubuntu platform

Trilio horizon install script will ask for horizon's openstack_dashboard directory path if it's not at the default location - /usr/shar/openstack-dashboard

For train ubuntu bionic, it's : /var/lib/kolla/venv/lib/python2.7/site-packages

If Trilio Horizon tabs are not accessible but Openstack Horizon works

Enabling Snapshout Mount

To make 'snapshot mount' functionality work, the cloud administrator needs to complete the following steps.

Identify backup target mount point on Trilio VM
install nfs-common on nova_compute and nova_libvirt containers
Mount backup target nfs share on nova_compute and nova_libvirt containers

Identify backup target mount point in Trilio VM

The following command will provide the active mountpoint on the Trilio VM

This example gives the following information:

Backup target is NFS share: 192.168.1.33:/mnt/tvault Mountpoint is: /var/triliovault-mounts/MTkyLjE2OC4xLjMzOi9tbnQvdHZhdWx0

Install nfs-common on nova_compute and nova_libvirt containers

It is necessary to install nfs-common package on both nova_compute and nova_libvirt containers.

Mount the backup target nfs share on 'nova_compute' and 'nova_libvirt' container at exactly same mount point as done on triliovault VM.

Create the mountpoint directory as necessary.

Troubleshoot installation

If any triliovault container is stuck in restarting state the following logs can be checked.

If the above logs do not help OR If containers running well but, backups fail, following service logs will help:

If the Trilio Horizon tabs are not visible on Openstack, verify the following:

Make sure trilio horizon plugin is installed on OpenStack horizon container
Trilio configuration step needs to be completed to see the triliovault dashboard on OpenStack
Make sure correct openstack_dashboard directory got provided and the triliovault horizon plugin files got successfully copied there.

Installing on RHOSP16.1

The Red Hat Openstack Platform Director is the supported and recommended method to deploy and maintain any RHOSP installation.

Trilio is integrating natively into the RHOSP Director. Manual deployment methods are not supported for RHOSP.

Prepare for deployment

Depending whether the RHOSP environment is already installed or is getting installed for the first time different steps are done to be able to deploy Trilio.

All commands need to be run as user 'stack'

The following command clones the Trilio configscripts github.

The following commands upload the Trilio puppet module to the overcloud registry. The actual upload happens upon the next deployment.

Update overcloud roles data file to include Trilio services

Trilio contains of multiple services. Add these services to your roles_data.yaml.

In case of uncostomized roles_data.yaml can the default file be found on the undercloud at:

/usr/share/openstack-tripleo-heat-templates/roles_data.yaml

Add the following services to the roles_data.yaml

Trilio Datamover Api Service

Add the following line to the identified role:

Trilio Datamover Service

Add the following line to the identified role:

Prepare Trilio container images

All commands need to be run as user 'stack'

Trilio containers are pushed to 'RedHat Container Registry'. Registry URL: 'registry.connect.redhat.com'. Container pull urls are given below.

There are three registry methods available in RedHat Openstack Platform.

Remote Registry
Local Registry
Satellite Server

Remote Registry

Follow this section when 'Remote Registry' is used.

For this method it is not necessary to pull the containers in advance. It is only necessary to populate the trilio_env.yaml file with the Trilio container URLs from Redhat registry.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container
Trilio Horizon Plugin

trilio_env_osp16.yaml will be available in triliovault-cfg-scripts/redhat-director-scripts/

Local Registry

Follow this section when 'local registry' is used on the undercloud.

In this case it is necessary to pull the Trilio containers to the undercloud registry. Trilio provides shell scripts which will pull the containers from 'registry.connect.redhat.com' to the undercloud and updates the trilio_env_osp16.yaml with the values for the datamover and datamover api containers.

The script assumes that the undercloud container registry is running on port 8787. If the registry is running on a different port, the script needs to be adjusted manually.

The changes can be verified using the following commands.

Satellite Server

Follow this section when a Satellite Server is used for the container registry.

Pull the Trilio containers on the Red Hat Satellite using the given Red Hat registry URLs.

Populate the trilio_env_osp16.yaml with container urls for:

Trilio Datamover container
Trilio Datamover api container

Provide environment details in trilio-env_osp16.yaml

The following information are required additionally:

Network for the datamover api
Backup target type {nfs/s3}
In case of NFS

Deploy overcloud with trilio environment

Use the following heat environment file and roles data file in overcloud deploy command:

trilio_env_osp16.yaml
roles_data.yaml

To include new environment files use '-e' option and for roles data file use '-r' option. An example overcloud deploy command is shown below:

Verify deployment

If the containers are in restarting state or not listed by the following command then your deployment is not done correctly. Please recheck if you followed the complete documentation.

On Controller node

Make sure Trilio dmapi and horizon containers are in a running state and no other Trilio container is deployed on controller nodes.

On Compute node

Make sure Trilio datamover container is in running state and no other Trilio container is deployed on compute nodes.

On the node with Horizon service

Configure Trilio Appliance

Once RHOSP16.1 Installation steps have completed successfully, follow the instructions below to now configure the Trilio Appliance.

Change the nova user id on the Trilio Nodes

In RHOSP, 'nova' user id on nova-compute docker container is set to '42436'. The 'nova' user id on the Trilio nodes need to be set the same. Do the following steps on all Trilio nodes:

Download the shell script that will change the user id
Assign executable permissions
Execute the script

Run the Trilio configurator

Follow .

Change the workloadmgr.conf to use the right mountpoint

It is necessary to first configure the Trilio appliance, before the steps of this section can be done.

Please follow these steps to align the mountpoints:

Edit /etc/workloadmgr/workloadmgr.conf file
Set parameter 'vault_data_directory' to '/var/lib/nova/triliovault-mounts'
create the directory for the mountpoint

Troubleshooting for overcloud deployment failures

Trilio components will be deployed using puppet scripts.

In case of the overcloud deployment failing does the following command provide the list of errors:

Further commands that can help identifying any errors.

In case of the trilio datamover api container is failing to start or stuck in restart, check these logs:

In case of Trilio datamover container failing to start or being stuck in restart, check these logs:

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

If Cinder backend is Ceph it is necessary to manually add the ceph details to tvault-contego.conf on all compute nodes.

The file can be found here: /var/lib/config-data/puppet-generated/triliodm/etc/tvault-contego/tvault-contego.conf

Add the following information:

The same block of information can be found in the nova.conf file.

Installing Trilio Components

Installing on RHOSP13

hashtagPrepare for deployment

hashtagClone triliovault-cfg-scripts repository and upload Trilio puppet module

hashtagUpdate overcloud roles data file to include Trilio services

hashtagTrilio Datamover Api Service

hashtagTrilio Datamover Service

hashtagPrepare Trilio container images

hashtagRemote Registry

hashtagLocal Registry

hashtagSatellite Server

hashtagProvide environment details in trilio-env.yaml

hashtagDeploy overcloud with trilio environment

hashtagVerify deployment

hashtagOn Controller node

hashtagOn Compute node

hashtagConfigure Trilio Appliance

hashtagChange the nova user id on the Trilio Nodes

hashtagRun the Trilio configurator

hashtagChange the workloadmgr.conf to use the right mountpoint

hashtagTroubleshooting for overcloud deployment failures

hashtagCinder backend is Ceph - additional steps

hashtagAdd Ceph details to configuration file

hashtagRestart the datamover container

Installing on RHOSP16.0

hashtagPrepare for deployment

hashtagUpdate overcloud roles data file to include Trilio services

hashtagTrilio Datamover Api Service

hashtagTrilio Datamover Service

hashtagPrepare Trilio container images

hashtagRemote Registry

hashtagLocal Registry

hashtagSatellite Server

hashtagProvide environment details in trilio-env_osp16.yaml

hashtagDeploy overcloud with trilio environment

hashtagVerify deployment

hashtagOn Controller node

hashtagOn Compute node

hashtagOn the node with Horizon service

hashtagConfigure Trilio Appliance

hashtagChange the nova user id on the Trilio Nodes

hashtagRun the Trilio configurator

hashtagChange the workloadmgr.conf to use the right mountpoint

hashtagTroubleshooting for overcloud deployment failures

hashtagCinder backend is Ceph - additional steps

hashtagAdd Ceph details to configuration file

hashtagRestart the datamover container

Installing on RHOSP16.1

hashtagPrepare for deployment

hashtagUpdate overcloud roles data file to include Trilio services

hashtagTrilio Datamover Api Service

hashtagTrilio Datamover Service

hashtagPrepare Trilio container images

hashtagRemote Registry

hashtagLocal Registry

hashtagSatellite Server

hashtagProvide environment details in trilio-env_osp16.yaml

hashtagDeploy overcloud with trilio environment

hashtagVerify deployment

hashtagOn Controller node

hashtagOn Compute node

hashtagOn the node with Horizon service

hashtagConfigure Trilio Appliance

hashtagChange the nova user id on the Trilio Nodes

hashtagRun the Trilio configurator

hashtagChange the workloadmgr.conf to use the right mountpoint

hashtagTroubleshooting for overcloud deployment failures

hashtagCinder backend is Ceph - additional steps

hashtagAdd Ceph details to configuration file

hashtagRestart the datamover container

Installing on Canonical Openstack Queens and Train

Installing on Kolla Train

hashtagChange the nova user id on the Trilio Nodes

hashtagDeploy Trilio Datamover API on all Openstack controller nodes

hashtagPull TrilioVaullt Datamover API container image

hashtagCreate the Trilio Datamover API configuration

hashtagCreate config directory for trilio-datamover-api service

hashtagGet the trilio-datamover-api default config file

hashtagEdit dmapi.conf

hashtagCopy nova.conf of nova-api service to trilio-datamover-api directory

Prepare for deployment

Clone triliovault-cfg-scripts repository and upload Trilio puppet module

Update overcloud roles data file to include Trilio services

Trilio Datamover Api Service

Trilio Datamover Service

Prepare Trilio container images

Remote Registry

Local Registry

Satellite Server

Provide environment details in trilio-env.yaml

Deploy overcloud with trilio environment

Verify deployment

On Controller node

On Compute node

Configure Trilio Appliance

Change the nova user id on the Trilio Nodes

Run the Trilio configurator

Change the workloadmgr.conf to use the right mountpoint

Troubleshooting for overcloud deployment failures

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

Restart the datamover container

Prepare for deployment

Update overcloud roles data file to include Trilio services

Trilio Datamover Api Service

Trilio Datamover Service

Prepare Trilio container images

Remote Registry

Local Registry

Satellite Server

Provide environment details in trilio-env_osp16.yaml

Deploy overcloud with trilio environment

Verify deployment

On Controller node

On Compute node

On the node with Horizon service

Configure Trilio Appliance

Change the nova user id on the Trilio Nodes

Run the Trilio configurator

Change the workloadmgr.conf to use the right mountpoint

Troubleshooting for overcloud deployment failures

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

Restart the datamover container

Prepare for deployment

Update overcloud roles data file to include Trilio services

Trilio Datamover Api Service

Trilio Datamover Service

Prepare Trilio container images

Remote Registry

Local Registry

Satellite Server

Provide environment details in trilio-env_osp16.yaml

Deploy overcloud with trilio environment

Verify deployment

On Controller node

On Compute node

On the node with Horizon service

Configure Trilio Appliance

Change the nova user id on the Trilio Nodes

Run the Trilio configurator

Change the workloadmgr.conf to use the right mountpoint

Troubleshooting for overcloud deployment failures

Cinder backend is Ceph - additional steps

Add Ceph details to configuration file

Restart the datamover container

Change the nova user id on the Trilio Nodes

Deploy Trilio Datamover API on all Openstack controller nodes

Pull TrilioVaullt Datamover API container image

Create the Trilio Datamover API configuration

Create config directory for trilio-datamover-api service

Get the trilio-datamover-api default config file

Edit dmapi.conf

Copy nova.conf of nova-api service to trilio-datamover-api directory

Create trilio-datamover-api log directory

Add trilio-datamover-api to haproxy.cfg

Run trilio-datamover-api container

Verify deployment of trilio-datamover-api container

Deploy Trilio Datamover container on all Compute nodes

Pull Trilio Datamover container