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.