home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / bbss10b2.zip / DOC / B&BSETUP.TX8 < prev    next >
Text File  |  1994-02-28  |  7KB  |  190 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. The Bits & Bytes Bulletin Board System/2
  8.  
  9.  
  10.  
  11. B&BSYS/2
  12.  
  13.  
  14.  
  15.  Version 1.0ß1
  16.  
  17.  
  18.  
  19. By Terje Flaar¢nning
  20.  
  21.  
  22.  
  23. SETUP.DOC
  24.  
  25.  
  26.  
  27. By Stian Seeberg
  28.  
  29.  
  30.  
  31.  
  32. 16.02.94
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51. Table of contents:
  52.  
  53. Welcome to B&BSYS/2    1
  54. What you need to set up B&BSYS/2    1
  55. First time installation    2
  56. Unpacking the distribution files    2
  57. Running SETUP.CMD    3
  58. First time startup    3
  59.  
  60.  
  61.  
  62. Welcome to B&BSYS/2
  63. ==================
  64. You are about to set up one of the easiest, yet most advanced BBS-systems for OS/2. It is 
  65. based on a database-structure so advanced other much larger systems can only aspire to 
  66. compete with it! There is almost no limit as to how large your BBS can become. 
  67.  
  68. What you need to set up B&BSYS/2
  69. ==========================
  70. Obviously you will need a computer (running OS/2 2.1 or better). This computer will need to 
  71. meet the minimum hardware requirements for running OS/2, that being a 386 with 6MB of 
  72. RAM. However we feel that for any kind of performance a 486sx with 6MB of RAM is the 
  73. minimum. In addition a modem is required, and it should support Hayes ⌐ AT-commands. The 
  74. speed of the modem is something that you will have to adress, but the UNREGISTRED version 
  75. of B&BSYS/2 only supports speeds up to 9600 BPS. And last but not least you will need 
  76. B&BSYS/2......
  77.  
  78. First time installation
  79. ===============
  80. This will cover unpacking the datafiles and setting up the system for the very first time.
  81.  
  82. Unpacking the distribution files
  83. --------------------------------------
  84. The program itself comes in the ZIP-files B&BS10ß1.ZIP and B&BN10ß1.ZIP. These files 
  85. contain the system files, and the Norwegian language files. These will have to be unzipped 
  86. using PkWare's PkUnzip, InfoZip's UnZip or a compatible utility into a subdirectory (default is 
  87. d:\BBS, where "d" is the drive letter). It is very important that the files be UnZipped WITH 
  88. THE DIRECTORY STRUCTURE INTACT! This is accomploshed with the "-d" swich in 
  89. PkWare's PkUnzip, and is default in InfoZip's UnZip. The following directories are stored in the 
  90. *.ZIP-files, and will be created on your HardDrive:
  91.  
  92. b&broot\API
  93. b&broot\BULLETS
  94. b&broot\MENUS
  95. b&broot\SCRIPTS
  96.  
  97. b&broot is the Drive-letter and Subdirectory you place B&BSYS/2's files in. It is usually 
  98. "C:\BBS", but can be changed if you wish. 
  99.  
  100. The API subdirectory contains the datastructures, and API interface for application 
  101. programmers.  
  102.  
  103. The BULLETS subdirectory contains the Bulletins that are supplied with B&BSYS/2, and is 
  104. alse where you will place other bulletins and files that you create (this will be covered later in 
  105. this document)
  106.  
  107. The MENUS subdirectory contains the Menu's that are supplied with B&BSYS/2. These 
  108. should not be modified! Any modifications will be made by the author and the files will be 
  109. made available to all users in a ZIP-file.
  110.  
  111. The SCRIPTS subdirectory contains the scripts that are supplied with B&BSYS/2, and is 
  112. where your own scripts should be placed. For information on creating scripts see 
  113. SYSOP.DOC!
  114.  
  115. Besides these subdirectories there are a few that are created in the SETUP process. These 
  116. subdirectories are:
  117.  
  118. b&broot\MAIN og
  119. b&broot\MAIN\AREA
  120. b&broot\TEMP.xxx
  121. b&broot\UPLOADS
  122.  
  123. The MAIN and MAIN\AREA subdirectories contain all the datafiles that are necessary to run 
  124. the system. None of these files should be tampered with! A copy of all the files in this directory-
  125. tree, and the file B&BSYS.CFG found in b&broot should be made. If any of these files 
  126. become corrupted all the files in this backup must be restored! For more information on this see 
  127. SYSOP.DOC.
  128.  
  129. The TEMP.xxx subdirectories represent the temprary storage area for the nodes on your BBS. 
  130. The letters "xxx" represent a number from "000" to "999", depending on the number of nodes 
  131. in your BBS. The system will automatically create TEMP.000 and TEMP.001, as the 
  132. B&BSYS/2 ShareWare version only supports 2 nodes, one Local, and one eksternal node! 
  133. These can be placed on a RAM-disk if you have one, and the procedure for that is discussed in 
  134. SYSOP.DOC.
  135.  
  136. The UPLOADS subdirectory is the default upload directory for B&BSYS/2. This can be 
  137. changed from within B&BSYS/2, but that is discussed in SYSOP.DOC.
  138.  
  139. Now that you have unpacked the files, and understand what subdirectories are created and why, 
  140. you are ready to begin installation of B&BSYS/2!
  141.  
  142. Running SETUP.CMD
  143. =================
  144. Your next task will be to run the OS/2 command file SETUP.CMD. This is done from the 
  145. OS/2 commandline, and the only paramaters are your HardDrive letters. It might look 
  146. something like this:
  147. [C:\BBS] SETUP.CMD CDE
  148.  
  149. Where CDE are the drives C, D and E if they are present on your system. Setup will then set 
  150. up the system, searching the entire computer for the necessary programs (communication 
  151. protocols and archivers). If B&BSYS/2 finds any of the following they will be autodetected, 
  152. and set up with the appropriate configuration:
  153.  
  154. DSZ.EXE     (or *.COM) which is a file that includes the common X, Y and Zmodem     
  155.         protocols.
  156. HSLINK.EXE which is a bi-directional file transfer protocol
  157. ZIP.EXE     which is InfoZip's ZIP utility (completely compatible with PK's popular ZIP-
  158.         utility,     but made for OS/2)
  159. UNZIP.EXE    Which is InfoZip's UnZip (companion to ZIP.EXE)
  160. ARJ.EXE    The popular DOS archiver doesn't have an OS/2 counterpart, so the DOS     
  161.         version is used.
  162. LHA.EXE    This is also a DOS archiver, and is often preferred by Amiga⌐ users. It also 
  163.         lacks an OS/2 version.
  164.  
  165. If for any reason these files are not detected, or do not reside on your system at the time of 
  166. running SETUP.CMD they can be added later. Please note that although you may use 
  167. PkWare's PkUnzip to unzip the distribution files it is not used by B&BSYS/2. For your BBS to 
  168. have ZIP/UNZIP available you will have to aquire InfoZip's ZIP/UNZIP or a fully compatible 
  169. OS/2 utility. If you use a compatible utility the files MUST be named ZIP.EXE and 
  170. UNZIP.EXE! 
  171.  
  172. First time startup
  173. ============
  174. The first time you start your new BBS you will need to run the file BBS.CMD, which is found 
  175. in the b&broot. BBS.CMD should be run with only one parameter, and that being the node 
  176. number. Node 0 is the default Local Node, and so the system should be started with the 
  177. command:
  178.  
  179. [C:\BBS] BBS.CMD 0
  180.  
  181. When you are prompted for a username use "Sysop Sysop", and specify your personal logon 
  182. password. You have now entered the BBS!  You may wish to og to the Utilities menu to 
  183. change your name on the system (which at this time is "Sysop Sysop") to match your real 
  184. name. The utilities menu can be reached by typing UTilities (only the capital letters need to be 
  185. typed), and then chosing Name. You will then see the current username "Sysop Sysop", and 
  186. can change it to your name, pressing ENTER when done. You are now ready to configure your 
  187. BBS. For detailed information on the Configuration of B&BSYS/2 you should read 
  188. SYSOP.DOC, which is a detailed description of the system and all commands that are 
  189. available!
  190.