Vhv0dZddlmZmZmZeZdZdZdZ ddl m Z ddl m Z e jdZd ZGd d eZd Zd ZdZdZdZedk(reyy)z/Ansible module for managing FileSystem on Unity)absolute_importdivisionprint_functiona( module: filesystem version_added: '1.1.0' short_description: Manage filesystem on Unity storage system description: - Managing filesystem on Unity storage system includes Create new filesystem, Modify snapschedule attribute of filesystem, Modify filesystem attributes, Display filesystem details, Display filesystem snapshots, Display filesystem snapschedule, Delete snapschedule associated with the filesystem, Delete filesystem, Create new filesystem with quota configuration, Enable, modify and disable replication. extends_documentation_fragment: - dellemc.unity.unity author: - Arindam Datta (@dattaarindam) - Meenakshi Dembi (@dembim) - Spandita Panigrahi (@panigs7) options: filesystem_name: description: - The name of the filesystem. Mandatory only for the create operation. All the operations are supported through I(filesystem_name). - It is mutually exclusive with I(filesystem_id). type: str filesystem_id: description: - The id of the filesystem. - It can be used only for get, modify, or delete operations. - It is mutually exclusive with I(filesystem_name). type: str pool_name: description: - This is the name of the pool where the filesystem will be created. - Either the I(pool_name) or I(pool_id) must be provided to create a new filesystem. type: str pool_id: description: - This is the ID of the pool where the filesystem will be created. - Either the I(pool_name) or I(pool_id) must be provided to create a new filesystem. type: str size: description: - The size of the filesystem. type: int cap_unit: description: - The unit of the filesystem size. It defaults to C(GB), if not specified. choices: ['GB' , 'TB'] type: str nas_server_name: description: - Name of the NAS server on which filesystem will be hosted. type: str nas_server_id: description: - ID of the NAS server on which filesystem will be hosted. type: str supported_protocols: description: - Protocols supported by the file system. - It will be overridden by NAS server configuration if NAS Server is C(Multiprotocol). type: str choices: ['NFS', 'CIFS', 'MULTIPROTOCOL'] description: description: - Description about the filesystem. - Description can be removed by passing empty string (""). type: str smb_properties: description: - Advance settings for SMB. It contains optional candidate variables. type: dict suboptions: is_smb_sync_writes_enabled: description: - Indicates whether the synchronous writes option is enabled on the file system. type: bool is_smb_notify_on_access_enabled: description: - Indicates whether notifications of changes to directory file structure are enabled. type: bool is_smb_op_locks_enabled: description: - Indicates whether opportunistic file locking is enabled on the file system. type: bool is_smb_notify_on_write_enabled: description: - Indicates whether file write notifications are enabled on the file system. type: bool smb_notify_on_change_dir_depth: description: - Integer variable, determines the lowest directory level to which the enabled notifications apply. - Minimum value is C(1). type: int data_reduction: description: - Boolean variable, specifies whether or not to enable compression. Compression is supported only for thin filesystem. type: bool is_thin: description: - Boolean variable, specifies whether or not it is a thin filesystem. type: bool access_policy: description: - Access policy of a filesystem. choices: ['NATIVE', 'UNIX', 'WINDOWS'] type: str locking_policy: description: - File system locking policies. These policy choices control whether the NFSv4 range locks must be honored. type: str choices: ['ADVISORY', 'MANDATORY'] tiering_policy: description: - Tiering policy choices for how the storage resource data will be distributed among the tiers available in the pool. choices: ['AUTOTIER_HIGH', 'AUTOTIER', 'HIGHEST', 'LOWEST'] type: str quota_config: description: - Configuration for quota management. It contains optional parameters. type: dict suboptions: grace_period: description: - Grace period set in quota configuration after soft limit is reached. - If I(grace_period) is not set during creation of filesystem, it will be set to C(7 days) by default. type: int grace_period_unit: description: - Unit of grace period. - Default unit is C(days). type: str choices: ['minutes', 'hours', 'days'] default_hard_limit: description: - Default hard limit for user quotas and tree quotas. - If I(default_hard_limit) is not set while creation of filesystem, it will be set to C(0B) by default. type: int default_soft_limit: description: - Default soft limit for user quotas and tree quotas. - If I(default_soft_limit) is not set while creation of filesystem, it will be set to C(0B) by default. type: int is_user_quota_enabled: description: - Indicates whether the user quota is enabled. - If I(is_user_quota_enabled) is not set while creation of filesystem, it will be set to C(false) by default. - Parameters I(is_user_quota_enabled) and I(quota_policy) are mutually exclusive. type: bool quota_policy: description: - Quota policy set in quota configuration. - If I(quota_policy) is not set while creation of filesystem, it will be set to C(FILE_SIZE) by default. - Parameters I(is_user_quota_enabled) and I(quota_policy) are mutually exclusive. choices: ['FILE_SIZE','BLOCKS'] type: str cap_unit: description: - Unit of I(default_soft_limit) and I(default_hard_limit) size. - Default unit is C(GB). choices: ['MB', 'GB', 'TB'] type: str state: description: - State variable to determine whether filesystem will exist or not. choices: ['absent', 'present'] required: true type: str snap_schedule_name: description: - This is the name of an existing snapshot schedule which is to be associated with the filesystem. - This is mutually exclusive with I(snapshot_schedule_id). type: str snap_schedule_id: description: - This is the id of an existing snapshot schedule which is to be associated with the filesystem. - This is mutually exclusive with I(snapshot_schedule_name). type: str replication_params: description: - Settings required for enabling or modifying replication. type: dict suboptions: replication_name: description: - Name of the replication session. type: str new_replication_name: description: - Replication name to rename the session to. type: str replication_mode: description: - The replication mode. - This is a mandatory field while creating a replication session. type: str choices: ['synchronous', 'asynchronous', 'manual'] rpo: description: - Maximum time to wait before the system syncs the source and destination LUNs. - The I(rpo) option should be specified if the I(replication_mode) is C(asynchronous). - The value should be in range of C(5) to C(1440) for C(asynchronous), C(0) for C(synchronous) and C(-1) for C(manual). type: int replication_type: description: - Type of replication. choices: ['local', 'remote'] type: str remote_system: description: - Details of remote system to which the replication is being configured. - The I(remote_system) option should be specified if the I(replication_type) is C(remote). type: dict suboptions: remote_system_host: required: true description: - IP or FQDN for remote Unity unisphere Host. type: str remote_system_username: type: str required: true description: - User name of remote Unity unisphere Host. remote_system_password: type: str required: true description: - Password of remote Unity unisphere Host. remote_system_verifycert: type: bool default: true description: - Boolean variable to specify whether or not to validate SSL certificate of remote Unity unisphere Host. - C(true) - Indicates that the SSL certificate should be verified. - C(false) - Indicates that the SSL certificate should not be verified. remote_system_port: description: - Port at which remote Unity unisphere is hosted. type: int default: 443 destination_pool_id: type: str description: - ID of pool to allocate destination filesystem. destination_pool_name: type: str description: - Name of pool to allocate destination filesystem. replication_state: description: - State of the replication. choices: ['enable', 'disable'] type: str notes: - SMB shares, NFS exports, and snapshots associated with filesystem need to be deleted prior to deleting a filesystem. - The I(quota_config) parameter can be used to update default hard limit and soft limit values to limit the maximum space that can be used. By default they both are set to 0 during filesystem creation which means unlimited. - The I(check_mode) is not supported. a` - name: Create FileSystem dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_name: "ansible_test_fs" nas_server_name: "lglap761" pool_name: "pool_1" size: 5 state: "present" - name: Create FileSystem with quota configuration dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_name: "ansible_test_fs" nas_server_name: "lglap761" pool_name: "pool_1" size: 5 quota_config: grace_period: 8 grace_period_unit: "days" default_soft_limit: 10 is_user_quota_enabled: false state: "present" - name: Expand FileSystem size dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_name: "ansible_test_fs" nas_server_name: "lglap761" size: 10 state: "present" - name: Expand FileSystem size dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_name: "ansible_test_fs" nas_server_name: "lglap761" size: 10 state: "present" - name: Modify FileSystem smb_properties dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_name: "ansible_test_fs" nas_server_name: "lglap761" smb_properties: is_smb_op_locks_enabled: true smb_notify_on_change_dir_depth: 5 is_smb_notify_on_access_enabled: true state: "present" - name: Modify FileSystem Snap Schedule dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_id: "fs_141" snap_schedule_id: "{{snap_schedule_id}}" state: "{{state_present}}" - name: Get details of FileSystem using id dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_id: "rs_405" state: "present" - name: Delete a FileSystem using id dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_id: "rs_405" state: "absent" - name: Enable replication on the fs dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_id: "rs_405" replication_params: replication_name: "test_repl" replication_type: "remote" replication_mode: "asynchronous" rpo: 60 remote_system: remote_system_host: '0.1.2.3' remote_system_verifycert: false remote_system_username: 'username' remote_system_password: 'password' destination_pool_name: "pool_test_1" replication_state: "enable" state: "present" - name: Modify replication on the fs dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_id: "rs_405" replication_params: replication_name: "test_repl" new_replication_name: "test_repl_updated" replication_mode: "asynchronous" rpo: 50 replication_state: "enable" state: "present" - name: Disable replication on the fs dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_id: "rs_405" replication_state: "disable" state: "present" - name: Disable replication by specifying replication_name on the fs dellemc.unity.filesystem: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" filesystem_id: "rs_405" replication_params: replication_name: "test_replication" replication_state: "disable" state: "present" a! changed: description: Whether or not the resource has changed. returned: always type: bool sample: true filesystem_details: description: Details of the filesystem. returned: When filesystem exists type: dict contains: id: description: The system generated ID given to the filesystem. type: str name: description: Name of the filesystem. type: str description: description: Description about the filesystem. type: str is_data_reduction_enabled: description: Whether or not compression enabled on this filesystem. type: bool size_total_with_unit: description: Size of the filesystem with actual unit. type: str tiering_policy: description: Tiering policy applied to this filesystem. type: str is_cifs_notify_on_access_enabled: description: Indicates whether the system generates a notification when a user accesses the file system. type: bool is_cifs_notify_on_write_enabled: description: Indicates whether the system generates a notification when the file system is written to. type: bool is_cifs_op_locks_enabled: description: Indicates whether opportunistic file locks are enabled for the file system. type: bool is_cifs_sync_writes_enabled: description: Indicates whether the CIFS synchronous writes option is enabled for the file system. type: bool cifs_notify_on_change_dir_depth: description: Indicates the lowest directory level to which the enabled notifications apply, if any. type: int pool: description: The pool in which this filesystem is allocated. type: dict contains: id: description: The system ID given to the pool. type: str name: description: The name of the storage pool. type: str nas_server: description: The NAS Server details on which this filesystem is hosted. type: dict contains: id: description: The system ID given to the NAS Server. type: str name: description: The name of the NAS Server. type: str snapshots: description: The list of snapshots of this filesystem. type: list contains: id: description: The system ID given to the filesystem snapshot. type: str name: description: The name of the filesystem snapshot. type: str is_thin_enabled: description: Indicates whether thin provisioning is enabled for this filesystem. type: bool snap_schedule_id: description: Indicates the id of the snap schedule associated with the filesystem. type: str snap_schedule_name: description: Indicates the name of the snap schedule associated with the filesystem. type: str quota_config: description: Details of quota configuration of the filesystem created. type: dict contains: grace_period: description: Grace period set in quota configuration after soft limit is reached. type: str default_hard_limit: description: Default hard limit for user quotas and tree quotas. type: int default_soft_limit: description: Default soft limit for user quotas and tree quotas. type: int is_user_quota_enabled: description: Indicates whether the user quota is enabled. type: bool quota_policy: description: Quota policy set in quota configuration. type: str replication_sessions: description: List of replication sessions if replication is enabled. type: dict contains: id: description: ID of replication session type: str name: description: Name of replication session type: str remote_system: description: Remote system type: dict contains: id: description: ID of remote system type: str sample: { "access_policy": "AccessPolicyEnum.UNIX", "cifs_notify_on_change_dir_depth": 512, "cifs_share": null, "data_reduction_percent": 0, "data_reduction_ratio": 1.0, "data_reduction_size_saved": 0, "description": "", "existed": true, "folder_rename_policy": "FSRenamePolicyEnum.SMB_RENAME_FORBIDDEN", "format": "FSFormatEnum.UFS64", "hash": 8735427610152, "health": { "UnityHealth": { "hash": 8735427614928 } }, "host_io_size": "HostIOSizeEnum.GENERAL_8K", "id": "fs_65916", "is_advanced_dedup_enabled": false, "is_cifs_notify_on_access_enabled": false, "is_cifs_notify_on_write_enabled": false, "is_cifs_op_locks_enabled": false, "is_cifs_sync_writes_enabled": false, "is_data_reduction_enabled": false, "is_read_only": false, "is_smbca": false, "is_thin_enabled": true, "locking_policy": "FSLockingPolicyEnum.MANDATORY", "metadata_size": 11274289152, "metadata_size_allocated": 4294967296, "min_size_allocated": 0, "name": "test_fs", "nas_server": { "id": "nas_18", "name": "test_nas1" }, "nfs_share": null, "per_tier_size_used": [ 6979321856, 0, 0 ], "pool": { "id": "pool_7", "name": "pool 7" }, "pool_full_policy": "ResourcePoolFullPolicyEnum.FAIL_WRITES", "quota_config": { "default_hard_limit": "0B", "default_soft_limit": "0B", "grace_period": "7.0 days", "id": "quotaconfig_171798760421_0", "is_user_quota_enabled": false, "quota_policy": "QuotaPolicyEnum.FILE_SIZE" }, "replication_sessions": { "current_transfer_est_remain_time": 0, "id": "***", "last_sync_time": "2022-05-12 11:20:38+00:00", "local_role": "ReplicationSessionReplicationRoleEnum.SOURCE", "max_time_out_of_sync": 60, "members": null, "name": "local_repl_new", "network_status": "ReplicationSessionNetworkStatusEnum.OK", "remote_system": { "UnityRemoteSystem": { "hash": 8735426929707 } }, "replication_resource_type": "ReplicationEndpointResourceTypeEnum.FILESYSTEM", "src_resource_id": "res_66444", "src_status": "ReplicationSessionStatusEnum.OK", "status": "ReplicationOpStatusEnum.AUTO_SYNC_CONFIGURED", "sync_progress": 0, "sync_state": "ReplicationSessionSyncStateEnum.IDLE" }, "size_allocated": 283148288, "size_allocated_total": 4578148352, "size_preallocated": 2401173504, "size_total": 10737418240, "size_total_with_unit": "10.0 GB", "size_used": 1620312064, "snap_count": 2, "snaps_size": 21474869248, "snaps_size_allocated": 32768, "snapshots": [], "supported_protocols": "FSSupportedProtocolEnum.NFS", "tiering_policy": "TieringPolicyEnum.AUTOTIER_HIGH", "type": "FilesystemTypeEnum.FILESYSTEM" } ) AnsibleModule)utils filesystemz Ansible/1.7.1ceZdZdZdZddZddZddZdZdZ d Z d Z d Z d Z d ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZd dZdZy)! Filesystemz Class with FileSystem operationsctj|_|jjt ddgddgddgddgg}ddgg}t |jd || |_tj|j tj|j jt|_ y ) z-Define all parameters required by this modulefilesystem_name filesystem_id pool_namepool_idnas_server_name nas_server_idsnap_schedule_namesnap_schedule_idF) argument_specsupports_check_modemutually_exclusiverequired_one_ofN) r$get_unity_management_host_parameters module_paramsupdateget_filesystem_parametersrmoduleensure_required_libsget_unity_unisphere_connectionparamsapplication_type unity_conn)selfrrs l/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/unity/plugins/modules/filesystem.py__init__zFilesystem.__init__s"GGI !!";"=>0/B*I60/B35GHJ .?@$,, %1+ - ""4;;/>> KK   02Nc|r|n|}d} d}|rc|r|jj||}n|jj|}|r$|jrtj d||Sy|rm|s3d}tj ||j j||jj||}|rtj d||Sytj d |y#tj$r}|jd k(rJd j|j} |j|| } |j j| n<|j|t|} |j j| Yd}~yYd}~yd}~wtj$r:}|j|t|} tj | Yd}~yd}~wt$rV}|j|t|} tj | |j j| Yd}~yd}~wwxYw) a&Get the details of a FileSystem. :param filesystem_name: The name of the filesystem :param filesystem_id: The id of the filesystem :param obj_nas_server: NAS Server object instance :return: instance of the respective filesystem if exist. z/Failed to get the filesystem {0} with error {1}N)_id nas_server)r'z*Successfully got the filesystem object %s z,NAS Server is required to get the FileSystemmsg)namer(zFailed to get the filesystem %siz$Incorrect username or password , {0})r!get_filesystemexistedLOGinfoerrorr fail_jsonr HttpError http_statusformatmessagestrUnityResourceNotFoundError Exception) r"r+idobj_nas_server id_or_nameerrormsgobj_fserr_msgecred_errr*s r#r,zFilesystem.get_filesystemsR4 D1 +F!!__;;#1<3F"__;;;CFfnnHH*+13!M %LGIIg&KK))g)677-8/HHDfN!M:JG /}}#AHHIIooj(; %%#%.ooj#a&9 %%#%../ // //*c!f5C IIcN +//*c!f5C IIcN KK ! !c ! * * +s?A%C71A-C7 C77I BF$$I:0G// I;A I  Icd}|r|n|} |jj||}|r$|jrtj d||S|rtj d||Sdj |}tj ||jj|y#t$rV}|j |t|}tj ||jj|Yd}~yd}~wwxYw)zGet the instance of a NAS Server. :param name: The NAS Server name :param id: The NAS Server id :return: instance of the respective NAS Server if exists. z/Failed to get the NAS Server {0} with error {1})r'r+z)Successfully got the nas server object %sz*Successfully got the nas server object %s z%Failed to get the nas server with {0}r)N) r!get_nas_serverr-r.r/r4r0rr1r8r6)r"r+r9r<r;obj_nasr*r?s r#rBzFilesystem.get_nas_serversE!Tr  +oo44$4GGgooD "E "=DD  # %%#%. +//$A/C IIcN KK ! !c ! * * +&AB* B*'AB** D 3A DD c|r|n|}d} |jj||}|r$|jrtj d||S|rtj d||Sdj |}tj ||jj|y#t$rV}|j |t|}tj ||jj|Yd}~yd}~wwxYw)zGet the instance of a pool. :param pool_name: The name of the pool :param pool_id: The id of the pool :return: Dict containing pool details if exists z)Failed to get the pool {0} with error {1})r+r'z#Successfully got the pool object %szSuccessfully got pool %szFailed to get the pool with {0}r)N) r!get_poolr-r.r/r4r0rr1r8r6)r"rrr;r<obj_poolr*r?s r#rFzFilesystem.get_pool.s!(WY > +//YG/LH8++>!#3X>7>>  # %%#%. +//*c!f5C IIcN KK ! !c ! * * +rDc|tjjvrtj|Sdj|}tj ||j j|y)zGet the tiering_policy enum. :param tiering_policy: The tiering_policy string :return: tiering_policy enum z%Invalid choice {0} for tiering policyr)N)rTieringPolicyEnum __members__r4r.r0rr1)r"tiering_policyr<s r#get_tiering_policy_enumz"Filesystem.get_tiering_policy_enumMs] U44@@ @**>: :>EE H IIh  KK ! !h ! /r%c|dk(rdn|}|tjjvrtj|Sdj|}tj ||j j|y)zGet the supported_protocol enum. :param supported_protocol: The supported_protocol string :return: supported_protocol enum MULTIPROTOCOLMULTI_PROTOCOLz)Invalid choice {0} for supported_protocolr)N)rFSSupportedProtocolEnumrJr4r.r0rr1)r"supported_protocolr<s r#get_supported_protocol_enumz&Filesystem.get_supported_protocol_enum[ss / 1.7I  !>!>!J!J J001CD DBII"$H IIh  KK ! !h ! /r%c|tjjvrtj|Sdj|}tj ||j j|y)zGet the locking_policy enum. :param locking_policy: The locking_policy string :return: locking_policy enum z%Invalid choice {0} for locking_policyr)N)rFSLockingPolicyEnumrJr4r.r0rr1)r"locking_policyr<s r#get_locking_policy_enumz"Filesystem.get_locking_policy_enumks] U66BB B,,^< <>EE H IIh  KK ! !h ! /r%c|tjjvrtj|Sdj|}tj ||j j|y)zGet the access_policy enum. :param access_policy: The access_policy string :return: access_policy enum z$Invalid choice {0} for access_policyr)N)rAccessPolicyEnumrJr4r.r0rr1)r" access_policyr<s r#get_access_policy_enumz!Filesystem.get_access_policy_enumxs] E22>> >))-8 8=DDH IIh  KK ! !h ! /r%c X |jjd}|r|j|nd}|jjd}|jjd}|r|j|nd}tj j |jj|||||||}tjd||S#t$rV} dj|t| } tj| |jj| Yd} ~ yd} ~ wwxYw) a:Create a FileSystem. :param name: Name of the FileSystem :param obj_pool: Storage Pool obj instance :param obj_nas_server: NAS Server obj instance :param size: Total size of a filesystem in bytes :return: FileSystem object on successful creation supported_protocolsNis_thinrK)poolr(r+sizeprotor]rKz%Successfully created file system , %sz6Create filesystem {0} operation failed with error {1}r))rrrRrLrUnityFileSystemcreater!_clir.r/r8r4r6r0r1) r"r+rGr:r_rQr]rKr=r?r<s r#create_filesystemzFilesystem.create_filesystems" 0!%!3!34I!J '9"&!A!A""$?C kk((3G![[//0@AN!"99.I'+ **11$$)(-2/F HH  IIh  KK ! !h ! / /  0sB"B%% D.A C??Dc i}|j}|jjd}|"||jk7r|jd|i|jjd}|ro|rmt t j ||}||jkr|jjdn"||jkDr|jd|i|jjd}|r@|j||jk7r"|jd|j|i|jjd}|"||jk7r|jd|i|jjd} | "| |jk7r|jd | i|jjd } | r@|j| |jk7r"|jd |j| i|jjd } | r@|j| |j k7r"|jd |j| i|j"j$} |j&v|j&d k(r/| re| j(|j&k7rL|jd din8| | j(|j&k7r|jd|j&i|jjd} | r| d}| d}| d}| d}| d}|"||j*k7r|jd|i|"||j,k7r|jd|i|"||j.k7r|jd|i|"||j0k7r|jd|i|"||j2k7r|jd|it5|dkDr|Sy#t6$r`}dj9|j(t;|}t<j?||jj|Yd}~yd}~wwxYw)zChecks if any modify required for filesystem attributes :param obj_fs: filesystem instance :param cap_unit: capacity unit :return: filesystem to update dict descriptionNr_z$Filesystem size can be expanded onlyr)rKr]data_reductionis_compressionrYrUis_snap_schedule_pausedF snap_sch_idsmb_propertiesis_smb_sync_writes_enabledis_smb_op_locks_enabledis_smb_notify_on_write_enabledis_smb_notify_on_access_enabledsmb_notify_on_change_dir_depthis_cifs_sync_writes_enabledis_cifs_op_locks_enabledis_cifs_notify_on_write_enabled is_cifs_notify_on_access_enabledcifs_notify_on_change_dir_depthrzNFailed to determine if FileSystem id: {0} modification required with error {1}) rrrrnintrget_size_bytes size_totalr1rLrKis_thin_enabledis_data_reduction_enabledrZrYrVrUstorage_resource snap_schedulersr9rzr{r|r}r~lenr8r4r6r.r0)r"r=cap_unit to_updaternr_ size_byterKr]rorYrUsnap_schrtsync_writes_enabledoplocks_enablednotify_on_writenotify_on_accessnotify_on_change_dir_depthr?r<s r#is_modify_requiredzFilesystem.is_modify_requireds k 0I]]_F++,,];K&;&:L:L+L  -!=>;;%%f-D 4 4T8 DE v000KK))/>)?!2!22$$fi%89![[//0@AN$">">"#$'-'<'<#=  "2"&">">&4#6"78kk((3G"w&2H2H'H  )W!56![[//0@AN)"f&F&FF  "2N!CD KK..?M!">"#$'-'<'<#=  "2"&">">&4#6"78..<>?$$:OLN$/(??@$$;)+,.92>>?$$:3569~!   0??EvfiiFI!f@N  IIh  KK ! !h ! / /  0sO3O77 Q AQQ c` gd}i}i}|D]+}||jvs|j|||i-tjd||jdi|}gd}|D]+} | |jvs|j| || i-|r|jd|id|jvr'|jddd|j diiin'd |jvr|jdd d ii|j}|j di|} tjd | y#t$r`} d j|jt| } tj| |jj| Yd} ~ yd} ~ wwxYw)z modifes attributes for a filesystem instance :param update_dict: modify dict :return: True on Success )rzr{r|r}r~zCIFS Modify Payload: %s)r_r]rKrprYrUrncifs_fs_parametersrrssnap_schedule_parameters snapScheduler9rrisSnapSchedulePausedFz-Successfully modified the FS with response %sz;Failed to modify FileSystem instance id: {0} with error {1}r)N)keysrr.debugprepare_cifs_fs_parametersgetmodifyr/r8r4r9r6r0rr1) r" update_dictr=adv_smb_paramscifs_fs_payloadfs_update_payload smb_paramrfs_update_paramsfs_paramrespr?r<s r#modify_filesystemzFilesystem.modify_filesystem:s 9 03N!O " + P  0 0 22#**I{97M+NO P II/ A!B!B!B"#!"#  & - P{//11%,,h H8M-NO P"!(()+=>@ 0 0 22!((/.KOOM:;2 +k.>.>.@@!((/2H%1P]]_F 6==5#45D HHDd K 0))/ 3q6)B  IIh  KK ! !h ! / /  0s%EAE>CE F- AF((F-c  |j}|j}tjt |d|d<|j r>|jd|j j |j jdi|jr>|jd|jj |jjdig}|jr;|jD],}|j |jd}|j|.||d<|jjrF|jjj|d<|jjj |d<|j|}|rtj|j}tj|j }t#|j$} |jd |j|||j&|jd | d ig|d <|j)|} | r| j|d <|S#t*$r`} d j-|j t/| } t0j3| |j4j7| Yd} ~ yd} ~ wwxYw)zget display filesystem attributes :param obj_fs: filesystem instance :return: filesystem dict to display rsize_total_with_unitr^r+r9r( snapshotsrr quota_config quota_policy)r9default_hard_limitdefault_soft_limitis_user_quota_enabledr grace_periodreplication_sessionsz3Failed to display the filesystem {0} with error {1}r)N)rrirconvert_size_with_unitrr^r+r9r(has_snaprappendrrget_quota_config_detailsrrget_time_with_unitrrget_replication_sessionr8r4r6r.r0rr1) r"r=filesystem_details snap_listsnapdquota_config_obj hard_limit soft_limitrfs_repl_sessionsr?r<s r#!get_filesystem_display_attributesz,Filesystem.get_filesystem_display_attributeszs 8 0]]_F!'!7!7!9 9>&&s+=l+K'L:N 5 6{{"))fkk&6&6$*KKNN456  "))!F,=,=,B,B*0*;*;*>*>$@ABI ",,(D!%$'':A$$Q'(/8 { +&&449?9P9P9^9^9a9a"#56;A;R;R;`;`;e;e"#78#<1A1D1DAKAK/?/U/U;K;[;[;]/=  IIh  KK ! !h ! / /  0sII K#AJ>>Kc|d} |jjD]o}|jj|}|dk(s |dk(s|dk(r,t|ts=||k(sCdj |}|jj |q|jjdr7|jjd|jj d y y y #t $rU}d j t|}tj||jj |Yd }~y d }~wwxYw) z9 validates the input string checks if it is empty string rqrnrrz"Invalid input parameter "" for {0}r)replication_paramsreplication_stateNz>Please specify replication_state along with replication_paramsz2Failed to validate the module param with error {0}) rr isinstancer6r4r1r8r.r0)r"invalid_stringkeyvalerrmsgr?r<s r#validate_input_stringz Filesystem.validate_input_strings# 0{{)) 6kk((--'32F+F $66c3'>1AHHFKK))f)5 6{{!!"67DKK  IIh  KK ! !h ! / /  0s&ACCA=C D;&A D66D;c  d}i}|dr9tjj|jj|d}n=|dr8tjj|jj|d}|r|j d}|sJdj |d|df}tj||jj||S#t$r$}d j t|}Yd}~yd}~wwxYw) z Get snapshot id for a give snap schedule name :param params: snap schedule name or id :return: snap schedule id after validation Nr+r+r9rfrzEFailed to find the snapshot schedule id against given name or id: {0}r)z4Failed to find the snapshot schedules with error {0}) rUnitySnapScheduleListrr!rcr9r4r.r0rr1r8r6)r"rrssnapshot_scheduler<r?s r#resolve_to_snapschedule_idz%Filesystem.resolve_to_snapschedule_ids  2K " f~$)$?$?$C$CDOODXDX_efl_m$C$n!$)$?$?$C$CDOODXDX]cdh]i$C$j! /2215 ((.vf~(>O (# %%(%3  2##)6#a&>  2sCC D )DD cT |jj|}|j}t|dk(rtj dyt t|D]b}|s||jj|k(s#||jr3d|d||j}tj|||cSy#t$rV}djt|}tj ||jj|Yd}~yd}~wwxYw) z Get the quota config ID mapped to the filesystem :param obj_fs: Filesystem instance :return: Quota config object if exists else None )rrz>The quota_config object for new filesystem is not updated yet.NzQuota config id for filesystem z is z?Failed to fetch quota config for filesystem {0} with error {1}r))r!get_quota_configr9rr.r0ranger tree_quotar/r8r4r6rr1)r"r=all_quota_configfs_idrr*r?r<s r#rz#Filesystem.get_quota_config_detailss   0#??6?R IIE#$) 01 %c*:&; < : -l;FFIIUR,\:EE"$4\$B$E$EGCHHSM+L99  : 0))/s1v)>  IIh  KK ! !h ! / /  0s7A CC(CC0CC D'A D""D'cV|r#|d}|d}|d}|d}|d}|d}|d} rtj|} n |j} rtj|} n |j} r t | } n |j } d} d}rtj |r8tj |} tj |jd }nBd j|}tj||jj| |j| k(rE|j| k(r6|j | k(r'||j| k(s||||jk(ry |jj!|j"| | | | }tj%d|y#t&$rj}dj|j(j"t+|}tj||jj| Yd}~yd}~wwxYw)a Modify default quota config settings of newly created filesystem. The default setting of quota config after filesystem creation is: default_soft_limit and default_hard_limit are 0, is_user_quota_enabled is false, grace_period is 7 days and, quota_policy is FILE_SIZE. :param quota_config_obj: Quota config instance :param quota_config_params: Quota config parameters to be modified :return: Boolean whether quota config is modified rrrrrrgrace_period_unitNvaluez#Invalid choice {0} for quota policyr)F)quota_config_idrrrrrz7Successfully modified the quota config with response %sTz@Failed to modify quota config for filesystem {0} with error {1})rrrrget_time_in_secondsrQuotaPolicyEnumrir4r.r0rr1rrr!modify_quota_configr9r/r8rr6)r"rquota_config_paramsrrrrrrgp_unitsoft_limit_in_byteshard_limit_in_bytesgrace_period_in_sec policy_enumpolicy_enum_valr<rr?s r#rzFilesystem.modify_quota_config sE ,-ABJ,-ABJ$78O$P !.~>L.~>L*:6H)*=>G "'"6"6z8"L "2"E"E  "'"6"6z8"L "2"E"E  "5lG"L "2"?"?   $$\2#33LA )),7GGI'R AGG " (# %%(%3  . .2E E 337JJ --1DD*"//;>%&.'3'+;+Q+QQ 0??66 0 3 30#6#6&;, 7.D HHNPT U 0))/0@0K0K0N0NPSTUPV)W  IIh  KK ! !h ! / /  0s3AF55 H(>A H##H(c0 |ddk(s |d~|dry|dd|dd|dd|dd|dd d }tj|t}|j|d <|d Z|j |d  }|j |d<y|d /|j j |d  }|j |d<yyy#t$rI}dt|z}tj||jj|Yd}~yd}~wwxYw)z Update replication params replication_typeremoteN remote_systemremote_system_hostremote_system_usernameremote_system_passwordremote_system_verifycertremote_system_port) unispherehostusernamepasswordvalidate_certsportremote_system_namedestination_pool_namerdestination_pool_idz0Updating replication params failed with error %sr)) rrr r+rFr9r!r8r6r.r0rr1)r"rconnection_paramsremote_system_conn pool_objectr?r<s r#update_replication_paramsz$Filesystem.update_replication_paramsXsm 0!"45A'(:;C'8%7%HI]%^ 2? CD\ ] 2? CD\ ]&8&IJd&e.?@TU %!&+%I%I%'7&9";M;R;R"#78%&=>J*339KLc9d3e @K&'<=%&=>J006HI`6a0b @K&'<=K K 0(*-a&1H IIh  KK ! !h ! / /  0sB C 3C D ?DDcH|ddk(r8|d3d}tj||jj||d|d}}|rV|rSddd d }|rG|||s;d |d |d }tj||jj|yyyyy)z) Validates rpo based on replication mode replication_mode asynchronousrpoNz>rpo is required together with 'asynchronous' replication_mode.r)c"d|cxkxrdkScS)Nirns r#z)Filesystem.validate_rpo..s!q.D..r%c |dk(S)Nrrrs r#rz)Filesystem.validate_rpo..s ar%c |dk(S)Nrrs r#rz)Filesystem.validate_rpo..s AGr%)r synchronousmanualzInvalid rpo value - z for z replication mode.r.r0rr1)r"rr<rr rpo_criterias r# validate_rpozFilesystem.validate_rpows 0 1^ C"5)1WH IIh  KK ! !h ! / 25 9;M <  #!9/+L 9<(89#>1#e.//AC (# %%(%3 ?s$3r%c|s3d}tj||jj||d8|d3d}tj||jj||j ||ddk(r:|d 4d }tj||jj|yyy)  Validate replication params z8Please specify replication_params to enable replication.r)rNrzH'destination_pool_id' and 'destination_pool_name' is mutually exclusive.rrrzARemote_system is required together with 'remote' replication_type)r.r0rr1r)r"rr<s r#validate_replication_paramsz&Filesystem.validate_replication_paramss!QH IIh  KK ! !h ! / 3 4 @"#:;GaH IIh  KK ! !h ! / ,- 0 1X =BTUdBeBmZH IIh  KK ! !h ! /Cn =r%c |d8|d3d}tj||jj|ddg}|D]>}|| d|z}tj||jj|@y) rrNrzZEither 'destination_pool_id' or 'destination_pool_name' is required to enable replication.r)rrz(Please specify %s to enable replication.r)r"rr<rrs r#"validate_create_replication_paramsz-Filesystem.validate_create_replication_paramss 3 4 <"#:;CsH IIh  KK ! !h ! /"$67 4C!#&.EK (# %%(%3  4r%c tjd|ji}|dr|ddk(rd}n|ddk(r d}n |dr|d}|j}|dr ||dk7r|d}|j|k7r||d <|ds|dr|jk7r||d <|r|jdi|y y #t $r@}d |z}tj ||jj|Yd}~yd}~wwxYw)a Modify the replication session :param: obj_fs: Filesystem object :param: repl_session: Replication session to be modified :param: replication_params: Module input params :return: True if modification is successful z.Modifying replication session of filesystem %srrrrrrnew_replication_namer+max_time_out_of_syncTFz2Modifying replication session failed with error %sr)Nr) r.r/r+rrr8r0rr1) r"r= repl_sessionrmodify_payloadrr+r?r<s r#modify_replication_sessionz%Filesystem.modify_replication_sessions* 0 HHEv{{ SN!"45%&89XEC'(:;}LC#E*(/$$D!"89./EFF)*@A  D()-v&#$67;Me;T 55<9<56# ##5n5 0KaOH IIh  KK ! !h ! / / 0sB+B// C886C33C8c  |j||j||j||d}|r|j|||S|j |t |}d|vr|d}|j j}|D]}|j|k(s||d<nd|jvr6d|z}tj||jj|tjd|j|jd i|y#t $rV} d|jd t#| }tj||jj|Yd } ~ y d } ~ wwxYw) z Enable the replication session :param: obj_fs: Filesystem object :param: replication_params: Module input params :return: True if enabling replication is successful rrrzRemote system %s is not foundr)z)Enabling replication to the filesystem %sTz'Enabling replication to the filesystem  failed with error Nr)r r!get_replication_session_on_filterrr get_replication_args_listr!get_remote_systemr+rr.r0rr1r/(replicate_with_dst_resource_provisioningr8r6) r"r=rrreplication_args_listrremote_system_listrr<r?s r#enable_replicationzFilesystem.enable_replicationsz  0  , ,-? @  * *+= >66v?QS[\ 66v|M_``  3 34F G$=>P$Q !#'99%78L%M"%)__%F%F%H"%7M$))-??AN-o>#*?*D*D*FF>BTUHIIh'KK))h)7 HH@&++ N ;F ; ; T>S T 0*0++s1v?H IIh  KK ! !h ! / /  0s'A D# AD# BD## F,A E==Fc~ tjd|jf|r|j||j ||d}|r|j yy#t $rV}d|jdt|}tj||jj|Yd}~yd}~wwxYw) z Remove replication from the filesystem :param: replication_params: Module input params :return: True if disabling replication is successful z*Disabling replication on the filesystem %srjTFz(Disabling replication on the filesystem rr)N) r.r/r+rrrjr8r6r0rr1)r"r=rrr?r<s r#disable_replicationzFilesystem.disable_replications  0 HHBFKKP Q!../AB66v?QS[\ ##% 0*0++s1v?H IIh  KK ! !h ! / /  0sAA B<&A B77B<c|r|dr|j|d|}|S|r|dr|j|d|d}|S|j||}|r:|r8|r6|dd k(r.|jj|jjk7ry|S) Nrr) filter_keyrreplication_namer+)rr+)actionrlocal)rrr+r!)r"r=rr rs r#rz,Filesystem.get_replication_session_on_filters "4_"E,,V@T@R-T  $67I$J,,V2DEW2X-Z   77v7NL+=&'9:gE ..33t7K7KKr%c |jj|jj}|s:|r8t |dkDr%|r!d|z}|j j ||S|dS|D]@}|dk(r |jj|dk(r|cS|dk(s.|j|k(s>|cSy#t$rH} d t| f} tj| |j j | Yd} ~ yd} ~ wwxYw) a Retrieves the replication sessions configured for the filesystem :param: obj_fs: Filesystem object :param: filter_key: Key to filter replication sessions :param: replication_params: Module input params :param: name: Replication session name :param: action: Specifies modify or delete action on replication session :return: Replication session details )src_resource_idzxThere are multiple replication sessions for the filesystem. Please specify replication_name in replication_params to %s.r)rrr+NzERetrieving replication session on the filesystem failed with error %s) r!rrr9rrr1rr+r8r6r.r0) r"r=rrr+r r error_msgsessionr?r<s r#rz"Filesystem.get_replication_session's 0??BBSYSjSjSmSmBnL,|$q(%dfl%m  --)-<''#A&' #!55--226HI]6^^"N'GLLD,@"N  #  0'(+A/H IIh  KK ! !h ! / /  0s<A&B4)B4.)B4B4B4.B42B44 D=>DDc |jjd}|jjd}|jjd}|jjd}|jjd}|jjd}|jjd}|jjd}|jjd } |jjd } |jjd } |jjd } |jjd } |jjd}d}tdi}d}d}d}|j|!|dk(r|jj d|r|sd}| r| d| d | dsd| d<| d | dd| d<| d$| ddkr|jj d| d4t j | dr|jj d| d4t j | dr|jj d||s|jj dd}|s|r|j||}d}|s|r|j|| }d}|j|||!}d|_ | s|r| |d}|j||_ n| d"k(s|d"k(rd"|_ |rH|j}|j}|j||}tj!d#|| d$k(r|s|s-d%j#|}|jj ||s|s|jj d&|s|jj d't j$||}|j'||||(}tj)d)||j*}|j}|j||}tj)d*|d+}| d$k(r|r|r|j-||,d+} | d$k(rK|rI| rG|j/|}||j1|| -}|rd+}n|jj d.| d$k(r.|r,| *| d/k(r|j3|| }n|j5|| }| d0k(r|r|j7|}d}| d$k(r|r|j9|1}||d2<||d3<|jj:d4i|y)5zs Perform different actions on filesystem module based on parameters passed in the playbook r r rrrrr_rrrrstaterrF)changedrNrzSize can not be 0 (Zero)r)GBrrrrdaysz6Invalid grace_period provided. Must be greater than 0.zHInvalid default_soft_limit provided. Must be greater than or equal to 0.zHInvalid default_hard_limit provided. Must be greater than or equal to 0.z)cap_unit can be specified along with sizer)rr)r+r9r:rqzFrom Mod Op, to_modify_dict: %spresentzbFileSystem with id {0} is not found, unable to create a FileSystem without a valid filesystem_namez9pool_id or pool_name is required to create new filesystemz'Size is required to create a filesystem)r+rGr:r_z$Successfully created filesystem , %szGot filesystem id , %sT)rr=)rrzOne or more operations related to this task failed because the new object created could not be fetched. Please rerun the task for expected result.enableabsent)r=r)rr)rrdictrr1ris_size_negativerBrFr,rsrriget_idrr.r/r4rrdrr9rrrrrrlr exit_json)r"r r rrrrr_rrrrr(rrr)resultto_modify_dictrrr(rGr=snap_schedule_params msg_nonameis_quota_config_modifieds r#perform_module_operationz#Filesystem.perform_module_operationGs ++,,->? **?; ++,,->? **?; KK&&{3 ++$$Y/{{!!&);;%%j1{{)).9 ![[//0DE KK../BC ""7+![[//0DE;;--.@A!  ! ""$   KK ! !&@ ! A H 12> 45A$Z0+/ Z(N+7$%89A4: 01N+7$^49 %%+D%E01=..|

