Install workloadmgr CLI client

About the workloadmgr CLI client
The workloadmgr CLI client is provided as rpm and deb packages.
It got tested against the following operating systems:
CentOS7, CentOS8
Ubuntu 18.04, Ubuntu 20.04
Installing the workloadmgr client will automatically install all required Openstack clients as well.
Further will the installation of the workloadmgr client integrate the client into the global openstack python client, if available.
The required connection strings and package names can be found on the TrilioVault Dashboard under the Downloads tab.
Install workloadmgr client rpm package on CentOS7/8
The TrilioVault workload manager CLI client has several requirements that need to be met before the client can be installed without dependency issues.
Preparing the workloadmgr client installation
The following steps need to be done to prepare the installation the workloadmgr client:
Add required repositories
epel-release
for CentOS7: centos-release-openstack-stein
for CentOS8: centos-release-openstack-train
install base packages
yum -y install epel-release
for CentOS7: yum -y install centos-release-openstack-stein
for CentOS8: yum -y install centos-release-openstack-train
These repositories are required to fulfill the following dependencies:
On CentOS7 Python2: python-pbr,python-prettytable,python2-requests,python2-simplejson,python2-six,pytz,PyYAML,python2-openstackclient
On CentOS8 Python3: python3-pbr,python3-prettytable,python3-requests,python3-simplejson,python3-six,python3-pyyaml,python3-pytz,python3-openstackclient
Installing the workloadmgr client
There are 2 possibilities for how the workloadmgr client packages can be installed.
Download from the TrilioVault Appliance and install directly
The TrilioVault appliance is shipping the workloadmgr client version, that is matching the TrilioVault version of the TrilioVault appliance. These clients will always work with their respective TrilioVault versions.
The workloadmgr client can be directly downloaded using the following command:
For CentOS7: 
wget http://<TVM-IP>:8085/yum-repo/queens/workloadmgrclient-<TrilioVault-Version>-<TrilioVault-Release>.noarch.rpm 
For CentOS8: http://<TVM-IP>:8085/yum-repo/queens/python3-workloadmgrclient-<TrilioVault-Version>-<TVault-Release>.noarch.rpm 
To identify the TrilioVault Version and TrilioVault release login into the TrilioVault Dashboard and check the upper left corner. 
The yum package manager is used to install the workloadmgr client package:
 yum install workloadmgrclient-<TrilioVault-Version>-<TrilioVault-Release>.noarch.rpm
An example installation can be found below:
[[email protected] ~]# wget http://10.10.2.15:8085/yum-repo/queens/workloadmgrclient-4.0.115-4.0.noarch.rpm
--2021-03-08 15:36:37--  http://10.10.2.15:8085/yum-repo/queens/workloadmgrclient-4.0.115-4.0.noarch.rpm
Connecting to 10.10.2.15:8085... connected.
HTTP request sent, awaiting response... 200 OK
Length: 155976 (152K) [application/x-rpm]
Saving to: ‘workloadmgrclient-4.0.115-4.0.noarch.rpm’
​
100%[======================================>] 1,55,976    --.-K/s   in 0.001s
​
2021-03-08 15:36:37 (125 MB/s) - ‘workloadmgrclient-4.0.115-4.0.noarch.rpm’ saved [155976/155976]
​
[[email protected] ~]# yum install workloadmgrclient-4.0.115-4.0.noarch.rpm
Loaded plugins: fastestmirror
Examining workloadmgrclient-4.0.115-4.0.noarch.rpm: workloadmgrclient-4.0.115-4.                                                                                                                                                                                                                                                                                                                                                           0.noarch
Marking workloadmgrclient-4.0.115-4.0.noarch.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package workloadmgrclient.noarch 0:4.0.115-4.0 will be installed
--> Finished Dependency Resolution
​
Dependencies Resolved
​
================================================================================
 Package         Arch   Version     Repository                             Size
================================================================================
Installing:
 workloadmgrclient
                 noarch 4.0.115-4.0 /workloadmgrclient-4.0.115-4.0.noarch 700 k
