Print Email PDF

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’ is 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! 

Was this article helpful?
1 out of 2 found this helpful

Comments

0 comments

Please sign in to leave a comment.

Have more questions?
Open a Case
Share it, if you like it.