6.4. SMB

1. Add the following lines to the [global] section of the smb.conf file. Note that the indentation level shown is required.

               fruit:aapl = yes
               ea support = yes

2. Load the vfs_fruit module and its dependencies by adding the following line to your volume's export configuration block in the smb.conf file.

   vfs objects = fruit streams_xattr glusterfs

   For example:

   [gluster-volname]
   comment = For samba share of volume smbshare
   vfs objects = fruit streams_xattr glusterfs
   glusterfs:volume = volname
   glusterfs:logfile = /var/log/samba/glusterfs-volname-fruit.%M.log
   glusterfs:loglevel = 7
   path = /
   read only = no
   guest ok = yes
   
   fruit:encoding = native

1. Add the user on all the Samba servers based on your configuration:

   # adduser username

2. Add the user to the list of Samba users on all Samba servers and assign password by executing the following command:

   # smbpasswd -a username

3. From any other Samba server, mount the volume using the FUSE protocol.

   # mount -t glusterfs -o acl ip-address:/volname /mountpoint

   For example:

   # mount -t glusterfs -o acl rhs-a:/repvol /mnt

4. Use the setfacl command to provide the required permissions for directory access to the user.

   # setfacl -m user:username:rwx mountpoint

   For example:

   # setfacl -m user:cifsuser:rwx /mnt

1. Install the cifs-utils package on the client.

   # yum install cifs-utils

2. Run mount -t cifs to mount the exported SMB share, using the syntax example as guidance.

   # mount -t cifs -o user=username,pass=password  //hostname/gluster-volname /mountpoint

   The sec=ntlmssp parameter is also required when mounting a volume on Red Hat Enterprise Linux 6.

   # mount -t cifs -o user=username,pass=password,sec=ntlmssp //hostname/gluster-volname /mountpoint

   For example:

   # mount -t cifs -o user=cifsuser,pass=redhat,sec=ntlmssp //server1/gluster-repvol /cifs

   Important

   Red Hat Gluster Storage is not supported on Red Hat Enterprise Linux 6 (RHEL 6) from 3.5 Batch Update 1 onwards. See Version Details table in section Red Hat Gluster Storage Software Components and Versions of the Installation Guide
3. Run # smbstatus -S on the server to display the status of the volume:

   Service        pid     machine             Connected at
   -------------------------------------------------------------------
   gluster-VOLNAME 11967   __ffff_192.168.1.60  Mon Aug  6 02:23:25 2012

Manual mounting process

1. In the Finder, click Go > Connect to Server.
2. In the Server Address field, type the IP address or hostname of a Red Hat Gluster Storage server that hosts the volume you want to mount.
3. Click Connect.
4. When prompted, select Registered User to connect to the volume using a valid username and password.
   If required, enter your user name and password, then select the server volumes or shared folders that you want to mount.
   To make it easier to connect to the computer in the future, select Remember this password in my keychain to add your user name and password for the computer to your keychain.

1. Open the /etc/fstab file in a text editor and add a line containing the following details:

   \\HOSTNAME|IPADDRESS\SHARE_NAME MOUNTDIR cifs OPTIONS DUMP FSCK

   In the OPTIONS column, ensure that you specify the credentials option, with a value of the path to the file that contains the username and/or password.
   Using the example server names, the entry contains the following replaced values.

   \\server1\test-volume /mnt/glusterfs cifs credentials=/etc/samba/passwd,_netdev 0 0

   The sec=ntlmssp parameter is also required when mounting a volume on Red Hat Enterprise Linux 6, for example:

   \\server1\test-volume /mnt/glusterfs cifs credentials=/etc/samba/passwd,_netdev,sec=ntlmssp 0 0

   See the mount.cifs man page for more information about these options.

   Important

   Red Hat Gluster Storage is not supported on Red Hat Enterprise Linux 6 (RHEL 6) from 3.5 Batch Update 1 onwards. See Version Details table in section Red Hat Gluster Storage Software Components and Versions of the Installation Guide
2. Run # smbstatus -S on the client to display the status of the volume:

   Service        pid     machine             Connected at
   -------------------------------------------------------------------
   gluster-VOLNAME 11967   __ffff_192.168.1.60  Mon Aug  6 02:23:25 2012

1. In Windows Explorer, click Tools Map Network Drive…. to open the Map Network Drive screen.
2. Choose the drive letter using the Drive drop-down list.
3. In the Folder text box, specify the path of the server and the shared resource in the following format: \\SERVER_NAME\VOLNAME.
4. Click the Reconnect at logon check box.
5. Click Finish to complete the process, and display the network drive in Windows Explorer.
6. If the Windows Security screen pops up, enter the username and password and click OK.
7. Navigate to the network drive to verify it has mounted correctly.

1. Manually mount the volume using the process outlined in Section 6.4.5.3, “Manually mounting volumes exported with SMB on macOS”.
2. In the Finder, click System Preferences > Users & Groups > Username > Login Items.
3. Drag and drop the mounted volume into the login items list.
   Check Hide if you want to prevent the drive's window from opening every time you boot or log in.

1. Start or restart the smb service.
   On RHEL 7 and RHEL 8, run systemctl [re]start smb
   On RHEL 6, run service smb [re]start
2. Enable User Serviceable Snapshot (USS) for Samba. For more information see Section 8.13, “User Serviceable Snapshots”

1. Right Click on the file or directory for which the previous version is required.
2. Click on Restore previous versions.
3. In the dialog box, select the Date/Time of the previous version of the file, and select either Open, Restore, or Copy.
   where,
   Open: Lets you open the required version of the file in read-only mode.
   Restore: Restores the file back to the selected version.
   Copy: Lets you copy the file to a different location.
   

   Figure 6.1. Accessing Snapshot

1. Execute the following command to enable metadata caching and cache invalidation:

   # gluster volume set <volname> group metadata-cache

   This is group set option which sets multiple volume options in a single command.
2. To increase the number of files that can be cached, execute the following command:

   # gluster volume set <VOLNAME> network.inode-lru-limit <n>

   n, is set to 50000. It can be increased if the number of active files in the volume is very high. Increasing this number increases the memory footprint of the brick processes.

1. Verify if the performance.readdir-ahead option is enabled by executing the following command:

   # gluster volume get <VOLNAME> performance.readdir-ahead

   If the performance.readdir-ahead is not enabled then execute the following command:

   # gluster volume set <VOLNAME> performance.readdir-ahead on

2. Execute the following command to enable parallel-readdir option:

   # gluster volume set <VOLNAME> performance.parallel-readdir on

   Note

   If there are more than 50 bricks in the volume it is recommended to increase the cache size to be more than 10Mb (default value):

   # gluster volume set <VOLNAME> performance.rda-cache-limit <CACHE SIZE>

1. Execute the following command to enable negative-lookup cache:

    # gluster volume set <volname> group nl-cache
      volume set success

   Note

   The above command also enables cache-invalidation and increases the timeout to 10 minutes.