Skip to main content

vserver cifs create

Contributors
Suggest changes
PDFs

Create a CIFS server

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver cifs create command creates a CIFS server on a Vserver. When you create the CIFS server, you can add it to an existing CIFS domain, or you can join it to a workgroup. When you add it to an existing CIFS domain, the storage system prompts you to provide the credentials of a user account that has sufficient privileges to add computers to the -ou container within the -domain domain. The user account must have a password that cannot be empty. If the new CIFS server is joining a domain, this command might take several minutes to complete.

Note Each Vserver can have only one CIFS server.

Parameters

-vserver <vserver name> - Vserver

This parameter specifies the name of the Vserver on which to create the CIFS server. The Vserver must already exist.

-cifs-server <NetBIOS> - CIFS Server NetBIOS Name

This parameter specifies the name of the CIFS server (up to 15 characters).

{ -domain <TextNoCase> - Fully Qualified Domain Name

This parameter specifies the name of the Active Directory domain to associate with the CIFS server.

[-ou <text>] - Organizational Unit

This parameter specifies the organizational unit within the Active Directory domain to associate with the CIFS server. By default, this parameter is set to CN=Computers. When specifying this parameter, specify only the organizational unit portion of the distinguished name. ONTAP appends the value provided for the required -domain parameter onto the value provided for –ou parameter to produce the Active Directory distinguished name, which is used to associate with the CIFS server.

Note Nested OUs must be provided in a specific order with all containers separated by a comma. Reading from left to right you travel up the directory tree until you reach the root OU.
[-default-site <text>] - Default Site Used by LIFs Without Site Membership

This parameter specifies the site within the Active Directory domain to associate with the CIFS server if ONTAP cannot determine an appropriate site. This parameter will also be used for discovering KDCs in the trusted domain if ONTAP cannot determine an appropriate site in the trusted domain.

| -workgroup <NetBIOS> - Workgroup Name }

This parameter specifies the name of the workgroup (up to 15 characters).

[-keytab-uri {scheme://(hostname|IPv4 Address|'['IPv6 Address']')…​}] - Kerberos Keytab File URI (privilege: advanced)

This parameter specifies loading a keytab file from the specified URI. This is applicable if the CIFS server is being created in realm mode or domain mode.

[-status-admin {down|up}] - CIFS Server Administrative Status

Use this parameter to specify whether the initial administrative status of the cifs server is up or down. The default setting is up .

[-comment <text>] - CIFS Server Description

This optional parameter specifies a text comment for the server. CIFS clients can see this CIFS server description when browsing servers on the network. The comment can be up to 256 characters long. If there is a space in the descriptive remark or the path, you must enclose the entire string in quotation marks.

[-netbios-aliases <NetBIOS>,…​] - List of NetBIOS Aliases

This parameter specifies a list of NetBIOS aliases, which are alternate names to the CIFS server name.

Examples

The following example creates a CIFS server CIFSSERVER1 for Vserver vs1 and domain EXAMPLE.com.

cluster1::> vserver cifs create -vserver vs1 -cifs-server CIFSSERVER1 -domain EXAMPLE.com
In order to create an Active Directory machine account for the CIFS server, you
must supply the name and password of a Windows account with sufficient
privileges to add computers to the "CN=Computers" container within the
"EXAMPLE.com" domain.

Enter the user name: Administrator

Enter the password:
cluster1::> vserver cifs create -vserver vs1 -cifs-server CIFSSERVER2 -domain EXAMPLE.com -keytab-uri http://nbsweb.eng.btc.netapp.in/~user/Sample1.keytab
Info: SMB1 protocol version is disabled on this CIFS server. If required, use
the (privilege: advanced) command "vserver cifs options modify -vserver vs1
-smb1-enabled true" to enable it.

The following example creates a CIFS server CIFSSERVER1 for Vserver vs1 and workgroup Sales:

cluster1::> vserver cifs create -vserver vs1 -cifs-server CIFSSERVER1 -workgroup Sales

The following example creates a CIFS server CIFSSERVER1 for Vserver vs1 and domain EXAMPLE.com with a user Administrator1 from a different domain, in this case an administrator from a trusted domain TRUST.LAB.COM:

cluster1::> vserver cifs create -vserver vs1 -cifs-server CIFSSERVER1 -domain EXAMPLE.com
In order to create an Active Directory machine account for the CIFS server, you
must supply the name and password of a Windows account with sufficient
privileges to add computers to the "CN=Computers" container within the
"EXAMPLE.com" domain.

Enter the user name: Administrator1@TRUST.LAB.COM

Enter the password:

The following example creates a CIFS server CIFSSERVER1 for Vserver vs1 with domain EXAMPLE.com using nested OUs:

cluster1::> vserver cifs create -vserver vs1 -cifs-server CIFSSERVER1 -domain EXAMPLE.com -ou OU=developers,OU=engineering,OU=corp
In order to create an Active Directory machine account for the CIFS server, you
must supply the name and password of a Windows account with sufficient
privileges to add computers to the "OU=developers,OU=engineering,OU=corp" container within the
"EXAMPLE.com" domain.

Enter the user name: Administrator

Enter the password: