Child pages
  • Configuring Volumes Options

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

The 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 vols option:

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.

Additionally, disk.volumes = all:

  • Works with single- and multi-server configurations.
  • Support hot plugging.
  • Supports exceptions. (all except).
  • Supports :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.


The 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 except:

disk.volumes = all except /dev/sda dev/sdb


Important: Only use except with disk.volumes = all.

Examples of a Linux device path are:

  • /dev/hda
  • /dev/sda
  • /dev/sdb

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/hda and /dev/hdc, while the slave devices are /dev/hdb and /dev/hdd.

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.


The 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 Returning a Stale Volume to Service for more information.