Conversion channel definition

From Messaging Server Technical Reference Wiki
Jump to: navigation, search

A conversion channel must be present in the MTA's configuration in order for conversions to be performed. In Unified Configuration, a conversion channel is configured automatically, while in legacy configuration the post-installation configuration step normally caused an appropriate conversion channel definition to be included in the MTA configuration file. The channel definition should have the general form:


or as displayed in Unified Configuration:

msconfig> show channel:conversion.* = conversion-daemon

As of MS 8.0, use of the receivedstate channel option is recommended:

conversion receivedstate "content" 

or in Unified Configuration:

msconfig> set channel:conversion.receivedstate content

Rewrite rules can be added if desired to make it possible to queue mail explicitly to the conversion channel. Something like

conversion                $U%conversion.localhostname@conversion-daemon 
conversion.localhostname  $U%conversion.localhostname@conversion-daemon 

where localhostname is the name of this MTA system, will provide the necessary functionality. Note that in Unified Configuration, such rewrite rules would typically be automatically generated, and make use of the $D and &/IMTA_HOST/ and &/IMTA_DEFAULTDOMAIN/  substitutions, to appear as:

msconfig> show rewrite.rule * *conversion*
role.rewrite.rule = conversion $
role.rewrite.rule = conversion.&/IMTA_HOST/ $

Once such rewrite rules are present, then addresses of the form


will be routed through the conversion channel regardless of what the CONVERSIONS mapping table says.

See also: