Skip to end of metadata
Go to start of metadata

Netmail Store reads the vols parameter from the node and/or cluster configuration files in order to determine which disks may be used for content storage. As shipped, Netmail Store has a dummy value that prevents unexpected formatting of a node’s disks. An administrator must edit the vols parameter and replace the dummy value with the keyword all or with a list of disks that Netmail Store can use for storage.

The easiest way to use all disks for content storage in a Netmail Store node is to set the vols parameter as follows.

 vols = all

When using the "all" keyword, Netmail Store will automatically exclude the Netmail Store USB flash drive from being used for storage.

If an administrator wishes to explicitly set the disk device names, this is also allowed. The device names of a node’s storage volumes are shown in the hardware report when the unmodified USB flash drive is booted.

This is an example hardware report from a node with two SATA disks plus the USB flash drive:

 /dev/sda (SATA disk A)
 /dev/sdb (SATA disk B)
 /dev/sdc (Netmail Store USB flash drive)

Using the example, the vols parameter would be set to:

 vols = /dev/sda /dev/sdb

The device names are separated by spaces. Use the actual device names obtained from the hardware report for the node. For more information about vols, see Volume Specifications.

Warning: Once an administrator has configured the node.cfg file on a USB device, affirmative action/care should be taken so that a non-Netmail Store computer is never booted from this USB device. If a computer is accidentally booted from a configured USB device, some or all of its disks could be reformatted (i.e., DATA PERMANENTLY LOST).

DHCP or Static Network

If there is a DHCP server in the subnet and an administrator wishes to have the Netmail Store nodes obtain their IP addresses from it, Netmail Store will do so automatically. No other configuration is required and Netmail Store is ready to be booted from the USB flash drive.

If an administrator wishes to use set static IP addresses for the Netmail Store node, edit the following parameters in the node.cfg file: ipaddress, netmask, and gateway. All three parameters must be set when using the static IP address configuration option. See example below:

 ipaddress = 10.20.30.101
 netmask = 255.255.255.0
 gateway = 10.20.30.1

Note: You must unremark these items in the node.cfg file when editing by removing the # in front of the text.

Administration Password

Netmail Store nodes require an administration password for making changes via the web console or in order to perform SNMP operations on a node. It is recommended that the default password be changed when Netmail Store is deployed. This is done by setting the “snmpCommunity” parameter in the node.cfg file. The value of this parameter should be the same for all Netmail Store nodes. See example below:

 snmpCommunity = 7glassBricks

Time Synchronization

Netmail Store clusters are capable of synchronizing their nodes’ clocks internally. However, it is a highly recommended best practice to use one or more trusted network time protocol (NTP) servers whenever they are available. This assures that a cluster’s clock is in sync with the clocks of the client machines. If booting Netmail Store from a CSN, the CSN will provide NTP services for all Netmail Store nodes and no further configuration is required.

If an administrator wishes to allow Netmail Store to synchronize its clocks internally within the cluster, no further configuration is necessary. The default settings in the node and/or configuration files will default to internal synchronization. A default NTP server will be used for a one-time sync at startup if no NTP servers are defined and a domain name server is available.

If one or more trusted NTP servers are available, an administrator may configure Netmail Store to use them by setting the “timeSource” parameter in the node and/or configuration files. The value of the “timeSource” parameter is a list of one or more NTP servers separated by spaces. This is an example:

 timeSource = 10.20.40.21 10.20.50.31

Note: NTP version 3 has design limitation that causes time to wrap in the year 2036. If a computer’s BIOS clock is set beyond this wrap point, NTP will be unable to correct the time. Please ensure that all BIOS clocks are set to a date prior to 2036 before booting Netmail Store. Alternatively, you may use NTP version 4.

If booting from a USB memory device, make sure to safely unmount or stop the USB flash drive from the computer after configuration editing has been completed. If the flash drive is simply unplugged without doing this, the changes may not be saved to the node.cfg file.

  • No labels