EMC Unity - SMB Share Operations

This chapter contains the following sections:

EMC Unity - Create SMB Share

Summary
Create an SMB/CIFS Share object on an EMC Unity array.
Description
This task creates an SMB/CIFS Share on an EMC Unity storage array. This task creates two types of shares:
  • An SMB Share created on a file system.
  • An SMB Share created on a snapshot.
Input Format:
  • EMC Unity Account: podName@AccountName. For example: Vblock@Unity_Hybrid
  • EMC Unity File System: podName@accountName@spName@id@nasServerName@nasServerID@storagePoolName@storagePoolId@fileSystemName@fileSystemID. For example: Default Pod@EmcUnity@SP A@spa@TestNAS@nas_4@pool_7@Pool0@TestFS@fs_14
  • Use Snapshot: Check box-To create SMB Share on Snapshot
  • EMC Unity File System Snapshot: Select the file system to create SMB share on
  • Name: Valid Storage Pool Name - The following special characters are not allowed: " % & ' * + . / \ : ; < = > ? ^ @ | ,
  • Description: Valid Description
  • Path: Valid Path - Path destination should exist, if path is not given share is created on root directory
  • Access-based Enumeration: Check box-Filter directory entries according to client access permission
  • Branch Cache Enabled: Check box-Supports hash generation for branch cache retrieval of data
  • Protocol Encryption: Check box-Encrypt data as it is transmitted between the array and the host
  • Continuous Availability: Check box-Gives continuous access to the share following an NAS Server failover
  • Offline Availability: Check box-Manage the offline cashing of the files by the client
  • UMASK: Valid UMASK. For example: 022 Specifies the default UNIX UMASK for new files created on the share
Inputs
Input Description Mappable To Type Mandatory
EMC Unity Account Choose an EMC Unity account EMCUnity​Account​Identity Y
EMC Unity File System Choose a file system on which to create the SMB share EMCUnity​File​System​Identity Y
Use Snapshot Check to use the snapshot of the file system for share creation Boolean
Path Enter the path of the SMB share related to the NAS server.​ The share is created in the root directory if the path is empty.​ gen_​text_​input
Share Name Enter the name of the SMB share.​ The following 19 special characters are not allowed:", %, &, ', *, +, .​, /, \, :, ;, <, =, >, ?, ^, @, | and ," gen_​text_​input
Description Enter a description for the SMB share gen_​text_​input
Access-based Enumeration Check to filter directory entries by client access permission Boolean
Branch Cache Enabled Check to branch the data retrieval cache Boolean
Protocol Encryption Check to encrypt data transmitted between the array and the host Boolean
Continuous Availability Check to maintain continuous access to the share following a NAS server failover Boolean
Offline Availability Choose an offline availability type to manage offline file cacheing by the client EMCUnity​SMBShare​Offline​Availability​Type
UMASK Enter the default UNIX UMASK for new files created on the share gen_​text_​input
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​IDENTITY EMC Unity SMB Share Identity EMCUnity​SMBShare​Identity
OUTPUT_​EMC_​UNITY_​CIFS_​SERVER_​IDENTITY EMC Unity SMB Server Identity EMCUnity​SMBServer​Identity
OUTPUT_​EMC_​UNITY_​SNAPSHOT_​IDENTITY EMC Unity Snapshot Identity EMCUnity​Snap​Shot​Identity
OUTPUT_​EMC_​UNITY_​FILE_​SYSTEM_​IDENTITY EMC Unity File System Identity.​ EMCUnity​File​System​Identity
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​NAME EMC Unity SMB Share Name gen_​text_​input
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​EXPORT_​PATH EMC Unity SMB Share Export Path gen_​text_​input
OUTPUT_​EMC_​UNITY_​ACCOUNT_​IDENTITY EMC Unity Account Identity.​ EMCUnity​Account​Identity

EMC Unity - Delete SMB Share

