Sun Internet Mail Server 3.5 Reference Manual: 3

Tailor File

The IMTA tailor file is an option file in which the location of various IMTA components are set. Certain parameters for tuning the performance of the IMTA databases are also set in this file. This file must always exist in the /etc/opt/SUNWmail/imta 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 IMTA should be restarted after making any changes to the file. It is preferable to make the changes while the MTA is down. If the database tuning parameters are changed, all existing IMTA databases must be removed and reconstructed.

Note - It is not recommended that this file be edited unless absolutely necessary.

An option setting has the form:
option=value
value may be either a string or an integer, depending on the option's requirements. 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:

IMTA_ADMIN_PROPERTY

Location of the adminserver properties file. The imta dirsync utility reads this file to find the domains the IMTA is responsible for. The default value is /etc/opt/SUNWmail/admin/adminserver.properties.

IMTA_ALIAS_DATABASE

The IMTA's alias database. The default is /var/opt/SUNWmail/imta/db/aliasesdb.

IMTA_ALIAS_FILE

The IMTA's aliases file. Aliases not set in the directory, for example. postmaster, are set in this file. The default value is /etc/opt/SUNWmail/imta/aliases.

IMTA_AUTHDL_DATABASE
(Enterprise Edition only)

Database used for storing distribution lists access controls. The default is /var/opt/SUNWmail/imta/authdldb.

IMTA_CHARSET_DATA

Specifies where IMTA's compiled character set data is located. The default value is /opt/SUNWmail/imta/lib/charset_data.

IMTA_CHARSET_OPTION_FILE

File used for charset conversion options. The default is /etc/opt/SUNWmail/imta/option_charset.dat.

IMTA_COM

Specifies where IMTA's shell scripts are located. The default value is /opt/SUNWmail/imta/lib/.

IMTA_CONFIG_DATA

The compiled configuration for the IMTA. The default value is /opt/SUNWmail/imta/lib/config_data.

IMTA_CONFIG_FILE

The IMTA's configuration file. All it's rewrite rules and per channel options are set in this file. The default is /etc/opt/SUNWmail/imta/imta.cnf.

IMTA_CONVERSION_FILE

File to set rules for the conversion channel. The default value is /etc/opt/SUNWmail/imta/conversions.

IMTA_DB_HASH_SIZE

The IMTA database hash size. The default is 7901. All IMTA databases should be removed and reconstructed if this value is changed.

IMTA_DB_PTR_SIZE

The IMTA database pointer size. This value should be increased for very large databases.All IMTA databases should be removed and reconstructed if this value is changed The default value is 10 and works fine for databases with up to 4 million entries.

IMTA_DISPATCHER_CONFIG (Enterprise edition only )

The IMTA dispatcher's configuration file. The default is /etc/opt/SUNWmail/imta/dispatcher.cnf.

IMTA_DOMAIN_DATABASE (Enterprise Edition only)

This option is not used for SIMS 3.5.

IMTA_FORWARD_DATABASE
(Enterprise Edition only)

This option is not used for SIMS 3.5.

IMTA_GENERAL_DATABASE
(Enterprise Edition only)

This database is provided for each site's customer usage. Generally lookups can be embedded in mappings and rewrite rules. The default is /var/opt/SUNWmail/imta/generaldb.

IMTA_JBC_CONFIG_FILE

The IMTA job_controller's configuration file. The default is /etc/opt/SUNWmail/imta/job_controller.cnf.

IMTA_JBC_SERVICE

Specifies the host and port for the job_controller.
Do not edit this option.

IMTA_LANG

Locale of the IMTA's notary messages. By default it is /etc/opt/SUNWmail/imta/locale/C/LC_MESSAGES.

IMTA_LDAP_SERVER

This option specifies the location of the LDAP directory, searched by the IMTA dirsync, autoreply and other programs. The list consists of one or more ldaphost: port pairs separated by commas. Each program reads this list and connects to the first directory, it is able to connect to. It connects to port 389, if the port is not specified. The default is just localhostname:389.

IMTA_LIB

Directory where the IMTA libraries and executables are stored. The default is /opt/SUNWmail/imta/lib/.

IMTA_LIBUTIL

The IMTA's utility library. By default it is /opt/SUNWmail/lib/libimtautil.so.1.

IMTA_LOG

Location of the IMTA's log files. The default is /var/opt/SUNWmail/imta/log/.

IMTA_MAPPING_FILE (Enterprise edition only )

File used for setting access control rules, reverse mapping rules, forward mapping rules etc. The default value is /etc/opt/SUNWmail/imta/mappings.

