6.8 Adding External Users to the GroupWise Address Book

The GroupWise Address Book lists all users that belong to your GroupWise system. When users receive incoming messages, the senders are added to users’ Frequent Contacts Address Books to facilitate replying to users who are not included in the GroupWise Address Book. If necessary, you can configure GroupWise so that external (non-GroupWise) users appear in the GroupWise Address Book and are therefore available to all GroupWise users.

The following sections help you add non-GroupWise users to the GroupWise Address Book:

6.8.1 Creating a Non-GroupWise Domain to Represent the Internet

  1. In ConsoleOne, right-click GroupWise System (in the left pane), then click New > Non-GroupWise Domain.

    Create Non-GroupWise Domain dialog box

  2. Fill in the fields:

    Domain Name: Specify a name that has not been used for another domain in your system (for example, Internet).

    Time Zone: This should match the time zone for the Internet Agent (GWIA). If it does not, select the correct time zone.

    Link to Domain: Select a domain where the GWIA is running.

  3. Click OK to create the non-GroupWise domain.

    The non-GroupWise domain appears under GroupWise System in the left pane.

  4. Continue with Linking to the Non-GroupWise Domain.

6.8.2 Linking to the Non-GroupWise Domain

After you have created the non-GroupWise domain, you must modify the link between the domain where the Internet Agent (GWIA) is running and the non-GroupWise domain. This enables the GroupWise system to route all Internet messages to the MTA of the GWIA domain. The MTA can then route the messages to the GWIA, which sends them to the Internet.

To modify the link to the non-GroupWise domain:

  1. In ConsoleOne, click Tools > GroupWise Utilities > Link Configuration to display the Link Configuration tool.

    By default, the Link Configuration tool displays the links for the domain that you are currently connected to.

    Link Configuration tool

  2. If the GWIA domain is not the currently displayed domain, select it from the list of domains on the toolbar.

    The non-GroupWise domain should be displayed in the Direct column. In the graphic displayed under step 1, Internet is the non-GroupWise domain.

  3. Double-click the non-GroupWise domain to display the Edit Domain Link dialog box.

    If you are prompted that the mapped path is empty, click Yes to dismiss the prompt and display the Edit Domain Link dialog box.

    Edit Domain Link dialog box

  4. In the Link Type field, select Gateway.

    After you select Gateway, the dialog boxes changes to display the settings required for a gateway link.

    Edit Domain Link dialog box with the gateway settings displayed

    NOTE:GroupWise gateways are legacy products that are not supported with the current GroupWise version.

  5. Fill in the following fields:

    Gateway Link: Select the GWIA.

    Gateway Access String: If you want to specify the conversion format (RFC-822 or MIME) for messages sent to the domain, include the -rfc822 or -mime parameter. If you do not use either of these parameters, the GWIA converts messages to the format specified in its startup file. The default is for MIME conversion (as specified by the GWIA’s /mime startup switch).

    Return Link: Leave this field as is. It does not apply to the GWIA.

    Maximum Send Message Size: If you want to limit the size of messages that the MTA for the GWIA domain passes to the GWIA, specify the maximum size. This is applied to all messages. If you want to limit the size of messages sent by specific users or groups of users, you can also use the Access Control feature. For details, see Section 54.1, Controlling User Access to the Internet.

    Delay Message Size: If you want the MTA to delay routing of large messages to the GWIA, specify the message size. Any messages that exceed the message size are assigned a lower priority by the MTA and are processed after the higher priority messages.

  6. Click OK to save the changes.

    The non-GroupWise domain is moved from the Direct column to the Gateway column. For a description of the link symbols next to the domain names, see the Help in the Link Configuration tool.

    Link Configuration tool

  7. Click the File menu, click Exit, then click Yes to exit the Link Configuration tool and save your changes.

  8. Continue with Creating a Non-GroupWise Post Office to Represent an Internet Host.

6.8.3 Creating a Non-GroupWise Post Office to Represent an Internet Host

When you create a post office to represent an Internet host, the post office name cannot be identical to the hostname because the period that separates the hostname components (for example, novell.com) is not a valid character for post office names. GroupWise reserves the period for its addressing syntax of user_ID.post_office.domain. Therefore, you should choose a name that is closely related to the hostname.

To create a non-GroupWise post office:

  1. In ConsoleOne, right-click the non-GroupWise domain that represents the Internet, then click New > External Post Office.

    Create External GroupWise Post Office dialog box

  2. Fill in the following fields:

    Post Office Name: Specify a name to associate the post office with the Internet host. Do not use the fully qualified hostname.

    Time Zone: Select the time zone in which the Internet host is located.

  3. Click OK to create the post office.

    The non-GroupWise post office is added under the non-GroupWise domain.

  4. Right-click the new non-GroupWise post office, then click Properties.

  5. Click GroupWise > Internet Addressing.

    Internet Addressing property page

  6. If you want to override the GroupWise system allowed address formats, select Override next to Allowed Address Formats, then select the allowed address formats for this Internet host.

  7. Next to Internet Domain Name, select Override, then specify the actual name of the Internet host that the external post office represents.

  8. Click OK to save your changes.

  9. Continue with Creating External Users.

6.8.4 Creating External Users

By creating external users, you add them to the GroupWise Address Book for easy selection by GroupWise users when addressing messages.

To add an Internet user to a post office:

  1. In ConsoleOne, right-click the post office that represents the user’s Internet host, then click New > External User.

    Create GroupWise External User dialog box

  2. In the User Name field, specify the exact user portion of the user’s Internet address. If the address is jsmith@novell.com, the portion you would specify is jsmith.

  3. Click OK to create the external user.

  4. Provide personal information about the external user:

    1. Right-click the new External User object.

    2. Fill in the desired fields on the Identification page.

      Because the user is displayed in the GroupWise Address Book, you might want to define the user’s first name and last name. This is especially important if the allowed address formats for the Internet host include first name and last name information.

    3. Click OK to save the user’s personal information.

If you have only a few users on some Internet hosts, you can create a single external post office for these users, then define their Internet domain names on the Identification pages of the External User objects instead of on the External Post Office object.

6.8.5 Configuring External Users and Resources to Appear in GroupWise Busy Searches

You can define the URL where free/busy schedule status is published for a user or resource in an external email system. This enables GroupWise users to receive Busy Search results from this external user or resource along with Busy Search results from other GroupWise users.

  1. In ConsoleOne, right-click an External User object or an External Resource object, then click Properties.

  2. Click GroupWise > Internet Free Busy Search.

  3. Specify the URL where free/busy schedule status for the user or resource is published, then click OK.