Microsoft KB Archive/899107

= How to configure the Microsoft Exchange Connector for Novell GroupWise 6 =

Article ID: 899107

Article Last Modified on 10/25/2007

-

APPLIES TO


 * Microsoft Exchange Server 2003 Standard Edition
 * Microsoft Exchange Server 2003 Enterprise Edition

-



 INTRODUCTION MORE INFORMATION  === Install and Configure the GroupWise 4.1 API gateway NLM with Patch 5 ===

 ==== Install the GroupWise 4.1 API gateway NLM with Patch 2 ====  ==== Install Patch 5 for the API gateway ====  ==== Enable GroupWise distribution list expansion ====  ==== Add and configure the API gateway object ====  ==== Load the API gateway ==== </li></ul> </li> === Add an external foreign domain for the Exchange system ===

<ul> ==== Add a non-GroupWise Domain ==== </li> ==== Configure the link table ==== </li> ==== Add a NetWare account for the Exchange Router for GroupWise ==== </li> ==== Configure the Connector for Novell GroupWise to use the NetWare account ==== </li></ul> </li></ul> </li></ul>

<div class="summary_section">

INTRODUCTION
The Novell GroupWise 4.1 Applications Programming Interface (API) gateway is an optional component that you can add to a working Novell GroupWise system. The API gateway provides an open interface to GroupWise 4.1 and to GroupWise 5.0 systems by using structured ASCII text files. These text files are made up of keywords that you can use to perform administrative tasks on your GroupWise system and to communicate with e-mail systems that are not Novell systems.

Before you start, you must install the Novell Netware Client 4.91 (Clnt491e.exe) on the Microsoft Exchange Server 2003 Service Pack 1 (SP1) computer that hosts the Microsoft Exchange Connector for Novell GroupWise. To obtain the Novell NetWare Client, visit the following Novell Web site:

http://download.novell.com/

Microsoft provides third-party contact information to help you find technical support. This contact information may change without notice. Microsoft does not guarantee the accuracy of this third-party contact information.

back to top

<div class="moreinformation_section">

Install the GroupWise 4.1 API gateway NLM with Patch 2
The GroupWise Patch 2 for API Netware Load Module (NLM) and OS/2 is included with the GroupWise 4.1 API gateway in one downloadable file (Gw41api2.exe file). To obtain the GroupWise 4.1 API gateway NLM with Patch 2, visit the following Novell Web site:

http://support.novell.com/servlet/filedownload/pub/gw41api2.exe

Microsoft provides third-party contact information to help you find technical support. This contact information may change without notice. Microsoft does not guarantee the accuracy of this third-party contact information. <ol> Download and extract the GroupWise 4.1 API gateway NLM with Patch 2 files to a temporary folder on the NetWare server. For example, extract the files to the Sys:Temp\Nlm folder.</li> In the NetWare System Console, type load :pinstall. In this step,  is the location of the GroupWise API gateway files.

For example, type load sys:temp\api\pinstall .</li> Make sure that the Install From box contains the installation path from which the Pinstall.nlm file was loaded.</li> In the Domain Path box, type the path of the GroupWise domain in which you want to install the gateway. The domain path uses the following format:



</li> Confirm that the following default values appear.

Note The following default values are correct for all standard NetWare installations. Do not change these values unless you have a customized installation. <ul> The default value for the Gateway Directory box is api.</li> The default value for the Gateway NLMs box is sys:\gwdomain\wpgate\api. This value is the path of the GroupWise domain API folder.</li> The default value for the Shared NLMs box is sys:\system.</li> The default value for the Load Script box is sys:\system.</li></ul> </li> Click Install to install the gateway.</li> <li>When the installation of the gateway has completed, press the ESC key until the NetWare System Console is displayed.

Do not start the gateway before you use the NetWare Administrator tool to configure the gateway.</li></ol>

back to top

Install Patch 5 for the API gateway
To upgrade the API gateway to Patch 5, you must perform a file replacement. To do this, follow these steps: <ol> <li>Download Patch 5 for the API gateway from the following Novell Web site:

http://support.novell.com/servlet/filedownload/pub/fgwapi5.exe

Microsoft provides third-party contact information to help you find technical support. This contact information may change without notice. Microsoft does not guarantee the accuracy of this third-party contact information.</li> <li>Extract the files to a temporary folder on the Novell server.</li> <li>Establish a connection to the NetWare server, and then copy the Ngwapi.fil file and the Ngwapi.nlm file to the : \Wpgate\Api folder.</li> <li>Click Replace the files when you are prompted.</li> <li>Copy the Ngwlib.nlm file to the Sys:\System folder.</li> <li>Click Replace the files when you are prompted.</li></ol>

