Installing the Sample Gateway

If you are installing the sample gateway for the first time, or if you have changed any of the files listed here since your previous installation, you need to create a new GWSETUP.INF file before proceeding. Files referenced in GWSETUP.INF are:

• EDKADT.HLP
• GWPERF.DLL
• GWSAMPLE.EXE
• IPM_IN.DLL
• IPM_OUT.DLL
• PROXYGEN.DLL
• SGWADMIN.DLL
• SGWADMIN.HLP

    To create the GWSETUP.INF file

1. Change to the \BKOFFICE\SAMPLES\EXCHANGE\GWSETUP directory.
2. Type the following command:

   NMAKE - F GWSETUP.MAK

   This process uses the default settings for the BLDTYPE and TARGETDIR environment variables unless you manually change them. You can view the environment variables by typing SET at the command prompt.

You can install the sample gateway either by using the GWSETUP.EXE program to automatically install all the gateway components, or by installing individual gateway components. See Installation Programs for information on how to install components.

The gateway setup program GWSETUP.EXE performs the following actions:

• Obtains information about the gateway environment and the Mail-Gateway object.
• Installs the Admin-Extension object for the gateway.
• Installs the Addr-Type object associated with the gateway.
• Copies the necessary files to the server.
• Creates the gateway site proxy address for the address type.
• Creates proxy addresses of the new address type for existing recipients in the Microsoft Exchange Server directory.
• Installs the Mail-Gateway object in the directory.
• Rebuilds the gateway address routing table (GWART).
• Installs the message conversion DLLs used by the gateway.
• Installs performance monitoring counters for the gateway service. (Note that GWSETUP.EXE only loads the counters; it doesn't actually install the performance monitor.)

These functions are discussed in Writing the Setup Program.

    To install the sample gateway using GWSETUP

1. Select Sample Gateway Setup in the Microsoft Exchange Server SDK program group

– Or –

Change to the command prompt and run SETUP.EXE from the \BKOFFICE\BIN\GWSETUP directory.

2. Click Continue.
3. Click Install.
4. In the Choose Server dialog box, enter the name of the computer running Microsoft Exchange Server on which you want to install the gateway, and click Continue.
5. In the Choose Site dialog box, select the site name for the gateway (for example, /o=Microsoft/ou=site) and click Continue.
6. In the Directory Display Name field of the Install dialog box, type the name of the gateway to be used by the Microsoft Exchange Server Administrator program (for example, samplegw).
7. In the Service Display Name field, enter the name to be displayed for the gateway when it is listed as a service. This name can be the same as the Directory Display Name.
8. For Service Account, enter the Windows NT Server account that has been created for the gateway. The account must have "Log On as Service" rights. This should be specified as domain\account (for example, operations\gwuser).
9. For Service Password, enter the password for the Windows NT Server account.
10. For Service Directory, enter the directory for the gateway executable file, including the drive name. (C:\GW is the default directory.)
11. Click Continue.

The setup program performs the following tasks:

• Creates a directory with the path and name specified as Service Directory in step 10 above.
• Copies the gateway's executable file, GWSAMPLE.EXE, to the service directory.
• Creates two subdirectories, IN and OUT, under the service directory. The sample gateway uses these subdirectories for message processing.
• Displays a message when the gateway object is installed.

You can verify that the gateway object is installed by looking in the Connections container inside the Microsoft Exchange Administrator program for the gateway name. This is the Directory Display Name entered in step 6 above. If the gateway name is not there, click Refresh on the Window menu in the Administrator program. The name should then appear.

The sample gateway uses the account and password information entered in steps 8 and 9 above. After the gateway service is installed, its associated account information can be changed through the Windows NT service control manager.