Mount Qumulo SMB shares via command line on Linux

IN THIS ARTICLE

Outlines the process of mounting SMB shares via command line for Qumulo-local user not bound to AD and members of AD domain

REQUIREMENTS

• Cluster running Qumulo core
• Linux SMB 2.1 Compatibility Requirements including Linux Kernel 3.7 or higher and cifs-utils (Samba)
• Samba versions 4.6 and higher require Qumulo version 2.8.3 and above to handle a directory delete permissions bug.

NOTE: Check your Linux kernel version using the command below. If you are not running Linux kernel 3.7 and above, your system is not compatible with SMB 2.1.

uname -r

PROCESS

Create a mount point:

sudo mkdir /mnt/qumulo

Mount share as a Qumulo-local user

• Qumulo user ‘admin’ used in this example. You’ll be prompted for the password for user ‘admin’
• Substitute gidNumber with desired GID Number to be written to files & directories on creation
• Substitute dir_mode and file_mode with the desire file/directory creation mode (0777, 0755, etc)

sudo mount -t cifs -o vers=2.1,user=admin,dom=qumulo,gid=gidNumber,dir_mode=0775,file_mode=0775,rw //your.qumulo.ip/ShareName /mnt/qumulo

Mount share as a member of Active Directory Domain

• Linux client bound or not bound to AD, Qumulo bound to AD
• You’ll be prompted for the password for user ‘yourADuser’
• Substitute gidNumber with desired GID Number to be written to files & directories on creation
• Substitute dir_mode and file_mode with the desire file/directory creation mode (0777, 0755, etc)
• Substitute yourADuser in "uid=yourADuser" with the Short Name or UID number of your desired Domain User

sudo mount -t cifs -o vers=2.1,user=yourADuser,dom=AD.YOURDOMAIN.COM,uid=yourADuser,gid=gidNumber,dir_mode=0775,file_mode=0775,rw //your.qumulo.ip/ShareName /mnt/qumulo

Mount share as a member of Active Directory Domain using Kerberos (Single Sign On)

• Linux client and Qumulo BOTH bound to AD and a valid AD user currently logged into Linux client
• A current valid Kerberos ticket for the logged in user is required (Check with "klist" and note expiration date.  Renew with "kinit" if required.)
• Substitute gidNumber with desired GID Number to be written to files & directories on creation
• Substitute dir_mode and file_mode with the desire file/directory creation mode (0777, 0755, etc)
• $UID & $USER are both environment variables for the currently logged in user
• Path to Qumulo share must match your Qumulo cluster's Kerberos Service Principal Name (SPN), which is usually the Qumulo's Fully Qualified Domain Name (FQDN)

sudo mount -t cifs -o vers=2.1,sec=krb5,uid=$UID,cruid=$USER,user=$USER,gid=gidNumber,dir_mode=0775,file_mode=0775,rw //your.qumulo.ip/ShareName /mnt/qumulo

RESOLUTION

You should now be able to successfully mount Qumulo SMB shares via command line on Linux 

ADDITIONAL RESOURCES

QQ CLI: SMB Shares

Like what you see? Share this article with your network!