home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / hamradio / nosvw304.zip / !!README.1ST next >
Text File  |  1993-01-25  |  9KB  |  280 lines
  1. ============                                        NOSview [304]
  2. !!README.1ST
  3. ============
  4.  
  5. ------------
  6. INTRODUCTION
  7. ------------
  8. NOSview is an on-line documentation and runtime package for the
  9. KA9Q Network Operating System (NOS).
  10.  
  11. This is version [304]; that is, it was released in:
  12.                  |||
  13.   year 199[3]----+||
  14.                   ||
  15.     week [04]-----++
  16.  
  17. This README file describes how to install the package.
  18.  
  19.  
  20. --------------------------
  21. NOSview [304] Distribution
  22. --------------------------
  23. This version of NOSview comprises the following ZIP files:
  24.  
  25. NOSVIEW.ZIP    Brief intro to NOSview
  26.                Contains:  !WELCOME.TXT
  27.  
  28. NOSVW304.ZIP   The main NOSview [304] distribution
  29.                Contains:  !!README.1ST
  30.                           NOSGAS.ZIP    (remaining NOSview files)
  31.  
  32.  
  33. --------------------
  34. NOSVIEW INSTALLATION
  35. --------------------
  36. -------------
  37. Preliminaries
  38. -------------
  39. Hardware Requirements:  80x86 machine with at least 640 KB RAM
  40.                         2 MB hard disk storage.
  41. Software Prerequisites: DOS version 3 or later, or
  42.                         DR-DOS version 6 or later.
  43.  
  44. Before installation, you need to decide where to put the NOSview
  45. package.  You can locate it in any subdirectory on your system.
  46. In this distribution, the default NOS root directory is C:\NOS.
  47.  
  48.  
  49. *****  When NOS is running, other users may log into your system
  50. and browse through your files, from the NOS root level downwards.
  51. For this reason it's strongly recommended that you do NOT choose
  52. C:\ as the NOS root, or any other existing directory containing
  53. sensitive files.
  54.  
  55. *****  The installation process doesn't at any time read or alter
  56. your AUTOEXEC.BAT and CONFIG.SYS files.  However, after
  57. installing NOSview, you will need to make minor additions to
  58. these files and reboot the system before running NOS.
  59.  
  60. ------------
  61. Installation
  62. ------------
  63.  
  64. The installation process is very simple.  In the description that
  65. follows, the NOS root is shown as "c:\nos".  Replace this with
  66. your chosen NOS root directory if you're not using the default.
  67.  
  68. Also, it is assumed that the NOSview distribution files are
  69. located on a diskette in drive a:.  Replace "a:" with the
  70. appropriate drive letter if you're using a different drive.
  71.  
  72. The installation process doesn't write anything to the diskette,
  73. so you can safely make it read-only.
  74.  
  75. First you create a new directory for the NOS root (e.g. c:\nos),
  76. CD into this directory and unzip NOSVW304.ZIP into it.  This will
  77. give you two files in the NOS root directory:  !!README.1ST (this
  78. file) and NOSGAS.ZIP.
  79.  
  80. You will then unzip NOSGAS.ZIP to extract the NOSview
  81. distribution.
  82.  
  83. To do all of this, give the following DOS commands:
  84.  
  85.   --------------------------------------------------------------
  86.    MKDIR c:\nos                  Make the NOS root directory
  87.    CD c:\nos                     Go to the NOS root directory
  88.    PKUNZIP a:\NOSVW304.ZIP       Get the NOSGAS zip file
  89.    PKUNZIP -D NOSGAS.ZIP         Unzip the NOS "Get-away Special"
  90.                             *** DON'T FORGET THE "-D" OPTION **
  91.    DEL *.ZIP
  92.   --------------------------------------------------------------
  93.  
  94. !!!!!!  The second unzip operation uses the -D option, which
  95.         automatically creates all the necessary subdirectories as
  96.         it goes along.  DON'T FORGET THE -D OPTION, OTHERWISE ALL
  97.         THE FILES WILL FINISH UP IN THE NOS ROOT DIRECTORY -- you
  98.         will then have to delete all the files and start again.
  99.  
  100. After completing the unzipping, you will find files in the
  101. following directories:
  102.  
  103.    c:\nos\
  104.    c:\nos\DUMP\
  105.    c:\nos\DUMP\RECORD\
  106.    c:\nos\DUMP\TRACE\
  107.    c:\nos\ETC\
  108.    c:\nos\ETC\LPD\
  109.    c:\nos\FINGER\
  110.    c:\nos\PUBLIC\
  111.    c:\nos\PUBLIC\MASTERS\
  112.    c:\nos\PUBLIC\NOSDOCS\
  113.    c:\nos\PUBLIC\NOSVIEW\
  114.    C;\nos\SCRIPTS\
  115.    c:\nos\SPOOL\
  116.    c:\nos\SPOOL\HELP\
  117.    c:\nos\SPOOL\LPD\
  118.    c:\nos\SPOOL\MAIL\
  119.    c:\nos\SPOOL\MQUEUE\
  120.    c:\nos\SPOOL\NEWS\
  121.    c:\nos\SPOOL\RQUEUE\
  122.    c:\nos\SPOOL\SIGNATUR\
  123.    c:\nos\TMP\
  124.  
  125. Some of these directories contain a dummy file called
  126. DEADBEEF.000.  These files are included to make PKUNZIP create
  127. what would otherwise be empty directories.  You may safely delete
  128. all DEADBEEF.000 files after installation.  (Why "DEADBEEF" you
  129. may ask?  Well, it turns out that a very well-known software
  130. development company uses the hexadecimal number "0xdeadbeef" when
  131. initialising registers to a "don't care" value, so it seemed that
  132. "DEADBEEF" would be a good name for dummy files.  Ah well ....).
  133.  
  134. For a complete directory tree listing, see the NOSview file
  135. !DIRTREE.
  136.  
  137. -----------------------------------
  138. Editing AUTOEXEC.BAT and CONFIG.SYS
  139. -----------------------------------
  140. Having unzipped NOSGAS.ZIP, you need to edit AUTOEXEC.BAT and
  141. CONFIG.SYS before running NOSview.
  142.  
  143. In the case of AUTOEXEC.BAT, all you need to do is add this line
  144. at the end of the file:
  145.  
  146.   --------------------------------------------------------------
  147.   CALL c:\nos\NOSENV.BAT
  148.   --------------------------------------------------------------
  149.  
  150. In the case of CONFIG.SYS, you need to add a SHELL statement and
  151. a LASTDRIVE statement:
  152.  
  153.   --------------------------------------------------------------
  154.   SHELL=C:\COMMAND.COM /E:1024 /P
  155.   LASTDRIVE=Z
  156.   --------------------------------------------------------------
  157.  
  158. If you have installed NOSview in the default NOS root directory
  159. C:\NOS, you can skip the next section.
  160.  
  161. ---------------------
  162. Changing the NOS root
  163. ---------------------
  164. If you did NOT install NOSview in the default NOS root directory,
  165. you must now make a few small changes to three files, to ensure
  166. that the correct NOS environment is set up at runtime.
  167.  
  168. For example, if you located NOSview in "e:\comms\nos", you need
  169. to make the following changes.
  170.  
  171.  
  172. In C:\AUTOEXEC.BAT, make the CALL to NOSENV.BAT look like this:
  173.   --------------------------------------------------------------
  174.   CALL e:\comms\nos\NOSENV.BAT
  175.   --------------------------------------------------------------
  176.  
  177.  
  178. In e:\comms\nos\NOSENV.BAT, change these lines:
  179.   --------------------------------------------------------------
  180.   SUBST N: e:\comms\nos
  181.  
  182.   SUBST M: e:\comms\nos\SPOOL\MAIL
  183.   SUBST Q: e:\comms\nos\SPOOL\MQUEUE
  184.   SUBST R: e:\comms\nos\DUMP\RECORD
  185.   SUBST T: e:\comms\nos\DUMP\TRACE
  186.   SUBST V: e:\comms\nos\PUBLIC\NOSVIEW
  187.  
  188.   SET HOME=e:\comms\nos
  189.   --------------------------------------------------------------
  190.  
  191.  
  192. In e:\comms\nos\PCELM.RC, change these lines:
  193.   --------------------------------------------------------------
  194.   smtp e:/comms/nos/spool/mail
  195.  
  196.   queuedir e:/comms/nos/spool/mqueue
  197.   --------------------------------------------------------------
  198.   (Note the FORWARD slashes here).
  199.  
  200.  
  201. ---------------------
  202. Optional Installation
  203. ---------------------
  204. Before starting NOSview, there is an additional step you might
  205. wish to take.  The three main NOSview directories (MASTERS,
  206. NOSDOCS and NOSVIEW) are located in the public directory
  207. c:\nos\PUBLIC, so that users logging in to your system can
  208. browse through the files located there.  To prevent people
  209. accidentally or deliberately changing these files, it's
  210. recommended that you set the read-only attribute:
  211.  
  212.   --------------------------------------------------------------
  213.    CD c:\nos\PUBLIC
  214.    ATTRIB +R MASTERS\*.*
  215.    ATTRIB +R NOSDOCS\*.*
  216.    ATTRIB +R NOSVIEW\*.*
  217.   --------------------------------------------------------------
  218.  
  219.  
  220. ================
  221. STARTING NOSVIEW
  222. ================
  223. You are now ready to reboot the system.  Remove the NOSview
  224. distribution diskette from the drive and hit CTRL-ALT-DEL.
  225.  
  226. When the system starts running again, you should now see the
  227. following message:
  228.  
  229.     ....................................................
  230.     : Loading VIEW - Clockwork's Resident File Viewer. :
  231.     : To activate press:-       RShift and SPC         :
  232.     :..................................................:
  233.  
  234. This is the public domain file viewer program called "VIEW",
  235. distributed with NOSview.  VIEW is loaded when AUTOEXEC.BAT makes
  236. the CALL to c:\nos\NOSENV.BAT.
  237.  
  238. Test the operation of VIEW by pressing the right shift key
  239. and the space bar simultaneously.  The Clockwork View
  240. introduction screen should appear.  Use the PgDn and PgUp keys to
  241. examine the help menus.
  242.  
  243. Then test the file viewer, by pressing F3.  The prompt
  244.  
  245.        "Load file: *.*"
  246.  
  247. should then appear.  Press Return.  This should pop up a list of
  248. files in the current directory.  Move the arrow keys up or down
  249. to select a particular file, then press Return again.  The
  250. selected file should now appear.
  251.  
  252. Use the "G" and/or "H" key to change the display format if
  253. necessary.  Finally press Escape to exit from VIEW.
  254.  
  255. Finally, check that the DOS drive environment variables defined
  256. in NOSENV.BAT have been set up properly, by giving the SUBST
  257. command:
  258.  
  259.   --------------------------------------------------------------
  260.    C:\NOS> SUBST
  261.  
  262. {DOS should reply:}
  263.  
  264.    M: =>  c:\nos\SPOOL\MAIL
  265.    N: =>  c:\nos
  266.    Q: =>  c:\nos\SPOOL\MQUEUE
  267.    R: =>  c:\nos\DUMP\RECORD
  268.    T: =>  c:\nos\DUMP\TRACE
  269.    V: =>  c:\nos\PUBLIC\NOSVIEW
  270.   --------------------------------------------------------------
  271.  
  272. NOSview is now ready for use.  File "!!README.2ND" continues the
  273. story.
  274.  
  275.  
  276. Ian Wade, G3NRW
  277.  
  278. NOSview Release [304]
  279. January 1993
  280.