-------------------------------------------------
               ! ! ! ! ! ! ! ! UPGRADE NOTES ! ! ! ! ! ! ! ! 
             -------------------------------------------------

Note: The dates referred to below are with respect to the date printed by
texis -version, not necessarily the date you received Texis or Webinator.
You should pay attention to all notes from the date of your existing
texis -version through the date of your new texis -version.

-------------------------------------------------------------------------------
August 2001:

  Webinator 4 databases are not compatible with Webinator 2 databases.
You may continue to use your Webinator 2 search script and database
with the Texis that comes with Webinator 4, but you should read the
upgrade notes below.  Webinator 4 scripts will not work with the old
databases.  Walk(s) will have to be redone to new database(s).
Webinator 4 has an option to import settings from Webinator 2
databases.  The Webinator 2 "gw" program is included with Webinator 4
for those familiar with Webinator 2. gw will probably not be developed
further.  The Webinator 4 scripts cannot be run by the old texis that
came with Webinator 2. Webinator 4 requires Texis released after Nov 1 2001.

- - - - Installing Webinator 4 with a pre-existing Texis Installation - - - -

  The preferred solution is to have only one copy of Webinator or
Texis installed on a machine, since Texis includes and supercedes
Webinator.  However, it may be possible in some circumstances to
install in parallel with a pre-existing Texis installation.  This
should be attempted only for temporary or beta testing purposes,
and not on a production server.

  To install in parallel, choose an alternate installation directory
when prompted during the install.  Also choose to not replace your
CGI's texis if so prompted: Webinator 4 will then install "texis-tmp"
in your CGI directory, leaving the live "texis" alone.  When done
testing, "texis-tmp" should be removed.

-------------------------------------------------------------------------------
June 2001:

  SYSINDEX has a new field added.  The new field is needed for some
newer features in Texis.  The database monitor can automatically
upgrade the SYSINDEX table in any databases, which will mean they will
no longer be usable by older versions of Texis.  The automatic
conversion can be enabled by adding the following to the texis.cnf
file:

[Monitor]
Upgrade SYSTEM tables = 60;

The default value is 0, which will not upgrade SYSINDEX.

-------------------------------------------------------------------------------
February 2001:

  The lock structure in Texis has been expanded to allow for more
connections to the database.  This has made the lock structure
incompatible.  You will need to stop all Texis processes, and remove
the lock structure before starting the new database.  On NT the lock
structure removal is automatic once the last process exits.  On most
Unix systems there is a file called SYSLOCKS in the database
directory, which you can remove once all processes have stopped
accessing it.  On the remaining Unix systems you will use "rmlocks -f"
to remove the locks, as the last thing you do with the old version.

-------------------------------------------------------------------------------
November 1999:

New Metamorph index format

  If you are upgrading from a version of Texis prior to November 1999,
new versions create a new format of Metamorph indexes.  New releases
will use and upgrade old Metamorph indexes automatically; you do not
need to do anything.

  However, if you update or create a Metamorph index with the new
release, _and_ then attempt to use an old (pre-November 1999) release
with that database, errors and index corruption may result.  No table
data will be lost, but you will have to drop and re-make the indexes.
Again, this is only if you fall back to an older release after using a
new release.

-------------------------------------------------------------------------------
July 1998:

  If you are upgrading from an older version of texis (prior to July
1998) you will need to rebuild all of your metamorph indices.  The
script called mm2new (included on the CD) will help with this.  Once
you create new indices with the new version, older versions of the
software will not be able to use them.

Usage is:
    texis db=database [tbl=table] [inverted=yes] [create=yes] mm2new

Where:
   "db"       specifies the database to work on.
   "tbl"      specifies that only indices belonging to "table" should
              be rebuilt. Otherwise all metamorph indices are rebuilt.
   "inverted" specifies whether to create the new indices with the new
              fully inverted metamorph index type. It uses more space but
              provides faster searches. Without this, non-inverted
              indices will be created.
   "create"   specifies to actually rebuild the indices. Without
              this, it will just display the SQL commands it
              would execute.

-------------------------------------------------------------------------------