Skip to main content

volume qtree modify

Contributors
Suggest changes
PDFs

Modify qtree attributes

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

Description

This command allows you to modify the following attributes of an existing qtree in the given Vserver and volume:

  • 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 containing the qtree to be modified.

-qtree <qtree name> - Qtree Name

This specifies the name of the qtree to be modified. You can modify the attributes of qtree0 (represented as "" in the CLI) by omitting the -qtree parameter from the command or by specifying the value """" for the -qtree parameter.

| -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. The automatically created qtree0 can be represented as /vol/<volume name>.

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

This optionally modifies the security style for the qtree. The supported values are unix (for UNIX uid, gid and mode bits), ntfs (for CIFS ACLs), and mixed (for NFS and CIFS access). Modifying a qtree's security style will not affect any of the files in the other qtrees of this volume.

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

This optionally modifies whether oplocks are enabled for the qtree.

Modifying qtree0's oplock mode will not affect any of the files in the other qtrees of this volume.

[-user <user name>] - User ID

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

[-group <group name>] - Group ID

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

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

This optionally modifies the UNIX permissions for the qtree. 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.

The unix permissions can be modified only for qtrees with unix or mixed security style.

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

This optional parameter modifies the export policy associated with the qtree. If you do not specify an export policy name, the qtree inherits the export policy of the containing volume.For information on export policy, see the documentation for the vserver export-policy create command.

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

This optional parameter specifies which QoS policy group to apply to the qtree. This 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. To remove this qtree from a policy group, enter the reserved keyword "none".

Examples

The following example modifies a qtree named qtree1. The Vserver name is vs0 and the volume containing the qtree is named vol1. The qtree now has a UNIX security style and oplocks are enabled.

cluster1::> volume qtree modify -vserver vs0 -volume vol1 -qtree qtree1 -security-style unix -oplocks enabled