HOW TO: Install the Sample Gateway in Exchange Development Kit (200669)



The information in this article applies to:

  • Microsoft Exchange Development Kit (EDK) 4.0
  • Microsoft Exchange Development Kit (EDK) 5.0
  • Microsoft Exchange Development Kit (EDK) 5.5

This article was previously published under Q200669

SUMMARY

This step-by-step article explains how to install the sample gateway once it has been built. The Exchange Development Kit (EDK) contains the files necessary to build the sample gateway.

back to the top

Requirements

This article assumes the following:
  • The Exchange server is installed to the directory C:\Exchsrvr.
  • You have built these programs found in the Platform SDK in subdirectories under \Samples\Dbmsg\Exchange:
    1. Proxygen.dll
    2. Sgwadmin.dll
    3. Gwsample.exe
    4. Xlatinst.exe
    5. Addrinst.exe
    6. Extninst.exe
    7. Gwinst.exe
    8. Servinst.exe
    9. Ipm_in.dll
    10. Ipm_out.dll
  • The Exchange server name is Server, the Exchange organization name is Organization, the Exchange site name is Site, the Windows NT domain name is Domain, the Exchange service account name is Exchange-Service-Account, and the password for the Exchange service account is Password.
  • You are logged into Windows NT as the Exchange-Service-Account.
back to the top

Steps to Install the Sample Gateway

  1. Make a directory named C:\Exchsrvr\Address\EDK\i386 and copy Proxygen.dll to that directory.
  2. Make a directory named C:\Exchsrvr\Add-ins\Sgw\i386 and copy Sgwadmin.dll to that directory.
  3. Make a directory named C:\Sgw\In.
  4. Make a directory named C:\Sgw\Out.
  5. Copy Gwsample.exe to C:\Sgw.
  6. Copy Ipm_in.dll and Ipm_out.dll to your \Winnt\System32 directory.
  7. Copy Msvcrtd.dll and Mfc42d.dll to your \Winnt\System32 directory. These files can be copied from your development computer to the Windows NT server that is going to run the gateway.
  8. Issue the following commands:

    Xlatinst.exe /dll=IPM_IN.DLL /CLASSES=ENVELOPE.IPM%REPORT.IPM /POINT=SAMPLEGW.INBOUND *NOTE: if you use this command in a batch file insert an additional % when defining the CLASSES; that is, /CLASSES=ENVELOPE.IPM%%REPORT.IPM Xlatinst.exe /dll=IPM_OUT.DLL /CLASSES=ENVELOPE.IPM%REPORT.IPM /POINT=SAMPLEGW.OUTBOUND *NOTE: if you use this command in a batch file insert an additional % when defining the CLASSES; that is, /CLASSES=ENVELOPE.IPM%%REPORT.IPM Addrinst.exe /sitedn=/o=Organization/ou=Site /name=edk /machine=i386 /type=edk /proxydll=\\Server\address\edk\i386\proxygen.dll /server=Server /gwproxy=EDK:@Site.Organization.com Extninst.exe /sitedn=/o=Organization/ou=Site /display_name="SGW EDK SAMPLE GATEWAY EXTENSION" /machine=i386 /name=SGW /extdll=\\Server\ADD-INS\SGW\i386\sgwadmin.dll /server=Server Gwinst.exe /sitedn=/o=Organization/ou=Site /display_name=SGW /name=SGW:i386 /addrtype=edk /server=Server /extname=sgw Servinst.exe /sitedn=/o=Organization/ou=Site /display_name=SGW /service=SGW /exe=c:\SGW\Gwsample.exe /server=Server /objname=SGW:i386 /objtype=gateway /account=Domain\Exchange-Service-Account /password=Password
  9. Run the Exchange Administrator program and configure properties of the sgw connector found on the Options tab. The Option tab for this article should have the following information filled in:
    Address Type: EDK
    Display Name: System Administrator
    Email Address: SysAdmin
    Messages to Process : select both Inbound and Outbound
                               INBOUND           OUTBOUND
    Threads                        4                4 
    Messages per Thread:           1                1
    Sleep per message:             0                0
    Polling Interval:        NOTIFICATION       NOTIFICATION
    Directory:                c:\sgw\in          c:\sgw\out
    Converter:             samplegw.inbound   samplegw.outbound
    						
    Start the SGW service in the Services Control Panel.
back to the top

Modification Type:MinorLast Reviewed:3/4/2004
Keywords:kbFAQ kbhowto kbHOWTOmaster kbMsg KB200669 kbAudDeveloper