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.

  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.

    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:

10.2.2 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.

    Domain with it links
  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.

    Edit Domain Link dialog box

    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.

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

  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.

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:

  1. Click Edit > Multiple Link Edits.

    Multiple Link Edits dialog box
  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 Section 10.2.2, Editing a Domain Link, then click OK.

    Edit Domain Link dialog box

    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:

  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.

    Post offices with their links
  3. Double-click a post office to edit the link from the domain to the post office.

    Edit Post Office Link dialog box
  4. Select the link protocol for the direct link.

  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.

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:

  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.

    Link Configuration tool with the list of hops displayed

You can also use GroupWise Monitor to trace the path a message would take between two domains. See Section 61.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:

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

    Link Configuration tool with a list of domains in the system
  2. Double-click a domain to list the indirect links passing through it.

    List of indirect links that pass through the domain
  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 Section 61.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:

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

    Link Configuration tool with a list of gateways in the system
  2. Double-click a gateway to list the domains linked through that gateway.

    List of domains linked through the gateway
  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.

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 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.