filesystem.rst

filesystem -- Manage Filesystems on PowerScale

• Synopsis
• Requirements
• Parameters
• Notes
• Examples
• Return Values
• Status

Synopsis

Managing Filesystems on PowerScale Storage System includes Create a new Filesystem, Delete a Filesystem, Get details of a filesystem, Modify a Filesystem (Quota, ACLs).

Requirements

The below requirements are needed on the host that executes this module.

• A Dell PowerScale Storage system.
• Ansible-core 2.14 or later.
• Python 3.9, 3.10 or 3.11.

Parameters

path (True, str, None)

This is the directory path. It is the absolute path for System access zone and is relative if using a non-System access zone. For example, if your access zone is 'Ansible' and it has a base path '/ifs/ansible' and the path specified is '/user1', then the effective path would be '/ifs/ansible/user1'. If your access zone is System, and you have 'directory1' in the access zone, the path provided should be '/ifs/directory1'.

access_zone (optional, str, System)

The access zone. If no Access Zone is specified, the 'System' access zone would be taken by default.

owner (optional, dict, None)

The owner of the Filesystem.

This parameter is required when creating a Filesystem.

The following sub-options are supported for Owner. - name(str), - provider_type(str).

If you specify owner, then the corresponding name is mandatory.

The provider_type is optional and it defaults to local.

The supported values for provider_type are local, file, ldap and ads.

group (optional, dict, None)

The group of the Filesystem.

The following sub-options are supported for Group. - name(str), - provider_type(str).

If you specify a group, then the corresponding name is mandatory.

The provider_type is optional, it defaults to local.

The supported values for provider_type are local, file, ldap and ads.

access_control (optional, str, None)

The ACL value for the directory.

At the time of creation, users can either provide input such as private_read , private , public_read, public_read_write, public or in POSIX format (eg 0700).

Modification of ACL is only supported from POSIX to POSIX mode.

This field is mutually exclusive with access_control_rights.

access_control_rights (optional, dict, None)

Manage user rights and set ACL permissions for files and directories.

access_rights (optional, list, None)

Provides the list of access rights that are defined for the directory.

access_type (True, str, None)

Allows or denies access to the directory based on the access rights set for the trustee.

inherit_flags (optional, list, None)

Provides the inherit flags set for the directory.

trustee (True, dict, None)

Provides the trustee (user or group) name and trustee provider_type.

name (True, str, None)

Provides the trustee (user or group) name.

type (optional, str, user)

Provides the trustee type.

provider_type (optional, str, local)

The provider_type is optional and it defaults to local.

The supported values for provider_type are local, file, ldap and ads.

access_control_rights_state (optional, str, None)

Specifies if the access rights are to be added or deleted for the trustee.

It is required together with access_control_rights.

recursive (optional, bool, True)

Creates intermediate folders recursively when set to true.

recursive_force_delete (optional, bool, False)

Deletes sub files and folders recursively when set to true even if the filesystem is not empty.

quota (optional, dict, None)

The Smart Quota for the filesystem. Only directory Quotas are supported.

The following sub-options are supported for Quota.

include_snap_data (optional, bool, False)

Whether to include the snapshots in the quota or not.

include_data_protection_overhead (optional, bool, None)

Whether to include the data protection overheads in the quota or not.

If not passed during quota creation then quota will be created excluding the overheads.

This parameter is supported for SDK 8.1.1

thresholds_on (optional, str, None)

For SDK 9.1.0 the parameter include_overheads is deprecated and thresholds_on is used.

advisory_limit_size (optional, int, None)

The threshold value after which the advisory notification will be sent.

soft_limit_size (optional, int, None)

Threshold value after which the soft limit exceeded notification will be sent and the soft_grace period will start.

Write access will be restricted after the grace period expires.

Both soft_grace_period and soft_limit_size are required to modify soft threshold for the quota.

hard_limit_size (optional, int, None)

Threshold value after which a hard limit exceeded notification will be sent.

Write access will be restricted after the hard limit is exceeded.

cap_unit (optional, str, None)

Unit of storage for the hard, soft and advisory limits.

This parameter is required if any of the hard, soft or advisory limits is specified.

container (optional, bool, False)

If true, SMB shares using the quota directory see the quota thresholds as share size.

quota_state (optional, str, None)

Defines whether the quota should exist or not

state (True, str, None)

Defines whether the Filesystem should exist or not.

A filesystem with NFS exports or SMB shares cannot be deleted.

Any Quotas on the Filesystem need to be removed before deleting the filesystem.

list_snapshots (optional, bool, False)

If set to true, the filesystem's snapshots are returned.

onefs_host (True, str, None)

IP address or FQDN of the PowerScale cluster.

port_no (False, str, 8080)

Port number of the PowerScale cluster.It defaults to 8080 if not specified.

verify_ssl (True, bool, None)

boolean variable to specify whether to validate SSL certificate or not.

true - indicates that the SSL certificate should be verified.

false - indicates that the SSL certificate should not be verified.

api_user (True, str, None)

username of the PowerScale cluster.

api_password (True, str, None)

the password of the PowerScale cluster.

Notes

Note

• While deleting a filesystem when recursive_force_delete is set as true it deletes all sub files and folders recursively. This is true even if the filesystem is not empty.
• Modification of inherit_flags of filesystem ACL is successful only if access_rights is also specified in the access_control_rights dictionary.
• Check_mode is not supported.
• The modules present in this collection named as 'dellemc.powerscale' are built to support the Dell PowerScale storage platform.

Examples

