Changing the Link Protocol between Domains

How MTAs for different domains communicate with each other is determined by the link protocol in use between the domains. Typically, inbound and outbound links for a domain use the same link protocol, but this is not required. For a review of link protocols, see Link Protocols for Direct Links.

If you originally set up an MTA using one link protocol and need to change to a different one, some reconfiguration of the MTA is necessary.


Using TCP/IP Links between Domains

To set up TCP/IP links between domains, you must perform the following two tasks:


Configuring the MTA for TCP/IP

To configure the MTA for TCP/IP:

  1. Make sure TCP/IP is properly set up on the machine where the MTA is running.

  2. In ConsoleOne, browse to and right-click the MTA object > click Properties to display the MTA Identification page.


    MTA Identification page

  3. In the Network Address box, click the pencil icon for the TCP/IP Address field to display the Edit Network Address dialog box.


    Edit Network Address dialog box

  4. Click IP Address, then provide the IP address, in dotted decimal format, of the machine where the MTA is running.

    or

    Click DNS Host Name, then provide the DNS host name of the machine where the MTA is running.

    The MTA must run on a machine that has a static IP address. DHCP cannot be used to dynamically assign an IP address for it.

    Specifying the DNS host name rather than the IP address makes it easier to move the MTA from one machine to another, should the need arise at a later time. You can assign a new IP address to the host name in DNS, without needing to change the MTA configuration information in ConsoleOne.

  5. To use a TCP port number other than the default port of 7100, type the port number in the Message Transfer Port field.

    If multiple MTAs will run on the same machine, each MTA must have a unique TCP port number.

  6. Click OK twice to save the network address and return to the main ConsoleOne window.

    ConsoleOne then notifies the MTA to restart enabled for TCP/IP.

Corresponding Startup Switches
You could also use the /tcpport switch in the MTA startup file to provide the message transfer port number.


Changing the Link Protocol between Domains to TCP/IP

Make sure you have configured the MTA for TCP/IP at both ends of each link.

To change the link between the domains from mapped or UNC to TCP/IP:

  1. In ConsoleOne, click Tools > GroupWise Utilities > Link Configuration.

  2. Click View > Domain Links to display domain links.


    Link Configuration tool window

  3. Select the MTA's local domain in the drop-down list.

    Outbound and inbound links for the selected domain are listed.

  4. Double-click a domain in the Outbound Links list.


    Edit Domain Links dialog box

  5. Set Link Type to Direct.

  6. Set Protocol to TCP/IP.

    Make sure the information displayed in the IP Address and MT Port fields matches the information for the MTA for the domain to which you are linking.

  7. Click OK.

  8. Repeat Step 4 through Step 7 for each domain in the Outbound Links list where you want the MTA to use a TCP/IP link.

    Selecting multiple domains is also allowed.

  9. Double-click a domain in the Inbound Links list.

  10. Set Link Type to Direct.

  11. Set Protocol to TCP/IP.

    Make sure the information displayed in the IP Address and MT Port fields matches the information you supplied in Configuring the MTA for TCP/IP.

  12. Click OK.

  13. Repeat Step 9 through Step 12 for each domain in the Inbound Links list where you want the MTA to use a TCP/IP link.

    Selecting multiple domains is also allowed.

  14. Click File > Exit, then click Yes to save the link changes.

    ConsoleOne then notifies the MTA to restart with the new link configuration.

For a sample message flow for this configuration, see TCP/IP Link Open: Transfer between Domains Successful in Message Delivery to a Different Domain in Troubleshooting 3: Message Flow and Directory Structure.


Using Mapped or UNC Links between Domains

To change to a mapped or UNC link between domains:

  1. In ConsoleOne, click Tools > GroupWise Utilities > Link Configuration.

  2. Click View > Domain Links to display domain links.

  3. Select the MTA's local domain in the drop-down list.

    Outbound and inbound links for the selected domain are listed.

  4. Double-click a domain in the Outbound Links list.

  5. Set Link Type to Direct.

  6. Set Protocol to Mapped or UNC.

  7. Enter the full path, in the appropriate format, of the directory where the other domain is located.

  8. Click OK.

  9. Repeat Step 4 through Step 8 for each domain in the Outbound Links list where you want the MTA to use a mapped or UNC link.

    Selecting multiple domains is also allowed.

  10. Double-click a domain in the Inbound Links list.

  11. Set Link Type to Direct.

  12. Set Protocol to Mapped or UNC.

  13. Enter the full path, in the appropriate format, of the directory where the local domain is located.

  14. Click OK.

  15. Repeat Step 10 through Step 14 for each domain in the Inbound Links list where you want the MTA to use a mapped link.

    Selecting multiple domains is also allowed.

  16. Click File > Exit, then click Yes to save the link changes.

    ConsoleOne then notifies the MTA to restart with the new link configuration.

For a sample message flow for this configuration, see Mapped/UNC Link Open: Transfer between Domains Successful in Message Delivery to a Different Domain in Troubleshooting 3: Message Flow and Directory Structure.