Bug 1838943

Summary: [Docs] Clarify steps on section 6.4.3. Sharing Volumes over SMB
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Miguel Duaso <mduasope>
Component: doc-Administration_GuideAssignee: Amrita <asakthiv>
doc-Administration_Guide sub component: Default QA Contact: susgupta
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: low    
Priority: unspecified CC: asakthiv, asriram, mmuench, puebele, rhs-bugs, storage-doc
Version: rhgs-3.5Keywords: ZStream
Target Milestone: ---   
Target Release: RHGS 3.5.z Batch Update 3   
Hardware: Unspecified   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-01-11 08:57:26 UTC 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:    
Bug Blocks: 1822639    

Description Miguel Duaso 2020-05-22 06:34:17 UTC 
Document URL: 
https://access.redhat.com/documentation/en-us/red_hat_gluster_storage/3.5/html/administration_guide/sect-smb#sect-Sharing_Volumes_over_SMB

Section Number and Name: 
6.4.3. Sharing Volumes over SMB

Describe the issue: 
On the steps below, emphasize that this has to be done on all nodes that share the gluster volume and provide an example to easy understand what is required in a few lines. This is what we can read:

"If you are using Samba-4.9.8-109 or later:"
...

... "Following steps need to be performed on every node in the cluster." 

   "1. Mount GlusterFS volume via FUSE and record the FUSE mountpoint for further steps: "


Suggestions for improvement: 
I'll propose to high light this on the documentation:

   1. Have a local mount using native gluster protocol fuse on every gluster node that shares the gluster volume via samba : Mount GlusterFS volume via FUSE and record the FUSE mountpoint for further steps: 

For example, for gluster volume "myvol" and mount point "/mylocal" , add on /etc/fstab an entry like:

localhost:/myvol /mylocal glusterfs defaults,_netdev,acl 0 0


Additional information: