Starting the Link Configuration Tool

The Link Configuration tool is provided to help you change from default links to whatever link configuration best suits your GroupWise system.

1. In ConsoleOne^®, select the Domain object whose links you want to modify.

2. Click Tools > GroupWise Utilities > Link Configuration to display the Link Configuration Tool window.

   
   

   The most frequently used features of the Link Configuration tool are available on the toolbar:

   Button	Menu Equivalent	Function
   	File > Open	Open a different domain database (wpdomain.db) to modify links in a different domain
   	File > Save	Save the current link configuration information to the domain database
   	Edit > Undo	Undo your changes to the link configuration (since the last save)
   	Help > Help	Display online Help for the Link Configuration tool
   	Search > Find	Search for a specified domain
   	Double-click object	Display details of the selected object
   	View > Domain Links	View domain links for the selected domain
   	View > Post Office Links	View post office links for the selected domain

3. Continue with a specific link management task:

   • Editing a Domain Link
   • Editing Multiple Domain Links
   • Editing a Post Office Link
   • Viewing the Path of an Indirect Link between Domains
   • Viewing the Indirect Links Passing through a Domain
   • Viewing the Gateway Links Passing through a Gateway

Editing a Domain Link

After starting the Link Configuration tool:

1. From the drop-down list, select the domain whose links you want to edit.

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

   Outbound and inbound links for the selected domain are listed.

   
   

3. Double-click a domain in the Outbound Links list to edit the link to that domain from the selected domain.

   or

   Double-click a domain in the Inbound Links list to edit the link from that domain to the selected domain.

   
   

   HINT:  You can also open the Edit Domain Link dialog box by dragging a domain from one link type to another.

4. Select the link type.

   • Direct Links
   • Indirect Links
   • Gateway Links

5. For a direct link, select the link protocol.

   • Mapped Links
   • UNC Links
   • TCP/IP Links

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

7. Click OK.

8. Repeat Step 1 through Step 7 for whatever links you need to modify.

   As a time-saving measure, you can make a new domain's links the same as an existing domain's links. Click Edit > Default Links, then click the domain whose links you want to use as a pattern for the new domain. Select Outbound and/or Inbound as needed, then click OK.

   To look at the same link information from different points of view, you can start the Link Configuration tool multiple times to open multiple Link Configuration Tool windows.

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

Editing Multiple Domain Links

When your GroupWise system includes indirect links, it is not unusual for several domains to link to the same domain. As a time-saving measure, you can create links from multiple domains to the same domain in one operation.

After starting the Link Configuration tool:

1. Click Edit > Multiple Link Edits.

   
   

2. In the Domains to Be Linked column, select the source domains whose outgoing links you want to modify.

3. In the Indirect Link Through column, select the intermediate domain through which you want the indirect links to pass.

4. In the Link To column, select one or more destination domains.

5. Click OK.

6. Fill in the fields in the Edit Domain Link dialog box for each direct link between a source domain and the intermediate domain, as described in Editing a Domain Link, then click OK.

   
   

   The Edit Domain Link dialog box continues to appear until you have defined all the direct links between the source domains and the intermediate domain.

IMPORTANT:  After defining links from the source domains to the intermediate domain, make sure the links from the intermediate domain to other domains are set up correctly.

Editing a Post Office Link

After starting the Link Configuration tool:

1. From the drop-down list, select the domain whose post office link you want to edit.

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

   
   

3. Double-click a post office to edit the link from the domain to the post office.

   
   

4. Select the link protocol for the direct link.

   • Mapped Links
   • UNC Links
   • TCP/IP Links

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

6. For a TCP/IP link, provide the message transfer port number where you want the POA to listen for incoming messages from the MTA.

   The default message transfer port for the POA is 7101.

7. Click OK.

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

Viewing the Path of an Indirect Link between Domains

The more hops between two indirectly linked domains, the longer it takes a message to travel between them. To make sure the number of hops between two indirectly linked domains is as small as possible, you can list the route a message would take from one domain to the other in ConsoleOne.

After starting the Link Configuration tool:

1. Select a domain from the drop-down list.

2. Select a domain in the Indirect links list.

3. Click View > Link Path to see a list of the hops between the two domains.

   
   

You can also use GroupWise Monitor to trace the path a message would take between two domains. See Link Trace Report and Tracing a Link at the Monitor Web Console.

Viewing the Indirect Links Passing through a Domain

If a domain serves as a hop in an indirect link, making changes to that domain could affect all indirect links passing through that domain. You can list all the indirect links that pass through a domain in ConsoleOne.

After starting the Link Configuration tool:

1. Click View > Link Hop to list all domains in your system.

   
   

2. Double-click a domain to list the indirect links passing through it.

   
   

3. If you need to reroute a link, right-click the link, then click Edit to open the Edit Domain Link dialog box and make changes as needed.

You can also use GroupWise Monitor to check the links passing through a selected domain. See Link Configuration Report and Checking Links Configuration at the Monitor Web Console. However, you cannot change link information using Monitor.

Viewing the Gateway Links Passing through a Gateway

Before making changes to a gateway, you can list all the links that pass through the gateway.

After starting the Link Configuration tool:

1. Click View > Gateway Hop to list all gateways in your system.

   
   

2. Double-click a gateway to list the domains linked through that gateway.

   
   

3. If you need to reroute a link, right-click the link, then Edit to open the Edit Domain Link dialog box and make changes as needed.

Saving and Synchronizing Link Configuration Information

Whenever you modify link configuration information, a cautionary symbol (see Link Status Symbols) appears next to the modified link until you save the current link configuration by clicking Edit > Save. If you are making extensive changes to link configuration information, you should save regularly. When you save, the information is written out to the domain database (wpdomain.db) for the domain to which you are currently connected. You can change to a different domain database without exiting the Link Configuration tool by clicking File > Open.

The MTA routinely synchronizes the information in the domain databases throughout your GroupWise system. If you are making extensive changes to link configuration information, you can synchronize the information immediately by clicking Edit > Synchronize.