You have the option to organize your cluster settings into sections. A configuration file section is identified by a unique name and contains settings that are logically related to each other. A section is defined by a set of square brackets (
]) that have nothing (or a name) between them.
To manage your configuration files in your upgraded Netmail Store clusters, follow these guidelines:
Upgrading Your Configuration File
Update your node or cluster configuration file by placing new parameters, renamed parameters, and sections at the end of your existing configuration file. This will prevent conflicts with parameters located at the beginning of the file.
When you add new parameters, use the following guidelines:
- Add new configuration parameters in sections or a fully qualified format. Adding new parameters at the end of your configuration file avoids problems that can prevent the cluster from booting. For example, to add the new
encodingparameter, place it at the end of your node or cluster configuration. In this scenario, the new parameter does not affect any parameters before it. The cluster boots normally and you do not have to change anything else in the configuration file.
- Rename existing parameters as you have time. Parameters that are renamed in this release will be deprecated and eventually removed in future releases.
- Add sections to your configuration file, ensuring that all parameters are in the correct sections. If you put a section in your node or cluster configuration file, all parameters after that section must either be in their respective sections or must be fully qualified.
Qualified versus Unqualified Parameters
Netmail Store supports both qualified and unqualified configuration parameters.
- An Unqualified parameter (such as
corporate) must be contained in its designated section, in the empty section, or in a configuration file that has no sections (or only the empty section).
- A Qualified parameter (such as
networks.corporate) is the name of the section, a period, and the unqualified parameter name.
A configuration file can have a mixture of unqualified and fully qualified parameters, provided the parameters are in the proper sections or the configuration file has no sections (or only the empty section).
Using Sections for Parameters
New sections are optional in Netmail Store (unless you use new, unqualified names). However, if you use sections, you must use them properly.
If you place unrelated parameters or an old parameter in any section, errors result and Netmail Store will not start.
For example, the following parameter is not valid:
non-starter = 900
The following parameter is valid:
startDelay = 900
The empty section
 (empty set of square brackets) is a special container that clears any section that might have preceded it.
For example, the following parameter is valid:
startDelay = 900
ipaddress = 192.168.0.33