Help on Protocols > Windows Sharing (SMB) > SMB Shares

The following information and controls appear on Protocols > Windows Sharing (SMB) > SMB Shares

Current Access Zone:
From this drop-down list, select the access zone in which you want to create or manage SMB shares.
SMB Shares
Displays the list of SMB shares available within the selected access zone, in table format.
Name
This column in the SMB Shares table displays share names. Click the check box corresponding to an existing share to take action.
Path
This column in the SMB Shares table displays the full directory path of a share.
Action
This column in the SMB Shares table displays actions you can perform for the share. Click View/Edit to view or edit share settings, or Delete to remove the share. If you choose Delete, a confirmation prompt displays.
Create an SMB Share
Click to add a new SMB share. The Create an SMB Share dialog box appears.
Name
Displays a system generated share name. Enter a different share name if desired, following the naming conventions listed under the field. Share names can contain up to 80 characters, and can only consist of alphanumeric characters, hyphens and spaces. Also, if the cluster character encoding is not set to UTF-8, SMB share names are case sensitive.
Description
If desired, enter a description for the new share. The description is optional, but can be helpful if you are managing multiple shares.
Path
Enter the full path of the share, beginning with /ifs, or click Browse to locate the share.

You can specify one or more of the following variables in the directory path, but you must select the Allow Variable Expansion check box or the string is interpreted literally by OneFS.

Variable
Expansion
%D
NetBIOS domain name.
%U
User name -- for example, user_1.
%Z
Zone name -- for example, System.
%L
Host name of the cluster, normalized to lowercase.
%0
First character of the user name.
%1
Second character of the user name.
%2
Third character of the user name.

For example, if a user is in a domain named DOMAIN and has the user name user_1, the path /ifs/home/%D/%U expands to /ifs/home/DOMAIN/user_1.

Create SMB share directory if it does not exist
Click this check box to have OneFS create the share directory for the path you specified.
Directory ACLs
Click Apply Windows default ACLs to apply a default ACL to the shared directory. If the Auto-Create Directories setting is enabled in home directory provisioning, OneFS creates an ACL with the equivalent of UNIX 700 mode bit permissions for any directory that is created automatically.

Click Do not change existing permissions to maintain the existing permissions on the shared directory.

Home Directory Provisioning
Select Allow Variable Expansion to expand path variables such as %U in the share directory path.

Select Auto-Create Directories to automatically create home directories when users access the share for the first time. This option is only available if Allow Variable Expansion is selected.

Enable continuous availability on the share
Click this check box 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).
Users and Groups
Displays a list of user and group accounts in table format. The default permissions configuration is read-only access for the well-known Everyone account. If you want to allow users to write to the share, click the View/Edit button to modify permissions.
Add User or Group
Click to add a user, group or well-known SID to the share.

If you select the User radio button, enter a user name and/or provider to search for, then select the desired user from the list of search returns.

If you select the Group radio button, enter a group name and/or provider to search for, then select the desired group from the list of search returns.

If you select the Well-known SIDs radio button, click Search to display a list of all available well-known SIDs.

Enable file filters
Click this check box to enable file filtering by file extension. You can deny writes to the share by certain file types, or allow only certain file types to write to the share.
Advanced SMB Share Settings
Click to access a list of advanced SMB share settings relating to permissions, performance and security. (You can also set or modify these settings inside the SMB Share Settings tab.) We recommend that you do not change any of the default values unless you thoroughly understand the potential effects of those changes.

To change the advanced settings, click Use Custom or Use Default under the appropriate setting title.

Continuous Availability Timeout
Specify the amount of time you want a persistent handle to be retained after a client is disconnected or a server fails. The default is two minutes.
Strict Continuous Availability Lockout
Set to yes to prevent a client from opening a file if another client has an open but disconnected persistent handle for that file. If set to no, OneFS will issue persistent handles, but discards them if any client other than the original opener attempts to open the file. The default is yes.
Create Permission
Sets the default source permissions to apply when a file or directory is created.
Change Notify
Configures notification of clients when files or directories change, which helps prevent clients from seeing stale content, but requires server resources. The default value is Norecurse.
Oplocks
Indicates whether an opportunistic lock (oplock) request is allowed. An oplock allows clients to provide performance improvements by using locally-cached information. The default is Yes.
Impersonate Guest
Determines guest access to a share. The default is Never.
Impersonate User
Allows all file access to be performed as a specific, fully qualified user name. The default is no value specified.
NTFS ACL
Allows ACLs to be stored and edited from SMB clients. The default is Yes.
Access Based Enumeration
Allows access based enumeration only on the files and folders that the requesting user can access. The default is No.
Directory Create Mask
Specifies UNIX mode bits that are removed when a directory is created, restricting permissions. Mask bits are applied before mode bits are applied.
Directory Create Mode
Specifies UNIX mode bits that are added when a directory is created, enabling permissions. Mode bits are applied after mask bits are applied.
File Create Mask
Specifies UNIX mode bits that are removed when a file is created, restricting permissions. Mask bits are applied before mode bits are applied.
File Create Mode
Specifies UNIX mode bits that are added when a file is created, enabling permissions. Mode bits are applied after mask bits are applied.
HOST ACL
The ACL that defines host access. The default is no value specified.