Creating and Managing an SMB Share in Qumulo Core

This section explains how to create, modify, and delete an SMB share by using the Qumulo Core Web UI.

To Create an SMB Share

1. Log in to the Qumulo Core Web UI.

2. Click Sharing > SMB Shares.

3. On the right side of the SMB Shares page, click Create Share.

4. On the Create SMB Share page, take the following steps.

   1. Enter the File system path from the root of your file system.

   2. To create a new directory, click Create new directory if it doesn’t exist.

   3. To allow username substitution in the File system path, click Expand %U to username in path.

      For more information see How SMB Share Username Expansion Works in Qumulo Core.

      Note
      If you click Create new directory if it doesn’t exist in addition to Expand %U to username in path, Qumulo Core creates the path automatically the first time the user connects to the SMB share. This lets cluster administrators configure individual access to home directories without having to create an SMB share for each user.

   4. Enter the Share name.

      The share name becomes part of the UNC path for your SMB share. For example, if you set the Share name to grumpquat and your cluster’s hostname is my-cluster.example.com, SMB clients can access the share by using the \\my-cluster.example.com\grumpquat UNC path.

   5. Enter the Description for the share.

   6. To display only the files and directories to which the user has read access, click Enable access-based enumeration.

   7. To force users to connect over SMB3 (and higher) by using encryption-enabled clients, click Require encryption.

   8. Under Share Permissions, enter trustees and specify their:

      • Permission type: Click Add allow or Add deny.

        Note
        To ensure that Qumulo Core processes users to whom it explicitly denies access before processing users to whom it grants access, Deny entries appear at the top of the list and Allow entries at the bottom.

      • Permissions: Click Read, Write, or Change Permissions.

      To delete a trustee, click .

   9. (Optional) Under Advanced Options:

      1. Enter the Default file create mode (0644 by default).

      2. Enter the Default directory create mode (0755 by default).

      Note
      Qumulo Core applies these POSIX permissions to files and directories that SMB clients create when the parent directory doesn’t contain any inheritable permissions. This helps maintain NFS compatibility and enable smooth cross-protocol workflows in scenarios when organizations use SMB and NFS together.

5. Click Create Share.

How SMB Share Username Expansion Works in Qumulo Core

In Qumulo Core 7.7.5 (and higher), the system expands the %U placeholder to a username for SMB shares. For example, for a user authenticated in SMB as EXAMPLE_DOMAIN\alice, the path /home/%U becomes /home/%alice.

Qumulo core expands the %U placeholder:

• Only if it is an entire file path component

  For example, Qumulo Core expands /home/%U/example but treats /home/test%U/example literally.

• Only to a username

  Important
  Qumulo Core expands the %U placeholder even if your system has a primary Active Directory (AD) domain user with the same username as:

  • A user in your Qumulo cluster
  • A trusted AD domain user

  For this reason, we strongly recommend that system administrators in your organization use the %U placeholder with caution and in conjunction with share permission to prevent unauthorized access to cluster data.

To Modify an SMB Share

1. Log in to the Qumulo Core Web UI.

2. Click Sharing > SMB Shares.

3. For an SMB share, in the Actions column, click .

4. Make changes to your SMB share (for more information, see To Create an SMB Share) and then click Save.

To Delete an SMB Share

1. Log in to the Qumulo Core Web UI.

2. Click Sharing > SMB Shares.

3. For an SMB share, in the Actions column, click .

4. In the Delete Share dialog box, click Yes, Delete Share.

Related Topics

• Managing File Shares by Using the Shared Folders MMC Snap-In