EMC Unity - File System Operations

This chapter contains the following sections:

EMC Unity - Create File System

Summary
Create a new file system on an EMC Unity array.
Description
This task creates or adds a new file system on an EMC Unity storage array. Minimum file system capacity is 3 GB. Before a file system is created, at least one NAS server must exist on the storage system. Optionally, Snapshot Schedule can be selected with the Pause Snapshot creation option. If Snapshot Schedule is selected and Pause Snapshot creation is not checked, the EMC Unity system creates snapshots on the file system at the frequency configured on the snapshot schedule. Input Format:
  • EMC Unity Account Name: podName@AccountName. For example: Vblock@Unity_Hybrid.
  • EMC Unity NAS Server: podName@accountName@spName@spid@storagePoolName@storagePoolid@nasServerName@nasServerID. For example: Default Pod@EmcUnity@SP A@spa@Pool0@Pool_7@TestNAS@nas_4.
  • Protocol: Configure the protocols the file system supports.
  • Name: A valid name. The following 19 special characters are not allowed in the file system name: " % & ' * + . / \ : ; < = > ? ^ @ | ,
  • Description: A description of the file system.
  • Storage Pool: PodName@accountName@storagePoolName@storagePoolId. For example: Vblock@Unity_Hybrid@Pool1@pool_7.
  • Size: Size of the File System. Minimum file system capacity is 3 GB.
  • Capacity Units: The unit for the size of the file system: GB, MB, or TB.
  • Thin: Check to enable thin provisioning for file system.
  • Snapshot Schedule: Select the schedule to associate to the file system. The snapshot schedule contains schedule settings for the file system.
  • Snapshot Schedule Paused: Check to indicate that the snapshot schedule is paused.
Inputs
Input Description Mappable To Type Mandatory
EMC Unity Account Select EMC Unity account to add host EMCUnity​Account​Identity Y
Protocol Choose a protocol that the file system supports EMCUnity​File​System​Protocol​Type Y
NAS Server Choose a NAS server to provide network connectivity to the share from the host EMCUnity​Nas​Server​Identity Y
Name Enter the name of file system.​ The following 19 special characters are not allowed: ", %, &, ', *, +, .​, /, \, :, ;, <, =, >, ?, ^, @, | and ," gen_​text_​input
Description Enter a description for the file system gen_​text_​input
Pool Choose a storage pool in which to create the file system EMCUnity​Storage​Pool​Identity Y
Size Enter the size of file system.​ Minimum size is 3 GB.​ gen_​text_​input Y
Capacity Units Choose the capacity units (MB, GB, or TB) EMCUnity​Size​Unit Y
Thin Check to enable thin provisioning for the file system Boolean
Snapshot Schedule Choose a snapshot schedule for the file system EMCUnity​Snapshot​Schedule​Identity
Snapshot Schedule Paused Check to pause the snapshot schedule Boolean
Sync Write Enabled Check to enable synchronous writes on the file system Boolean
Opslocks Enabled Check to enable opportunistic file locking on the file system Boolean
Notify On Write Enabled Check to enable notifications of file writes on the file system Boolean
Notify On Access Enabled Check to enable notifications of file accesses on the file system Boolean
Access Policy Indicates whether notifications on files access is enabled on the file system EMCUnity​File​System​Access​Policy​Type
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​FILE_​SYSTEM_​IDENTITY EMC Unity File System Identity.​ EMCUnity​File​System​Identity
OUTPUT_​EMC_​UNITY_​STORAGE_​POOL_​IDENTITY EMC Unity Storage Pool Identity EMCUnity​Storage​Pool​Identity
OUTPUT_​EMC_​UNITY_​ACCOUNT_​IDENTITY EMC Unity Account Identity.​ EMCUnity​Account​Identity
OUTPUT_​EMC_​UNITY_​FILE_​SYSTEM_​SIZE EMC Unity File System Size.​ gen_​text_​input

EMC Unity - Delete File System

Summary
Delete a file system on an EMC Unity array.
Description
This task deletes a file system on an EMC Unity storage array. Use the Force option to delete snapshots along with the file system. Delete EMC Unity File System is the rollback task for Create EMC Unity File System. Input Format:
  • 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
  • Force: Select to also delete snapshots.
Inputs
Input Description Mappable To Type Mandatory
File System Choose an EMC Unity file system EMCUnity​File​System​Identity Y
Force Check to force delete if the file system has snapshots associated with it Boolean
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​FILE_​SYSTEM_​IDENTITY EMC Unity File System Identity.​ EMCUnity​File​System​Identity
OUTPUT_​EMC_​UNITY_​STORAGE_​POOL_​IDENTITY EMC Unity Storage Pool Identity EMCUnity​Storage​Pool​Identity

EMC Unity - Modify File System

Summary
Modify an EMC Unity file system on an EMC Unity array.
Description
This task modifies a file system on an EMC Unity storage array. Only description, size, and snapshot schedule inputs can be modified using this task. To enable or disable snapshot creation on a file system, use Start Snapshot creation or Pause Snapshot creation respectively. A snapshot schedule can be added or changed but cannot be removed from the file system. Input Format:
  • 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
  • Description: A description of the file system.
  • Size: The size of the File System. Minimum file system capacity is 3 GB.
  • Capacity Units: The unit for the size of the file system: GB, MB, or TB.
  • Snapshot Schedule: A snapshot schedule can be added or changed but cannot be removed from the file system.
Inputs
Input Description Mappable To Type Mandatory
File System Choose an EMC Unity file system EMCUnity​File​System​Identity Y
Description Enter a description for the file system gen_​text_​input
Size Enter the size of file system.​ Minimum size is 3 GB.​ gen_​text_​input
Capacity Units Choose the capacity units (MB, GB, or TB) EMCUnity​Size​Unit Y
Snapshot Schedule Choose a snapshot schedule settings for the file system EMCUnity​Snapshot​Schedule​Identity
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​FILE_​SYSTEM_​IDENTITY EMC Unity File System Identity.​ EMCUnity​File​System​Identity
OUTPUT_​EMC_​UNITY_​STORAGE_​POOL_​IDENTITY EMC Unity Storage Pool Identity EMCUnity​Storage​Pool​Identity
OUTPUT_​EMC_​UNITY_​ACCOUNT_​IDENTITY EMC Unity Account Identity.​ EMCUnity​Account​Identity