SMTP Gateway for Windows NT
---------------------------

First, the legalese:

THE SOFTWARE IS PROVIDED TO YOU "AS IS" WITHOUT WARRANTY OF ANY KIND, 
EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.  
YOU ASSUME THE ENTIRE RISK AS TO THE ACCURACY AND THE USE OF THE SOFTWARE.  
MICROSOFT SHALL NOT BE LIABLE FOR ANY DAMAGES WHATSOEVER ARISING OUT OF 
THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF MICROSOFT HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The SMTP Gateway for Windows NT is a Windows NT service which can be used to
transfer mail between a Microsoft Mail postoffice and an SMTP host.  Only one
post office and gateway is required to service all mailboxes of that post
office. Only one post office is needed to provide mail boxes for a network
of connected Microsoft mail clients.

The SMTP gateway does not intelligently route mail, instead forwarding all
outgoing messages to a designated router host. It also refuses to accept
incoming mail not destined for mailboxes present on the local post office.

Requirements:

To use this SMTP Gateway, you must have:
*       An Intel version of the Windows NT operating system.
*       An upgraded or stand-alone Microsoft Mail postoffice.  The gateway
	code WILL NOT work with the default workgroup post office. Microsoft
	part # 068-499-300 can be used to upgrade the post office.
*       The TCP/IP service installed and correctly configured on a Windows NT
	machine that hosts the post office, or can see the post office via a
	network share.
*       A TCP/IP connected host that will generate/accept SMTP connections
	to/from the Windows NT machine containing the gateway

Installation:

On a network of Windows NT machines with NO POSTOFFICE yet installed:
*       Designate one Windows NT machine as the post office. 
*       Run MAIL (msmail32.exe), and choose to Create a new post office when
	prompted - You will be sharing the WGPO directory among your
	workgroup of Windows NT machines. You may wish to create the post
	office on a separate partition of your hard disk. (In this example,
	we'll be putting the post office on a computer named PISMO on drive
	M). In our example, the post office will be called post1.
*       Share the post office directory among the Windows NT workgroup by 
	using the file manager or the command NET SHARE WGPO=M:\
*       Make sure that the other Windows NT machines can mount the shared
	directory via the file manager or via NET USE M:=\\PISMO\WGPO
	When setting up mail clients on the other Windows NT workstations,
	make sure the Tools Options Server information is set to use the 
	common post office on drive M:
*       Continue with directions below:


On a network of Windows NT machines already set up with a workgroup post
office:
*       Upgrade the post office to a full stand-alone configuration using
	Microsoft part # 068-499-300 (Mail and Schedule+ Extensions) or
	equivalent.
*       ALL ADMINISTRATION OF THE POST OFFICE ONCE UPGRADED MUST BE DONE
	WITH THE UTILITIES SUPPLIED BY THE UPGRADE PACKAGE. (Note: We have had
	one report that administrative changes to add users and create new
	groups are not visible to clients when the admin utilities are run
	under Windows NT, but are unable to reproduce this bug thus far. If
	you run into this problem and have a DOS machine available on your
	network, you can run the admin utilities from there as a work-around.)
*       Continue with "Install the SMTP gateway software" below.

On a network of Windows NT and DOS machines already set up with a full DOS
post office and dedicated DOS machine running Microsoft's SMTP Gateway for
DOS:
*       Remove the DOS gateway using the installation program included in
	your DOS Gateway package.
*       Continue with "Install the SMTP gateway software" below.

Install the SMTP gateway software:

The SMTP gateway for Windows NT package consists of 6 files:

SMTPGATE.TXT  -- ASCII version of this file
SMTPGATE.DOC -- this file
INSTALL.EXE -- the installation program
GATEWAY.EXE -- the gateway service itself
SMTPPUT.EXE -- a utility program called by the gateway
SMTPGET.EXE -- a utility program called by the gateway

Copy all of these files into your post office directory (in our example, M:\
on the machine named PISMO), and run INSTALL.EXE with two parameters: the
TCP/IP hostname of the mail post office, and the IP address of the SMTP mail
router host.  For our example, PISMO is the hostname, and the SMTP mail host
IP address is 192.9.0.4.
	INSTALL pismo.microsoft.com 192.9.0.4

The installation program will modify several of the existing post office data
files, and call the NT Service Manager to add the gateway to the current
control set.

NOTE:
If your Windows NT machine that is running the gateway software is known by
multiple names (such as pismo.microsoft.com AND pismo), add an entry to the
file M:\SMTP\ADDR_MAP.CFG:

Windows/post1 pismo.microsoft.com
Windows/post1 pismo <-added entry

Lines in this file have the format of
<POST OFFICE NETWORK NAME>/<POST OFFICE NAME> <SPACE><SMTP MAIL NAME>


*       Start the gateway service using the Services applet in the Control 
	Panel -- select "SMTP Gateway" and click on the "Start" button. You
	can also, at this time, set the gateway to automatically start up at
	boot time through the "Startup..." dialog.

	Startup Parameters are also accepted by the gateway through the 
	Services applet. The following parameters are supported:

	-Clevel         Logging levels, where level is: i=info, w=warning, 
							e=error, n=none
	-Fm, -Ff, -Fr   From address extraction: m = SMTP "MAIL FROM" line
						 f = From: header
						 r = Reply-To: header
			(m is the default)
	-Lgroups        Logging groups: c=network courier s=smtp y=system
					a=address n=none
	-MR             Logging to RECV summary file
	-MS             Logging to SENT summary file
	-Osize          Limit to size of outgoing mail (default=0, which is
							no limit)
	-Qtime          Timeout before failing when trying to connect to
			router (default=180)
	-RE             Disable encapsulation
	-RR             Generate Rr: header for registered mail
	-T              Retain trace headers on incoming mail
	-U              Disable automatic uudecode
	-Wtime          Seconds between polling for outbound messages 
			(default=300)

*       Logging information can be found in the LOG directory under the post
	office main directory.


