This topic applies to the page in XInsight for managed systems running QSM 4.2 or later.

Go to Storage > Share. The Share page displays and manages shared folders created on file volumes. It provides share information, access permissions, associated host groups, quota settings, file-retention settings, and other share properties.

Create a Share #

Click the + icon in the lower-left corner of the Shares panel to open the Create New Share wizard. The wizard includes the following steps:

Share Settings #

Select the file volume on which to create the share, and then configure the share name and optional description.

Configure the following properties as required:

• Recycle Bin: Moves deleted files to the Recycle Bin until they are manually cleared or the retention period expires. A share with Recycle Bin enabled cannot be used as a Userhome share.
• Share Quota: Limits the amount of storage space available to the share. When enabled, enter the quota value and select its unit. For thick-provisioned pools, the quota cannot exceed the volume capacity.
• File Retention: Identifies files that have not been accessed for the configured number of days and processes them according to the selected delete policy. Enabling this option adds the File Retention Setting step to the wizard. Carefully review the retention period and scan time before enabling this option to prevent important files from being unintentionally removed after a long period of inactivity.

Important: The Recycle Bin toggle must be enabled before the File Retention toggle can be enabled. Keeping the Recycle Bin enabled provides an additional recovery option for accidentally deleted files. When configuring File Retention, verify the retention period, scan time, and delete policy carefully. Files processed with Delete Permanently cannot be recovered from the Recycle Bin.

Click Next to continue.

User Permission #

Select a domain and one or more users, and then assign an access permission to each selected user:

• Read/Write: Allows the user to read, create, modify, and delete files.
• Read Only: Allows the user to view and read files without modifying them.
• Deny: Prevents the user from accessing the share.

Click Next to continue.

Group Permission #

Select a domain and one or more groups, and then assign Read/Write, Read Only, or Deny permission to each selected group. Click Next to continue.

Note: When both User Permission and Group Permission apply to the same user, User Permission takes precedence over Group Permission.

File Retention Setting #

This step appears when File Retention is enabled in Share Settings. Configure the following settings:

Delete Policy: Select how XInsight processes files that have not been accessed within the specified retention period.

• Move to Recycle Bin: Moves the files to the Recycle Bin, where they remain until they are manually cleared or the Recycle Bin retention period expires.
• Delete Permanently: Permanently deletes the files without moving them to the Recycle Bin.

Retention Days: Enter the number of days that a file can remain unaccessed before the selected delete policy is applied.

Scan Time: Specify the time at which XInsight scans the share each day for files that meet the retention criteria.

File Extension Filter: Select the file extensions to exclude from automatic retention processing. Files with the selected extensions are not moved to the Recycle Bin or permanently deleted.

Click Next to continue.

Warning: The Delete Permanently policy can cause irreversible data loss. Verify the retention period, scan time, and excluded file extensions before completing the wizard.

Ready to Complete #

Review the settings and the assigned user and group permissions. Click Finish to create the share.

Create a CSI Volume #

A QSM file storage pool can be used by a KSM system to dynamically provision CSI volumes through NFS.

Before configuring CSI storage on KSM, prepare the required storage resources on the QSM system:

• Create a storage pool with sufficient available capacity.
• Create a file volume in the pool.
• Create a share host group and enable NFS access.
• Record the pool name and share host group name for the Storage Class configuration.

On the KSM system, go to Cluster > CSI Driver and click the + icon in the Storage Classes pane.

In Create Storage Class, select Use existing connection or Create new connection. When creating a new connection, configure the storage-system address, port, HTTPS setting, username, and password.

Select NFS for Protocol, enter a name for the Storage Class, and specify the prepared Pool and Share Host Group. Click Create.

To view or modify existing storage-system connections, click Manage Connections. Each connection displays its address, username, and port and can be edited or deleted.

Note: A connection currently used by a Storage Class cannot be deleted.

After the Storage Class is created, go to Application, select the required microservice, and then select Storage. Under CSI Storage, click the + icon to create a CSI volume. Select the required Storage Class, configure the volume size and mount path, and complete the configuration.

The provisioned volume appears in the CSI Volume List, which displays information such as the volume name, volume size, and mount path.

Share Overview #

The Share panel organizes shares by pool and volume. Select a share to view its status and configuration.

The share information includes:

• Share Name: Displays the name of the share. Edit the field to rename the share.
• Location: Displays the device, pool, and volume that contain the share.
• Capacity: Displays the used and total capacity.
• Health: Displays the current health status.
  • Normal: The share and its associated volume are operating normally.
  • Preparing: The share is temporarily unavailable while a related volume operation is in progress, the share is blocked, or the associated volume is in a failed state.
  • Missing: The share data exists on the storage system, but the corresponding share configuration is missing.
  • -: The health status cannot be determined because the associated volume is corrupted, unavailable, or missing.
• Description: Displays or updates the share description.

Hosts #

Select Hosts to view the host groups associated with the share. Each entry displays the enabled access protocols, such as CIFS, FTP, WebDAV, and NFS. Host group associations are managed under Storage > Host.

Permission #

Select Permission to review the users and groups that have access to the share and their assigned permission levels.

Note: When both User Permission and Group Permission apply to the same user, User Permission takes precedence over Group Permission.

Recycle Bin #

Enable the Recycle Bin toggle to move deleted files to a recoverable location. Files remain in the Recycle Bin until they are manually cleared or their retention period expires. Recycle Bin toggle and Userhome toggle cannot be enabled for the same share. Disable Userhome before enabling Recycle Bin.

Share Quota #

Enable the Share Quota toggle to restrict the amount of storage space that the share may use. Enter a value, select the capacity unit, and click Apply. Disable the Share Quota toggle to allow the share to use the available capacity of its volume.

File Retention #

Select File Retention to view or modify the file retention policy for the selected share. Enable the File Retention toggle to process files that have not been accessed within a specified number of days.

Configure the following settings:

• Delete Policy: Select how eligible files are processed:
  • Move to Recycle Bin: Moves eligible files to the Recycle Bin, where they remain recoverable until they are cleared.
  • Delete Permanently: Permanently deletes eligible files without moving them to the Recycle Bin.
• Retention Days: Enter the number of days a file may remain unaccessed before it is processed.
• Scan Time: Specify the daily time at which the system scans for eligible files.
• File Extension Filter: Enter file extensions that must be excluded from automatic deletion.

Important: The Recycle Bin toggle must be enabled before File Retention toggle can be enabled. Files processed with Delete Permanently cannot be recovered.

Userhome #

Enable the Userhome toggle to use the share for personal user folders. The Userhome toggle and the Recycle Bin toggle cannot be enabled for the same share. Disable the Recycle Bin toggle before enabling the Userhome toggle.

Delete a Share #

Select Share Deletion, and then click Delete to remove the selected share. A share associated with a host group cannot be deleted. Remove the share from all host groups before attempting deletion.

Warning: Deleting a share permanently removes the share and its data. Back up all required data before deleting the share.