Sun Java System Messaging Server 6.3 Administration Reference

Tailor File

The MTA tailor file (imta_tailor) is an option file in which the location of various MTA components are set. This file must always exist in the msg-svr-base/config directory for the MTA to function properly. The file may be edited to reflect the changes in a particular installation. Some options in the file should not be edited. The MTA should be restarted after making any changes to the file. It is preferable to make the changes while the MTA is down.

An option setting has the form:

option=value

The value can be either a string or an integer, depending on the option's requirements. If you make changes to values in order to specify directory paths, note that these values are prefixes, not paths. You must include a trailing slash. Comments are allowed. Any line that begins with an exclamation point is considered to be a comment and is ignored. Blank lines are also ignored. Options that are available and can be edited are shown in Table 4–23.

Table 4–23 Tailor File Options


Option	Description
`IMTA_ALIAS_DATABASE`	The alias database. The default is `msg-svr-base/data/db/aliasesdb.`
`IMTA_ALIAS_FILE`	The MTA aliases file. Aliases not set in the directory, for example, postmaster, are set in this file. The default is `msg-svr-base/config/aliases`.
`IMTA_CHARSET_DATA`	Specifies where the MTA compiled character set data is located. The default is `msg-svr-base/config/charset_data`.
`IMTA_CHARSET_OPTION_FILE`	File used for charset conversion options. The default is `msg-svr-base/config/option_charset.dat`.
`IMTA_COM`	Specifies where the MTA command definition files are located. The default is `msg-svr-base/sbin/`.
`IMTA_CONFIG_DATA`	Compiled configuration for the MTA. The default is `msg-svr-base/imta/lib/config_data`.
`IMTA_CONFIG_FILE`	The MTA configuration file. Rewrite rules and per-channel options are set in this file. The default is `msg-svr-base/config/imta.cnf`.
`IMTA_CONVERSION_FILE`	File to set rules for the conversion channel. The default is `msg-svr-base/config/conversions`.
`IMTA_DISPATCHER_CONFIG`	The MTA dispatcher’s configuration file. The default is `msg-svr-base/config/dispatcher.cnf`.
`IMTA_DOMAIN_DATABASE`	Database used to store additional rewrite rules. The default is `msg-svr-base/data/db/domaindb`.
`IMTA_DNSRULES`	The MTA DNS configuration library. The default is `msg-svr-base/imta/lib/imdnsrules.so`.
`IMTA_BIN`	Location of the MTA executables. The default is `msg-svr-base/lib/`.
`IMTA_FORWARD_DATABASE`	Not used.
`IMTA_GENERAL_DATABASE`	Provided for each site’s customized usage. Generally, lookups can be embedded in mappings and rewrite rules. The default is `msg-svr-base/config/generaldb`.
`IMTA_HELP`	Location of the help files for the MTA utility. The default is `msg-svr-base/imta/lib/`.
`IMTA_JBC_CONFIG_FILE`	The MTA Job Controller’s configuration file. The default is `msg-svr-base/config/job_controller.cnf`.
`IMTA_LANG`	Locale of the MTA’s notary messages. By default it is `msg-svr-base/imta/locale/C/LC_MESSAGES`.
`IMTA_LIB`	Directory where the MTA libraries and executables are stored. The default is `msg-svr-base/imta/lib/`.
`IMTA_LIBUTIL`	The MTA utility library. By default it is `msg-svr-base/lib/libimtautil.so.1`.
`IMTA_LOG`	Location of the MTA log files. The default is `msg-svr-base/imta/log`/.
`IMTA_MAPPING_FILE`	File used for setting access control rules, reverse mapping rules, forward mapping rules, and so forth. The default value is `msg-svr-base/config/mappings`.
`IMTA_NAME_CONTENT_FILE`	Location of file used by the MTA for certain attachment handling labeling. The default is `msg-svr-base/config/name_content.dat`.
`IMTA_OPTION_FILE`	Name of the MTA’s option file. The default is `msg-svr-base/config/option.dat`.
`IMTA_QUEUE`	The MTA message queue directory. The default is `msg-svr-base/imta/queue`/. CAUTION: Do not add any files or directories in the MTA queue directory as this causes problems. When using a separate file system for the MTA queue directories, create a subdirectory under that mount point and specify that subdirectory as the value of `IMTA_QUEUE`.
`IMTA_RETURN_PERIOD`	Controls the return of expired messages and the generation of warnings. The default value for this option is `1`. If this options is set to an integer value N, then the associated action is only performed every N times the return job runs. By default, the return job runs once every day.
`IMTA_RETURN_SPLIT_PERIOD`	Controls splitting of the `mail.log` file. The default value for this option is `1`. If this options is set to an integer value N, then the associated action is only performed every N times the return job runs. By default, the return job runs once every day.
`IMTA_REVERSE_DATABASE`	The MTA reverse database. This database is used for rewriting `From` addresses. The default is `msg-svr-base/data/db/reversedb`.
`IMTA_ROOT`	Base directory for the MTA installation. The default is `msg-svr-base/imta/`.
`IMTA_SYSTEM_FILTER_FILE`	Specifies the location of the MTA system filter file. The value of this option can be either a file name or a URL.
`IMTA_TABLE`	The MTA configuration directory. The default is `msg-svr-base/config/`.
`IMTA_USER`	Name of the postmaster. The default is `inetmail`. If this is changed be sure to edit the `msg-svr-base/config/aliases` file to reflect the change to the postmaster address.
`IMTA_USER_PROFILE_DATABASE`	Database used for storing user’s vacation, forwarding, and program delivery information. The default is `msg-svr-base/data/db/profiledb`.
`IMTA_USER_USERNAME`	Specifies the `userid` of the subsidiary account the MTA uses for certain “non-privileged” operations—operations which it doesn't want to perform under the usual MTA account. The default is `nobody`.
`IMTA_VERSION_LIMIT`	Maximum versions of log files to be preserved while purging old log files. The default value is `5`.
`IMTA_WORLD_GROUP`	Can perform certain privileged operations as a member of this group. The default is `mail`.