Official_host_name Option

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


Updated in release: 8.0.1


The official_host_name channel option specifies the "name" of the system with which this channel communicates. The official_host_name may be either a fully qualified host name, in the case of a channel dedicated to communicating with one particular system,


msconfig> show channel:l.official_host_name
role.channel:l.official_host_name = host.domain.com

or in the case of a more "generic" channel used for communicating with multiple systems (such as the Internet-communication channel tcp_local), the official_host_name tends to be a generic, place-holder name, e.g.,


msconfig> show channel:tcp_local.official_host_name
role.channel:tcp_local.official_host_name = tcp-daemon

In legacy configuration, the official host name is specified as the first name on the second line of a channel definition:


tcp_local ...keywords...
tcp-daemon

Each channel must have its own, unique official_host_name; no duplication with other channels is allowed. As of MS 6.1, the official host name is limited to 128 characters; in prior versions the limit was 40 characters. An official host name is required for each channel; omitting an official host name from a channel definition is an error.

Note that the official_host_name on the l channel (lowercase "L" channel) has somewhat special significance, as it is used/assumed at certain times by the MTA; and normally, it would be set to match the value of the ldap_local_host MTA option.

As of 8.0.1, the option if not set for a channel will default to channel-name.hostname in Unified Configurations.


See also: