Changing the Link Protocol between a Domain and Its Post Offices

How messages are transferred between the MTA for the domain and the POA for each post office is determined by the link protocol in use between the domain and each post office. For a review of link protocols, see Link Protocols for Direct Links.

If you need to change from one link protocol to another, some reconfiguration of the MTA and its link to each post office is necessary.

• Using TCP/IP Links between a Domain and its Post Offices
• Using Mapped or UNC Links between a Domain and its Post Offices

Using TCP/IP Links between a Domain and its Post Offices

To change from mapped or UNC links to TCP/IP links between a domain and its post offices, you must perform the following two tasks:

• Configuring the Agents for TCP/IP
• Changing the Link Protocol between a Domain and its Post Offices to TCP/IP

Configuring the Agents for TCP/IP

To configure the agents for TCP/IP:

1. If the MTA for the domain is not yet set up for TCP/IP communication, see Configuring the MTA for TCP/IP.

2. If any post offices do not yet have a POA set up for TCP/IP communication, see Using Client/Server Access to the Post Office to set up the initial TCP/IP information.

3. In ConsoleOne, expand the Post Office object to display the POA object(s) in the post office.

   Only one POA per post office needs to communicate with the MTA. If the post office has multiple POAs, have a POA that performs message file processing communicate with the MTA for best performance. For information about message file processing, see Role of the Post Office Agent.

4. Right-click the POA object > click Properties to display the POA Identification page.

   
   

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

   
   

6. In the Message Transfer Port field, specify a unique TCP port on which the POA will listen for incoming messages from the MTA.

   The default is 7101.

7. Click OK twice to save the TCP/IP information and return to the main ConsoleOne window.

   ConsoleOne then notifies the POA to restart with message transfer processing enabled.

Changing the Link Protocol between a Domain and its Post Offices to TCP/IP

To change the links between the domain and its post offices from mapped or UNC to TCP/IP:

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

   
   

2. In the drop-down list, select the domain where you want TCP/IP links to post offices.

3. Click View > Post Office Links to display post office links.

   
   

4. Double-click a Post Office object.

5. In the Protocol field, select TCP/IP.

   
   

6. Make sure the information displayed in the Edit Post Office Link dialog box matches the information provided in the Edit Network Address dialog box in Configuring the Agents for TCP/IP.

7. Click OK.

8. Repeat Step 4 through Step 7 for each post office in the domain where you want to use TCP/IP links.

9. To exit the Link Configuration tool and save your changes, click File > Exit, then click Yes.

   ConsoleOne then notifies the MTA and POAs to restart using the new link protocol.

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

Using Mapped or UNC Links between a Domain and its Post Offices

To change from a TCP/IP link to a mapped or UNC link between a domain and its post offices:

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

2. In the drop-down list, select the domain where the post offices reside.

3. Click View Post Office Links to display post office links.

4. Double-click a Post Office object.

5. In the Protocol field, select Mapped or UNC.

6. Provide the location of the post office in the format appropriate to the selected protocol.

7. Click OK.

8. Repeat Step 4 through Step 7 for each post office in the domain.

9. To exit the Link Configuration tool and save your changes, click File > Exit, then click Yes.

   ConsoleOne then notifies the POA and MTA to restart using the new link protocol.

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