back to top

Enable GroupWise distribution list expansion
<ol> <li>Locate the Ngwapi.prm file in the API folder of the GroupWise domain in which the API gateway was installed. For example, the Ngwapi.prm file may be located in the Sys:\Gwdomain\Wpgate\Api folder.</li> <li>Use either Notepad in Microsoft Windows or Edit in NetWare to open the Ngwapi.prm file.</li> <li>Find the line that contains the following text:

;/group

</li> <li>Remove the semicolon from this text.</li> <li>Save the file.</li></ol>

back to top

Add and configure the API gateway object
After the installation of the GroupWise API Gateway NLM files has completed, use the NetWare Administrator tool to configure an API gateway object in your GroupWise system: <ol> <li>Start the NetWare Administrator tool, and then click the GroupWise domain in which you want to install the connector.</li> <li>On the Object menu, click Create.</li> <li>In the Class of new object list, click GroupWise Gateway/Internet Agent, and then click OK.</li> <li>In the Create GroupWise Gateway/Internet Agent dialog box, configure the following settings: <ol style="list-style-type: lower-alpha;"> <li>At the top of the dialog box, click Gateway.</li> <li>In the Gateway Name box, type a name that is unique in your GroupWise domain. For example, type ExchangeLink .</li> <li>In the Gateway Home Directory list, click the name of the gateway.</li> <li>In the Language list, click English-US.</li> <li>In the Time Zone list, click the correct time zone.

By default, the gateway assumes the time zone of its domain. However, you can select a different time zone if the gateway is installed on a computer that is in a different time zone.</li> <li>In the Version list, click the version number of the API gateway. For example, click 4.X.</li> <li>In the Platform list, click the correct platform. For example, click NetWare Loadable Module.</li> <li>In the Gateway Type list, click the correct gateway type. For example, click API.</li> <li>Click to select the Define additional properties check box, and then click Create.</li></ol> </li> <li>In the GroupWise Gateway/Internet Agent:API dialog box, confirm the following settings: <ol style="list-style-type: lower-alpha;"> <li>Make sure that Information is selected (it is selected by default).</li> <li>In the Database Version list, make sure that 4.X is selected.</li> <li>In the Platform list, make sure that NetWare Loadable Module is selected.</li> <li>In the Gateway Type list, make sure that API is selected.</li> <li>In the Gateway Alias Type box, accept the default setting. By default, the Gateway Alias Type box is blank.</li> <li>In the Foreign ID box, accept the default setting. By default, the Foreign ID box is blank.</li> <li>In the UNC Path box, accept the default path.</li></ol> </li> <li>Click Optional Gateway Settings, and then click Exchange in the Directory Sync/Exchange list. Leave the default settings in the remaining boxes.</li> <li>Click Required Parameters.</li> <li>Under Gateway File Paths, view the paths that are listed in the Root Directory for Gateway Messages box and in the Root Directory for Directory Services Messages box. These paths use the mapped drive format. Change these paths to absolute paths that use the :\  format. For example, change one path to Sys:\Groupwisedomain\Wpgate\Api.

Note The paths must use the :\  format. And, you must change the paths in both boxes.</li> <li>In the Addressing Format list, click Component.

To verify that this value has been set, quit the NetWare Administrator tool, restart the NetWare Administrator tool, and then review the properties of the API gateway object.</li> <li>Click Gateway Time Settings, and then configure the following settings: <ul> <li>In the Idle Sleep Duration box, set the value to 5 seconds or less.</li> <li>Accept the default values for the remaining boxes, and then click OK.</li></ul> </li> <li>Verify that the /home switch setting in the Ngwapi.prm file is correct.

The Ngwapi.prm file is an ASCII text file that contains the parameters for starting the API gateway. Use any text editor to open the file. All the options in this file are commented out except for the /home switch. The /home switch contains the path of the gateway home directory. Make sure that the path uses the following format:

/Home- :\GroupWise_ \Wpgate\API

For example, the switch contains the following path:

/Home-sys:\GroupWise_ \Wpgate\Api

</li></ol>

back to top

Load the API gateway
Start a Server Console on the NetWare server that hosts the API gateway. To do this, use the load command to start the API gateway. The load statement takes an argument in the following form: 



For example, use the following load command: 

load sys:\groupWise_domain\wpgate\api\ngwapi @ngwapi.prm

To view the running processes on the server after the API gateway starts, press CTRL+ESC, and then type the number for the process at the prompt.

