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 Select the EMC Unity account to create SMB Share on EMCUnity​Account​Identity Y
EMC Unity File System SMB Share Will be Created on the File System EMCUnity​File​System​Identity Y
Use Snapshot Indicates if the Snapshot of the file system used for share creation Boolean
Path Absolute Path of the SMB Share related to the NAS Server gen_​text_​input
Share Name Name of the SMB Share.​ The following special characters are not allowed ", %, &, ', *, +, .​, /, \, :, ;, <, =, >, ?, ^, @, | and ," gen_​text_​input
Description Description of the SMB Share gen_​text_​input
Access-based Enumeration Filter directory entries according to client access permission Boolean
Branch Cache Enabled Supports hash generation for branch cache retrieval of data Boolean
Protocol Encryption Encrypt data as it is transmitted between the array and the host Boolean
Continuous Availability Gives continuous access to the share following a NAS Server failover Boolean
Offline Availability Manage the offline cashing of the files by the client EMCUnity​SMBShare​Offline​Availability​Type
UMASK Specifies 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 Select EMC Unity SMB Share to delete 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 Select EMC Unity SMB Share to Modify EMCUnity​SMBShare​Identity Y
Description Description of the SMB Share gen_​text_​input
Access-based Enumeration Filter directory entries according to client access permission Boolean
Branch Cache Enabled Supports hash generation for branch cache retrieval of data Boolean
Protocol Encryption Encrypt data as it is transmitted between the array and the host Boolean
Continuous Availability Gives continuous access to the share following a NAS Server failover Boolean
Offline Availability Manage the offline cashing of the files by the client EMCUnity​SMBShare​Offline​Availability​Type
UMASK Specifies 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