mayactl

The mayactl is a command line tool for interacting with OpenEBS volumes and Pools. The mayactl is not used or required while provisioning or managing the OpenEBS volumes, but it is currently used while debugging and troubleshooting. OpenEBS volume and pool status can be get using the mayactl command.

Summary

Command used with mayactl

Accessing mayactl

Using mayactl

Commands used with mayactl

The following commands can be run using mayactl to get the details of OpenEBS volume, StoragePool and installed version.

1. OpenEBS volume related
   • mayactl volume list
   • mayactl volume stats
   • mayactl volume describe
2. OpenEBS StoragePool related
   • mayactl pool list
   • mayactl pool describe
3. OpenEBS version related
   • mayactl version

Accessing mayactl

For getting access to mayactl command line tool, you have to login or execute into the maya-apiserver pod on Kubernetes. The steps are outlined below.

1. Find out the name of the maya-apiserver

   kubectl get pod -n openebs | grep -i api

   Following is an example output.

   maya-apiserver-7f5689b96b-p1p2p 1/1 Running 0 10d

2. It is possible that there are multiple instances of maya-apiserver pods for scaling purposes. You can run mayactl in any one of them. Shell into one of the pods using kubectl exec command . You can do as following way.

   kubectl exec -it <maya-apiserver-podname> /bin/bash -n openebs

   You will get access to the bash shell of maya-apiserver pod like shown below.

   bash-4.3#

Using mayactl

Once you are inside the maya -apiserver,use mayactl help command for more details.

mayactl help

Example Output:

Maya means 'Magic' a tool for storage orchestration

Usage:

mayactl [command]

Available Commands:

completion Outputs shell completion code for the specified shell (bash or zsh)

help Help about any command

pool Provides operations related to a storage pool

version Prints version and other details relevant to maya

volume Provides operations related to a Volume

mayactl for OpenEBS Storage Volume

OpenEBS storage volume command usage examples are shown below.

mayactl volume

Example Output:

The following commands helps in operating a Volume such as create, list, and so on.

Usage: mayactl volume <subcommand> [options] [args]

Examples:

> List Volumes:

$ mayactl volume list

> Statistics of a Volume:

$ mayactl volume stats --volname <vol>

> Statistics of a Volume created in 'test' namespace:

$ mayactl volume stats --volname <vol> --namespace test

> Info of a Volume:

$ mayactl volume describe --volname <vol>

> Info of a Volume created in 'test' namespace:

$ mayactl volume describe --volname <vol> --namespace test

Usage:

mayactl volume [command]

Available Commands:

describe Displays Openebs Volume information

list Displays status information about Volume(s)

stats Displays the runtime statistics of Volume

The following command shows the list of all OpenEBS volumes including both Jiva and cStor.

mayactl volume list

Example Output:

Namespace Name Status Type Capacity StorageClass Access Mode

--------- ---- ------ ---- -------- ------------- -----------

openebs pvc-dc3cb979-51ec-11e9-803f-42010a800179 Running cstor 8G openebs-cstor-sparse ReadWriteOnce

The following command shows the description of a OpenEBS volume.

mayactl volume describe --volname pvc-dc3cb979-51ec-11e9-803f-42010a800179 -n openebs

Example Output:

Portal Details :

-------- --------

IQN : iqn.2016-09.com.openebs.cstor:pvc-dc3cb979-51ec-11e9-803f-42010a800179

Volume : pvc-dc3cb979-51ec-11e9-803f-42010a800179

Portal : 10.67.247.34:3260

Size : 8G

Controller Status : running,running,running

Controller Node : gke-ranjith-082-default-pool-2cd2b6cb-l4ck

Replica Count : 3

Replica Details :

-----------------

NAME STATUS POOL NAME NODE

---- ------ --------- -----

pvc-dc3cb979-51ec-11e9-803f-42010a800179-cstor-sparse-pool-ejs2 Running cstor-sparse-pool-ejs2 gke-ranjith-082-default-pool-2cd2b6cb-d456

pvc-dc3cb979-51ec-11e9-803f-42010a800179-cstor-sparse-pool-gf1d Running cstor-sparse-pool-gf1d gke-ranjith-082-default-pool-2cd2b6cb-l4ck

pvc-dc3cb979-51ec-11e9-803f-42010a800179-cstor-sparse-pool-m8cy Running cstor-sparse-pool-m8cy gke-ranjith-082-default-pool-2cd2b6cb-x571

The following command shows the live statistics of OpenEBS volume.

mayactl volume stats --volname pvc-448deccf-40d9-11e9-a23b-0050569331ce -n openebs

Example Output:

Portal Details :

------ ---------

Volume : pvc-dc3cb979-51ec-11e9-803f-42010a800179

Size : 5.000000

Performance Stats :

------ ---------

r/s w/s r(MB/s) w(MB/s) rLat(ms) wLat(ms)

---- ---- -------- -------- --------- ---------

0 121 0.000 0.013 0.000 9.495

Capacity Stats :

------ ---------

LOGICAL(GB) USED(GB)

------------ ---------

0.000 3.246

mayactl for OpenEBS Storage Pools

OpenEBS storage pool command usage examples are shown below.

mayactl pool

It will show the available commands which can run with mayactl for getting details of OpenEBS pools.

Command provides operations related to a storage pools.

Usage: mayactl pool <subcommand> [options] [args]

Examples:

> Lists pool:

$ mayactl pool list

Usage:

mayactl pool [command]

Available Commands:

describe Describes the pools

list Lists all the pools

The following command shows the list of all OpenEBS StoragePools.

mayactl pool list

Example Output:

POOL NAME NODE NAME POOL TYPE

--------- --------- ---------

cstor-pool1-5lwv node3.mayalab.com striped

cstor-pool1-qba6 node2.mayalab.com striped

cstor-pool1-v4oy node4.mayalab.com striped

The following command show the description of OpenEBS StoragePool.

mayactl pool describe --poolname cstor-pool1-5lwv

Example Output:

Pool Details :

------ ------

Storage Pool Name : cstor-pool1-5lwv

Node Name : node3.mayalab.com

CAS Template Used : cstor-pool-create-default-0.9.0

CAS Type : cstor

StoragePoolClaim : cstor-pool1

UID : fb2bd1d8-2f88-11e9-a23b-0050569331ce

Pool Type : striped

Over Provisioning : false

Disk List :

------ ------

disk-42b4fb20cd36896dfc2a486b977363de

mayactl Version

OpenEBS installed version can be obtained using the following command. This will show the status of maya-apiserver and its URL.

mayactl version

Example Output:

Version: 1.2.0-released

Git commit: c00fc22aab1425e824ed24ed4b7e6f49c9c1468c

GO Version: go1.11.2

GO ARCH: amd64

GO OS: linux

m-apiserver url: http://10.44.1.5:5656

m-apiserver status: running

See Also:

FAQ Troubleshooting Guide