Create an SMB share

When you create an SMB share, you can override the default permissions, performance, and access settings. You can configure SMB home directory provisioning by including expansion variables in the share path to automatically create and redirect users to their own home directories.

Before you begin

Specify a directory path to use as the SMB share, and create the directory before you create an SMB share. Shares are specific to access zones and the share path must exist under the zone path. Create access zones before you create SMB shares.


  1. Click Protocols > Windows Sharing (SMB) > SMB Shares.
  2. From the Current Access Zone drop-down list, select the access zone where you want to create the share.
  3. Click Create an SMB Share.
  4. In the Name field, type a name for the share.
    Share names can contain up to 80 characters, except for the following: " \ / [ ] : | < > + = ; , * ?

    Also, if the cluster character encoding is not set to UTF-8, SMB share names are case-sensitive.

  5. Optional: In the Description field, type a comment about the share.
    A description is optional, but can be helpful if you are managing multiple shares. This field is limited to 255 characters.
  6. In the Path field, type the full directory path of the share, beginning with /ifs, or click Browse to locate the directory path.
    Note Image

    If you want to use any of the variables in the following table when you specify a directory path, select the Allow Variable Expansion checkbox or the system interprets the string literally.




    NetBIOS domain name.


    Username—for example, user_001.


    Zone name—for example, System.


    Hostname of the cluster, normalized to lowercase.


    First character of the username.


    Second character of the username.


    Third character of the username.

    For example, if a user is in a domain that is named DOMAIN and has a username of user_1, the path /ifs/home/%D/%U expands to /ifs/home/DOMAIN/user_1.
  7. Select Create SMB share directory if it does not exist to have OneFS create the share directory for the path you specified if it did not previously exist.
  8. Apply the initial ACL settings for the directory. You can modify these settings later.
    • To apply a default ACL to the shared directory, select Apply Windows default ACLs.
      Note Image

      If the Create SMB share directory if it does not exist setting is selected, OneFS creates an ACL with the equivalent of UNIX 700 mode bit permissions for any directory that is created automatically.

    • To maintain the existing permissions on the shared directory, select Do not change existing permissions.
  9. Optional: Configure home directory provisioning settings.
    • To expand path variables such as %U in the share directory path, select Allow Variable Expansion.
    • To automatically create home directories when users access the share for the first time, select Auto-Create Directories. This option is available only if the Allow Variable Expansion option is enabled.
  10. Select the Enable continuous availability on the share to allow clients to create persistent handles that can be reclaimed after an outage such as a network-related disconnection or a server failure. Servers must be using Windows 8 or Windows 2012 R2 (or higher).
  11. Click Add User or Group to edit the user and group settings.
    The default permissions configuration is read-only access for the well-known Everyone account. Modify settings to allow users to write to the share.
  12. Select Enable file filters in the File Filter Extensions section to enable support for file filtering. Add the file types to be applied to the file filtering method.
  13. Select Enable or Disable in the Encryption section to allow or disallow SMBv3 encrypted clients to connect to the share.
  14. Optional: Click Show Advanced Settings to apply advanced SMB share settings if needed.
  15. Click Create Share.