PowerScale OneFS 9.3.0.0 CLI Administration Guide

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.

1. Run the isi smb shares create command.
   The following commands creates a directory at /ifs/zone5/data/share1, creates a share named share1 using that path, and adds the share to the existing access zone named zone5:

   mkdir /ifs/data/share1 isi smb shares create --name=share1 \
   --path=/ifs/data/share1 --zone=zone5 --browsable=true \
   --description="Example Share 1" 

   NOTE: 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.

   The following command creates a directory at /ifs/data/share2, converts it to an SMB share, and adds the share to the default System zone because no zone is specified:

   isi smb shares create share2 --path=/ifs/data/share2 \
   --create-path --browsable=true --description="Example Share 2" 

   The following command creates a directory at /ifs/data/share3 and converts it to an SMB share. The command also applies an ACL to the share:

   isi smb shares create share3 --path=/ifs/data/share3 \
   --create-path --browsable=true --description="Example Share 3" \ 
   --inheritable-path-acl=true --create-permissions="default acl"

   NOTE: If no default ACL is configured and the parent directory does not have an inheritable ACL, an ACL is created for the share with the directory-create-mask and directory-create-mode settings.
   The following command creates the directory /ifs/data/share4 and converts it to a non-browsable SMB share. The command also configures the use of mode bits for permissions control:

   isi smb shares create --name=share4 --path=/ifs/data/share4 \
   --create-path --browsable=false --description="Example Share 4" \
   --inheritable-path-acl=true --create-permissions="use create \
   mask and mode"

2. The following command creates home directories for each user that connects to the share, based on the user's NetBIOS domain and user name.
   In this example, if a user is in a domain named DOMAIN and has a username of user_1, the path /ifs/home/%D/%U expands to /ifs/home/DOMAIN/user_1.

   isi smb shares modify HOMEDIR --path=/ifs/home/%D/%U \
   --allow-variable-expansion=yes --auto-create-directory=yes

   The following command creates a share named HOMEDIR with the existing path /ifs/share/home:

   isi smb shares create HOMEDIR /ifs/share/home

3. Run the isi smb shares permission modify command to enable access to the share.
   The following command allows the well-known user Everyone full permissions to the HOMEDIR share:

   isi smb shares permission modify HOMEDIR --wellknown Everyone \
    --permission-type allow --permission full