Installing on other supported Openstack distributions

Installing Trilio Nova API Extension on Controller Node¶

The next step in the installation process is to install the Trilio Nova API extension on each of the Nova API controller nodes. The purpose of the API extension is to route RESTful API calls to a Trilio Data Mover (which will be discussed next).

In case of multiple Controller nodes it is necessary to repeat these steps on all controller nodes running the Nova API service.

To install the Trilio Nova Extension on each Nova controller node, follow these steps after logging into a controller node.

[root@controller]# wget https://<ipaddress-of-triliovault-controller>/tvault-contego-install.sh --no-check-certificate
[root@controller]# chmod +x tvault-contego-install.sh
[root@controller]# ./tvault-contego-install.sh --install

Once the script has been started does it prompt for the following information:

Trilio IP This IP will be used to download the Trilio Nova API Extension pip packages.
Request whether the script is running on a Controller or Compute Node To install the Trilio Nova API Extension choose Controller

The Trilio Nova API extension is a download from Trilio appliance and installed on the controller node. After installation, the Nova-API service is restarted to load the Trilio Nova API extension into Nova-API process so Nova-API now can handle Data Mover requests from the Trilio appliance.

Installing Trilio Data Mover on Computer Node

Now it is time to install the Trilio Data Mover service on the compute nodes where the Nova Compute service is running. The purpose of the Data Mover service is, as the name says, to move the actual disk data to and from the backup target.

The Trilio Data Mover needs to be installed on all Compute Nodes to guarantee the possible protection of all VMs running inside the Openstack Cluster.

To install the Trilio Data Mover on a Compute node, follow these steps after logging into a compute node.

[root@compute]# wget https://<ipaddress-of-triliovault-controller>/tvault-contego-install.sh --no-check-certificate
[root@compute]# chmod +x tvault-contego-install.sh

At this point it is possible to run the installation either in an automated fashion or in an interactive mode.

Interactive install of the Trilio Data Mover

The following command will start the interactive installation.

[root@compute]# ./tvault-contego-install.sh  --install

Once the script has been started does it prompt for the following information:

Trilio IP This IP will be used to download the Trilio Nova API Extension pip packages.
Request whether the script is running on a Controller or Compute Node To install the Trilio Data Mover service choose Compute Node.
Request of the path to the compute.filters file Choose matching your distribution or provide the exact path.
Acceptance of Trilio changing the sudoers file for nova nova ALL = (root) NOPASSWD: /home/tvault/.virtenv/bin/privsep-helper *
Choose between NFS or S3 as backup target
In case of NFS
1. Provide the NFS Volume path
2. check and change the default NFS options if necessary
In case of S3
1. Choose the S3 profile to be used
2. provide access credentials according to the chosen profile

Automated installation of Trilio Data Mover¶

The Trilio Data Mover can be installed in an unattended way using a configuration file. The configuration file contains all the data that is required while the script is being executed.

The first step for the automated installation is to generate the answers file. A predefined file can be downloaded from any Trilio VM.

[root@compute]# wget https://<ipaddress-of-triliovault-controller>/tvault-contego-install.answers --no-check-certificate

Edit tvault-contego-install.answers file as required for compute nodes. An example can be seen below:

####IP address of Tvault appliance###

IP_ADDRESS=192.168.1.122
TVAULT_CONTEGO_EXT_USER=nova
TVAULT_CONTEGO_EXT_GROUP=nova

#Uncomment following node which you want to configure##
#controller=True
compute=True

#Need to add the following statement in nova sudoers file
#nova ALL = (root) NOPASSWD: /home/tvault/.virtenv/bin/privsep-helper *
#These changes require for Datamover, Otherwise Datamover will not work
# if you are agree then please uncomment the below line   NOVA_SUDOERS=require
#NOVA_SUDOERS=require

#Nova compute.filters file path
#Uncomment following line as per the OS distribution, you can edit the path as per your nova configuration
###For RHEL systems
NOVA_COMPUTE_FILTERS_FILE=/usr/share/nova/rootwrap/compute.filters

###For Debian systems
#NOVA_COMPUTE_FILTERS_FILE=/etc/nova/rootwrap.d/compute.filters

##For any other system
##NOVA_COMPUTE_FILTERS_FILE=


##### Select snapshot storage type #####
#Uncomment following two lines and edit for NFS as snapshot storage, Provide multiple nfs shares separated by comma
NFS=True
NFS_SHARES=192.168.1.33:/mnt/tvault,192.168.1.33:/mnt/tvault_1

#### Uncomment following lines and edit for Swift as snapshot storage
#Swift=False
#VAULT_SWIFT_AUTH_URL=
#VAULT_SWIFT_TENANT=
#VAULT_SWIFT_USERNAME=
#VAULT_SWIFT_PASSWORD=
#VAULT_SWIFT_DOMAIN_ID=
### TEMPAUTH / KEYSTONEV2/ KEYSTONEV3
#VAULT_SWIFT_AUTH_VERSION=TEMPAUTH

#### Uncomment following lines and edit for S3 as snapshot storage
#S3=True
#VAULT_S3_ACCESS_KEY=
#VAULT_S3_SECRET_ACCESS_KEY=
#VAULT_S3_REGION_NAME=
#VAULT_S3_BUCKET=
#### S3 Specific Backend Configurations
#### Uncomment one of the following for the specific S3 type
#Amazon=True
#other_S3_compatible_storage=True

#### Required field(s) for all S3 backends except Amazon
### IP Address:Port Ex: http://192.168.1.33:9000
#VAULT_S3_ENDPOINT_URL=
### True / False
#VAULT_S3_SECURE=


#### Required field(s) for Minio
### Required Signature version s3v4
#VAULT_S3_SIGNATURE_VERSION=s3v4

Once the answersfile has been created can it be used to run the Data Mover installation unattended, which allows the automation of the installation process.

[root@compute]# ./tvault-contego-install.sh –install –file <path to answersfile>

Start the Trilio Data Mover service

At the end of the installation is the Data Mover service deactivated.

To start the service using the installation script run:

[root@compute]# ./tvault-contego-install.sh  --start

Alternatively can the operating system service control commands be used to start the service tvault-contego.service

Install Trilio Horizon Plugin¶

The last component to install is the Trilio Horizon Plugin on the Controllers where the Openstack Horizon service is running. The purpose of the Horizon Plugin is, to provide the native integration of TrlioVault into the GUI of Openstack.

To install the Trilio Horizon Plugin on each Openstack Horizon controller node, follow these steps after logging into a controller node.

[root@controller]# wget https://<ipaddress-of-triliovault-controller>/tvault-horizon-plugin-install.sh --no-check-certificate
[root@controller]# chmod +x tvault-horizon-plugin-install.sh
[root@controller]# ./tvault-horizon-plugin-install.sh

The installation of the Trilio Horizon Plugin will restart the Openstack Horizon service.

PreviousInstalling on RHOSP10 NextConfiguring Trilio

Last updated 1 year ago