- name: Create Filesystem with Quota in given access zone
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "<path>"
    access_zone: "{{access_zone}}"
    owner:
      name: 'ansible_user'
      provider_type: 'ldap'
    group:
      name: 'ansible_group'
      provider_type: 'ldap'
      access_control: "{{access_control}}"
    quota:
      include_snap_data: false
      include_data_protection_overhead: false
      advisory_limit_size: 2
      soft_limit_size: 5
      hard_limit_size: 10
      cap_unit: "GB"
      quota_state: "present"
      container: true
      recursive: "{{recursive}}"
    state: "{{state_present}}"

- name: Create Filesystem in default (system) access zone, without Quota
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "<path>"
    owner:
    name: 'ansible_user'
    provider_type: 'ldap'
    state: "{{state_present}}"

- name: Get filesystem details
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    access_zone: "{{access_zone}}"
    path: "<path>"
    state: "{{state_present}}"

- name: Get filesystem details with snapshots
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    access_zone: "{{access_zone}}"
    path: "<path>"
    list_snapshots: "{{list_snapshots_true}}"
    state: "{{state_present}}"

- name: Modify Filesystem Hard Quota
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "<path>"
    access_zone: "{{access_zone}}"
    quota:
    hard_limit_size: 15
    cap_unit: "GB"
    quota_state: "present"
    container: true
    state: "{{state_present}}"

- name: Modify Filesystem Owner, Group and ACL
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "<path>"
    access_zone: "{{access_zone}}"
    owner:
      name: 'ansible_user'
      provider_type: 'ldap'
    group:
      name: 'ansible_group'
      provider_type: 'ldap'
      access_control: "{{new_access_control}}"
    state: "{{state_present}}"

- name: Modify Filesystem to add access control rights
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "/ifs/test"
    access_zone: "{{access_zone}}"
    access_control_rights:
    access_type: "allow"
    access_rights:
      - dir_gen_all
    inherit_flags:
      - container_inherit
    trustee:
      name: test_user
      provider_type: "ldap"
    access_control_rights_state: "add"
    state: "present"

- name: Modify Filesystem to remove access control rights
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "/ifs/test"
    access_zone: "{{access_zone}}"
    access_control_rights:
    access_type: "allow"
    access_rights:
      - dir_gen_all
    inherit_flags:
      - container_inherit
    trustee:
      name: test_user
      provider_type: "ldap"
    access_control_rights_state: "remove"
    state: "present"

- name: Remove Quota from FS
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "<path>"
    access_zone: "{{access_zone}}"
    quota:
      quota_state: "absent"
    state: "{{state_present}}"

- name: Create Filesystem with access control rights for everyone
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{api_user}}"
    api_password: "{{api_password}}"
    path: "/ifs/test"
    access_zone: "{{access_zone}}"
    access_control_rights:
    access_type: "allow"
    access_rights:
      - dir_gen_all
    inherit_flags:
      - container_inherit
    trustee:
      name: "everyone"
      type: "wellknown"
    access_control_rights_state: "add"
    state: "present"

- name: Delete filesystem
  dellemc.powerscale.filesystem:
    onefs_host: "{{onefs_host}}"
    port_no: "{{powerscaleport}}"
    verify_ssl: "{{verify_ssl}}"
    api_user: "{{user}}"
    api_password: "{{api_password}}"
    access_zone: "{{access_zone}}"
    path: "<path>"
    recursive_force_delete: "{{recursive_force_delete}}"
    state: "{{state_absent}}"

Return Values

changed (always, bool, true)

Whether or not the resource has changed.

filesystem_details (When Filesystem exists., complex, {'attrs': [{'name': 'owner', 'namespace': None, 'value': 'user'}, {'name': 'group', 'namespace': None, 'value': 'group'}, {'name': 'mode', 'namespace': None, 'value': '0750'}], 'namespace_acl': {'acl': [{'accessrights': ['dir_gen_all'], 'accesstype': 'allow', 'inherit_flags': ['container_inherit'], 'op': 'add', 'trustee': {'id': 'id:2001', 'name': 'user', 'type': 'user'}}], 'action': 'replace', 'authoritative': 'acl', 'group': {'id': '123', 'name': 'group', 'type': 'group'}, 'mode': '0750', 'owner': {'id': '123', 'name': 'user', 'type': 'user'}}})

The filesystem details.

attrs (, dict, )

The attributes of the filesystem.

quota_details (When Quota exists., complex, {'inodes': 1, 'logical': 0, 'physical': 2048})

The quota details.

id (, str, 2nQKAAEAAAAAAAAAAAAAQIMCAAAAAAAA)

The ID of the Quota.

enforced (, bool, True)

Whether the Quota is enforced.

container (, bool, True)

If (true), SMB shares using the quota directory see the quota thresholds as share size.

type (, str, directory)

The type of Quota.

usage (, dict, )

The Quota usage.

filesystem_snapshots (When I(list_snapshots) is true., complex, {'alias': None, 'created': 1636393464, 'expires': None, 'has_locks': False, 'id': 4, 'name': 'SIQ-latest', 'path': 'VALUE_SPECIFIED_IN_NO_LOG_PARAMETER', 'pct_filesystem': 2.435778242215747e-06, 'pct_reserve': 0.0, 'schedule': None, 'shadow_bytes': 0, 'size': 4096, 'state': 'active', 'target_id': None, 'target_name': None})

The filesystem snapshot details.

created (, int, 1581069354)

The creation timestamp.

expires (, int, 2581069354)

The expiration timestamp.

name (, str, ansible_snapshot)

The name of the snapshot.

path (, str, /ifs/ansible/ansible281825)

The path of the snapshot.

id (, int, 1524)

The id of the snapshot.

Status

Authors

• Prashant Rakheja (@prashant-dell) <ansible.team@dell.com>
• Trisha Datta (@trisha-dell) <ansible.team@dell.com>