Quantum DXi-Series Command Line Interface (CLI) Guide
6-67081-02 Rev A
July 2011
34
NAS Configuration CLI Commands
disjoin ADS for cases where the AD server is changed or the old admin user
account is no longer valid.
CLI command options:
•
--join
: Joins CIFS server to a Windows Active Directory domain.
If
--password
is specified and
<admin_password>
is not, or if
--password
is omitted, it will be prompted interactively and the password is not echoed
on screen.
•
--domain
: Active Directory domain name
•
--admin
: username of any account that has the right to join the domain.
•
--password
: if not specified, will be prompted interactively and the
password is not echoed on screen.
•
--pdc
: host name or IP address of primary domain controller. If not
specified, will search automatically.
•
--prewin2kdomain
: Normally, this option is omitted because the join
command will query the ADS server for the pre-Windows 2000 domain
name, A.K.A NetBIOS domain name.
This option is specified as a last resort when and only when the command
fails because of wrong NetBIOS domain name. If specified, the specified
name is used instead of querying the domain server/controller.
Pre-Windows 2000 Domain Name
The pre-Windows 200 domain name is also known as the NetBIOS domain
name, which is 15 characters or less. This name can be specified via the
--prewin2kdomain
option. Normally this option need not be specified because
the join command can query the ADS server or domain controller to get the pre-
Windows 2000 domain name.
However, the NetBIOS domain name is sometimes wrong (for example, longer
than 15 characters), causing the join operation to fail. This can happen in an
environment that has multiple domain controllers and some of them may be
misconfigured. In this case one can try any of the following methods:
• Specify
--prewin2kdomain
explicitly in the join command.
• If the domain has more than one domain controllers, specify
--pdc
explicitly
with the hostname or IP of each domain controller. If the domain controller
returns the correct NetBIOS domain name, the join command will succeed.
So be patient to try rerunning the command with one domain controller
after another until the join command succeeds.
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.