disk.volumes option in the node or cluster configuration file specifies the volumes used by Netmail Store. This specification includes the device names and optional flags for handling these volumes. Only one
disk.volumes parameter is allowed in a configuration file.
Warning: Netmail Store erases any non-Netmail Store data on all the volumes it uses. Netmail recommends running Netmail Store only on nodes that are free of non-Netmail Store data.
Below is the formal syntax of the
disk.volumes = volume-specification
volume-specification ::== all-volumes | volume-list |
all-volumes ::== 'all' [ ':' policy ] [ space 'except' space device-list ]
device-list ::== device [ space device [ ... ] ]
device ::== Linux-device-path
space ::== space or Tab character and not the word space
policy ::== 'k'
The recommended setting is
disk.volumes = all, which enables Netmail Store to use all volumes larger than the configured
disk.minGB (64GB by default). You can configure Netmail Store to format and mount smaller disks by decreasing the value of
disk.minGB. If you are booting Netmail Store from a USB flash drive, the drive is automatically excluded from the volume list.
disk.volumes = all:
- Works with single- and multi-server configurations.
- Support hot plugging.
- Supports exceptions. (
:k(keep). See policy.
Below are examples of disk.volumes entries:
disk.volumes = all
disk.volumes = all:k
disk.volumes = all except /dev/hda
disk.volumes = /dev/sda /dev/sdb
disk.volumes = /dev/hda:k /dev/hdc:k
If no value is set for
disk.volumes or if it is absent, the Netmail Store node is considered volumeless. A volumeless node is able to process client requests and can be used with a few nodes with fixed IP addresses to serve as stable primary access nodes for all client operations.
device component is either the keyword
all or the Linux device path string for the drive. When using the keyword
all, do not include any other device path specifications.
For best results, use
disk.volumes = all and avoiding Linux device paths. However, you can exclude certain volumes from being used by Netmail Store using
disk.volumes = all except /dev/sda dev/sdb
Important: Only use
Examples of a Linux device path are:
Older IDE disks, also known as Parallel ATA , EIDE , ATA-33, ATA-66, ATA-100, or ATA-133, use
hd device names. These drives are configured as master or slave devices on each IDE controller. Typically, the master devices are
/dev/hdc, while the slave devices are
SCSI, SAS,and SATA disks typically use
sd device names. The device letters are assigned sequentially in the order in which the drives are discovered starting at
/dev/sda. The hardware report in the utility menu will show the actual names in use on a node.
If an invalid device name is specified in the
device component, the node log indicates an error during the format operation. Incorrectly specified volumes are not used.
policy option enables you to instruct Netmail Store how to handle a volume. Currently, these handling features involve the formatting characteristics of the physical device.
The format policy allows you to override the default volume expiration behavior by specifying the
:k (keep) policy. See for more information.