Skip to main content
A newer release of this product is available.

volume make-vsroot

Contributors
Suggest changes
PDFs

Designate a non-root volume as a root volume of the Vserver

Availability: This command is available to cluster administrators at the advanced privilege level.

Description

The volume make-vsroot command promotes a non-root volume of the Vserver to be the Vserver's root volume. The Vserver's root volume must be a FlexVol volume with a size of atleast 1 GB.

For instance, if you run this command on a volume named user that is located on a Vserver named vs0 , the volume user is made the root volume of the Vserver vs0 .

If you run this command on a Vserver with Infinite Volume, you must create a new root volume. You cannot promote an existing non-root volume to be the root volume of the Vserver with Infinite Volume. When the command executes, the new root volume is created on the aggregate specified by the aggregate parameter, and the old root volume is deleted.

This command is available only at the advanced privilege level and higher.

Parameters

-vserver <vserver name> - Vserver Name (privilege: advanced)

This specifies the Vserver on which a non-root volume is to be made the root volume.

-volume <volume name> - Volume Name (privilege: advanced)

This specifies the non-root volume that is to be made the root volume of its Vserver. For Vservers with FlexVol volume this must be an existing FlexVol volume. For Vservers with Infinite Volume this must be a non-existent volume that will be created during the execution of the command. Using a SnapLock volume as the root volume for a Vserver is not supported.

[-aggregate <aggregate name>] - Aggregate Name (privilege: advanced)

This specifies the aggregate that the new root volume will be created on for Vservers with Infinite Volume. This parameter is not supported for Vservers with FlexVol volumes.

Examples

The following example makes a volume named root_vs0_backup the root volume of its Vserver with FlexVol volumes, which is named vs0 .

node::> volume make-vsroot -vserver vs0 -volume root_vs0_backup

The following example makes a volume named root_vs1 the root volume of the Vserver with Infinite Volume vs1 .

node::> volume make-vsroot -vserver vs1 -volume root_vs1 -aggregate aggr1