home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / TG_309G2.ZIP / INSTALL.DOC < prev    next >
Text File  |  1998-07-05  |  17KB  |  333 lines
  1.  
  2.                   Telegard Bulletin Board Software, v3.10
  3.                          Installation Documentation
  4.  
  5.                    Copyright (C) 1995,1998 by Tim Strike
  6.                             All Rights Reserved.
  7.  
  8.  
  9.        INTRODUCTION
  10.        
  11.        Welcome to Telegard Bulletin Board Software, version 3.10.  This 
  12.        documentation contains quick instructions for installing Telegard 
  13.        for the first time, or for completing an upgrade from previous 
  14.        versions of the Telegard software.
  15.        
  16.        Please read README.DOC before continuing with this installation.
  17.  
  18.        Please follow these instructions very carefully.  The steps we have 
  19.        outlined are designed to ensure that you install our system with
  20.        minimal effort and with success the FIRST time!
  21.  
  22.        If you are upgrading from a previous version of Telegard, you should 
  23.        refer to the section titled "UPGRADE INSTRUCTIONS", otherwise if you 
  24.        are a first time user of Telegard, please follow the "NEW 
  25.        INSTALLATION" section.
  26.        
  27.         
  28.        SYSTEM REQUIREMENTS
  29.  
  30.        DOS (Telegard):
  31.           Memory                        440K minimum
  32.           Diskspace, installation       2 megs
  33.                      post-installation  1 meg + msgs + files + doors + data
  34.                      recommended        10+ megs at least
  35.           Fossil Driver (level 5)
  36.           Share/OS-equivalent (for multinode)
  37.  
  38.        OS/2 (Telegard/2):
  39.           Memory                        440K minimum
  40.           Diskspace, installation       2 megs
  41.                      post-installation  1 meg + msgs + files + doors + data
  42.                      recommended        10+ megs at least
  43.           SIO/compatible communications driver
  44.  
  45.  
  46.        TELEGARD/2 INSTALLATION NOTES
  47.  
  48.        Please note that this document references only DOS installation 
  49.        files; the Telegard/2 installation is identical, except please note 
  50.        the following:
  51.        
  52.                 INSTALL2.TWS  replaces INSTALL.TWS
  53.                 INSTALL2.EXE  replaces INSTALL.EXE
  54.                 TG2.EXE       replaces TELEGARD.EXE
  55.  
  56.                 ; both DOS and OS/2 utilities are included in Telegard/2 
  57.                 UPDATE2.EXE   may be used in place of UPDATE.EXE
  58.                 UNPACK2.EXE   may be used in place of UNPACK.EXE
  59.                 MAKLANG2.EXE  may be used in place of MAKELANG.EXE
  60.                 FA2FB2.EXE    may be used in place of FA2FB.EXE
  61.                 FB2FA2.EXE    may be used in place of FB2FA.EXE
  62.                 INDEX2.EXE    may be used in place of INDEX.EXE
  63.  
  64.        No other changes to the installation process are required.
  65.  
  66.  
  67.        NEW INSTALLATION
  68.  
  69.        1)  Create a new directory for your Telegard BBS
  70.  
  71.        2)  Copy INSTALL.* into your bbs directory
  72.  
  73.        3)  Run INSTALL.EXE from your bbs directory.  When prompted, enter 
  74.            the case-sensitive unarchiving password 'READYTOGO'.  This will 
  75.            extract the remaining installation files for your system.
  76.  
  77.        4)  Run TELEGARD.EXE from your bbs directory, which will start the 
  78.            installation process.  It will ask you a few simple questions 
  79.            regarding the placement of the remaining data files.  For 
  80.            security reasons, you should consider configuring these 
  81.            directories in such a manner that the directory structure is not 
  82.            obvious (i.e. do not use /DATA/ as your data directory).
  83.  
  84.            The installation process will build the desired directory 
  85.            structure, unpack the enclosed data files, and create any other
  86.            data files which are needed for BBS installation.  In addition,
  87.            the installation process will attempt to build and compile your
  88.            index and language files automatically (errors will be noted; if 
  89.            errors exist, you can run the command line utilities instead).
  90.  
  91.        5)  Run "TELEGARD -?" to familiarize yourself with the commands 
  92.            available from the command line.
  93.  
  94.        6)  Run "TELEGARD -L" to load the BBS locally -- Hit "ESC" for the
  95.            menu commands available -- Use the System Configuration and
  96.            System Manager commands to setup the remainder of your BBS
  97.            system (remember to change the information in the first user
  98.            record to your OWN personal information!).
  99.  
  100.        7)  You may delete INSTALL.EXE and *.TWS after the installation has 
  101.            been completed.  These files are only temporary installation 
  102.            files and are not used in the general operation of the BBS.  You 
  103.            should save a copy of the original archive (TG_nnn@n.ZIP) in 
  104.            case you want or need to reinstall the software at a later date.
  105.  
  106.            You can also delete the UPDATE.EXE file, which is only used if
  107.            updating from a previous version of Telegard.
  108.  
  109.        8)  Remember to read /docs/faq.doc at some point in the near future.
  110.  
  111.        NOTE: You will need to install a fossil driver before you can use 
  112.        Telegard remotely (for Telegard/2, you will need a SIO compatible 
  113.        communications driver).  A fossil or communications driver should 
  114.        likely be available on a local BBS.
  115.  
  116.  
  117.        UPGRADING INSTRUCTIONS
  118.  
  119.        We don't have any upgrade instructions for any versions of Telegard
  120.        prior to 3.02.  If you are upgrading from Telegard 2.7, or from one
  121.        of the (expired) gamma releases (2.99.x), or old final releases 
  122.        (3.0/3.01), then please get the TG_302.ZIP package and update your 
  123.        system to 3.02 before continuing the upgrade to 3.10.
  124.  
  125.        TELEGARD 3.09 GAMMA 1 UPGRADING INSTRUCTIONS
  126.  
  127.        If you are still using 3.02, you may upgrade by following the 3.02
  128.        instructions found later in this document.
  129.  
  130.        1)  Make a backup of your BBS configuration/data files (your data,
  131.            language, menu and text folders), your file section data files
  132.            (*.FB?, *.FSI) and your message section data files (*.MSI),
  133.            and the main Telegard executables.  A thorough backup is your 
  134.            best defense. 
  135.  
  136.        2)  Copy INSTALL.* into your bbs directory
  137.  
  138.        3)  Run INSTALL.EXE from your bbs directory.  When prompted, enter 
  139.            the case-sensitive unarchiving password 'READYTOGO'.  This will 
  140.            extract the remaining installation files for your system.
  141.  
  142.        4)  Create a folder (directory) off your main BBS directory called
  143.            /docs/.  You can remove /notes/ at your leisure.
  144.  
  145.        5)  You should then run UNPACK for each of the .TWS files in order
  146.            to update the data files that are in use on the system.  To do
  147.            this type "UNPACK <filename> <location>" at the DOS command 
  148.            prompt, without the quotes, replacing <filename> with the .TWS
  149.            filename and <location> with the directory for the unpacking.
  150.            
  151.            Say NO to extract new/non-existant files.  You want to replace
  152.            some files which already exist; saying NO will ensure that you
  153.            can do that.
  154.  
  155.            For existing files, UNPACK lists current (C=xx) and new (N=xx) 
  156.            file dates for comparison. If the file dates are different, then 
  157.            the line is highlighted in YELLOW.
  158.                 
  159.            If you say YES to overwrite the file, the NEW file (the one in 
  160.            the .TWS archive) will be extracted over the current file.  
  161.            NOTE: The file in the archive is not necessarily newer then the 
  162.            file on disk.  Files which have not changed from 3.02 are listed 
  163.            with a file time of 3:02a.
  164.  
  165.                FILENAME        LOCATION                  OVERWRITE?
  166.                docs.tws        /docs/ directory             yes
  167.                defaults.tws    data directory               yes*1 
  168.                language.tws    languages directory          yes*2
  169.                bin.tws         main bbs directory           yes
  170.                bin2.tws        main bbs directory           yes*3
  171.                text.tws        default text directory       no*4
  172.                menus.tws       default menus directory      no*5
  173.         
  174.            *1 overwrite TELEGARD.* files, MENUS.DAT and HARDWARE.DAT files.
  175.            *2 overwrite ENGLISH.TXT if you desire (this will wipe out any 
  176.               changes that you did to your language file)
  177.            *3 Telegard/2 installation only
  178.            *4 several of the scripts have changed, as have some of the
  179.               standard text files; you might want to update these as you
  180.               desire (replace DOORFILE.SCR, for instance)
  181.            *5 several of the menus have changed cosmetically, only the
  182.               new menus are required
  183.               
  184.        6)  Completely review /docs/WHATSNEW.G2 for all changes, and then 
  185.            return to these installation instructions.
  186.  
  187.        7)  Run UPDATE.EXE from the main BBS directory.  Select version 
  188.            3.09.g1 (option 8) and the let the utility update your data 
  189.            files--which will update new fields, create new files, and 
  190.            convert old files to their new format.  In case of error, 
  191.            restore from your backup, report the error and abort the upgrade 
  192.            {for now}.
  193.  
  194.        8)  Run "INDEX BUILD ALL" to update and correct your files.
  195.  
  196.        9)  Review /docs/LANGUAGE.G2 for instructions on updating your 
  197.            language files.  Remember to update -all- your languages.  If 
  198.            you replaced your language with the default ENGLISH.TXT in step 
  199.            5 and you only use ENGLISH, you are already done.
  200.        
  201.        10) From your main bbs directory run "MAKELANG .\LANGUAGE\ENGLISH"
  202.            to compile your new language file (Note: Replace \LANGUAGE\ with
  203.            your correct language path).  Repeat as neccessary for each of
  204.            your remaining languages.
  205.  
  206.        11) Review the new configuration options to ensure that your system 
  207.            is setup the way that you desire.  For more information on these 
  208.            options, refer to /docs/WHATSNEW.G2.
  209.  
  210.        12) You may delete INSTALL.EXE and *.TWS after the upgrade has 
  211.            been completed, and UPDATE.EXE after it has been run (step 6).
  212.  
  213.        13) Remember to read /docs/FAQ.DOC at some point in the near future.
  214.  
  215.  
  216.        TELEGARD 3.02 RELEASE UPGRADING INSTRUCTIONS
  217.        
  218.        1)  Make a backup of your BBS configuration/data files (your data,
  219.            language, menu and text folders), your file section data files
  220.            (*.FB?, *.FSI) and your message section data files (*.MSI),
  221.            and the main Telegard executables.  A thorough backup is your 
  222.            best defense. 
  223.  
  224.        2)  Copy INSTALL.* into your bbs directory
  225.  
  226.        3)  Run INSTALL.EXE from your bbs directory.  When prompted, enter 
  227.            the case-sensitive unarchiving password 'READYTOGO'.  This will 
  228.            extract the remaining installation files for your system.
  229.  
  230.        4)  Create a folder (directory) off your main BBS directory called
  231.            /docs/.  You can remove /notes/ at your leisure.
  232.  
  233.        5)  You should then run UNPACK for each of the .TWS files in order
  234.            to update the data files that are in use on the system.  To do
  235.            this type "UNPACK <filename> <location>" at the DOS command 
  236.            prompt, without the quotes, replacing <filename> with the .TWS
  237.            filename and <location> with the directory for the unpacking.
  238.            
  239.            Say NO to extract new/non-existant files.  You want to replace
  240.            some files which already exist; saying NO will ensure that you
  241.            can do that.
  242.  
  243.            For existing files, UNPACK lists current (C=xx) and new (N=xx) 
  244.            file dates for comparison. If the file dates are different, then 
  245.            the line is highlighted in YELLOW.
  246.                 
  247.            If you say YES to overwrite the file, the NEW file (the one in 
  248.            the .TWS archive) will be extracted over the current file.  
  249.            NOTE: The file in the archive is not necessarily newer then the 
  250.            file on disk.  Files which have not changed from 3.02 are listed 
  251.            with a file time of 3:02a.
  252.  
  253.                FILENAME        LOCATION                  OVERWRITE?
  254.                docs.tws        /docs/ directory             yes
  255.                defaults.tws    data directory               yes*1 
  256.                language.tws    languages directory          yes*2
  257.                bin.tws         main bbs directory           yes
  258.                bin2.tws        main bbs directory           yes*3
  259.                text.tws        default text directory       no*4
  260.                menus.tws       default menus directory      no*5
  261.         
  262.            *1 overwrite TELEGARD.* files, MENUS.DAT and HARDWARE.DAT files.
  263.            *2 overwrite ENGLISH.TXT if you desire (this will wipe out any 
  264.               changes that you did to your language file)
  265.            *3 Telegard/2 installation only
  266.            *4 several of the scripts have changed, as have some of the
  267.               standard text files; you might want to update these as you
  268.               desire (replace DOORFILE.SCR, for instance)
  269.            *5 several of the menus have changed cosmetically, only the
  270.               new menus are required
  271.               
  272.        6)  Completely review /docs/WHATSNEW.* for all changes, and then 
  273.            return to these installation instructions.
  274.  
  275.        7)  Run UPDATE.EXE from the main BBS directory.  Select version 3.02 
  276.            and the let the utility update your data files--which will 
  277.            update new fields, create new files, and convert old files to 
  278.            their new format.  In case of error, restore from your backup,
  279.            report the error and abort the upgrade {for now}.
  280.  
  281.            A disk cache is extremely helpful in the upgrade process, which 
  282.            may take anywhere from several seconds to many minutes, 
  283.            depending on how many message and file areas, and how many users
  284.            you have, how big your history file is, etc.  Please be patient,
  285.            the update utility will inform you have it's progress.
  286.  
  287.        8)  Run FB2FA.EXE from the main BBS directory to convert your old
  288.            file section to the new file section.  This will take several
  289.            minutes as well.
  290.  
  291.        9)  Run "INDEX BUILD ALL" to update your files and to create the new 
  292.            index formats (QFILES.IDX, among others).
  293.  
  294.        10) Review /docs/LANGUAGE.G1 and /docs/LANGUAGE.G2 for instructions 
  295.            on updating your language files.  Remember to update -all- your 
  296.            languages. If you replaced your language with the default 
  297.            ENGLISH.TXT in step 5 and you only use ENGLISH, you are done.
  298.        
  299.        11) From your main bbs directory run "MAKELANG .\LANGUAGE\ENGLISH"
  300.            to compile your new language file (Note: Replace \LANGUAGE\ with
  301.            your correct language path).  Repeat as neccessary for each of
  302.            your remaining languages.
  303.  
  304.        12) Several new menus were added in step 5: NEWUSERV, MSGREAD,
  305.            FILETAGP, WFCQFILE, WFCQMSG.  Review these menus as you see fit-
  306.            I do not suggest any changes until you have updated your entire
  307.            system and it has been running in a stable environment for a few
  308.            days.
  309.        
  310.        13) Update your ACS strings (menus, msg & file areas, access control
  311.            items in msg & file configuration) to reflect the new Ixxx ACS
  312.            (which changed from I00-nnnn to Innnn).   If you have doors 
  313.            which still expect the old format, then use I00-~UU instead of
  314.            just ~UU.  Please read OTHER section of /docs/WHATSNEW.G1 for 
  315.            further information.
  316.  
  317.        14) DOOR.SYS file format was changed; your doors will not likely 
  318.            work correctly if they use the DOOR.SYS format.  You have to 
  319.            edit your users' door records to reflect their real name instead 
  320.            of handle in the door configuration, or you must use the 
  321.            OLDDOORS script.  YOU HAVE BEEN WARNED!  Please read DOORS 
  322.            section of /docs/WHATSNEW.G1 for further information.
  323.            
  324.        15) Review the new configuration options to ensure that your system
  325.            is setup the way that you desire.  For more information on these
  326.            options, refer to /docs/WHATSNEW.G1 and /docs/WHATSNEW.G2.
  327.  
  328.        16) You may delete INSTALL.* and *.TWS after the upgrade has 
  329.            been completed, and UPDATE.EXE after it has been run (step 6).
  330.  
  331.        17) Remember to read /docs/FAQ.DOC at some point in the near future.
  332.  
  333.