Open topic with navigation

Disconnected: You’re looking at a local copy of the Appliance Controller Documentation Center. The most current version is online at www.quantum.com/accdocs.

# 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

- The Appliance Controller manages the smb.conf and /etc/exports files for StorNext NAS. Any edits you make directly to either of these files are lost when you restart the Appliance Controller, or when you make a change using any of the `share` commands.

- When you make a change to an SMB share, its existing connection might be impacted and depending on the SMB client, it is possible to disconnect from that share.

Add Shares

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]`

   Parameters

   `<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.

StorNext file system (snfs) global file locking required

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:

> `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:

> `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:

> `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:

> `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:

> `share add nfs nfs-multi /stornext/snfs1/test-multi`

Output:

Share nfs-multi successfully created

6-68456-07_RevA | Initial publication date: Friday, December 22, 2017 | Last updated on Monday, January 12, 2026.

Open topic with navigation