Add Shares

Note: For a list of all the Appliance Controller commands, see the Command Index.

Default Ownership Settings

In addition to creating a directory to be shared, the share add command assigns default ownership settings. If you have configured StorNext NAS to use ADS, the share directories will have the UID and GID of the AD administrator user.

Important

If you use AD authentication with the RFC2307 idmap option, you cannot use the share add command. See NAS Share Tips and FAQs.

Caution

  1. Log in to the Appliance Controller CLI.
  2. At the prompt, enter the following:

    > share add <share_type> <share_name> <share_path> [option, option, …] [nfshosts = host1, hostN]

    <share_type>

    The type of share, either nfs or smb.

    <share_name>

    An alias name for the share.

    The input is limited to 64 characters.

    <share_path>

    The fully qualified path name of the share's directory.

    The input is limited to 128 characters.

    [option, ...]

    (Optional) Options to define attributes of the share.

    When entering options, use the following conventions:

    • Separate multiple options by a comma.
    • For options that can have multiple values, separate the values by a space.

    The input for the export option is limited to 1024 characters per option.

    Example:

    guest ok = yes

    users = john sue mary

    In the above example, the first option contains 14 characters and the second option contains 21 characters. Both options are well within the 1024-character limit.

    See SMB Share Options.

    [nfshosts = host1, hostN]

    (NFS shares only) Host(s) allowed access to an NFS share. If no host(s) is provided, any host may access the NFS share.

    When entering options, use the following conventions:

    • You must enter nfshosts =.
    • List hosts in one of the following ways:
      • Host name or IP address
      • Wildcards
      • IP networks or netgroups

    See NFS Share Options.

    Note: If the share does not currently exist, the output informs you that the share first will be created.

  1. Repeat steps 1 and 2 for each share to add.

As of Appliance Controller 3.0, nfs and smb shares will not be created unless StorNext global file locking is first enabled on the file system or you use the "nolocking" option for the share [see Example (add a share with the file locking override). If you do not have global file locking and attempt to create a share you will see one of the following error messages:

Example (error message for nfs or smb shares)

> Validation failure: Share path /stornext/snfs2/test1 requires snfs global file locking (E-2002)

Note: Enable global file locking for the StorNext file system. See the snfs_config MAN page, or search for "snfs_config − StorNext File System Configuration File" in the the StorNext MAN Pages Reference Guide for more information about the fileLocks parameter. Enable global file locking before adding a NAS share, or use the "nolocking" parameter (see below).

Example (add a share to an existing directory):

  1. Add the share. Enter:

    2. > share add smb mysmbshare /stornext/snfs1/mysmbshare

    Output:

    Adding share to existing directory
    Share smb3 successfully added

Example (add a share with a new directory):

  1. Add the share. Enter:

    2. > share add smb smb3 /stornext/snfs1/smb-3

    Output:

    Creating directory /stornext/snfs1/smb-3
    Share smb3 successfully added

Example (add a share with the file locking override)

  1. If you need to override the file locking limitation, enter the "nolocking" option. An smb example follows:

    > share add smb test1 /stornext/snfs2/test1 nolocking

    Output:

    Share test1 successfully created

  2. Validate the share was created correctly, and that "nolocking" was set. Enter:

    3. > share show smb test1

    Output:

    SMB global options: named streams = true

    1 shares:

    1: test1 | smb | /stornext/snfs2/test1 | nolocking,public = no,writable = yes

Example (add a share for both smb and nfs in the same directory)

  1. Add an smb share. Enter:

    2. > share add smb smb-multi /stornext/snfs1/test-multi

    Output:

    Share smb-multi successfully created

  2. Add an nfs share in the same directory. Enter:

    3. > share add nfs nfs-multi /stornext/snfs1/test-multi

    Output:

    Share nfs-multi successfully created