Qtrees and ONTAP FlexVol volume partitioning
Suggest changes
PDFs
Qtrees enable you to partition FlexVol volumes into smaller segments that can be managed individually. The volume partitioning enabled by qtrees provides a finer level of control when administering storage by project, user, or group. You can use qtrees to better manage quotas, security style, and CIFS oplocks.
|
ONTAP creates a default qtree for each volume named qtree0. If you do not put data in a specific qtree, it's placed in qtree0. |
General limitations
You should be aware of the limitations of qtrees before using them in a production environment. Also review the Operation and limitations when using the extended qtree performance monitoring feature.
-
Qtree names can be no more than 64 characters.
-
Certain special characters used in the qtree names, such as commas and spaces, can cause problems with other ONTAP capabilities and should be avoided.
-
You cannot move directories between different qtrees. Only files can be moved between qtrees.
-
If you create qtree-level and volume-level shares on the same FlexVol or SCVMM pool, the qtrees appear as directories on the FlexVol share. You should be careful not to accidentally delete them.
Commands for managing and configuring qtrees
You can manage and configure qtrees using the ONTAP CLI. Depending on what you want to do, you should use the following commands to administer qtrees.
|
|
The command |
If you want to… |
Use this command… |
||
|---|---|---|---|
Create a qtree |
|
||
Display a filtered list of qtrees |
|
||
Delete a qtree |
|
||
Modify a qtree's UNIX permissions |
|
||
Modify a qtree's CIFS oplocks setting |
|
||
Modify a qtree's security setting |
|
||
Rename a qtree |
|
||
Display a qtree's statistics |
|
||
Reset a qtree's statistics |
|
Extended qtree performance monitoring
Beginning with ONTAP 9.16.1, you can use the ONTAP REST API to access the extended qtree monitoring capabilities which includes latency metrics and historical statistics.
The ONTAP REST API includes several endpoints related to qtrees. Prior to ONTAP 9.16.1, customers could access real-time statistics for qtrees, including IO operations per second (IOPs) as well as throughput for read, write, and other operations.
The extended qtree performance monitoring available beginning with ONTAP 9.16.1 gives you the ability to monitor real-time latency statistics as well as IOPs and throughput for NFSv3, NFSv4.0, NFSv4.1, NFSv4.2, pNFS (technically a part of NFSv4.1 and NFSv4.2), and CIFS. It also collects and archives statistics to allow viewing of historical performance data.
This extended monitoring provides storage administrators with greater insight into system performance. You can use this data to identify high-use qtrees, potential bottlenecks, and other areas when working to improve quality of service. Being able to analyze these metrics, including trends over a longer period of time, enables you to make more informed data-driven decisions.
Operation and limitations
There are several operational characteristics, including limitations, you should consider before using the extended qtree performance monitoring feature in a production environment.
After enabling qtree extended monitoring, you need to remount the affected volume to activate the feature.
After enabling extended performance monitoring, the statistical data is not immediately available. This includes IOPS, throughput, and latency statistics. It can take up to five minutes before this data is displayed for a qtree.
You can enable extended performance monitoring for a maximum of 50,000 qtrees in an ONTAP cluster.
Access extended metrics using the ONTAP REST API
Beginning with ONTAP 9.16.1, you can access the extended qtree performance monitoring feature through the ONTAP REST API. The basic capabilities fall into several categories as described below.
You can access the property ext_performance_monitoring.enabled at the endpoint /api/storage/qtrees to enable or disable the extended monitoring feature. The POST and PATCH methods are available depending on whether you are creating a new qtree or configuring an existing qtree.
Several new global properties have been added to the /api/storage/qtrees endpoint. You can retrieve these fields using the GET method.
You can use the GET method at the endpoint /api/storage/qtrees/{volume.uuid}/{id}/metrics to retrieve the new statistics and metrics properties for a specific qtree as defined at a specific volume.
Upgrading and reverting
If you enable the feature in ONTAP 9.16.1, you can upgrade to a subsequent ONTAP release without restrictions. However, there are two scenarios to consider.
The extended performance monitoring feature cannot be used (that is, ext_performance_monitoring.enabled cannot be set to true) until the effective cluster version (ECV) of the cluster is at 9.16.1.
If any qtrees have the property ext_performance_monitoring.enabled set to true, reverting to 9.15.1 from 9.16.1 is not allowed. The revert operation is blocked. The best practice is to set ext_performance_monitoring.enabled to false for all qtrees prior to reverting to an earlier ONTAP release.
Learn more
Learn more about the ONTAP REST API, including what's new with the ONTAP REST API, from the ONTAP automation documentation. You should also review the ONTAP automation documentation for details about the ONTAP REST API qtree endpoints.