Quantum DXi-Series Command Line Interface (CLI) Guide
6-66538-03 Rev C
November 2010
46
NAS CLI Configuration Commands
Deleting a NAS Share
syscli --del share --name <share_name>
This CLI command allows the CLI admin to delete an existing NAS share. The
NAS share name is required to delete a share. When a share is deleted, all
connections to the share are severed and all data stored on it is removed
permanently.
Deleting All NAS Shares
syscli --deleteall share [--proto {cifs|nfs}] [--sure]
This CLI command allows the CLI admin to delete all NAS shares. If the
--sure
option is specified, no confirmation prompt will be displayed. If the
--proto
option is specified, it deletes shares of the specified type (CIFS or NFS).
Joining or Disjoining a
Windows Domain
syscli --join workgroup --name <workgroup name>
syscli --join ads --domain <domain name> [--org <organizational unit>] --
admin <domain user authorized to join> [--password <domain user
password>] [--pdc <primary domain controller>]
syscli --disjoin workgroup --name <workgroup name>
syscli --disjoin ads --admin <domain user authorized to join> [--password
<domain user password>]
This CLI command allows the admin user to join the Samba server to a Windows
workgroup or a Windows active directory domain (ADS). If the server is already
in the joined state, the CLI also provides the capability to disjoin the workgroup
or the active directory domain.
Joining an active directory requires the name or IP address of a primary domain
controller (PDC). However, if the --pdc option is not specified, the CLI will
discover it automatically. The --admin option specifies the name of the domain
user who is authorized to join the active directory domain. This domain user is
not necessarily the CLI admin user. Thus the admin must supply this domain
user credential in order to join the domain. The admin can choose not to supply
the password on the command line. In this case the CLI prompts the admin for
the password and will not echo his response for security purposes.
Note that the "disjoin ads" command always succeeds even if the username and/
or password is wrong. The only difference is that the computer account in the
AD server will be successfully disabled if both the username and password are
correct, and will remain enabled otherwise. The new behavior of this command
is needed to disjoin ADS for cases where the AD server is changed or the old
admin user account is no longer valid.
Workgroup Users
There are two types of users who are allowed access to CIFS shares depending
on whether the system is joined to a workgroup or an Active Directory domain.
When the server is joined to a workgroup, only workgroup users can access CIFS
shares, and the CLI provides the capabilities to manage them. Workgroup users
are users who are both in the local Linux database and the Samba password
database.