​
Transaction Summary
================================================================================
Install  1 Package
​
Total size: 700 k
Installed size: 700 k
Is this ok [y/d/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : workloadmgrclient-4.0.115-4.0.noarch                         1/1
  Verifying  : workloadmgrclient-4.0.115-4.0.noarch                         1/1
​
Installed:
  workloadmgrclient.noarch 0:4.0.115-4.0
​
Complete!
Installing from the TrilioVault online repository
To install the latest available workloadmgr package for a TrilioVault release from the Trilio repository the following steps need to be done:
Create the TrilioVault yum repository file /etc/yum.repos.d/trilio.repo 
Enter the following details into the repository file:
[trilio]
name=Trilio Repository
baseurl=http://trilio:[email protected]:8283/triliovault-<TrilioVault-Release>/yum/
enabled=1
gpgcheck=0
Install the workloadmgr client issuing the following command:
For CentOS7: yum install workloadmgrclient
For CentOS8: yum install python-3-workloadmgrclient-el8
An example installation can be found below:
[[email protected] ~]# cat /etc/yum.repos.d/trilio.repo
[trilio]
name=Trilio Repository
baseurl=http://trilio:XpmkpMFviqSe[email protected]:8283/triliovault-4.0/yum/
enabled=1
gpgcheck=0
​
[[email protected] ~]# yum install workloadmgrclient
Loaded plugins: fastestmirror
Determining fastest mirrors
 * base: centos-canada.vdssunucu.com.tr
 * centos-ceph-nautilus: mirror.its.dal.ca
 * centos-nfs-ganesha28: centos.mirror.colo-serv.net
 * centos-openstack-train: centos-canada.vdssunucu.com.tr
 * centos-qemu-ev: centos-canada.vdssunucu.com.tr
 * extras: centos-canada.vdssunucu.com.tr
 * updates: centos-canada.vdssunucu.com.tr
base                                                                                                                                                                                                                                                                                                                                                                                                                | 3.6 kB  00:00:00
centos-ceph-nautilus                                                                                                                                                                                                                                                                                                                                                                                                | 3.0 kB  00:00:00
centos-nfs-ganesha28                                                                                                                                                                                                                                                                                                                                                                                                | 3.0 kB  00:00:00
centos-openstack-train                                                                                                                                                                                                                                                                                                                                                                                              | 3.0 kB  00:00:00
centos-qemu-ev                                                                                                                                                                                                                                                                                                                                                                                                      | 3.0 kB  00:00:00
extras                                                                                                                                                                                                                                                                                                                                                                                                              | 2.9 kB  00:00:00
trilio                                                                                                                                                                                                                                                                                                                                                                                                              | 2.9 kB  00:00:00
updates                                                                                                                                                                                                                                                                                                                                                                                                             | 2.9 kB  00:00:00
(1/3): extras/7/x86_64/primary_db                                                                                                                                                                                                                                                                                                                                                                                   | 225 kB  00:00:00
(2/3): centos-openstack-train/7/x86_64/primary_db                                                                                                                                                                                                                                                                                                                                                                   | 1.1 MB  00:00:00
(3/3): updates/7/x86_64/primary_db                                                                                                                                                                                                                                                                                                                                                                                  | 5.7 MB  00:00:00
Resolving Dependencies
--> Running transaction check
---> Package workloadmgrclient.noarch 0:4.0.116-4.0 will be installed
--> Finished Dependency Resolution
​
Dependencies Resolved
​
===========================================================================================================================================================================================================================================================================================================================================================================================================================================
 Package                                                                                                         Arch                                                                                                 Version                                                                                                   Repository                                                                                            Size
===========================================================================================================================================================================================================================================================================================================================================================================================================================================
Installing:
 workloadmgrclient                                                                                               noarch                                                                                               4.0.116-4.0                                                                                               trilio                                                                                               152 k
​
Transaction Summary
===========================================================================================================================================================================================================================================================================================================================================================================================================================================
Install  1 Package
​
Total download size: 152 k
Installed size: 700 k
Is this ok [y/d/N]: y
Downloading packages:
workloadmgrclient-4.0.116-4.0.noarch.rpm                                                                                                                                                                                                                                                                                                                                                                            | 152 kB  00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : workloadmgrclient-4.0.116-4.0.noarch                                                                                                                                                                                                                                                                                                                                                                                    1/1
  Verifying  : workloadmgrclient-4.0.116-4.0.noarch                                                                                                                                                                                                                                                                                                                                                                                    1/1
​
Installed:
  workloadmgrclient.noarch 0:4.0.116-4.0
​
Complete!
Install workloadmgr client deb packages on Ubuntu
The TrilioVault workloadmgr client packages for Ubuntu are only available from the online repository. 
Preparing the workloadmgr client installation
There is no preparation required. All dependencies are automatically resolved by the standard repositories provided by Ubuntu.
Installing the Workloadmgr client
There are 2 possibilities for how the workloadmgr client packages can be installed.
Download from the TrilioVault Appliance and install directly
The TrilioVault appliance is shipping the workloadmgr client version, that is matching the TrilioVault version of the TrilioVault appliance. These clients will always work with their respective TrilioVault versions.
The workloadmgr client can be directly downloaded using the following command:
For Python2:
curl -Og6 http://<TVM-IP>:8085/deb-repo/deb-repo/python-workloadmgrclient_<TrilioVault-Version>_all.deb
For Python3:curl -Og6 http://<TVM-IP>:8085/deb-repo/deb-repo/python3-workloadmgrclient_<TrilioVault-Version>_all.deb
o identify the TrilioVault Version and TrilioVault release login into the TrilioVault Dashboard and check the upper left corner. 
The apt package manager is used to install the workloadmgr client package:
For Python2:apt-get install ./python-workloadmgrclient_<TrilioVault-Version>_all.deb -y
For Python3:apt-get install ./python3-workloadmgrclient_<TrilioVault-Version>_all.deb -y
An example installation can be found below:
[email protected]:~# curl -Og6 http://10.10.2.15:8085/deb-repo/deb-repo/python3-workloadmgrclient_4.0.115_all.deb
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  116k  100  116k    0     0   899k      0 --:--:-- --:--:-- --:--:--  982k
​
[email protected]:~# apt-get install ./python3-workloadmgrclient_4.0.115_all.deb -y
Reading package lists... Done
Building dependency tree
Reading state information... Done
Note, selecting 'python3-workloadmgrclient' instead of './python3-workloadmgrclient_4.0.115_all.deb'
The following NEW packages will be installed:
  python3-workloadmgrclient
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 0 B/120 kB of archives.
After this operation, 736 kB of additional disk space will be used.
Selecting previously unselected package python3-workloadmgrclient.
(Reading database ... 65533 files and directories currently installed.)
Preparing to unpack .../python3-workloadmgrclient_4.0.115_all.deb ...
Unpacking python3-workloadmgrclient (4.0.115) ...
Setting up python3-workloadmgrclient (4.0.115) ...
Installing from the TrilioVault online repository
To install the latest available workloadmgr package for a TrilioVault release from the Trilio repository the following steps need to be done:
Create the TrilioVault yum repository file /etc/apt/sources.list.d/fury.list 
Enter the following details into the repository file:
deb [trusted=yes] https://apt.fury.io/triliodata-<TrilioVault-Version>/ /
run apt update to make the new repository available.
The apt package manager is used to install the workloadmgr client package:
For Python2:apt-get install python-workloadmgrclient
For Python3:apt-get install python3-workloadmgrclient
An example installation can be seen below:
[email protected]:~# cat /etc/apt/sources.list.d/fury.list
deb [trusted=yes] https://apt.fury.io/triliodata-4-0/ /
​
[email protected]:~# apt update
Hit:1 http://security.ubuntu.com/ubuntu bionic-security InRelease
Hit:2 http://archive.ubuntu.com/ubuntu bionic InRelease
Hit:3 http://archive.ubuntu.com/ubuntu bionic-updates InRelease
Hit:4 http://archive.ubuntu.com/ubuntu bionic-backports InRelease
Ign:5 https://apt.fury.io/triliodata-4-0  InRelease
Ign:6 https://apt.fury.io/triliodata-4-0  Release
Ign:7 https://apt.fury.io/triliodata-4-0  Packages
Ign:8 https://apt.fury.io/triliodata-4-0  Translation-en
Get:7 https://apt.fury.io/triliodata-4-0  Packages
Ign:8 https://apt.fury.io/triliodata-4-0  Translation-en
Ign:8 https://apt.fury.io/triliodata-4-0  Translation-en
Ign:8 https://apt.fury.io/triliodata-4-0  Translation-en
Ign:8 https://apt.fury.io/triliodata-4-0  Translation-en
Ign:8 https://apt.fury.io/triliodata-4-0  Translation-en
Ign:8 https://apt.fury.io/triliodata-4-0  Translation-en
Fetched 84.0 kB in 12s (6930 B/s)
Reading package lists... Done
Building dependency tree
Reading state information... Done
All packages are up to date.
​
[email protected]:~# apt-get install python3-workloadmgrclient
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
  python3-workloadmgrclient
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 0 B/120 kB of archives.
After this operation, 736 kB of additional disk space will be used.
Selecting previously unselected package python3-workloadmgrclient.
(Reading database ... 65533 files and directories currently installed.)
Preparing to unpack .../python3-workloadmgrclient_4.0.115_all.deb ...
Unpacking python3-workloadmgrclient (4.0.115) ...
Setting up python3-workloadmgrclient (4.0.115) ...
​
Upgrade TrilioVault Appliance
Next - Deployment Guide
Switch Backup Target on Kolla-ansible
Last updated 5 months ago