Bug 1482103

Summary:	[Doc RFE] Document the set volume options via heketi-cli commands.
Product:	[Red Hat Storage] Red Hat Gluster Storage	Reporter:	Anjana Suparna Sriram <asriram>
Component:	doc-Container_Native_Storage_with_OpenShift	Assignee:	Bhavana <bmohanra>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Apeksha <akhakhar>
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	cns-3.6	CC:	asriram, bmohanra, hchiramm, madam, mliyazud, pprakash, rcyriac, rhs-bugs, storage-doc, storage-qa-internal
Target Milestone:	---	Flags:	hchiramm: needinfo-
Target Release:	CNS 3.6
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:	1480123	Environment:
Last Closed:		Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1480123
Bug Blocks:	1445453

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