10.2 Using the Link Configuration Tool
The Link Configuration tool helps you manage the links between the domains and post offices in your GroupWise system. The following topics help you perform basic link management tasks:
10.2.1 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.
-
In ConsoleOne, select the Domain object whose links you want to modify.
-
Click > > 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
>
Open a different domain database (wpdomain.db) to modify links in a different domain
>
Save the current link configuration information to the domain database
>
Undo your changes to the link configuration (since the last save)
>
Display online Help for the Link Configuration tool
>
Search for a specified domain
Double-click object
Display details of the selected object
>
View domain links for the selected domain
>
View post office links for the selected domain
-
Continue with a specific link management task:
10.2.2 Editing a Domain Link
After starting the Link Configuration tool:
-
From the drop-down list, select the domain whose links you want to edit.
-
Click > to display domain links.
Outbound and inbound links for the selected domain are listed.
-
Double-click a domain in the Links list to edit the link to that domain from the selected domain.
or
Double-click a domain in the 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.
-
Select the link type:
-
For a direct link, select the link protocol:
-
Provide the location of the domain in the format appropriate to the selected protocol.
-
Click .
-
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 > , then click the domain whose links you want to use as a pattern for the new domain. Select and/or as needed, then click .
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.
-
To exit the Link Configuration Tool and save your changes, click >>.
10.2.3 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:
-
Click > .
-
In the column, select the source domains whose outgoing links you want to modify.
-
In the column, select the intermediate domain through which you want the indirect links to pass.
-
In the column, select one or more destination domains.
-
Click .
-
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 Section 10.2.2, Editing a Domain Link, then click .
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 the way you want them.
10.2.4 Editing a Post Office Link
After starting the Link Configuration tool:
-
From the drop-down list, select the domain whose post office link you want to edit.
-
Click > to display post office links.
-
Double-click a post office to edit the link from the domain to the post office.
-
Select the link protocol for the direct link.
-
Provide the location of the post office in the format appropriate to the selected protocol.
-
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.
-
Click .
-
To exit the Link Configuration tool and save your changes, click >>.
10.2.5 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:
-
Select a domain from the drop-down list.
-
Select a domain in the Indirect links list.
-
Click > 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 Section 71.3.1, Link Trace Report.
10.2.6 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:
-
Click > to list all domains in your system.
-
Double-click a domain to list the indirect links passing through it.
-
If you need to reroute a link, right-click the link, then click 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 Section 71.3.2, Link Configuration Report. However, you cannot change link information using Monitor.
10.2.7 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:
-
Click > to list all gateways in your system.
-
Double-click a gateway to list the domains linked through that gateway.
-
If you need to reroute a link, right-click the link, then click to open the Edit Domain Link dialog box and make changes as needed.
10.2.8 Saving and Synchronizing Link Configuration Information
Whenever you modify link configuration information, a cautionary symbol (see Section 10.3.2, Link Status Symbols) appears next to the modified link until you save the current link configuration by clicking > . 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 > .
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 > .