Skip to main content

Create CIFS server configuration

Contributors netapp-ranuk

If you want to create CIFS volumes on your Cloud Volumes ONTAP system, you first need to configure the CIFS server. You can choose to set up the CIFS server in a workgroup or in an Active Directory domain. Review the Set up SMB (CIFS) in a workgroup and Set up SMB (CIFS) in an Active Directory domain topics for more information.

Choose the workflow to use based on the type of Cloud Volumes ONTAP deployment:

Create CIFS for single node

You can use this workflow to create CIFS volumes in a single node working environment.

Choose the workflow that is specific to your goal:

Set up a CIFS server in a workgroup

You can configure a CIFS server in a workgroup when the Microsoft Active Directory domain infrastructure is not available.

1. Select the working environment

Perform the workflow Get working environments and choose the publicId value for the working environment used in the workingEnvironmentId path parameter.

2. Create the CIFS configuration

Create the CIFS server configuration.

HTTP method Path

POST

/occm/api/gcp/vsa/working-environments/{workingEnvironmentId}/cifs-workgroup
curl example
curl --location --request POST 'https://cloudmanager.cloud.netapp.com/occm/api/gcp/vsa/working-environments/<WORKING_ENV_ID>/cifs-workgroup' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>' --d @JSONinput
Input

  • Path parameter <WORKING_ENV_ID> workingEnvironmentId string

JSON input example
{
  "serverName": "SMB_SERVER02",
  "workgroupName": "workgroup02",
  "svmName": "svm_ziv01we01"
}
Output

None.

Set up a CIFS server in an Active Directory domain

You can create a CIFS server on the SVM and specify the Active Directory (AD) domain to which it belongs.

1. Select the working environment

Perform the workflow Get working environments and choose the publicId value for the working environment used in the workingEnvironmentId path parameter.

2. Determine the Active Directory configuration

You need the following configuration parameters for an Active Directory server.

Input parameter Description

dnsDomain

Use the Active Directory domain as the DNS name.

ipAddresses

Define the primary DNS IP address and optionally add a secondary IP address.

netBIOS

Use the CIFS server NetBIOS name.

organizationalUnit

Include the organizational unit as appropriate.

activeDirectoryDomain

Set the Active Directory domain to join.

activeDirectoryUsername

A username with authorization to join the domain.

activeDirectoryPassword

The password for the authorized username.

3. Create the CIFS configuration

Create the CIFS server configuration.

HTTP method Path

POST

/occm/api/gcp/vsa/working-environments/{workingEnvironmentId}/cifs
curl example
curl --location --request POST 'https://cloudmanager.cloud.netapp.com/occm/api/gcp/vsa/working-environments/<WORKING_ENV_ID>/cifs' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>' --d @JSONinput
Input

  • Path parameter <WORKING_ENV_ID> workingEnvironmentId string

JSON input example
{
  "dnsDomain": "zivh.netapp.com",
  "ipAddresses": [
    "172.31.5.241"
  ],
  "netBIOS": "zivaws02we03",
  "organizationalUnit": "CN=Computers",
  "activeDirectoryDomain": "zivh.netapp.com",
  "activeDirectoryUsername": "administrator",
  "activeDirectoryPassword": "password"
}
Output

None.

Create CIFS for high availability pair

You can use this workflow to create CIFS volumes in an HA working environment.

Choose the workflow that is specific to your goal:

Set up a CIFS server in a workgroup (HA)

You can configure a CIFS server in a workgroup when the Microsoft Active Directory domain infrastructure is not available.

1. Select the working environment

Perform the workflow Get working environments and choose the publicId value for the working environment used in the workingEnvironmentId path parameter.

2. Create the CIFS configuration

Create the CIFS server configuration.

HTTP method Path

POST

/occm/api/gcp/ha/working-environments/{workingEnvironmentId}/cifs-workgroup
curl example
curl --location --request POST 'https://cloudmanager.cloud.netapp.com/occm/api/gcp/ha/working-environments/<WORKING_ENV_ID>/cifs-workgroup' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>' --d @JSONinput
Input

  • Path parameter <WORKING_ENV_ID> workingEnvironmentId string

JSON input example
{
  "serverName": "SMB_SERVER02",
  "workgroupName": "workgroup02",
  "svmName": "svm_ziv01we01"
}
Output

None.

Set up a CIFS server in an Active Directory domain (HA)

You can create a CIFS server on the SVM and specify the Active Directory (AD) domain to which it belongs.

1. Select the working environment

Perform the workflow Get working environments and choose the publicId value for the working environment used in the workingEnvironmentId path parameter.

2. Determine the Active Directory configuration

You need the following configuration parameters for an Active Directory server.

Input parameter Description

dnsDomain

Use the Active Directory domain as the DNS name.

ipAddresses

Define the primary DNS IP address and optionally add a secondary IP address.

netBIOS

Use the CIFS server NetBIOS name.

organizationalUnit

Include the organizational unit as appropriate.

activeDirectoryDomain

Set the Active Directory domain to join.

activeDirectoryUsername

A username with authorization to join the domain.

activeDirectoryPassword

The password for the authorized username.

3. Create the CIFS configuration

Create the CIFS server configuration.

HTTP method Path

POST

/occm/api/gcp/ha/working-environments/{workingEnvironmentId}/cifs
curl example
curl --location --request POST 'https://cloudmanager.cloud.netapp.com/occm/api/gcp/ha/working-environments/<WORKING_ENV_ID>/cifs' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>' --d @JSONinput
Input

  • Path parameter <WORKING_ENV_ID> workingEnvironmentId string

JSON input example
{
  "dnsDomain": "zivh.netapp.com",
  "ipAddresses": [
    "172.31.5.241"
  ],
  "netBIOS": "zivaws02we03",
  "organizationalUnit": "CN=Computers",
  "activeDirectoryDomain": "zivh.netapp.com",
  "activeDirectoryUsername": "administrator",
  "activeDirectoryPassword": "password"
}
Output

None.