LEGENDS(tm) Upgrade Guide
Addendum to Sysop Handbook, Chapter II
Authored by Jeffrey D. Hoffman.  Copyright(c) 1996.  All rights reserved.

This file contains the documentation for installing each upgrade of LEGENDS
as they have been released.

Upgrading 7.x software to 7.3

Installing the latest version of LEGENDS over your game in-progress is very
simple.  The following steps will guide you through the upgrade process.

1.  Make a back-up of your existing LEGENDS 7.x software.  In the event that
    anything goes wrong, you always want to ability to backstep a version and
    start over.

2.  Copy and extract the LEGEND73.ZIP file into the directory containing your
    existing LEGENDS software.  Be sure to use the overwrite flag (-o) when you
    extract the software.  This flag will insure that any existing files for
    the installation will be updated to the most recent release.

C:\> cd \tbbs\legends7
C:\TBBS\LEGENDS7> pkunzip -o legend73.zip

3.  Type INSTALL7.EXE -U to initiate the installation program.  The appended
    flag -u forces the installation program to upgrade existing software in the
    directory without interfering with the existing game in-progress.

C:\TBBS\LEGENDS7> install7 -u

4.  The upgrade will take several moments.  If you are using software earlier
    than 7.22, there will be two or more stages to the upgrade.  These upgrades
    alter the existing files according to the history of the upgrades. When the
    upgrade is complete you will be returned to the DOS prompt.

5.  The upgrade modifies your existing SYSTEMS\LEGENDS7.CFG file.  Your
    original configuration file has been saved as SYSTEMS\LEGENDS7.ORG.  You
    can use this .ORG file as reference to modify the new LEGENDS7.CFG file.
    Furthermore, the EXAMPLES\RESET.L and WORLDSLC\RESET.LC files have been
    modified.  Similar .ORG files are located in the directory with each file.

*IF* you were running 7.22 software prior to the installation, your task is now
done.  You can run your BBS because LEGENDS 7.3 has been successfully
installed.  If you were running any earlier version, you may need to consult
the following instructions for handling earlier upgrades.

6.  Make a back-up of your existing LEGENDS 7.x software.  In the event that
    anything goes wrong, you always want to ability to backstep a version and
    start over.

7.  Copy and extract the LGNDS721.ZIP file into the directory containing your
    existing LEGENDS software.  Be sure to use the overwrite flag (-o) when you
    extract the software.  This flag will insure that any existing files for
    the installation will be updated to the most recent release.

C:\> cd \tbbs\legends7
C:\TBBS\LEGENDS7> pkunzip -o lgnds721.zip

8.  Type INSTALL7.EXE -U to initiate the installation program.  The appended
    flag -u forces the installation program to upgrade existing software in the
    directory without interfering with the existing game in-progress.

C:\TBBS\LEGENDS7> install7 -u

9.  The upgrade will take several moments.  If you are using software earlier
    than 7.1, there will be two stages to the upgrade - the first upgrades from
    7.0 to 7.1, the second then upgrades 7.1 to 7.2.  When the upgrade is
    complete you will be returned to the DOS prompt.

*IF* you were running 7.1 software prior to the installation, your task is now
done.  You can run your BBS as LEGENDS 7.2 has been successfully installed.  If
you were running LEGENDS 7.0 prior to the install, you need to perform the
following steps that were created by the 7.0 to 7.1 upgrade.

10. The installation program creates new configuration files but saves your
    original settings as .ORG files.  Within the LEGENDS SYSTEMS\ directory you
    will find LEGENDS7.ORG.  Use this file to assist you (as reference) to
    configure LEGENDS 7.1 to your needs.  Notice that several new flags are
    available to customize LEGENDS.  Refer to the Sysop Handbook for more
    information.

11. You need to modify the existing LegendTASK ghost event in your TBBS
    configuration.  Using CEDIT, modify your specified ghost task(s) for the
    new information required by the ghost event.  The SYSTEMS\LGNDTASK.CFG file
    contains all of the settings for each ghost event you define.  Consult
    chapter III in the Sysop Handbook for further details.

Entry  #, Occurs on Line   16 at 07:00 on Sun,Mon,Tue,Wed,Thu,Fri,Sat
Type = 200 OptData = c:\tbbs\legends7\lgndtask.tpg /Q && /E=1

    This setting would instruct the LegendTASK event to use the flags specified
    under #DEFINE EVENT1= in the configuration file.

12. Your AUTOEXEC.BAT file needs to be updated with a single line.  This line
    is required to make the executable LegendTASK maintenance software work
    properly.

set clipper=f99

    Be sure to either run your AUTOEXEC.BAT file or reset your system prior to
    running the LegendTASK software.

13. The final step to getting LEGENDS up and running is to add the external
    maintenance executable to your daily TBBS maintenance routine.  Somewhere
    within your maintenance file, you need to add the following lines of code.
    Again, these settings are covered in detail in the Sysop Handbook, Chapter
    III, but for this example each daily the maintenance software will purge
    inactive players after twenty- five days.

rem Perform the daily LEGENDS maintenance by running the executable version of
rem LegendTASK.
cd \tbbs\legends7
lgndtask.exe -a:25

14. Run your BBS.

Further information for customizing your LEGENDS software is available by
reading chapter III in the Sysop Handbook.  If you haven't already, please
refer to the WHATSNEW.TXT file for a listing of new features and bugfixes in
this, the latest version of the software.