IMTA_NAME_CONTENT_FILE

Location of file used by the IMTA for content-type conversions. The default is /etc/opt/SUNWmail/imta/name_content.dat.

IMTA_OPTION_FILE

Name of the IMTA's option file. The default is /etc/opt/SUNWmail/imta/option.dat.

IMTA_QUEUE

The IMTA's message queue directory. The default is /var/opt/SUNWmail/imta/queue.

IMTA_QUEUE_CACHE_DATABASE

Location of the IMTA's message queue cache. The default is /var/opt/SUNWmail/imta/queue_cache/.

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 will only be 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 will only be performed every N times the return job runs. By default the return job runs once every day.

IMTA_RETURN_SYNCH_PERIOD

Controls queue synchronization.The default value for this option is 1. If this options is set to an integer value N, then the associated action will only be performed every N times the return job runs. By default the return job runs once every day.

IMTA_REVERSE_DATABASE (Enterprise Edition only)

The IMTA's reverse database. This database is used for rewriting From: addresses. The default is /var/opt/SUNWmail/imta/db/reversedb.

IMTA_ROOT

Base directory for the IMTA installation. The default is /opt/SUNWmail/imta/.

IMTA_SCRATCH

Directory where the IMTA stores it's backup configuration files. During a full dirsync temporary database files are also created under this directory.The default is /var/opt/SUNWmail/imta/tmp/.

IMTA_SYNCH_CACHE_PERIOD

Controls the queue synchronization by the post program.The default value for this option is 1. If this options is set to an integer value N, then the associated action will only be performed every N times the post job runs. By default the post job runs once every four hours.

IMTA_TABLE

The IMTA's configuration directory. The default is /etc/opt/SUNWmail/imta/.

IMTA_USER

Name of the postmaster. The default is inetmail. If this is changed be sure to edit /etc/opt/SUNWmail/imta/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 /var/opt/SUNWmail/imta/profiledb.

IMTA_USER_USERNAME

This option specifies the userid of the subsidiary account the IMTA uses for certain "non-privileged" operations--operations which it doesn't want to perform under the usual IMTA 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_VERSION_LIMIT_PERIOD

Controls the frequency of purging of log files by the post job. The default value for this option is 1. If this options is set to an integer value N, then the associated action will only be performed every N times the post job runs. By default the post job runs once every four hours

IMTA_WORLD_GROUP

This is the group in which one must belong to be able to perform certain "privileged" sorts of operations. The default is mail.

