Refresh utility

The refresh utility refreshes the configuration of running Messaging Server components.

Syntax
refresh &#x5b;components ...&#x5d;

Restrictions
Must have superuser privileges or use the Solaris RBAC feature in order to use this utility.

One or more   parameters may be supplied to refresh specific running components. See start-msg utility for a list of the valid values for  .

Description
This triggers a configuration refresh of one or more running Messaging Server processes. The actual configuration refresh by each process happens asynchronously.

Note:The MTA&#x27;s design makes it easy to restart a dispatcher server process without service impact. In general, therefore, MTA options are not refreshable (with mappings being a notable exception). For example,  causes the dispatcher to start new SMTP server processes for future incoming connections, reading a new configuration. This happens without service interruption. The Message Store, ENS, and MMP design makes restarting a process a service outage, so it is important for refresh logic to be built for most options in these servers. Most of these options are therefore refreshable.

Having msconfig print a restart required warning would generate a lot of pointless warnings for MTA options which is undesirable behavior for Unified Configuration. Because of this, the msconfig utility does not issue a warning when an option that requires a restart is modified. The legacy configutil tool does issue such a warning.

Example
The following command refreshes the IMAP server:
 * 1) refresh imap

See also:
 * Messaging Server command line utilities
 * reload utility
 * restart utility
 * start-msg utility