home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / onlipub2.zip / RAPUPGR.DOC < prev    next >
Text File  |  1996-10-16  |  6KB  |  114 lines
  1. How to Upgrade RAP v1.82/v1.82a to TOP v2.00
  2. --------------------------------------------
  3.  
  4.     This file describers how to upgrade The RemoteAccess Pub v1.82 or v1.82a to
  5. The Online Pub v2.00.  Users upgrading from TOP v2.00g1 should obtain the
  6. uprade package of TOP from the author's BBS instead.
  7.  
  8.     If you have not changed your action file, and do not want to keep your old
  9. RAP user file, you can delete RAP completely and follow the new installation
  10. instructions in TOP.DOC.
  11.  
  12.     It is important that you follow EACH instruction in order to complete the
  13. upgrade successully!  NOTE:  If you are planning to use the OS/2 version of
  14. TOP, these instructions still apply!  The OS/2 version is completely compatible
  15. with the DOS version, so you can still use your old files!
  16.  
  17.     1) Backup RAP.KEY (if you're registered), USERS.RAP and ACTIONS.RAP.  Make
  18. sure you've got an archived copy of RAP 1.82/1.82a around, just in case the
  19. gamma proves problematic.
  20.  
  21.     2) Delete NODE????.RAP, MIDX???.RAP, and CHGIDX.RAP from your RAP Work
  22. Path.  You can run DELTEMP.BAT from RAP 1.82/1.82a to do this.
  23.  
  24. *** At this point you are advised to DELETE your RAP directory, create a new
  25. TOP directory, and unpack the beta version into this directory.  A lot of files
  26. used by RAP have either been renamed for TOP, or are unused altogether.  Thus,
  27. your directory for RAP may get rather cluttered.  Furthermore, making a new
  28. directly will help to prevent confusion as to which files belong to which
  29. version (RAP or TOP).  After reunpacking the archive, move onto the next step.
  30.  
  31.     3) Copy the backups that you made in step 1 back to the TOP directory.  Be
  32. sure to keep the backups around in case problems arise.  Then rename USERS.RAP
  33. to USERS.TOP.  Also, if you are registered and have a RAP.KEY file, rename it
  34. to TOP.KEY.
  35.  
  36.     4) Edit the included file TOP.CFG (yes, there finally is a configuration
  37. file!) to suit your own setup.  TOP.CFG is a plain ASCII file, and is fully
  38. "comment-documented".  You should make a backup of TOP.CFG and keep it around
  39. in case you make a mistake or want to refer back to it.
  40.  
  41.     5) Edit the included file NODES.CFG to suit your node setup.  Like TOP.CFG,
  42. NODES.CFG is a plain ASCII file and is self-documented with comments.  You
  43. should also keep a backup of NODES.CFG around in case you ever need one.
  44.  
  45.     6) From the same directory as USERS.TOP, run 2G1TO200.EXE.  This program
  46. will search for any personal actions which do not have the %m token in their
  47. singular and plural text and insert it at the front of the action, as well as
  48. change the action response to inform the user the action has been altered.  The
  49. requirement of the %m token is necessary because without %m, users can use
  50. personal actions to perform rather mean and nasty tricks on other users (eg.
  51. impersonation, fake system messages, etc.)  This requirement is hardcoded into
  52. TOP as well.
  53.  
  54.     7) Create a subdirectory for the *.ASC, *.ANS, and *.AVT files to be kept
  55. in.  This is not required, but it keeps the TOP directory cleaner.  Next,
  56. unpack ALLANSI.ARJ into this directory.  Finally, be sure to update the
  57. TOPANSIPath setting in TOP.CFG so it uses the directory created in this step.
  58.  
  59.     8) To upgrade your action file, type the following command into DOS:
  60.  
  61. COPY __ACTHDR.TXT + ACTIONS.RAP MAIN.ACT
  62.  
  63.     This will prefix your old action file (ACTIONS.RAP) with some new
  64. information that is required by TOP.  It will also rename the file to the
  65. proper convention.  The new file should look exactly like your old ACTIONS.RAP
  66. file with five new lines of information at the top, and no blank lines anywhere
  67. in the file.  After verifiying that MAIN.ACT was copied successfully, you
  68. can delete ACTIONS.RAP.  To complete the upgrade, enter this command into DOS:
  69.  
  70. TOPACT MAIN
  71.  
  72.     This will compile your new action file so that TOP can use it.  If TOPACT
  73. reports that the file did not compile successfully, retry this step.  If you
  74. still have problems, then review the section on "Actions" in TOP.DOC and see if
  75. you can correct the problem.  If that doesn't work, edit the "ActionFiles"
  76. setting in TOP.CFG so that no files are listed, and contact the author at your
  77. earliest opportunity.
  78.  
  79.     9) If you wish, you can edit the files CHANNELS.CFG, BIOQUES.CFG, and
  80. CENSOR.CFG to your needs, although changing these files is not required to
  81. complete the upgrade.  These files are all ASCII files and comment-documented
  82. like TOP.CFG is.  If you edit these files, keep a backup of the originals!
  83.  
  84.    10) Edit your existing BBS batch files to reflect these changes:
  85.         a) the new TOP directory instead of the old RAP one.
  86.         b) the TOP.EXE command line, which now only takes the node as a
  87.            parameter. If your system has a TASK environment variable that
  88.            contains the node number in decimal format, then you don't need the
  89.            node number on the command line (though it's recommended you put it
  90.            there anyhow).
  91.  
  92.    11) If you are upgrading to the OS/2 version of TOP, copy the included file
  93. DRS2V5B3.DLL to any directory on your OS/2 LIBPATH.  The recommended location
  94. for this file is the \OS2\DLL directory on your OS/2 boot partition.  If you
  95. are upgrading to the Win95 version of TOP, copy the included ODOORS60.DLL to
  96. your Windows SYSTEM path.  You can delete the .DLL file from the TOP directory
  97. after copying it.
  98.  
  99.   11a) If you are upgrading to TOP for Win95 you will also need to perform the
  100. steps described in TOPWIN95.DOC before proceeding.
  101.  
  102.   11b) If you are upgrading to TOP for OS/2 and plan to use TOP's Maximus/2
  103. v3.0x support, please see MAXOS2V3.DOC before proceeding.
  104.  
  105.    12) Give it a try!  Logon to your BBS and run TOP as any other user normally
  106. would.  This will ensure that your batch files work, and that the BBS will
  107. interact with TOP properly.
  108.  
  109.    13) Be sure to read TOP.DOC for important information, including:
  110.         - Detailed information on features and configuration.
  111.         - How to contact the author to report problems/suggestions.
  112.  
  113.     Thank you for trying TOP!
  114.