`IMTA_ADMIN_PROPERTY`	Location of the adminserver properties file. The `imta dirsync` utility reads this file to find the domains the IMTA is responsible for. The default value is `/etc/opt/SUNWmail/admin/adminserver.properties`.
`IMTA_ALIAS_DATABASE`	The IMTA's alias database. The default is `/var/opt/SUNWmail/imta/db/aliasesdb`.
`IMTA_ALIAS_FILE`	The IMTA's aliases file. Aliases not set in the directory, for example. postmaster, are set in this file. The default value is `/etc/opt/SUNWmail/imta/aliases`.
`IMTA_AUTHDL_DATABASE` (Enterprise Edition only)	Database used for storing distribution lists access controls. The default is `/var/opt/SUNWmail/imta/authdldb`.
`IMTA_CHARSET_DATA`	Specifies where IMTA's compiled character set data is located. The default value is `/opt/SUNWmail/imta/lib/charset_data`.
`IMTA_CHARSET_OPTION_FILE`	File used for charset conversion options. The default is `/etc/opt/SUNWmail/imta/option_charset.dat.`
`IMTA_COM`	Specifies where IMTA's shell scripts are located. The default value is `/opt/SUNWmail/imta/lib/`.
`IMTA_CONFIG_DATA`	The compiled configuration for the IMTA. The default value is `/opt/SUNWmail/imta/lib/config_data`.
`IMTA_CONFIG_FILE`	The IMTA's configuration file. All it's rewrite rules and per channel options are set in this file. The default is `/etc/opt/SUNWmail/imta/imta.cnf`.
`IMTA_CONVERSION_FILE`	File to set rules for the conversion channel. The default value is `/etc/opt/SUNWmail/imta/conversions`.
`IMTA_DB_HASH_SIZE`	The IMTA database hash size. The default is 7901. All IMTA databases should be removed and reconstructed if this value is changed.
`IMTA_DB_PTR_SIZE`	The IMTA database pointer size. This value should be increased for very large databases.All IMTA databases should be removed and reconstructed if this value is changed The default value is 10 and works fine for databases with up to 4 million entries.
`IMTA_DISPATCHER_CONFIG` (Enterprise edition only )	The IMTA dispatcher's configuration file. The default is `/etc/opt/SUNWmail/imta/dispatcher.cnf`.
`IMTA_DOMAIN_DATABASE` (Enterprise Edition only)	This option is not used for SIMS 3.5.
`IMTA_FORWARD_DATABASE` (Enterprise Edition only)	This option is not used for SIMS 3.5.
`IMTA_GENERAL_DATABASE` (Enterprise Edition only)	This database is provided for each site's customer usage. Generally lookups can be embedded in mappings and rewrite rules. The default is `/var/opt/SUNWmail/imta/generaldb`.
`IMTA_JBC_CONFIG_FILE`	The IMTA job_controller's configuration file. The default is `/etc/opt/SUNWmail/imta/job_controller.cnf`.
`IMTA_JBC_SERVICE`	Specifies the host and port for the job_controller. Do not edit this option.
`IMTA_LANG`	Locale of the IMTA's notary messages. By default it is `/etc/opt/SUNWmail/imta/locale/C/LC_MESSAGES`.
`IMTA_LDAP_SERVER`	This option specifies the location of the LDAP directory, searched by the IMTA dirsync, autoreply and other programs. The list consists of one or more ldaphost: port pairs separated by commas. Each program reads this list and connects to the first directory, it is able to connect to. It connects to port 389, if the port is not specified. The default is just localhostname:389.
`IMTA_LIB`	Directory where the IMTA libraries and executables are stored. The default is `/opt/SUNWmail/imta/lib/`.
`IMTA_LIBUTIL`	The IMTA's utility library. By default it is `/opt/SUNWmail/lib/libimtautil.so.1`.
`IMTA_LOG`	Location of the IMTA's log files. The default is `/var/opt/SUNWmail/imta/log/`.
`IMTA_MAPPING_FILE` (Enterprise edition only )	File used for setting access control rules, reverse mapping rules, forward mapping rules etc. The default value is `/etc/opt/SUNWmail/imta/mappings`.
`IMTA_NAME_CONTENT_FILE`	Location of file used by the IMTA for content-type conversions. The default is `/etc/opt/SUNWmail/imta/name_content.dat`.
`IMTA_OPTION_FILE`	Name of the IMTA's option file. The default is `/etc/opt/SUNWmail/imta/option.dat`.
`IMTA_QUEUE`	The IMTA's message queue directory. The default is `/var/opt/SUNWmail/imta/queue`.
`IMTA_QUEUE_CACHE_DATABASE`	Location of the IMTA's message queue cache. The default is `/var/opt/SUNWmail/imta/queue_cache/`.
`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 will only be 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 will only be performed every N times the return job runs. By default the return job runs once every day.
`IMTA_RETURN_SYNCH_PERIOD`	Controls queue synchronization.The default value for this option is 1. If this options is set to an integer value N, then the associated action will only be performed every N times the return job runs. By default the return job runs once every day.
`IMTA_REVERSE_DATABASE` (Enterprise Edition only)	The IMTA's reverse database. This database is used for rewriting From: addresses. The default is `/var/opt/SUNWmail/imta/db/reversedb`.
`IMTA_ROOT`	Base directory for the IMTA installation. The default is `/opt/SUNWmail/imta/`.
`IMTA_SCRATCH`	Directory where the IMTA stores it's backup configuration files. During a full dirsync temporary database files are also created under this directory.The default is `/var/opt/SUNWmail/imta/tmp/`.
`IMTA_SYNCH_CACHE_PERIOD`	Controls the queue synchronization by the post program.The default value for this option is 1. If this options is set to an integer value N, then the associated action will only be performed every N times the post job runs. By default the post job runs once every four hours.
`IMTA_TABLE`	The IMTA's configuration directory. The default is `/etc/opt/SUNWmail/imta/`.
`IMTA_USER`	Name of the postmaster. The default is inetmail. If this is changed be sure to edit `/etc/opt/SUNWmail/imta/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 `/var/opt/SUNWmail/imta/profiledb`.
`IMTA_USER_USERNAME`	This option specifies the userid of the subsidiary account the IMTA uses for certain "non-privileged" operations--operations which it doesn't want to perform under the usual IMTA 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_VERSION_LIMIT_PERIOD`	Controls the frequency of purging of log files by the post job. The default value for this option is 1. If this options is set to an integer value N, then the associated action will only be performed every N times the post job runs. By default the post job runs once every four hours
`IMTA_WORLD_GROUP`	This is the group in which one must belong to be able to perform certain "privileged" sorts of operations. The default is mail.