Quantum DXi-Series Command Line Interface (CLI) Guide
6-67081-05 Rev B
April 2012
Editing a NAS Share
24
syscli --edit share --name <sharename> [--desc <description>] [--perms
rw|ro [--restart]] [--hidden false|true] [--anonuid <anonymous_uid>] [--
anongid <anonymous_gid>] [--namecase default [--sure]]
This CLI command allows the admin user to modify one or more attributes of a
NAS share such as description, permissions, hidden (CIFS only), etc. Although
the syntax says all attributes are optional, at least one attribute must be
specified.
Notes on the --restart option:
This option is applicable to CIFS shares only; it is ignored on NFS shares. If a CIFS
share's permissions are changed, users who are currently logged on the share
will not see the change until they log off and log in again, or CIFS service is
restarted.
The admin user can choose to restart CIFS service by specifying the --restart
option. If CIFS service is restarted, users currently logged on to CIFS shares may
experience disconnection and/or I/O disruption or backup jobs connected to all
shares may fail I/O.
CLI command options:
• --edit: Edits one or more attributes of a NAS share.
• --name: sharename: must be alphanumeric character. Must begin with a
letter.
• --perms: change permissions to read-write or read-only.
• --restart: applicable to CIFS share only. If specified, restart CIFS service. This
can cause disruption to all users and all backup jobs.
• --hidden: hidden: true if share name is not browseable in the browser (for
CIFS shares only).
• --anonuid: Anonymous user id (for NFS only), usually 4294967294 on 32-bit
systems or 65534 on 16-bit systems.
• --anongid: Anonymous group id (for NFS only), usually 4294967294 on 32-
bit systems or 65534 on 16-bit systems.
• --namecase: if specified, client file/directory names are treated as case-
insensitive and case-preserved. This option makes a difference only for
shares that were previously created with the option --namecase lower.
Basically, it makes the share behave as if it had been created without the
--namecase option. This option is useful in the following situation:
• User creates a share using option --namecase lower.
• Some files/directories with mixed case are somehow copied over to the
share without using CIFS.
• User can browse these files in browsers but cannot open, rename,
move, copy, or delete.
In this case, to access them via CIFS, their names have to be changed to
lower case, but this task is impossible to do over CIFS. One of the
solutions is for users to use this edit command to revert name support
to the default (case-insensitive and case-preserved).
After the --namecase option is executed successfully:
NAS Configuration CLI Commands