We recommend that you add the load command to the Grpwise.ncf file that is located in the Agents folder of the GroupWise post office. When you do this, the gateway automatically starts when the server restarts.

back to top

Add an external foreign domain for the Exchange system
The GroupWise system requires a means to route to the foreign system and to route from the foreign system. In this case, the GroupWise system routes to the Exchange system. Exchange is represented as a non-GroupWise domain. An instance of the API gateway is used to route mail between the foreign domain and the GroupWise domain that is used as the gateway to the GroupWise system.

Add a non-GroupWise domain

 * 1) In ConsoleOne, right-click GroupWise System, and then click New Non GroupWise Domain.
 * 2) Type a name to represent the Exchange system.

The external domain name must match the domain part of the GroupWise proxy address in the recipient policy that is used to provide GroupWise addresses to the Exchange system. The domain part is the first part of the GroupWise proxy address. You can change the name of the domain by editing the GroupWise proxy address on the E-Mail Addressing tab of the recipient policy. The default domain for the Exchange organization is &quot;Exchange&quot;.
 * 1) In the Domain Type box, click External Foreign.
 * 2) In the Database Version box, click 4.x. This value must match the API gateway version.
 * 3) Confirm that the value in the Time Zone box is set to the same time zone that is used by the Exchange computer that is running the Connector for Novell GroupWise.
 * 4) Click Create.
 * 5) Right-click the non-GroupWise domain, and then click New External Post Office.
 * 6) Type a name in the Post office name box.

This name must correspond to the second part of the GroupWise proxy address that is used in the Exchange recipient policy. The Exchange recipient policy default name is “First Administrative Group”. This name can be simplified. For example, you can type EXPO in the Post office name box.

back to top

Configure the link table

 * 1) In ConsoleOne, click the GroupWise domain that will act as the GroupWise system link to the Exchange system. This domain contains the API gateway.
 * 2) Right-click GroupWise System, and then click GroupWise Utilities Link Configuration.
 * 3) Click the GroupWise domain, and then double-click the Exchange domain.
 * 4) In the Link Type box, click Gateway.
 * 5) In the Gateway Link box, click the API gateway that you added to service the Exchange system.
 * 6) Leave all other settings set to the default setting, close the Link Configuration Tool, and then save changes when you are prompted.

back to top

Add a NetWare account for the Exchange Router for GroupWise
The Connector for Novell GroupWise must have Read, Write, Execute, Create, Modify and Filescan rights to the API folder and to all the subfolders of the API folder. The Microsoft Exchange GroupWise Router service uses this NetWare identity when the service sends and retrieves mail to the GroupWise API gateway.
 * 1) Open ConsoleOne, right-click the context in which the GroupWise API gateway resides, and then click New User.
 * 2) In the Name box, type a name for the Exchange account.
 * 3) In the Surname box, type a value. We suggest that you type Service.

A surname is required to save the object.
 * 1) Click to select the Define additional properties check box, and then click OK.
 * 2) Type a password for the account, and then click OK.
 * 3) In the Properties dialog box, click the Rights to Files and Folders tab.
 * 4) Click Show, and then click the volume in which the API gateway is installed.
 * 5) Click Add, and then locate the API folder.
 * 6) Click to select the following check boxes:
 * 7) * Write
 * 8) * Execute
 * 9) * Create
 * 10) * Modify
 * 11) * Filescan
 * 12) Click Apply, and then click OK.

back to top

Configure the Connector for Novell GroupWise to use the NetWare account
<ol> <li>Start Exchange System Manager, right-click Connector for Novell GroupWise, and then click Properties.</li> <li>In the API Gateway Path box, type the UNC path to the API gateway on the NetWare server.

The path uses the following format:

\\ \ \ \wpgate\api

</li> <li>Click Modify, and then type the NetWare account that is made for the Connector for Novell GroupWise.</li> <li>Type and then confirm the password for the NetWare account.</li> <li>Configure the Import container to point to the organizational unit in which the objects that represent GroupWise users will be added.</li> <li>Configure the Export container to point to the organizational units that contain Exchange Users objects that will be exported to the GroupWise system.</li> <li>In the Address space box, type a wildcard character (*).</li> <li>Click Apply, and then click OK.</li> <li>Close the Connector for Novell GroupWise properties, and then start the following services: <ul> <li>Microsoft Exchange Connectivity Controller</li> <li>Connector for Novell GroupWise</li> <li>Microsoft Exchange Router for Novell GroupWise</li></ul> </li></ol>

back to top

Keywords: kb3rdparty kbconfig kbexpertiseadvanced kbhowtomaster KB899107

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.