Network Appliance(TM)

Manual Pages


Table of Contents

NAME

vol - summary of commands for managing volumes and for displaying volume status

SYNOPSIS

vol command argument ...

DESCRIPTION

Use the vol commands for managing a volume, applying options to a volume, or displaying the status of one or more volumes.

USAGE

vol create volname [ -r raidsize ] ndisks[@size] -d diskname...
creates a new volume with the name volname. The volume name can contain letters, numbers, and the underscore character(_), but the first character must be a letter or underscore. You can create up to 23 volumes on each filer.

The -r raidsize argument specifies the maximum number of disks in each RAID group in the volume. The maximum value of raidsize is 28. The default value is 14. ndisks is the number of disks in the volume, including the parity disks. The disks in this newly created volume come from the pool of spare disks. The smallest disks in this pool join the volume first, unless you specify the @size argument. size is the disk size in GB, and disks within 1 GB of the specified size are used in this volume.

If you use the -d diskname argument, the filer creates the volume with the specified spare disks. You can specify a space-separated list of disk names.

vol add volname ndisks[@size] | -d diskname... adds disks to the volume with the name volname. Specify the disks in the same way as for the vol create command.

When adding disks to a volume, the filer fills up one RAID group with disks before starting another RAID group. Suppose a volume currently has one RAID group of 12 disks and its RAID group size is 14. If you add 5 disks to this volume, it will have one RAID group with 14 disks and another RAID group with 3 disks. The filer does not evenly distribute disks among RAID groups.

vol destroy volname
destroys the volume with the name volname. The disks originally in the volume become spare disks. Only offline volumes can be destroyed.

vol rename volname newname
renames the volume named volname to the name newname. If the volume named volname is referenced in the /etc/exports file, remember to make the name change in /etc/exports also so that the affected file system can be exported by the filer after the filer reboots. The vol rename command does not automatically update the /etc/exports file.

vol online volname
brings the volume named volname online. This command takes effect immediately. The volume specified in this command must be currently offline or foreign. If the volume is foreign, it will be made native before being brought online. A ``foreign'' volume is a volume that consists of disks moved from another filer and that has never been brought online on the current filer. Volumes that are not foreign are considered ``native.'' You can also use this command to cancel a vol offline command.

vol offline volname
takes the volume named volname offline. This command takes effect when the filer is rebooted. If you change your mind after entering this command, you can enter vol online volname before the reboot.

vol options volname optname optval
sets the option named optname of the volume named vol_name to the value optval. The command remains effective after the filer is rebooted, so there is no need to add vol options commands to the /etc/rc file. Some options have values that are numbers. Some options have values that may be on (which can also be expressed as yes, true, or 1) or off (which can also be expressed as no, false, or 0). You can use a mixture of uppercase and lowercase characters when typing the value of an option. The root option is special in that it does not have a value. To set the root option, use this syntax:

vol options volname root

The following describes the options and their possible values:

root The volume named volname will become the root volume for the filer on the next reboot. This option can be used on one volume only at any given time. The existing root volume will become a nonroot volume after the reboot. The only way to remove the root status of a volume is to set the root option on another volume.

raidsize number
The value of this option is the maximum size of a RAID group within the volume. Changing the value of this option will not cause existing RAID groups to grow or shrink; it will only affect whether more disks will be added to the last existing RAID group and how large new RAID groups will be.

minra on | off
If this option is on, the filer performs minimal read-ahead on the volume. By default, this option is off, causing the filer to perform very aggressive read-ahead on the volume.

no_atime_update on | off
If this option is on, it prevents the update of the access time on an inode when a file is read. This option is useful for volumes with extremely high read traffic, since it prevents writes to the inode file for the volume rom contending with reads from other files. It should be used carefully. That is, use this option when you know in advance that the correct access time for inodes will not be needed for files on that volume.

nosnap on | off
If this option is on, it disables automatic snapshots on the volume.

nosnapdir on | off
If this option is on, it disables the visible .snapshot directory that is normally present at client mount points, and turns off access to all other .snapshot directories in the volume.

vol status [ -r | -v | -d ] [ volname ] displays the status of one or all volumes. If volname is used, the status of the specifed volume is printed; otherwise the status of all volumes in the filer are printed. By default, it prints a one-line synopsis of the volume, which includes the volume name, whether it is online or offline, other states (for example, partial, degraded, and so on) and per-volume options.

The -v flag displays information about each RAID group within the volume.

The -r flag displays a listing of the RAID infomation for that volume.

The -d flag displays information about the disks in the specified volume. The types of disk information are the same as those from the sysconfig -d command.

EXAMPLES

vol create vol1 -r 10 20
creates a volume named vol1 with 20 disks. The RAID groups in this volume can contain up to 10 disks, so this volume has two RAID groups. The filer adds the current spare disks to the new volume, starting with the smallest disk.

vol create vol1 20@9
creates a volume named vol1 with 20 9-GB disks. Because no RAID group size is specified, the default size (14 disks) is used. The newly created volume contains one RAID group with 14 disks and another group with six disks.

vol create vol1 -d 8a.1 8a.2 8a.3
creates a volume named vol1 with the specified disks.

vol create vol1 10
vol options vol1 raidsize 5
The first command creates a volume named vol1 with 10 disks, which belong to one RAID group. The second command specifies that if any disks are subsequently added to this volume, they will not cause any current RAID group to have more than five disks. Each existing RAID group will continue to have 10 disks and no more disks will be added to that RAID group. When new RAID groups are created, they will have a maximum size of five disks.

vol options vol1 root
The volume named vol1 becomes the root volume after the next filer reboot.

vol options vol1 nosnapdir on
In the volume named vol1, the snapshot directory is invisible at the client mount point or at the root of a share. Also, for UNIX clients, the .snapshot directories that are normally accessible in all the directores become inaccessible.

vol status -r vol1
displays the RAID information about the volume named vol1:

     RAID group 0




Data ONTAP 5.0    Last change: 6 February 1998                  4






User Commands                                           na_vol(1)



  RAID Disk       HA.DISK_ID        Used (MB/blks)  Phys (MB/blks)
  ---------       --------        --------------  --------------
  parity          0.3             4000/8192000    4095/8386728
  data            0.2             4000/8192000    4095/8386728

SEE ALSO

na_sysconfig(1)


Table of Contents