home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / TELECOM / RCIS_2_3_demo.lzh / DOCS / install.txt < prev    next >
Text File  |  1993-11-21  |  10KB  |  294 lines
  1.                   BBS Installation Instructions  
  2.  
  3.                    V.1.0/OSK  (For RCIS V.2.1 - 2.3)
  4.  
  5.                      (c)1993 Steve Rottinger
  6.                        All rights reserved
  7.                       Last updated: 11/21/93
  8.  
  9.  
  10. The following is a list of steps required to install the RCIS BBS
  11. software in its minimal configuration.  Please see sysop.txt and
  12. RCIS man pages for more detailed explanations of the the various
  13. commands and features.
  14.  
  15.  
  16. 1)   Ensure that the nil device driver is in your boot file
  17.  
  18. 2)   Replace your w8 window descriptor with log, which can be found
  19.      in the BOOTMODS directory. 
  20.  
  21. 3)   Make sure that you have a /dd (default drive) descriptor for
  22.      your main hard drive. If you don't already have one, you will
  23.      need to create one, or rename an existing hard drive descriptor
  24.      to dd.
  25.  
  26. 4)   Copy all of the files and directories from the BBS package
  27.      to your main hard drive.  You can run rcp, or a similar utility 
  28.      on each floppy, to do this. If you received the BBS package
  29.      archived, you simply need to unarchive it in your main directory. 
  30.           If you decide to use rcp, assuming that you want to
  31.      copy all the files on /d0 to /dd, the command would be:
  32.  
  33.      rcp /d0 /dd
  34.  
  35. 5)   Modify your startup file so that it does the following
  36.      things:
  37.  
  38.      - Sets up and initalizes /log window
  39.  
  40.      - loads incoming, constat, conmod, read, filelist, msglist
  41.  
  42.      - adds /dd/rciscmds to the PATH environment variable
  43.      
  44.      - for example, you might add the following lines:
  45.  
  46.      iniz /log ; display 1b 32 f 1b 33 0 1b 34 d c>/log 
  47.      load constat incoming  conmod read filelist msglist
  48.  
  49.      a sample startup file has been included for you to examine.
  50.      Its also a good idea to set the default settings on all of
  51.      your windows to the way you want them.  This can be done
  52.      with wmode. The chat program will open the next available
  53.      window with its default settings, if a user pages you.
  54.  
  55. 6)   Reboot your system so that the changes you made to the
  56.      os9boot file take effect, the log window gets created, and
  57.      the various modules get loaded.
  58.  
  59. 7)   Modify /dd/sys/localinfo using EDIT or a similar text editor.
  60.      A sample localinfo file has been provided to give you an idea 
  61.      of its format:
  62.  
  63. NODE_NAME PHONE# PASSWORD CITY/STATE SYSOP_NAME
  64.  
  65. Each of the fields are separated with a signal space, and none of
  66. the fields should contain spaces. The description of each field
  67. is as follows:
  68.  
  69. NODE_NAME : RCISNet site name. This field should be no more than
  70. 15 characters long, and should only contain uppercase characters
  71. and underscores. If you don't have a registered RCISNet node
  72. name. Chose any name that best reflects the name of your BBS, and
  73. fits the described criteria.
  74.  
  75. PHONE# : Self-expanatory. Enter your country code (if out of US),
  76. area code, prefix, suffix.
  77.  
  78. PASSWORD: Enter a password here 8 chars or less. This is used for
  79. RCISNet transfers
  80.           
  81. CITY/ST: Enter your City and state changing spaces to underscores
  82.  
  83. SYSOP_NAME: Real name of SysOp, no spaces
  84.  
  85.  
  86. 8)   Create /dd/datafiles/lprefix. This file is used for
  87.      auto-callback validation. The first line should your area
  88.      code. The remaining lines contain the local prefixes for
  89.      your area, one per line. A listing of local prefixes for
  90.      can be found in the phone book.
  91.  
  92.      Note: If there is more than one area code in your local calling
  93.      area, you can start the information for the new area code by
  94.      placing "---" after the end of the information for the previous
  95.      area code:
  96.  
  97.  
  98.      AREA_CODE1
  99.      prefix1
  100.      prefix2
  101.      ...
  102.      prefix(n)
  103.      ---
  104.      AREA_CODE2
  105.      prefix1
  106.      prefix2
  107.      ....
  108.      prefix(n)
  109.  
  110.  
  111.  9)  Adjust your modem for either dumb or smart mode.
  112.  
  113.      "dumb" requires the following modem settings:
  114.  
  115.      -Echo should be off
  116.      -Result codes should be off
  117.      -Carrier status must be normal
  118.      -Modem should reset when DTR goes off
  119.      -Auto-Answer must be on
  120.  
  121.      Your modem can be set up this way by sending it the
  122.      following commands:
  123.  
  124.      ATQ1E0&C1&D3&W
  125.      ATS0=1
  126.  
  127.      "smart" requires these settings:
  128.  
  129.      -Echo should be off
  130.      -Numeric result codes must be sent
  131.      -Carrier status must be normal
  132.      -Modem should reset when DTR goes off
  133.      -Auto-Answer must be on
  134.  
  135.      To set your modem this with, use the following commands:
  136.  
  137.      ATX1V0Q0E0&C1&D3&W
  138.      ATS0=1
  139.  
  140.  
  141.      14.4Kbps operation: 
  142.  
  143.          For use with a 14.4Kbps modem, you must use "smart" mode
  144.      along with the following additional settings:
  145.  
  146.      -Modem to Computer baud rate must remain constant.
  147.      -Modem should send connection speed, as well as carrier speed
  148.       after establishing a connection.
  149.  
  150.      use the following command:
  151.  
  152.      ATW1N1X4V0Q0E0&C1&D3&W
  153.  
  154.  
  155. 10)  Execute the shell script /dd/cocopal. Since RCIS was originally
  156.      developed for the CoCo, colors used within the BBS, and within
  157.      many BBS utilities use the default CoCo color set. Until some
  158.      kind of facility can be written to easily switch between the
  159.      two color sets, cocopal must be used to adjust the default
  160.      colors of the MM/1 to those of the CoCo.
  161.  
  162. 11)  Execute SysOp from an 80 column window. Enter the requested
  163.      information for the status file. Don't worry if you don't set
  164.      up everything correctly the first time around; you can go back
  165.      and fix the settings later.
  166.  
  167. 12)  Exit the SysOp utility by selecting option 6.
  168.  
  169. 13)  Execute the BBS by typing: rcis [enter]
  170.  
  171. 14)  Sign yourself on as a new user. Avoid using "sysop" as a
  172.      handle, since it will confuse things if you decide to
  173.      join a network in the future. 
  174.      You should use the name you entered in the status file, for
  175.      the SysOp's name, as your handle. Ignore any errors that
  176.      might occur, and answer no to Auto-call back verification.
  177.  
  178. 15)  Logoff the BBS with "G".
  179.  
  180. 16)  run sysop, and use option 1 to change your access level to
  181.      250, and upgrade your time limit.
  182.  
  183. 17)  Use option 5 to set your first voting topic.
  184.  
  185. 18)  Use option 4 to make all of your SIGs.
  186.      Most of the menus are self-explanitory. Ignore SIG type,
  187.      Usenet MSG#, first message, and last message. Those fields
  188.      are either used by the system or for netmail.
  189.      
  190.      The SIG name must be a valid OS-9 file name (no spaces, or
  191.      special chars except for _ and .)     
  192.  
  193.      The message limit is used to adjust the amount of messages
  194.      you wish to allow the SIG to grow to. Once that limit has
  195.      been reached, each time a new message is posted, the oldest
  196.      one will be deleted.
  197.  
  198.      The Access requirement allows you to require a certain
  199.      security level for a user to access that SIG. If the user's
  200.      access level matches or is greater than the access
  201.      requirement, the user will be permitted entry to that SIG.
  202.  
  203. 19)  Use option 2 to add all of the file sections. You can add
  204.      file sections to any of the SIGs that you just created.
  205.      Again, the menus are mostly self-explanitory. The size limit
  206.      refers to the size, in bytes that file section is permitted to
  207.      grow to. Total size, is the current size of the file section.
  208.      The directory name must be a valid OS-9 filename.
  209.  
  210. 20)  Add tsmon to your startup file. Tsmon is a program that
  211.      operates in the background, and is used to connect the BBS
  212.      with your modems.  It waits for an incomming call, detects
  213.      the baud rate; then runs "rcis".
  214.  
  215.      Tsmon has a couple of switches that need some mentioning:
  216.  
  217.      -f  Fast mode. In this mode, TSMon will not adjust the CPU
  218.          to computer baud rate.  The baud rate the port is currently
  219.          set for will be used.
  220.  
  221.      -p  Pulse mode.  Use this switch, if the modem is on a Pulse
  222.          dialing only line.
  223.  
  224.      add the following line to your startup, substituting port for
  225.      the name of your modem port, and {opts} for the options, as
  226.      described above:
  227.  
  228.      tsmon /port {opts}&
  229.  
  230.      For each modem you have, you will need to run a tsmon on the
  231.      corresponding port. So far, a maximum of two modems per
  232.      computer has been tried. While the BBS software will handle
  233.      up to 32 users; the total amount of users you will be able
  234.      to handle depends entirely on your hardware.
  235.  
  236. 21)  Create /dd/sys/crontab. Crontab contains a list of scheduled
  237.      events, and at what time they occur. This file is read by
  238.      rcron. The format of this file is as follows:
  239.      
  240. B MN HH DY MH DW command
  241.  
  242. B - Just place this before each line. This is here for further
  243.     expansion of rcron.
  244.  
  245. MN - Minute
  246.  
  247. HH - Hour (24 hour format)
  248.  
  249. DY - Day
  250.  
  251. MH - Month (1-12)
  252.  
  253. DW - Day of week (0-6) 0=Sunday
  254.  
  255. Any of the time fields can contain an "*" this acts as a
  256. don't-care.
  257.  
  258. The line:
  259. B 03 00 01 * * arcup
  260.  
  261. tells rcron to execute arcup in the background at 12:30, on the
  262. first day of each month.
  263. Be sure to examine the sample crontab that was included.
  264.  
  265. The following maintenance utilities should be included in your
  266. crontab:
  267.  
  268. arclog - run once a day. Archives the callerlog for the day
  269. arcup  - run once a month. Archives the upload list for the month
  270. crunchmb - run once a day. Necessary maintenance for message bases
  271. optmsg /dd/mail - run once a week. Cleans mail section
  272.  
  273. 22)  Place the line: rcron& in your startup file
  274.  
  275. 23)  Make sure your clock is set correctly at all times. The BBS
  276.      is very dependant upon the system time. It uses the system
  277.      time for determining when to start different events, and
  278.      what messages are new. Especially if your system is part of
  279.      a network, if the time isn't correct, duplicate messages
  280.      could be sent.  A hardware clock is strongly recommended. If
  281.      you need to execute a command to update the software clock
  282.      from the hardware clock every once in a while, you can place
  283.      that command in /dd/sys/clockup.
  284.  
  285. 24)  Create /dd/datafiles/loginprogs. Loginprogs is a one line
  286.      file that gets sent to a shell every time a user logs
  287.      on. Its useful for displaying the users online,
  288.      bulletins,etc. A sample loginprogs has been included.
  289.  
  290.  
  291. This completes the installation process. Be sure to read sysop.txt,
  292. and the RCIS MAN pages for more details on BBS operation.
  293.  
  294.