%@  !1*&$  $>>?STD  2 %)9R)?!D  !'!7!7!9 "MMOM!44VXFN HH6 G I &8"//5vm/D %%*%5W %%+E%F %%+:%;''h7D++5=;E15,7F IIG I "4  " "~f " MG  I "4#<+> 00 0 0$0L08q0f>0@=0~0,2:0:M0^0>420(4 $0L$0L0*$0@d(r%r cXd}d}d}|"|dkDr|dvr||zS|dvr||zS|dvr||zS|Sy)zThis method get time is seconds<Qrminuteshoursr+r)time time_units min_in_sec hour_in_sec day_in_secs r#rrs^JKJ D1H  "*$ $ 7 "+% % 6 !*$ $Kr%cjd}d}d}||zdk(r||z }d}n||zdk(r||z }d}n||z }d}|d|S) z3This method sets seconds in minutes, hours or days.r>r?r@rr+rBrA r)rC sec_in_min sec_in_hour sec_in_dayunits r#rrseJKJ jAj  q k!j D !!r%cd|di}|dr|d|d<d|vr&|ddk(r |d|d<|S|ddk(rd |d<|Sd |d<|S) z(Returns the replication args for payload dst_pool_idrrrrrrrrrr)rrs r#rrs )*?@,-4FGY4Z01// 0 1^ CgS)@zYThis method provide parameters required for the ansible filesystem module on Unityr Fr6)requiredtyper rrrnrrr_rrr*TB)rQrRchoicesr]boolror\)NFSCIFSrNrtr/)rR)rurxrvrwry)rRoptionsrY)NATIVEUNIXWINDOWSrUADVISORY MANDATORYrK) AUTOTIER_HIGHAUTOTIERHIGHESTLOWESTrrr)rArBr+ FILE_SIZEBLOCKS)MBr*rS)rrrrrrrrr)rQrRrXrrr!r)rRrT)rrrT)rRrQ)rRrQdefault)rRrQno_logi)rrrrr)rr rrrrrrrr-disabler(r,r.r)r/rr%r#rr(s < e%8< E6< e%8< E6 <  %e4 <  E2 < e%0< 5u -< u54,G< e&1< U8< !%e)IK< '+'8,0f,=$(f$5+/V+<+/U+; 2  < *E#@B+< .U%/$=?/< 2UA>?3< 6 U;7< 8u599< :5vtu59"EGcd#U?#U?"&F"Cu5;PXBYZ5u>PQ@ !8HIK;< L VT!u-!%5!1!uw6IJ!u+56% F'+7;QU7V=AvX]JN>P;?UUY;Z;?UUYbf;g7;QV`c7d (!"#'E"2 $% 0%6  M< tEHi3HIu< vDuy(6KLw< <r%c8t}|jy)zb Create Unity FileSystem object and perform action on it based on user input from playbookN)r r8)objs r#mainrjjs ,C  "r%__main__N)r< __future__rrrrR __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrCansible_collections.dellemc.unity.plugins.module_utils.storage.dellr get_loggerr.r objectr rrrrrjr9rr%r#rus 6@@ d L W ra F5e|$"t(t(n!$"(!(?D# zFr%