The VTrak A-Class supports the use of an external LDAP server for limiting the total amount of storage consumed, administered on an individual user basis (quota users), or by quota user groups. Quota limits are applied across an entire file system, placing a hard limit on the total storage capacity allowed and the total number of files allowed.
Requirements:
- The External LDAP must be enabled on the A-Class.
- The export path for the FC client must be either squash noroot or squash root in order for quotas to be respected. The reason for this is that squash all (anonymous) maps the SAN to UID:1000 GID:1000 and newly created files will be written to the filesystem with UID:1000 GID:1000; regardless if your SAN client is logged in with an LDAP user.
- If you have created a File System and have been using squash all, changing the squash is not recommended without properly composing the POSIX permission scheme. Contact Technical Support before executing a squash change on a production volume.
- Create Users and User Groups on an external LDAP server that can then be added in the Quota Configuration (see below). The VTrak A-Class currently supports LDAP using Windows Active Directory and Mac Open Directory. Note that use of Windows Active Directory requires that Identity Management for UNIX be installed on the Windows server.
- macOS SAN clients must be joined to an Open Directory or Active Directory server.
Directory Utility: Configure access to an LDAP directory manually
Directory Utility: Configure domain access - Windows SAN clients have the option to either login with their AD credentials or have the host joined to an Active Directory Domain.
Join a Computer to a Domain - Windows SAN clients also have the ability to mount the filesystem using Open Directory credentials within the VTrakFS utility.
- NAS Gateway users authenticating with LDAP credentials will respect the quota set for a user or group when accessing the shares.
- The LDAP Settings menu is located under the Administration tab.
- Refer to External LDAP Configuration
- CLI Quota Instructions
- In order to enable the Quota feature on the VTrakFS, the File System must be stopped.
- You can use the A-Class GUI or the CLI to stop the File System.
#CLI Command to Stop File System
fs -a stop -n FileSystemName - Once the File System is stopped, locate Quota: and select checkbox icon to modify the field.
- Click on the checkbox to enable Quota on the File System.
- You will be prompted with the following message:
WarningI/O performance will be impacted after Quota is enabled, no matter if user/group is added into Quota. - Close the dialogue and click Save.
- You will receive a dialogue indicating that the Quota module was enabled successfully:
- Start the File System:
#CLI Command to Start File System
fs -a start -n FileSystemName - After starting the File System, you must execute a Quota Check.
- Go to the Quota tab.
- You will receive the following message (This alert is normal when establishing quotas for the first time):
Data cannot be displayed due to some error.(0x10003ee) The operation failed, quota check is required - Click on Check Quota:
- Confirm the Quota Check:
- After confirming the Quota Check, you will see a status bar of the progress:
- You will also receive a notification status at the bottom of the GUI:
Quota check was done successfully. - Click on Add Quota:
- In the Add Quota dialogue, select the user or group that you would like to establish a quota for:
- Click Save and you will be returned back to the Quota tab with your list of users or groups that you configured with quotas:
- The macOS SAN client must be joined to either an Open Directory or Active Directory domain.
- Windows SAN clients have the option to either login with their AD credentials or have the host joined to an Active Directory Domain.
- Windows SAN clients have the ability to mount the filesystem using Open Directory credentials within the VTrakFS utility.
- Note: Logging in with LDAP credentials within the VTrakFS client only applies to Windows SAN users. The VTrakFS client for macOS does not have this feature.
CLI Quota Instructions for Advanced Users
CLI Instructions to Enable Quota
#Stop the File System
fs -a stop -n FileSystemName
#Enable Quotas on the File System
fs -a mod -n FileSystemName -s "quotas=enable"
#Start the File System
fs -a start -n FileSystemName
#Execute Check Quota on File System
fsqc -a start -n FileSystemName
File system will become readonly when Quota Check is running.
Do you want to start Quota Check? (y|n):y
#Adding Quota via CLI
Examples:
fsquota -n fs1
fsquota -u user1
fsquota -a add -n fs1 -u user1 -s "diskhard=30gb"
fsquota -a mod -n fs1 -g group1 -s "filehard=10000"
fsquota -a del -n fs1 -u user1
Contact Promise Technology Support
Need more help? Save time by starting your support request online and a technical support agent will be assigned to your case.
Promise Technology Technical Support >
