Bug 1482103 - [Doc RFE] Document the set volume options via heketi-cli commands.
Summary: [Doc RFE] Document the set volume options via heketi-cli commands.
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Container_Native_Storage_with_OpenShift
Version: cns-3.6
Hardware: Unspecified
OS: Unspecified
unspecified
low
Target Milestone: ---
: CNS 3.6
Assignee: Bhavana
QA Contact: Apeksha
URL:
Whiteboard:
Depends On: 1480123
Blocks: 1445453
TreeView+ depends on / blocked
 
Reported: 2017-08-16 13:09 UTC by Anjana Suparna Sriram
Modified: 2017-11-17 05:29 UTC (History)
10 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of: 1480123
Environment:
Last Closed:
Embargoed:
hchiramm: needinfo-


Attachments (Terms of Use)

Comment 2 Bhavana 2017-08-29 03:53:39 UTC
Hi Humble,

Can you please share the steps/information that needs to be highlighted in the doc for set volume options via heketi-cli commands.

Comment 3 Humble Chirammal 2017-09-06 19:10:57 UTC
(In reply to Bhavana from comment #2)
> Hi Humble,
> 
> Can you please share the steps/information that needs to be highlighted in
> the doc for set volume options via heketi-cli commands.

At section "enabling encryption" on statically provisioned volumes, we need to use below command:
 
$ heketi-cli volume create --size=100 --options="client.ssl on","server.ssl on"



instead of:

# oc rsh <gluster_pod_name> gluster volume set VOLNAME client.ssl on
# oc rsh <gluster_pod_name> gluster volume set VOLNAME server.ssl on

In short, the main difference is that, instead of logging in the pod and setting the command, admin can use heketi-cli command directly to set these options.

Comment 5 Prasanth 2017-09-15 18:55:35 UTC
(In reply to Humble Chirammal from comment #3)
> (In reply to Bhavana from comment #2)
> > Hi Humble,
> > 
> > Can you please share the steps/information that needs to be highlighted in
> > the doc for set volume options via heketi-cli commands.
> 
> At section "enabling encryption" on statically provisioned volumes, we need
> to use below command:
>  
> $ heketi-cli volume create --size=100 --options="client.ssl on","server.ssl
> on"
> 

Bhavana, you need to update the above as the correct command would be: 

#  heketi-cli volume create --size=100 --gluster-volume-options="client.ssl on","server.ssl on"

Comment 6 Apeksha 2017-09-20 05:40:42 UTC
Bhavana,

This is the correct command 
# heketi-cli volume create --size=100 --gluster-volume-options="client.ssl on","server.ssl on"

Comment 7 Bhavana 2017-09-20 08:06:19 UTC
I seemed to have Prasanth's comment!

Following is the link with the updated command:

https://access.qa.redhat.com/documentation/en-us/red_hat_gluster_storage/3.3/html-single/container-native_storage_for_openshift_container_platform/#idm139780158619920

Comment 8 Apeksha 2017-09-20 08:20:37 UTC
There is  little confusion here Bhavana.

The heketi-cli command -  
#heketi-cli volume create --size=100 --gluster-volume-options="client.ssl on","server.ssl on"
has to be provided for statically provisioned volumes while creating them.

and at 12.2.2 where volume already exists we need to give these commands:
# oc rsh <gluster_pod_name> gluster volume set VOLNAME client.ssl on
# oc rsh <gluster_pod_name> gluster volume set VOLNAME server.ssl on

Comment 9 Bhavana 2017-09-20 11:55:43 UTC
(In reply to Apeksha from comment #8)
> There is  little confusion here Bhavana.
> 
> The heketi-cli command -  
> #heketi-cli volume create --size=100 --gluster-volume-options="client.ssl
> on","server.ssl on"
> has to be provided for statically provisioned volumes while creating them.
> 
> and at 12.2.2 where volume already exists we need to give these commands:
> # oc rsh <gluster_pod_name> gluster volume set VOLNAME client.ssl on
> # oc rsh <gluster_pod_name> gluster volume set VOLNAME server.ssl on

Made the required change:

https://access.qa.redhat.com/documentation/en-us/red_hat_gluster_storage/3.3/html-single/container-native_storage_for_openshift_container_platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Enabling_Encryption-New_Setup


Note You need to log in before you can comment on or make changes to this bug.