Skip to main content

volume qtree create

Contributors
Suggest changes

Create a new qtree

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command creates a qtree in the Vserver and volume you specify. You can create up to 4,994 qtrees per volume.

You can optionally specify the following attributes when creating a new qtree:

  • Security style

  • Opportunistic lock mode

  • User ID

  • Group ID

  • UNIX permissions

  • Export Policy

Parameters

-vserver <vserver name> - Vserver Name

This specifies the name of the Vserver on which the volume containing the qtree belongs.

{ -volume <volume name> - Volume Name

This specifies the name of the volume that will contain the qtree you are creating.

-qtree <qtree name> - Qtree Name

This specifies the name of the qtree you are creating.

A qtree name cannot contain a forward slash (/). The qtree name cannot be more than 64 characters long.

| -qtree-path <qtree path> - Actual (Non-Junction) Qtree Path }

The qtree path argument in the format /vol/<volume name>/<qtree name> can be specified instead of specifying volume and qtree as separate arguments.

[-security-style <security style>] - Security Style

This optionally specifies the security style for the qtree, which determines how access to the qtree is controlled. The supported values are unix (for UNIX uid, gid and mode bits), ntfs (for CIFS ACLs), and mixed (for NFS and CIFS access). If you do not specify a security style for the qtree, it inherits the security style of its containing volume.

[-oplock-mode {enable|disable}] - Oplock Mode

This optionally specifies whether oplocks are enabled for the qtree. If you do not specify a value for this parameter, it inherits the oplock mode of its containing volume.

[-user <user name>] - User ID

This optionally specifies the name or ID of the user that is set as the owner of the qtree.

[-group <group name>] - Group ID

This optionally specifies the name or ID of the group that is set as the owner of the qtree.

[-m, -unix-permissions <unix perm>] - Unix Permissions

This optionally specifies the UNIX permissions for the qtree when the -security-style is set to unix or mixed. You can specify UNIX permissions either as a four-digit octal value (for example, 0700) or in the style of the UNIX ls command (for example, ` -rwxr-x---` ). For information on UNIX permissions, see the UNIX or Linux documentation. If you do not specify UNIX permissions for the qtree, it inherits the UNIX permissions of its containing volume.

[-export-policy <text>] - Export Policy

This optional parameter specifies the name of the export policy associated with the qtree. For information on export policies, see the documentation for the vserver export-policy create command. If you do not specify a value for this parameter, it inherits the export policy of its containing volume.

[-qos-policy-group <text>] - QoS policy group

A policy group defines measurable service level objectives (SLOs) that apply to the storage objects with which the policy group is associated. If you do not assign a policy group to a qtree, the system does not monitor and control the traffic to it.

Examples

The following example creates a qtree named qtree1. The Vserver name is vs0 and the volume containing the qtree is named vol1. The qtree has a mixed security style. Its other attributes are inherited from volume vol1.

cluster1::> volume qtree create -vserver vs0 -volume vol1 -qtree qtree1 -security-style mixed

The following example uses a 7G-compatible command to create the qtree.

cluster1::> vserver context vs0
vs0::> qtree create /vol/vol1/qtree1