home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SX4_1.ZIP / INSTALL.DOC < prev    next >
Text File  |  1992-05-13  |  12KB  |  293 lines
  1.  █████████████████████████████████████████████████████████████████████████████
  2.  █▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                             ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒█
  3.  █▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒  INSTALLATION INSTRUCTIONS  ▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒█
  4.  █▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                             ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒█
  5.  █████████████████████████████████████████████████████████████████████████████
  6.  
  7.  
  8.  
  9.  NOTE:  If you are  upgrading  from  an earlier  version  of Sapphire,  please
  10.         install  this copy  in a  separate directory  (and try it out,  if you
  11.         wish) then refer to  the upgrade section,  which appears later in this
  12.         document.
  13.  
  14.  
  15.                          
  16.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  17.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                                   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  18.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒     INSTALLATION ON HARD DISK     ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  19.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                                   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  20.  █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  21.  
  22.  
  23.  
  24.  ▀▀▀▀▀▀▀
  25.  STEP #1   Check your CONFIG.SYS
  26.  ▄▄▄▄▄▄▄
  27.  
  28.  
  29.  When you start up your computer,  it looks for a file named CONFIG.SYS in the
  30.  root directory of the boot drive (i.e. A: on a diskette-only system, or C: if
  31.  you have a hard disk).   This file contains information  about how the system
  32.  should run.
  33.  
  34.  CONFIG.SYS is a text file,  so you can edit it  (or create it, if it does not
  35.  already exist) using a text editor program such as DOS EDLIN,  a programmer's
  36.  editor, or a word processor in non-document (generic DOS text) mode.
  37.  
  38.  The CONFIG.SYS file should contain the following line:
  39.  
  40.    FILES=25
  41.  
  42.  If it does not, you should insert this on  a separate line,  starting in col-
  43.  umn one.   (If a higher value is shown, such as  FILES=30,  you can leave the
  44.  file the way it is.)
  45.  
  46.  For more information about this step,  see the explanations of CONFIG.SYS and
  47.  EDLIN in your DOS manual.
  48.  
  49.  If you found it necessary to create or change the file, restart your computer
  50.  so that it can read in the new values you have specified.
  51.  
  52.  
  53.  
  54.  ▀▀▀▀▀▀▀
  55.  STEP #2   Copy the files into their home directory.
  56.  ▄▄▄▄▄▄▄
  57.  
  58.  
  59.  IF YOU RECEIVED THE INSTALLATION DISK FROM  PINNACLE SOFTWARE,  you will have
  60.  already done this by inserting the diskette in the A: drive  and typing  A:GO
  61.  (or B:GO if you used the B: drive).
  62.  
  63.  IF YOU RECEIVED THE INSTALLATION DISK FROM SOMEONE ELSE,  you should copy all
  64.  the files on that disk into a directory on your hard disk -- preferably named
  65.  SAPPHIRE.  Read the label on the diskette carefully -- some shareware vendors
  66.  use Pinnacle Software's GO program, or something similar, to do the necessary
  67.  copying for you.
  68.  
  69.  ·············································································
  70.  AT THIS POINT,  ALL THE FILES SHOULD RESIDE IN A DIRECTORY  ON YOUR HARD DISK
  71.  ·············································································
  72.  
  73.  
  74.  
  75.  ▀▀▀▀▀▀▀
  76.  STEP #3   Try out Sapphire in demonstration mode.
  77.  ▄▄▄▄▄▄▄
  78.  
  79.  
  80.  At the DOS prompt, type SYSOP.  Then select the "DEMO" option.  This will run
  81.  Sapphire in demonstration mode.   When you are finished with Sapphire,  enter
  82.  the BYE or CLOSE command, either of which close down Sapphire when it is run-
  83.  ning in demonstration mode.
  84.  
  85.  If you run into problems, refer to the trouble-shooting guide,  available via
  86.  SYSOP:INFO:TROUBLE.  (Enter SYSOP at the DOS prompt, select INFO, then select
  87.  TROUBLE)
  88.  
  89.  
  90.  
  91.  ▀▀▀▀▀▀▀
  92.  STEP #4   Read the operations manual (basic topics) in SYSOP:INFO:MANUAL.
  93.  ▄▄▄▄▄▄▄
  94.  
  95.  
  96.  At the  DOS prompt, enter SYSOP.   Select INFO.   Select MANUAL.   You should
  97.  familiarize yourself with basic operations, such as signing on as sysop,  and
  98.  changing the sysop's password.
  99.  
  100.  
  101.  
  102.  ▀▀▀▀▀▀▀
  103.  STEP #5   Configure Sapphire, using SYSOP:CONFIG.
  104.  ▄▄▄▄▄▄▄
  105.  
  106.  
  107.  For this step, you will need your modem's user manual.
  108.  
  109.  At the DOS prompt, enter SYSOP.  Select CONFIG.  Go through all the items one
  110.  at a time.   If you don't understand any of the configuration items,  you can
  111.  press the F1 key to pop up a detailed explanation.
  112.  
  113.  
  114.  
  115.  ▀▀▀▀▀▀▀
  116.  STEP #6   Run Sapphire locally (SYSOP:LOCAL).
  117.  ▄▄▄▄▄▄▄
  118.  
  119.  At the  DOS prompt,  type SYSOP.   Select LOCAL.   This runs Sapphire without
  120.  referring to the  modem.  This lets you  check out  its basic operations  and
  121.  become more familiar with its commands  without  running into modem problems,
  122.  which are the most common source of difficulty for any new BBS.
  123.  
  124.  To sign on as sysop, press the spacebar to "wake up" the BBS.  When asked for
  125.  your name, press the spacebar,  then hit  Enter.   When asked for a password,
  126.  type "SYSOP".
  127.  
  128.  When you are finished, enter the CLOSE command to shut down Sapphire.
  129.  
  130.  
  131.  
  132.  ▀▀▀▀▀▀▀
  133.  STEP #7   Run Sapphire remotely (SYSOP:STANDARD).
  134.  ▄▄▄▄▄▄▄
  135.  
  136.  At the  DOS prompt, enter SYSOP.    Select STANDARD.    This runs Sapphire in
  137.  the standard mode, using the modem.  If you have any problems with the modem,
  138.  refer to the  trouble-shooting guide in SYSOP:INFO:TROUBLE.
  139.  
  140.  When Sapphire starts, you should see it having a brief dialog with the modem.
  141.  Once Sapphire displays  "Waiting for Visitor",  call in  using  another modem
  142.  and try signing up as a new user.
  143.  
  144.  When you are finished, press  ALT-X  while Sapphire is waiting for a visitor.
  145.  This will shut down Sapphire and reset the modem.
  146.  
  147.  
  148.  
  149.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  150.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                                   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  151.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒     INSTALLATION ON DISKETTES     ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  152.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                                   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  153.  █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  154.  
  155.  
  156.  
  157.  Earlier versions of Sapphire were designed  to allow a diskette-based system,
  158.  and this version retains the code written to support diskettes.  For example,
  159.  the  maximum length  of messages is  reduced  to allow you to store an entire
  160.  message base on  a 360K drive.   Also,  the file-transfer system is disabled,
  161.  since it would be  risky  to allow uploads  to diskettes -- they could easily
  162.  fill up the remaining space on the disk.
  163.  
  164.  Sapphire decides that it is running from diskettes if it sees A: or B: in the
  165.  paths of the configured directories, or if it finds itself (i.e. SRUN.EXE) on
  166.  the A: or B: drive.   You can  defeat  this behaviour by using the DOS ASSIGN
  167.  command (see your DOS manual for information about ASSIGN).
  168.  
  169.  Since there are now many different types of diskette drives, it is impractic-
  170.  tical to suggest one approach.   In general,  however,  you should  configure
  171.  your smallest drive as the "message drive".  (Remember that it must contain a
  172.  directory for the messages -- the root directory has a limit on the number of
  173.  files it can hold).   On your larger diskette drive,  put all of the Sapphire
  174.  files that you need, following these guidelines:
  175.  
  176.  
  177.  1.  All documentation files (*.DOC) can be removed.  This will disable the
  178.      INFO section of the SYSOP utility.  You can also remove the READ.ME and
  179.      READ.ME2 files.
  180.  
  181.  2.  The SYSOP.BAT and INFO.BAT files can be removed IF you understand
  182.      enough about batch files to follow what they were doing.  If you
  183.      remove them, you can also the following files:
  184.  
  185.      GO-MENU.EXE, SEE.EXE, SAPPFIVE.EXE, SOUND.EXE,
  186.      FNAMES.FIV, *.INC, SYSOP.MNU, INFO.MNU
  187.  
  188.      These files should be kept handy on a separate diskette, since they
  189.      contain much useful information.
  190.  
  191.      With SYSOP.BAT removed, you must run CONFIG.EXE directly from the
  192.      DOS prompt when you need to configure Sapphire.  You will also start
  193.      Sapphire directly from SAPPHIRE.BAT, as follows:
  194.  
  195.      Standard:  SAPPHIRE
  196.      Local:     SAPPHIRE LOCAL
  197.      Demo:      SAPPHIRE DEMO
  198.  
  199.  3.  Modem-testing software can be removed:  MODEM.EXE and TERM.BAT.  Keep
  200.      them handy, though, in case you have to call us for support.
  201.  
  202.  4.  Since file transfer is disabled on a diskette-based system, you can
  203.      removed DSZ.ARC and ARCE.COM.  If you have already installed the DSZ
  204.      archive, refer to the data file FNAMES.FIV for a list of the files it
  205.      contained.
  206.  
  207.  5.  Once you've got a registered copy of Sapphire, you can delete the files
  208.      ORDER.FRM and REGISTER.XXX.  Do NOT delete these files from an unregis-
  209.      tered copy; it will stop working.
  210.  
  211.  6.  As a last resort, if you are very short of space, you can remove the
  212.      GRA files (*.GRA).  This will mean that your system will look basically
  213.      the same whether or not a user turns graphics on or off.
  214.  
  215.  
  216.  
  217.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  218.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                                   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  219.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  UPGRADING FROM EARLIER VERSIONS  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  220.  █ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒                                   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █
  221.  █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  222.  
  223.  
  224.  
  225.  If you are upgrading from a Sapphire v4.xx,  refer to  SYSOP:INFO:HISTORY  to
  226.  determine what steps you need to take to get from your present version to the
  227.  current version.
  228.  
  229.  If you are upgrading from  Sapphire v3.x  or earlier  you will find that this
  230.  version is largely compatible.   To upgrade, follow the steps listed below.
  231.  
  232.  NOTE:  If you had  a registered version,  the upgrade will  NOT carry forward
  233.  your registration.  See the  order form  for  information  about our low-cost
  234.  upgrade policy.
  235.  
  236.  
  237.   1.  Install Sapphire in a new directory.  (See "Installation on a Hard Disk")
  238.  
  239.  
  240.   2.  Test-run it and make sure it functions properly.  Do not skip this step,
  241.       because it is needed to ensure that all directories are present.
  242.  
  243.  
  244.   3.  Copy the following files to the new directory:
  245.  
  246.                       NAME IN OLD   NAME IN NEW
  247.       FILE FUNCTION    DIRECTORY     DIRECTORY    COMMENTS
  248.       ─────────────   ───────────   ───────────   ─────────────────────
  249.       Messages        B*            Same          See Note #3.1
  250.       Upload files    *.*           Same          See Note #3.1
  251.       Activity        SACTI.DAT     SAPPHIRE.ACT
  252.       Control         SCTRL.DAT     SAPPHIRE.CTL
  253.       Message times   STIME.DAT     SAPPHIRE.MSG
  254.       Next message    SNEXT.DAT     SAPPHIRE.NXT
  255.       OBSERVE data    SSSYL.DAT     SAPPHIRE.LOG
  256.       Users           SUSER.DAT     SAPPHIRE.USR
  257.       Software        SSOFT.DAT     SAPPHIRE.SOF  See Note #3.2
  258.  
  259.       NOTE #3.1:  As an alternative to copying, you can point Sapphire at the
  260.       original directory, using SYSOP:CONFIG.
  261.  
  262.       NOTE #3.2:  SSOFT.DAT will be present only if you have installed the
  263.       file transfer system.
  264.  
  265.   4.  Copy your text files.
  266.  
  267.       Earlier versions of Sapphire had some text in external text files, such
  268.       as SHINT.TXT.  This text is now stored in the GRA and STD files.
  269.  
  270.                       NAME IN OLD   NAME IN NEW
  271.       FILE FUNCTION    DIRECTORY     DIRECTORY    COMMEMTS
  272.       ─────────────   ───────────   ───────────   ─────────────────────
  273.       Sign-on logo    SLOGO.TXT     LOGOXX.STD    See Note #4.1
  274.       New user info   SNEWH.TXT     NEWHXX.STD
  275.       INFO            SINFO.TXT     INFOXX.STD
  276.       GIMMICKS        SGIMM.TXT     GIMMXX.STD
  277.       HINTS           SHINT.TXT     HINTXX.STD
  278.       GET             SGETF.TXT     GETFXX.STD
  279.       GIVE            SGIVE.TXT     GIVEXX.STD
  280.  
  281.       NOTE #4.1:  In previous versions of Sapphire, you were able to put some
  282.       spare logos at the end of the SLOGO.TXT file.  This is not supported
  283.       in the LOGOXX.STD file, which must contain only the logo that will be
  284.       displayed when the user logs on.
  285.  
  286.   5.  (Optional)  Import your command levels file.
  287.  
  288.       The file COMMANDS.LEV is the same as the old SCMDL.DAT file, except that
  289.       it contains one new command:  BASES.  Copy over your old SCMDL.DAT file
  290.       as COMMANDS.LEV and use a text editor to insert the BASES command after
  291.       BANISH.
  292.  
  293.