
     W...W
     W.W.W
     .W.W.

     WaterGate
     Message processor for FidoNet & Internet/Usenet
     Upgrade Instructions

     (c) Copyright 1993-1997 Waterline Software Development
                             All Rights Reserved

6 July 1997,

This file describes the procedure to upgrade WaterGate from older
versions to the latest version.

If you are installing from scratch, then extract MANUALS.ZIP and
read MANUAL.TXT for instructions on how to extract the manuals.
Then continue reading those for detailed installation instructions.


The most important thing about upgrading is getting the database
(*.TDB) files compatible with the latest format. The UPGRADE.EXE
program in this archive that takes care of upgrading all older
formats to the latest.

One files not touched by UPGRADE.EXE are the ASCII configuration
file ROUTE.TDB. The changes to this file are very specific and
you need to read the upgrade instructions (these) that come with each
release to make sure you do not miss anything important, especially
if you are upgrading from a somewhat older version.

When upgrading, you do not just want to get ready to run the new
executables. It is important that you become aware of what has
changed in the new version. All the changes are detailed in the
CHANGES.DOC file. Read that file!

Upgrading is rather simple:

1) Backup all executables, databases (the *.TDB files) and the batch
   files that run WaterGate (basically your WaterGate system
   directory).

2) replace all the executable files: WTRGATE.EXE, WTRCONF.EXE,
   WTRUTIL.EXE, WTRSTAT.EXE, WTRTEST.EXE and, if you are using these,
   WTRGATEO.EXE, WTRGATEO.OVR or WTRGATED.EXE.

3) Run the UPGRADE.EXE program to upgrade your database files. Notice
   that you have to use the command line option NOW or nothing will
   happen.

4) Copy the changes from the new language file, or replace it
   completely. This is especially important if you have customized
   it for a local language. See below for details.

5) Edit the ROUTE.TDB file according to the details below.

Here are the details for upgrading 0.92 to 0.93:

- The format of the BOUNCE and BOUNCEFROM statements has changed. You
  have to add an astriks at the start of a statement to make sure it
  triggers on all occurances of the search string in the e-mail
  address. For example: BOUNCEFROM savetrees.com "JUNK MAIL!"
  doesn't work anymore. Instead, change it to:
  BOUNCEFROM *savetree.com "JUNK MAIL!".
  A better example is this one: BOUNCE test@my.domain "Reason: test"
  which would trigger on "mytest@my.domain" as well. This no longer
  happens, unless you add the astriks before "test".

- The group structure has changed. You will find the old area in which
  new areas are created automatically in the new group F1. You can move
  these areas and the definition for it to group Z1 via WtrConf,
  Group Definitions, function key F2. The manual has more details on
  how to move groups (separate chapter about groups).

That is all! Start with WtrConf and check that it accepts the upgraded
database file. Get familiar with the new system menu structure and the
new Link Definitions and then do some test runs with WtrGate.
                                                             
Good luck,

Ramon

ramon@wsd.wline.se
ramon.winkel@ex1.ecs.ericsson.se
