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 Trilio Dashboard under the Downloads tab.

Install workloadmgr client rpm package on CentOS7/8

The Trilio 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:

  1. Add required repositories

    1. epel-release

    2. for CentOS7: centos-release-openstack-stein

    3. for CentOS8: centos-release-openstack-train

  2. install base packages

    1. yum -y install epel-release

    2. for CentOS7: yum -y install centos-release-openstack-stein

    3. 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 Trilio Appliance and install directly

The Trilio appliance is shipping the workloadmgr client version, that is matching the Trilio version of the Trilio appliance. These clients will always work with their respective Trilio versions.

The workloadmgr client can be directly downloaded using the following command:

For CentOS7: wget http://<TVM-IP>:8085/yum-repo/queens/workloadmgrclient-<Trilio-Version>-<Trilio-Release>.noarch.rpm

For CentOS8: http://<TVM-IP>:8085/yum-repo/queens/python3-workloadmgrclient-<Trilio-Version>-<TVault-Release>.noarch.rpm

To identify the Trilio Version and Trilio release login into the Trilio Dashboard and check the upper left corner.

The yum package manager is used to install the workloadmgr client package:

yum install workloadmgrclient-<Trilio-Version>-<Trilio-Release>.noarch.rpm

An example installation can be found below:

[root@controller ~]# 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]

[root@controller ~]# 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 Trilio online repository

To install the latest available workloadmgr package for a Trilio release from the Trilio repository the following steps need to be done:

Create the Trilio yum repository file /etc/yum.repos.d/trilio.repo Enter the following details into the repository file:

[trilio]
name=Trilio Repository
baseurl=http://trilio:XpmkpMFviqSe@repos.trilio.io:8283/triliovault-<Trilio-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:

[root@controller ~]# cat /etc/yum.repos.d/trilio.repo
[trilio]
name=Trilio Repository
baseurl=http://trilio:XpmkpMFviqSe@repos.trilio.io:8283/triliovault-4.0/yum/
enabled=1
gpgcheck=0

[root@controller ~]# 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 Trilio 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 Trilio Appliance and install directly

The Trilio appliance is shipping the workloadmgr client version, that is matching the Trilio version of the Trilio appliance. These clients will always work with their respective Trilio 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_<Trilio-Version>_all.deb

For Python3:curl -Og6 http://<TVM-IP>:8085/deb-repo/deb-repo/python3-workloadmgrclient_<Trilio-Version>_all.deb

o identify the Trilio Version and Trilio release login into the Trilio 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_<Trilio-Version>_all.deb -y For Python3:apt-get install ./python3-workloadmgrclient_<Trilio-Version>_all.deb -y

An example installation can be found below:

root@ubuntu:~# 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

root@ubuntu:~# 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 Trilio online repository

To install the latest available workloadmgr package for a Trilio release from the Trilio repository the following steps need to be done:

Create the Trilio 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-<Trilio-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:

root@ubuntu:~# cat /etc/apt/sources.list.d/fury.list
deb [trusted=yes] https://apt.fury.io/triliodata-4-0/ /

root@ubuntu:~# 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.

root@ubuntu:~# 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) ...

Last updated