Skip to main content

volume online

Contributors
Suggest changes

Bring an existing volume online

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

Description

The volume online command brings the volume online. A volume can only be brought online if it is offline or restricted. If the volume is inconsistent but has not lost data, the user will be cautioned and prompted before bringing it online. It is advisable to run wafl-iron (or do a snapmirror initialize in case of a replica volume) prior to bringing an inconsistent volume online. Bringing an inconsistent volume online increases the risk of further file system corruption. If the containing aggregate cannot honor the space guarantees required by this volume, the volume online operation will fail. It is not advisable to use volumes with their space guarantees disabled. Lack of free space can lead to failure of writes which in turn can appear as data loss to some applications.

Parameters

-vserver <vserver name> - Vserver Name

This parameter specifies the name of the Vserver from which the volume is to be brought online. If only one data Vserver exists, you do not need to specify this parameter.

-volume <volume name> - Volume Name

This parameter specifies the name of the volume that is to be brought online.

[-f, -force <true>] - Force Online

When this parameter is used, the volume will be brought online even if there is not enough space available in the aggregate to honor the volume's space guarantee.

[-foreground {true|false}] - Foreground Process

This parameter specifies whether the operation runs in the foreground. The default setting is true (the operation runs in the foreground). When set to true, the command will not return until the operation completes. This parameter applies only to FlexGroups. For FlexVol volumes, the command always runs in the foreground.

Examples

The following example brings a volume named vol1 online:

cluster1::> volume online vol1
Volume 'vs1:vol1' is now online.