Summary
Delete an SMB/CIFS Share object from an EMC Unity array.
Description
This task deletes an SMB/CIFS Share from an EMC Unity storage array. This task is also the rollback task for Create EMC Unity SMB/CIFS Share. Input Format:
  • EMC Unity SMB Share: podName@accountName@spName@id@nasServerName@nasServerID@storagePoolName@storagePoolId@fileSystemName@fileSystemID@smbServerName@smbServerID. For example: Default Pod@EmcUnity@SP A@spa@TestNAS@nas_4@pool_7@Pool0@TestFS@fs_14@TestSMB@SMBShare_10
Inputs
Input Description Mappable To Type Mandatory
EMC Unity SMB Share Choose an EMC Unity SMB share to be deleted EMCUnity​SMBShare​Identity Y
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​IDENTITY EMC Unity SMB Share Identity EMCUnity​SMBShare​Identity
OUTPUT_​EMC_​UNITY_​FILE_​SYSTEM_​IDENTITY EMC Unity File System Identity.​ EMCUnity​File​System​Identity
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​NAME EMC Unity SMB Share Name gen_​text_​input
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​EXPORT_​PATH EMC Unity SMB Share Export Path gen_​text_​input
OUTPUT_​EMC_​UNITY_​ACCOUNT_​IDENTITY EMC Unity Account Identity.​ EMCUnity​Account​Identity

EMC Unity - Modify SMB Share

Summary
Modify an SMB/CIFS Share object on an EMC Unity array.
Description
This task modifies an SMB/CIFS Share on an EMC Unity storage array. This task modifies two types of shares:
  • An SMB Share created on a file system
  • An SMB Share created on a snapshot
Input Format:
  • EMC Unity SMB Share: podName@accountName@spName@id@nasServerName@nasServerID@storagePoolName@storagePoolId@fileSystemName@fileSystemID@smbServerName@smbServerID. For example: Default Pod@EmcUnity@SP A@spa@TestNAS@nas_4@pool_7@Pool0@TestFS@fs_14@TestSMB@SMBShare_10
  • Description: Valid Description
  • Access-based Enumeration: Check box-Filter directory entries according to client access permission
  • Branch Cache Enabled: Check box-Supports hash generation for branch cache retrieval of data
  • Protocol Encryption: Check box-Encrypt data as it is transmitted between the array and the host
  • Continuous Availability: Check box-Gives continuous access to the share following an NAS Server failover
  • Offline Availability: Check box-Manage the offline cashing of the files by the client.
  • UMASK: Valid UMASK. For example: 022. Specifies the default UNIX UMASK for new files created on the share.
Inputs
Input Description Mappable To Type Mandatory
EMC Unity SMB Share Choose an EMC Unity SMB share to be modified EMCUnity​SMBShare​Identity Y
Description Enter a description for the SMB share gen_​text_​input
Access-based Enumeration Check to filter directory entries by client access permission Boolean
Branch Cache Enabled Check to branch the data retrieval cache Boolean
Protocol Encryption Check to encrypt data transmitted between the array and the host Boolean
Continuous Availability Check to maintain continuous access to the share following a NAS server failover Boolean
Offline Availability Choose an offline availability type to manage offline file cacheing by the client EMCUnity​SMBShare​Offline​Availability​Type
UMASK Enter the default UNIX UMASK for new files created on the share gen_​text_​input
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​IDENTITY EMC Unity SMB Share Identity EMCUnity​SMBShare​Identity
OUTPUT_​EMC_​UNITY_​CIFS_​SERVER_​IDENTITY EMC Unity SMB Server Identity EMCUnity​SMBServer​Identity
OUTPUT_​EMC_​UNITY_​SNAPSHOT_​IDENTITY EMC Unity Snapshot Identity EMCUnity​Snap​Shot​Identity
OUTPUT_​EMC_​UNITY_​FILE_​SYSTEM_​IDENTITY EMC Unity File System Identity.​ EMCUnity​File​System​Identity
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​NAME EMC Unity SMB Share Name gen_​text_​input
OUTPUT_​EMC_​UNITY_​CIFS_​SHARE_​EXPORT_​PATH EMC Unity SMB Share Export Path gen_​text_​input
OUTPUT_​EMC_​UNITY_​ACCOUNT_​IDENTITY EMC Unity Account Identity.​ EMCUnity​Account​Identity