ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • volume qtree modify

    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
    Top of Page