Cisco Unity Connection

Unity Connection SMTP Domain Name Change

Document ID: 117237

Updated: Jan 14, 2014

Contributed by Andrew Goodman and Scott Hills, Cisco TAC Engineers.



This document describes how to update the Simple Mail Transfer Protocol (SMTP) domain name in Connection Administration. This domain has an effect on Unified Messaging and Digital Networking.

Unity Connection has the ability to perform as an SMTP client as well as an SMTP server. By default, the SMTP domain name is set to the Fully Qualified Domain Name (FQDN - hostname with DNS domain name appended, if applicable) of the first node installed. In certain scenarios, it might be necessary to change the SMTP domain name from the default value. This might be required in order to ensure that each of the Connection Locations has a unique SMTP domain, and that this domain is not the same as the corporate e-mail domain. 


If you have a current Digital Networking setup, in order to change the SMTP domain for a cluster you must remove it from the network. Complete these steps before you add it back to the Digital Network:

  1. Check all remote locations in order to verify that the location (cluster) to be changed no longer appears in either of these lists:

    • Connection Administration > Networking > Links > Intrasite Links
    • Connection Administration > Networking > Links > Intersite Links
  2. Once the location no longer appears in remote clusters, complete these steps in order to change the SMTP domain:

    1. Go to the Unity Connection Administration web page.
    2. Choose System Settings > SMTP Configuration > Server.
    3. Click Change SMTP Domain. Update the domain name and click Save.
    4. You will be prompted to restart these services: Connection Conversation Manager, Connection Message Transfer Agent, and Connection SMTP Server.
    5. If in a cluster, restart Connection Conversation Manager and Connection SMTP Server on both servers (Mail Transfer Agent [MTA] only runs on the Primary node).
  3. As applicable, add back the Intrasite and Intersite links.

Note: Ensure the SMTP domain of Cisco Unity Connection is different from the corporate e-mail domain in order to avoid issues in message routing for Cisco Unity Connection.

Related Information

Updated: Jan 14, 2014
Document ID: 117237