volume qtree rename

08/29/2024 Contributors

Rename an existing qtree

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

Description

This command allows you to rename an existing qtree.

The automatically created qtree in the volume - qtree0, listed in CLI output as "" - cannot be renamed.

-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 renamed.
-qtree <qtree name> - Qtree Name: This specifies the name of the qtree to be renamed.
| -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.
[-newname <qtree name>] - Qtree New Name: This specifies the new name of the qtree. The new qtree name cannot contain a forward slash (/) and cannot be more than 64 characters long.

The following example renames a qtree named qtree3 to qtree4. The Vserver name is vs0 and the volume containing the qtree is named vol1.

cluster1::> volume qtree rename -vserver vs0 -volume vol1 -qtree qtree3 -newname qtree4