home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / unix / riscbsd / datafile / beta_txt < prev    next >
Encoding:
Text File  |  1996-10-12  |  36.3 KB  |  1,155 lines

  1. =============================================================================
  2.                              RiscBSD Beta Release
  3. =============================================================================
  4.  
  5. Notes on installing the RiscBSD Beta Release.
  6.  
  7. Author: Mark Brinicombe
  8.  
  9. Some small additions by Dirk.vanGulik@jrc.it, for the
  10. DataFile, Boston.
  11.  
  12. $Id: beta.txt,v 1.2 1996/02/08 22:17:22 mark Exp $
  13.  
  14. Prerequisites: A large X on a brick wall to indicate where you bang your head.
  15.  
  16.  
  17. System Requirements
  18.  
  19. 8Meg + of DRAM
  20. 1Meg + of VRAM
  21. 300Meg + of spare IDE disc space
  22.  
  23.  
  24. Software requirements
  25.  
  26. 1. A SCSI/IDE Hard drive its re-formatter and partitioning tool, such as:
  27. !hform        - HD formatter (available with your machine)
  28.           (For IDE drives, as come with the RPC.)
  29. ScsiDM        - As comes with most Acorn SCSI drives
  30. !hform / !scsiutils / !scsiformat
  31.           As come with most third party SCSI drives.
  32.     
  33. 2. One or more kernels, in the kernel direcotry.
  34. bsd-XXX.gz    - boot kernel
  35. inst-X.X.fs    - installation kernel
  36.  
  37. 3. This file *PRINTED* out !!
  38.  
  39. 4. bootloader + tools
  40.  
  41. 5. faq.txt        - RiscBSD FAQ
  42.  
  43. 6. Distribution sets
  44.  
  45. sets/as252.*    - OPT - Binutils 2.5.2 as and ld
  46. sets/base.*    - REQ - base distribution set
  47. sets/bash.*    - OPT - Bash shell
  48. sets/bison.*    - OPT - GNU bison set
  49. sets/cc263.*    - OPT - GCC 2.6.3
  50. sets/comp.*    - OPT - compiler related distribution set
  51. sets/config.*    - REC - experimental configuration scripts
  52. sets/cvs.*    - OPT - Concurrent Versions System
  53. sets/dip.*    - OPT - Dialup Internet Protocol distribution set
  54. sets/etc.*    - REQ - /etc distribution set
  55. sets/games.*    - OPT - text console based games
  56. sets/gmake.*    - OPT - GNU make 3.74 set
  57. sets/gs.*    - OPT - Ghostscript, postscript previewer set
  58. sets/gsfonts.*    - OPT - Ghostscript extra fonts set
  59. sets/httpd.*    - OPT - NCSA HTTPD set
  60. sets/joe.*    - OPT - Text editor set
  61. sets/kern*.*    - REQ - kernel distribution sets
  62. sets/local.*    - REC - local binaries and scripts
  63. sets/man.*    - OPT - manual pages set
  64. sets/misc.*    - REQ - miscellaneous distribution set
  65. sets/perl.*    - OPT - Perl
  66. sets/shells.*    - REC - Extra shells set (tcsh, bash, zsh)
  67. sets/sup.*    - OPT - Software Upgrade Protocol
  68. sets/tcl.*    - OPT - Tcl
  69. sets/tcsh.*    - REC - Tcsh shell
  70. sets/tk.*    - OPT - Tk
  71. sets/text.*    - OPT - text distribution set
  72. sets/zsh.*    - OPT - zsh shell
  73. sets/x11r6.*    - OPT - X11R6 base distribution
  74. sets/x11r6man.*    - OPT - X11R6 manual distribution
  75. sets/xarm15.*    - OPT - Xarm 8bpp Xserver
  76. sets/xarm15m.*    - OPT - Xarm 1bpp Xserver
  77. sets/xarchie.*    - OPT - X11 interface to archie
  78. sets/xcontrib.*    - OPT - X11 contrib programs
  79. sets/xdm.*    - OPT - Xdm configuration
  80. sets/xftp.*    - OPT - X11 FTP tool
  81. sets/xpaint.*    - OPT - X11 paint package
  82. sets/xpixmap.*    - OPT - Xpm editor
  83. sets/xpm.*    - OPT - Xpm library for X11
  84. sets/xrn.*    - OPT - X11 news reader
  85. sets/axe.*    - OPT - X11 text editor
  86. sets/chimera.*    - OPT - X11 WWW browser
  87. sets/fvwm.*    - OPT - FVWM window manager for X11R6
  88. sets/gview.*    - OPT - Ghostview, X11 postscript previwer
  89. sets/knews.*    - OPT - X11 Threaded news reader
  90.  
  91. REQ - Required set
  92. OPT - Optional set
  93. REC - Optional but recommended
  94.  
  95. Note the required set etc is only needed for new installations, not
  96. upgrades.
  97.  
  98. Each set is a single compressed tar file that has been split into
  99. small chunks that will fit on 1.44Meg DOS floppies.
  100.  
  101.  
  102. This file will attempt to explain how you install a beta release of
  103. RiscBSD. (Note: It may not work, or these instructions may be wrong :-))
  104.  
  105. Ok, The first thing is to allocate disc space for RiscBSD. We (the
  106. Datafile) have found it to work on IDE (as supplied with
  107. the RPC) as well as Cumana and Powertech SCSI.
  108.  
  109. RiscBSD will co-exist with ADFS on the same disc, so you do not need to
  110. allocate a complete disc to RiscBSD. However, RiscBSD *requires* its own
  111. partition. This partition lives after the ADFS part of the disc.
  112. The implication of this is that in order to share a disc with ADFS, the
  113. ADFS partition will not occupy the whole disc i.e. you will have to
  114. reinitialise the ADFS partition to leave room above it for RiscBSD.
  115. Alternatively, and highly recommended, you can use a whole disc for RiscBSD.
  116.  
  117. This file will use an installation on a Conner CFS420 HD (826 cyls, 16 heads,
  118. 63 sects/track) connected as drive 5, with half the disc for ADFS as an
  119. example.
  120.  
  121. Ok. so step 0 is...
  122.  
  123. 0. Print this file out. Since you are going to be booting RiscBSD later etc.
  124.    you will not be able to keep referring back to this file so make a paper
  125.    copy now :-)
  126.  
  127. Step 1...
  128.  
  129. 1. Decide which disc to install on and how you are going to split the
  130.    disc between ADFS and RiscBSD. You should seriously consider getting
  131.    an extra drive completely devoted to RiscBSD !
  132.  
  133. Since alpha/beta release users are going to want to play and compile things
  134. I would suggest that they have a minimum of 200Meg. See Appendix A/B
  135. for details on the sizes of various directories.
  136.  
  137. Step 2 ...
  138.  
  139. Copy the 'bb-riscbsd' utility to a floppy or onto a location reachable
  140. *after* you have re-initailised the hard-disk.
  141.  
  142. (You can use the copy on PDCD_4 so there is no need to copy this file)
  143.  
  144. Backup your drive and then reinitialise the ADFS part with !Hform,
  145. specifying the new size for the ADFS section e.g. 413 cylinders (210Meg)
  146. on a CFS420A drive (which has 826 cylinders). i.e. half the disc. 
  147.  
  148. Or if you are using SCSI, use the appropriate tool; to re-format and 
  149. partition. Do *write* down the cylinder numbers !. Unless you know
  150. what you are doing; the *first partition should be ADFS, the
  151. second is left for RiscBSD.
  152.  
  153. Run bb-riscbsd from and check that it 'sees' the filecore at the
  154. beginning; and gives you the right size. Specify the offset onto
  155. the next partition for RiscBSD. (So in the above example you would
  156. use 413 as the offset; 0..412 being in use for ADFS/Filecore.
  157.  
  158. Step 3 ...
  159.  
  160. 3. Put all your backed up stuff back on the disc. (Actually this
  161. can wait.. and it might be best to do it *after* unix is installed
  162. because you might have to re-do this if you got some number/cylinder
  163. offset wrong.)
  164.  
  165. Ok now we can install the RiscOS based bits (bootloader) and a kernel
  166. onto the ADFS/Filecore part of the HD (or any other HD).
  167.  
  168. Step 4...
  169.  
  170. 4. Create a RiscBSD directory on the ADFS partition and extract the file
  171.    riscos.spark into it. Copy the kernel files into the directory and
  172.    decompress them. Run the basic program bb_riscbsd in the misc
  173.    subdirectory. This will prompt you for the type of filesystem, the
  174.    drive and starting cylinder of the RiscBSD section. The program will
  175.    tell you how big the ADFS part is before prompting, so for our example
  176.    this would be 413. This means that the ADFS part occupies cyls 0-412,
  177.    so RiscBSD will start at 413.
  178.  
  179. Ok now we have part of the disc reserved for RiscBSD. Before we can boot we
  180. need a root floppy. 
  181.  
  182. Step 5...
  183.   Locate the inst-11.fs file.
  184.    Under RiscOS this can be written to a floppy with the flopwrite program.
  185.  
  186.    e.g.
  187.      *format 0 DOS/Q
  188.      *dir $.riscbsd
  189.      *misc.flopwrite -t=1440 inst-11
  190.  
  191. Ok now we are now ready to rock and roll :-). The next stage is to boot
  192. RiscBSD and see what happens :-)
  193.  
  194. Step 6...
  195.  
  196. 6. Run the !BtRiscBSD application. An icon will be installed on the iconbar.
  197.    Click select on the icon to open the configuration window.
  198.    You should boot riscbsd via the ramdisc. This should be the default
  199.    configuration for the bootloader but just in case this means that
  200.    you need to set the root device to /dev/rd0a and set the ramdisc
  201.    size to 1440K (This should happen automatically when you select /dev/rd0a)
  202.    The swap device should be set to either wd0b or wd1b depending on
  203.    which disc you are using for RiscBSD (for our example - wd1b).
  204.    Also select single user mode. Insert the root floppy.
  205.    Drag the kernel file you wish to boot into the window (It may be
  206.    worth saving this configuration) and then click on boot.
  207.  
  208. Ok, if all goes well the kernel will start to boot.
  209.  
  210. The boot will start by report the memory located along with various
  211. information messages and a few debugging messages. This is the arm
  212. initiation code. The "real" startup point is when the copyright message
  213. is printed. After probing the CPU/FPA in cpu_startup() the kernel will
  214. attempt to configure the appropriate device drivers for the hardware it
  215. finds. Note: Whilst probing the IDE controller there may be a pause if
  216. you only have one drive attached.
  217.  
  218. After probing the hardware and configuring the devices the kernel will
  219. attempt to mount the root filesystem and run init.
  220.  
  221. NOTE: remember the cylinders/heads/sectors reported for the drive you
  222. wish to install on, you will need the later.
  223. (Our example will have reported 826 cyls, 16 heads and 63 sects/track)
  224.  
  225. So if you install on IDE, the line to look for looks like
  226.  
  227. wd0: 826 cylinders, 16 heads, 64 sect and 512 bytes/sector
  228.  
  229. For SCSI, look for something like
  230.  
  231. sd0: 826 cylinders, 16 heads, 64 sect and 512 bytes/sector
  232.  
  233. Write these numbers down! If nessesarry repeat the above to get
  234. a second look/verification.
  235.  
  236. If all has gone well RiscBSD has booted given you lots of information
  237. during bootup, found all your hardware and will be sitting with the prompt
  238.  
  239. Enter pathname of shell or RETURN for sh:
  240.  
  241. At this point things are looking good :-)
  242.  
  243. Step 7...
  244.  
  245. Pressing return will start the installation script
  246. Now we will have lots of questions to answer
  247.  
  248. Step 8...
  249.  
  250. 8. Ok at this point you should have some text on screen saying welcome to
  251.    the NetBSD 1.1 installation program.
  252.    and lower down
  253.  
  254.    Progress with installation? [n]
  255.  
  256.    Pressing return will abort the installation and drop you into a sh shell.
  257.  
  258.    To continue type y and press RETURN
  259.  
  260. Now we will have to answer questions about the harddisc.
  261.  
  262. Step 9...
  263.  
  264. 9. Ok the next prompt should be
  265.  
  266.    What kind of disk will you be installing on ? [IDE]
  267.  
  268.    At this point you can just press return as currently only IDE drives
  269.    are supported.
  270.  
  271. Now select the device
  272.  
  273. Step 10...
  274.  
  275. 10. A list of possible devices you can install on will be printed.
  276.     (For the moment this will just be wd0 and wd1)
  277.     and you will have the prompt
  278.  
  279.     Which disk would you like to install on? [wd0]
  280.  
  281.     enter either wd0 or wd1 and press RETURN depending on which HD you
  282.     are installing on.
  283.     (for our example it will be wd1)
  284.  
  285. Naming the disc
  286.  
  287. Step 11...
  288.  
  289. 11. Next prompt is
  290.  
  291.     What kind of disk is it? (one word please) [mywd]
  292.  
  293.     You should enter the name/type of the disc (no spaces allowed)
  294.     for our example we could use cfs420a or my420slave or cfs420slave etc.
  295.  
  296. Specifying the geometry
  297.  
  298. Step 12...
  299.  
  300. 12. We now enter the geometry of the HD. There will be 4 prompts for this.
  301.  
  302.     Number of bytes per disk sector? [512]
  303.  
  304.     This value is correct if the HD block size is 512 bytes so you can just
  305.     press RETURN.
  306.  
  307.     Number of disk cylinders?
  308.  
  309.     Enter the total number of cylinders as reported during boot. For our
  310.     example this will be 826.
  311.  
  312.     Number of disk tracks (heads) per disk cylinder?
  313.  
  314.     Enter the number of heads reported during boot. For our example this
  315.     will be 16.
  316.  
  317.     Number of disk sectors per disk track?
  318.  
  319.     Enter the number of sectors reported during the boot. For our example this
  320.     will be 63.
  321.  
  322.     You will them be told how many bytes there are per cylinder.
  323.     (for the example this will be approximately 512K)
  324.  
  325. Specifying the partitions.
  326.  
  327. Step 13...
  328.  
  329. 13. The next prompt will ask you how you want to specify the partition sizes.
  330.     This can either be in cylinders or sectors. Cylinders is recommended
  331.     as ideally all partitions should start and finish on cylinder boundries.
  332.  
  333.     What units would you like to use? [cylinders]
  334.  
  335.     Just press RETURN
  336.  
  337. Step 14...
  338.  
  339. 14. We now need to specify how much of the disk is NetBSD.
  340.  
  341.     Size of NetBSD portion of disk (in cylinders)?
  342.  
  343.     Ok this will be the total number of cylinders minus the number of
  344.     cylinders used by ADFS. For example this will be 826 - 413 = 413
  345.  
  346.     Offset of NetBSD portion of disk (in cylinders)?
  347.  
  348.     Ok this will be the starting cylinder of the NetBSD part. This will be
  349.     the cylinder number you specified when running the bb_riscbsd program
  350.     under RiscOS. For our example it will be 413.
  351.  
  352. Specifying the root size
  353.  
  354. Step 15...
  355.  
  356. 15. You will be informed how many cylinders are left to be allocated. You
  357.     will then be prompted for the size of the root partition.
  358.  
  359.     Root partition size (in cylinders)?
  360.  
  361.     Enter the number of cylinders you wish to use. For our example we
  362.     will allocate about 30Meg for the root partition (we will include /var
  363.     on the root partition). This will be about 60 cylinders.
  364.     See appendix B for partition size information.
  365.  
  366. Specifing the swap size
  367.  
  368. Step 16...
  369.  
  370. 16. You will be informed how many cylinders are left to be allocated. You
  371.     will then be prompted for the size of the swap partition.
  372.  
  373.     Swap partition size (in cylinders)?
  374.  
  375.     Enter the number of cylinders you wish to use. For our example we
  376.     will allocate about 24Meg for the swap partition. This will be about
  377.     50 cylinders.
  378.  
  379. Specifying other partitions.
  380.  
  381. Step 17...
  382.  
  383. 17. You will be informed how many cylinders are left to be allocated. You
  384.     will then be prompted for the size of the next partition.
  385.  
  386.     Next partition size (in cylinders)?
  387.  
  388.     Enter the number of cylinders you wish to use for the next partition.
  389.     This will either be /var or /usr depending on whether you have allowed
  390.     space for /var on the root partition.
  391.     You will them be prompted for the mount point.
  392.  
  393.     Mount point ?
  394.  
  395.     Enter the required mount point for the partition.
  396.     For our example we will allocate the rest of the NetBSD space to /usr
  397.     so we will enter 303 cylinders and a mount point of /usr
  398.  
  399. more partitions ?
  400.  
  401. Step 18...
  402.  
  403. 18. If you have not used up all the space you will be prompted for another
  404.     partition (see Step 17)
  405.  
  406. Now all the partitions have be specified it is time to write the disklabel.
  407.  
  408. Step 19...
  409.  
  410. 19. You will get the prompt
  411.  
  412.     THIS IS YOUR LAST CHANCE
  413.  
  414.     Are you sure you want NetBSD installed on your hard drive? (yes/no)
  415.  
  416.     Ok well thats a tough question :-)
  417.  
  418.     Entering no will abort the installation.
  419.  
  420.     For our example we will of course enter yes.
  421.  
  422.     The message will be 
  423.  
  424.     Here we go...
  425.  
  426. Step 20...
  427.  
  428. 20. Start biting your nails :-) This will either work now or not :-)
  429.     If not, start crying ;-)
  430.  
  431.     The install script should now start printing information about what
  432.     it is doing. Firstly it will install a disklabel.
  433.     Then it will attempt to newfs the partitions created.
  434.     This may take a little while depending on the sizes of the partitions.
  435.     During newfs the block numbers of all the superblock backups will be
  436.     printed.
  437.  
  438.     After newfs it will copy the base binaries from the floppy to the
  439.     root partition so that you can boot from the HD.
  440.  
  441.     Hopefully no errors will have occurred during this session. If everything
  442.     is ok, some text will be printed before returning you to the shell.
  443.  
  444. There should now be enough on the harddisc to allow you to boot from it.
  445.  
  446. At the point we can test this :-) If you would rather go ahead and install
  447. the distribution sets before booting from the HD skip step 21.
  448.  
  449. Step 21...
  450.  
  451. 21. At the shell prompt type halt
  452.     The kernel will halt and reboot RiscOS.
  453.     Change the rootdevice in the bootload config window. You can also remove
  454.     the ramdisc by setting it's size to zero.
  455.     Boot again in single user mode.
  456.     This time after pressing RETURN at the prompt
  457.  
  458.     Enter pathname of shell or RETURN for sh:
  459.  
  460.     All the created partitions will be checked by fsck and then the shell
  461.     will be entered.
  462.  
  463. That was the hard work done. Despite how complex it seems it should take less
  464. than 5 minutes to do :-)
  465.  
  466. Now all you have to do is get all the sets onto the HD so you can install
  467. them :-)
  468.  
  469. Ok assuming everything above worked you should now be in a shell having
  470. booted RiscBSD off the harddisc. The next stage is to make the sets
  471. available to RiscBSD for installation. If you did not do stage 21 and
  472. are still running with the ramdisc mounted as the root filesystem then
  473. the following should still apply. The set install proceedure for the beta
  474. release should detect this and take that into consideration.
  475.  
  476. This text file will either consider installing the sets from floppies
  477. or from a CDROM. If you are going to install from floppies you need to
  478. put the set files onto a collection of 1.44MB floppy discs. Each
  479. distribution set has at least a .set file and a .00 file. In addition there
  480. may be .01 .02 etc. for sets that will not fit on a single floppy.
  481. If you are installing from CDROM you need to mount the CDROM. Check
  482. the instructions supplied with the CDROM for mounting details.
  483.  
  484. Step 22...
  485.  
  486. 22. If the backspace key is not working correctly on the command line then
  487.     type
  488.  
  489.     stty erase ^H
  490.  
  491.     and press return.
  492.     NOTE: This will enable the backspace key to work properly. Normally this
  493.     sort of this would be taken care of during the login but
  494.     in single user mode it may not have been.
  495.  
  496.  
  497. Making the sets available to the installer. If you are installing from
  498. CDROM goto step 27.
  499.  
  500. Steps 23 to 26
  501.  
  502. Transfer the sets from floppies to the HD.
  503.  
  504. Step 23
  505.  
  506. Start the installer
  507.  
  508. 23. At the prompt type
  509.  
  510.     /usr/local/sbin/inst
  511.  
  512.     This will run the RiscBSD installer script. This installer can be
  513.     used to transfer the set files from floppies to the HD and also
  514.     handles installing the sets.
  515.  
  516. Step 24
  517.  
  518. 24. The installer will present a menu of 6 or more options. Select the
  519.     menu option "Load distributions onto HD" (This will normally option 2)
  520.     This will take you into another menu with 4 or 5 options. These options
  521.     allow you to simply transfer files from floppies into a distribution
  522.     directory on the HD from where they can be installed.
  523.  
  524. Step 25
  525.  
  526. Set the distribution directory
  527.  
  528. 25. Typically the distribution directory will be /usr/distrib on the HD.
  529.     The installed menu option to set the distribution directory will show
  530.     you the current setting. If you have booted off the harddisc then
  531.     this should be /usr/distrib. If you booted off the floppy via
  532.     the ramdisc then this should be /mnt/usr/distrib as the harddisc is
  533.     mounted on /mnt when the bootstrap binaries are transferred from
  534.     from the rootdisc to the harddisc.
  535.     If the distribution directory is not set correct or you wish to
  536.     change it do so now.
  537.  
  538. Step 26
  539.  
  540. Actually copy the files
  541.  
  542. 26. The installer gives you three methods of copying the files from
  543.     floppies to the harddisc. Select the appropraite method depending
  544.     on how you have copied the set files onto floppy disc.
  545.     The normal way is to have copied them onto 1.44MB DOS floppies
  546.     (option 2). The other 2 options support transferring the sets straight
  547.     from tars files written to the floppies (avoiding the use of the
  548.     DOS filesystem)
  549.     Having selected an installation method you will be asked which floppy
  550.     drive to use. Assuming a standard RiscPC is being use then this will
  551.     be drive 0.
  552.  
  553.     You will then be asked to insert a floppy disc and press return.
  554.     On pressing return the installer will copy all the files from the
  555.     floppy to the distribution directory.
  556.     You will then be prompted for the next floppy.
  557.     Typing s at the prompt will terminate the process.
  558.  
  559. If you have installed from floppies then skip step 27 and go directly
  560. to step 30. 
  561.  
  562. Step 27.
  563.  
  564. Installing from CDROM
  565.  
  566. 27. If you are installing from CDROM the first thing to do is to mount
  567.     the CDROM. At the prompt type something like
  568.  
  569.     mount -r -t cd9660 /dev/scd0 /cdrom
  570.  
  571.     Check the mounting details supplied with the CDROM for the exact details.
  572.  
  573. Step 28
  574.  
  575. Start the installer
  576.  
  577. 28. At the prompt type
  578.  
  579.     /usr/local/sbin/inst
  580.  
  581.     This will run the RiscBSD installer script.
  582.  
  583. Step 29
  584.  
  585. Set the distribution directory
  586.  
  587. 29. Typically the distribution directory will be /usr/distrib on the HD.
  588.     As we are installing from CDROM then we need to change the distribution
  589.     directory to point to the distribution sets on the CDROM
  590.  
  591.     Use the set distrib directory (Option 1) on the installer menu to
  592.     change the distribution directory to the CDROM distribution directory
  593.     typically /cdrom/usr/distrib
  594.     Check the instructions with the CDROM for exact details.
  595.  
  596. Step 30
  597.  
  598. What have we got and are there any errors ...
  599.  
  600. 30. Ok we now are now running the RiscBSD inst program and have either
  601.     mounted and CDROM and set the distribution directory to point to it
  602.     or we have loaded the sets from a collection of floppy discs into
  603.     the distribution directory on the harddisc.
  604.  
  605.     Select the "Show distribution sets" option from the inst menu.
  606.     This will list all the distribution sets found in the distribution
  607.     directory. It will show the set name along with a brief discription
  608.     of the set.
  609.  
  610.     If you have transferred the sets from floppy discs you may like to
  611.     check that none of the set files are missing or corrupt.
  612.  
  613.     Select the option "Validate distribution sets".
  614.     This will list the set names of all the available sets and will prompt
  615.     you to enter a list. You can enter a space separated list of sets to
  616.     validate or the set name "all" for all the sets.
  617.     The installer will then check that all the parts of each of the
  618.     specified sets are present and will check the checksums on each part.
  619.     Any errors will be reported.
  620.  
  621.     The option "Verify distribution sets" can also be used but this is alot
  622.     slower as tests the integrity of the compressed sets using gzip.
  623.     This option should not normally be needed though.
  624.  
  625. Step 31
  626.  
  627. Actually install something ...
  628.  
  629. 31. Select the option "Install distribution sets" from the inst menu.
  630.     The installer will list all the sets that are available for
  631.     installation.
  632.  
  633.     You will then be prompted for a space separated list of sets to
  634.     install.
  635.     There are three special set names that can be used.
  636.     The set name "req" can be used to install all the required sets.
  637.     These are the sets "base etc misc text kern".
  638.     The set name "std" can be used to install all the standard sets.
  639.     These are the sets "base etc misc text kern man local"
  640.     The set name all can be used to install all the available sets.
  641.  
  642.     NOTE: The sets will be installed in the order given at the prompt
  643.     apart from the base set which will always be installed first.
  644.  
  645.     The optional sets do not have to be installed at this point. They
  646.     can be installed at a future date using the inst program.
  647.  
  648.     Having installed the required set you may like to quit and find out
  649.     how much disc space you have left before installing the option sets.
  650.  
  651. How much space did I lose ?
  652.  
  653. Step 31...
  654.  
  655. 31. type at the shell prompt
  656.  
  657.     df -k
  658.  
  659.     installing the sets base, etc, text, misc and man
  660.     should result in
  661.     approx 9.5Meg used on /    (/mnt)
  662.     approx 61Meg used on /usr    (/mnt/usr)
  663.  
  664.     The paths in brackets are the relevant ones if you booted of the root
  665.     floppy.
  666.  
  667. I've got bags of room left ;-)
  668.  
  669. Step 32...
  670.  
  671. 32. Other sets you may have pulled include all the X11R6 sets and the
  672.     NetBSD source tree.
  673.     If so you can install that now :-)
  674.  
  675. Step 33...
  676.  
  677. 33. Also the actual compiler and assembler have not yet been installed.
  678.     The compiler and assembler distribution is split into three sets.
  679.     The "comp" contains all the header files and libraries.
  680.     The "as???" sets contain version ?.?.? of the assembler and linker
  681.     The "cc???" sets contain version ?.?.? of the C and C++ compiler.
  682.  
  683. Ekk I'm running out of space !
  684.  
  685. Step 34...
  686.  
  687. 34. Once the distribution sets have been installed you can delete them from
  688.     your HD. However if you installed from CDROM - oh dear, buy a new HD :-)
  689.  
  690. Configuring the system
  691.  
  692. Step 35...
  693.  
  694. 35. Ok now everything has been install there are one or two things to
  695.     configure.
  696.     From the shell prompt type
  697.  
  698.     Configure
  699.  
  700.     and press return.
  701.  
  702. Hostname config
  703.  
  704. Step 36...
  705.  
  706. 36. Ok the first prompt will be
  707.  
  708.     What is this machine's hostname? [unknown.host.domain]
  709.  
  710.     Enter the name of your machine.
  711.  
  712. Step 37...
  713.  
  714. 37. The next prompt will be
  715.  
  716.     What domain is this machine in ?
  717.  
  718.     Enter the domain name here.
  719.  
  720. Step 38...
  721.  
  722. 38. The next prompt will ask you if you have an ethernet interface.
  723.     If you have ether1, ether3, ether5, etherb or etherh interface
  724.     in your machine then you can configure it now. After responding
  725.     yes to this question you will be prompted for some information
  726.     about the interface.
  727.  
  728.     For reference, the following hardware corresponds with the following
  729.     drivers.
  730.  
  731.     ether1 podule  - ie
  732.     ether3 podule  - ea
  733.     ether5 podule  - ea
  734.     etherB netslot - eb
  735.     etherH netslot - eh
  736.  
  737.     After the network interface config the configure script will
  738.     make all the special device files in /dev
  739.  
  740.     Then it's back to the prompt.
  741.  
  742. Time zone configuration
  743.  
  744. Step 39...
  745.  
  746. 39. You may need to change the symbolic link /etc/localtime to point
  747.    to your preferred timezone.
  748.  
  749. Fix the bugs.
  750.  
  751. Step 40...
  752.  
  753. 40. The following commands will fix a few bugs in the beta release
  754.  
  755.     So far no bugs have been reported in the beta release...
  756.  
  757. Try for a multiuser startup
  758.  
  759. Step 41...
  760.  
  761. 41. Type exit from the single user mode shell. init will then try
  762.     for a multiuser mode startup.
  763.  
  764. More configuration ?
  765.  
  766. Step 42...
  767.  
  768. 42. If you have installed the config set then you may like to try
  769.     running the RiscBSD Configuration Manager. This provides options
  770.     to configure timezones, network interfaces, nfs, resolver and
  771.     users. The configuration manager can be run with the command
  772.  
  773.     /usr/local/sbin/rcm
  774.  
  775.     This is now the recommended configuration proceedure. In future
  776.     RCM will be extended to support more configuration options.
  777.  
  778. This section i.e. steps 43 to 7842 have not been written yet as my current
  779. research contract ends in a 3 months time and I have about 9 months of work
  780. left to do to finish it.
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788. Appendix A
  789.  
  790. Package        Compressed size    Uncompress size
  791. as252           226702       552960
  792. axe          1405776      3184640
  793. base         19882724     45260800
  794. bash           307400       788480
  795. bison           123244       368640
  796. cc263          2172029      5253120
  797. chimera           604974      1464320
  798. comp          2832589     10547200
  799. config            12052        81920
  800. cvs           349009       849920
  801. dip           111448       276480
  802. etc            60054       337920
  803. fvwm          2000309      4577280
  804. games          4763364     10813440
  805. gmake           234611       665600
  806. gs           786962      1925120
  807. gsfonts          1714119      3409920
  808. gview           533531      1198080
  809. httpd           392081      1095680
  810. joe           532992      1239040
  811. knews           499240      1116160
  812. local           200177       460800
  813. man           827888      3287040
  814. misc          1887975      6563840
  815. perl          1501396      4833280
  816. sup           303780       675840
  817. tcl           394772      1648640
  818. tcsh           273662       645120
  819. text          1278299      3942400
  820. tk          1315495      4341760
  821. x11r6         18836638     49858560
  822. x11r6man       715160      1300480
  823. x11xv           970872      2334720
  824. xarchie           597348      1382400
  825. xarm15           829722      2170880
  826. xarm15m          1054148      2775040
  827. xcontrib      3880086      8724480
  828. xdm             2778        20480
  829. xemacs         10613054     38768640    ** Alpha2 set **
  830. xftp           649660      1546240
  831. xpaint           679017      1679360
  832. xpixmap           581883      1351680
  833. xpm           400376       911360
  834. xrn           583260      1310720
  835. zsh           224000       532480
  836.  
  837. Total         88114617    236072960
  838.  
  839. NOTE: The uncompresses size is the size for the uncompressed binaries and
  840. data files. It does not include filesystem overheads and block rounding.
  841.  
  842. I did have a piece of paper with all the sizes of various directories
  843. written down. Anybody who has seen my desk will agree that it is probably
  844. lost forever now...
  845.  
  846. Note these sizes are approximate and the for the src directories includes
  847. objects files as well.
  848.  
  849. NOTE: These were the sizes for the alpha2 release so things may be a bit
  850. bigger now.
  851.  
  852. Sizes are in blocks (512 bytes)
  853.  
  854. /bin                 5785
  855. /sbin                 8478
  856. /etc                  484
  857. /var                 4089
  858. /usr/bin            45606
  859. /usr/sbin            16997
  860. /usr/libexec             6435
  861. /usr/lib             2969
  862. /usr/include             5961
  863. /usr/src/bin            14629
  864. /usr/src/include          712
  865. /usr/src/lib            17885
  866. /usr/src/sbin            15883
  867. /usr/src/libexec         9007
  868. /usr/src/usr.bin        54885
  869. /usr/src/usr.sbin        28254
  870. /usr/src/sys            34371
  871. /usr/src/gnu            57369
  872. /usr/share             9381
  873. /usr/local
  874. /usr/local/NetBSD-current    51524
  875. /usr/X11R6
  876. /usr/X11R6/man
  877.  
  878. Note: It is not difficult to fill up a 800 Meg partition :-)
  879.  
  880.  
  881. Appendix B - Suggested partition sizes
  882.  
  883. /    - 16Meg
  884. swap - 24Meg
  885. /var - 12Meg
  886.  
  887. Sometimes simpler to put /var on / and make the root about 25-30Meg
  888.  
  889. /usr - 200Meg+
  890.  
  891. If you want to even think about X then
  892.  
  893. /usr - 300Meg+
  894.  
  895. If you want things like xemacs and TeX then
  896.  
  897. /usr - 400Meg+
  898.  
  899. Appendix C - Useful commands
  900.  
  901. ls -al         - list all the files in a dir in long format
  902. df -k        - list the mounted partitions and sizes in kilobytes
  903.                   (without -k sizes are in blocks)
  904. stty erase ^H   - enable the backspace key in single user mode
  905.  
  906. vmstat        - general stats
  907. vmstat -i    - interrupt stats
  908. vmstat -s    - stats summary
  909. vmstat -m    - memory stats
  910.  
  911. ps -aux        - process stats
  912.  
  913. mount -t msdos /dev/fd0a /mnt    - mount a msdos floppy on /mnt
  914. umount /mnt            - unmount the device mounted at /mnt
  915.  
  916. mount -r -t cd9660 /dev/scd0 /cdrom - mount a CDROM
  917.  
  918. Appendix D - Miscellaneous
  919.  
  920. Special keys / mouse buttons
  921.  
  922. The left mouse button will slow down the speed at which text is printed
  923. The middle mouse button will freeze the console.
  924.  
  925. ALT-Cursor up - scroll back through the VRAM 
  926. ALT-Cursor up - scroll forward through the VRAM 
  927. CTRL-ESC      - force a kernel panic (Do no use this unless dire emergency)
  928.  
  929.  
  930. Floppies.
  931.  
  932. Faster access times can be obtained if 1.44M floppies are formatted from
  933. a PC not from RiscOS (Note: the 486 card does not solve this as it uses RiscOS
  934. to format the floppies :-)
  935.  
  936. Switching consoles
  937.  
  938. ALT-F1 to ALT-F? will switch between any virtual consoles enabled.
  939. The X server is on console 9 so use ALT-F9 to switch to it. 
  940.  
  941. Appendix E - Help I am stuck !!!
  942.  
  943. Have you checked the FAQ ? It may contain the answer you need.
  944.  
  945. 1. Sometimes when halting / rebooting the kernel will freeze while syncing
  946.    discs or will go mad reporting errors (again during the syncing/unmount
  947.    phase. If this happens try pressing CTRL-ESC to attempt to scramble for
  948.    the kshell (kernel debug shell) where you can try CTRL-D or reboot
  949.    to reboot RiscOS.
  950.  
  951. 2. You are getting weird errors from inetd etc.
  952.    ermm kill inetd :-)
  953.    unless you are using SLIP you probably will not be using networking stuff.
  954.    This error occured on the alpha distribution and should not occur on the
  955.    beta release.
  956.  
  957. Appendix F - Using other kernels.
  958.  
  959. The kernels directory in the beta release contains alternative kernels
  960. that you can use. Note, not all these kernel have the same device support.
  961. They may, however, provide better performance.
  962.  
  963. To use a different kernel, just decompress it and drag the file into the
  964. bootloader config window. That kernel will them be used instead. Click
  965. the save button if you wish to save the new config.
  966.  
  967. Once you have booted you may find that certain commands such as ps and vmstat
  968. will give errors or rubbish results. This is because they use the symbol
  969. table in the file /netbsd to get the addresses of any kernel variables they
  970. need. If you decide to stick with one of these other kernels you will need
  971. to copy it to /netbsd. Then after the next reboot the kernel in /netbsd
  972. will match with the kernel you booted.
  973.  
  974. The recommended proceedure is that once you have completed the installation
  975. and have installed a kernel in /netbsd you should then use the native boot
  976. option in the boot loader. To enable this select the native boot option
  977. and specify the kernel filename of unixfs:$.netbsd
  978.  
  979.  
  980. Appendix G - The new installer
  981.  
  982. inst is a new program to aid in the installation of the RiscBSD sets.
  983. it can be found in /usr/local/sbin/
  984.  
  985. It is aimed at replacing the installation method for the sets described above.
  986. Eventually it will be a general purpose installer/deinstaller.
  987.  
  988. Currently it can not be used for the installation of the base set.
  989. Until the base and etc sets has been installed and the machine rebooted
  990. certain installer options (Validate) will not work.
  991.  
  992. Once you have booted from the HD using the base set you can run the
  993. new installer
  994.  
  995. i.e.
  996. /usr/local/sbin/inst
  997.  
  998. This will give you a menu.
  999.  
  1000. 1. Set distrib directory (Currently ...)
  1001. 2. Load distribution sets
  1002. 3. Show distribution sets
  1003. 4. Validate distribution sets (confirm checksums)
  1004. 5. Verify distribution sets (integrity check)
  1005. 6. Install distribution sets from ...
  1006. Q. Quit
  1007.  
  1008. Select 1 and specify the location of the distribution files. This will be
  1009. the directory (probably /usr/distrib) where you copied the base set to.
  1010. If you specify a directory that does not exist you will be prompted as
  1011. to whether you want to create one.
  1012. If you have not transferred all the sets to the HD yet, select option 2
  1013.  
  1014. This gives you a sub menu
  1015.  
  1016. 1. Set distrib directory (Currently ...)
  1017. 2. Load sets from msdos floppies
  1018. 3. Load sets from tar floppies
  1019. 4. Load sets from multi-volume tar floppies
  1020. Q. Quit
  1021.  
  1022. If you copies the sets onto msdos floppies select option 2.
  1023. You will then be prompted to insert the floppies one at a time and
  1024. they will be transferred to the hard disc. Once this has been completed
  1025. you can return to the main menu.
  1026. The other 2 options allow the sets to be transferred as either a single
  1027. multivolume tar for or as a collection of floppy sized tar files.
  1028.  
  1029.  
  1030. Once all the sets have be loaded onto the harddisc you can show the available
  1031. sets by selecting option 3. This will produce a brief list of the sets and
  1032. a description of their contents.
  1033.  
  1034. Options 4 and 5 provide a means to check that the sets have been correctly
  1035. transferred before you try to install them. If you are using inst to install
  1036. the base set then option 4 will not be available.
  1037.  
  1038. Both options will print out the available sets and will prompt for the
  1039. names of the sets to check.
  1040.  
  1041. Option 4 will then check that there are the correct number of parts to
  1042. the set and that each part has the correct checksums. It will report passed
  1043. or failed messages for each set.
  1044.  
  1045. Option 5 will check the integrity of the sets using gzip. (This option is
  1046. slower than just checksuming).
  1047.  
  1048. Once you are happy that the sets are ok you can proceed to option 6.
  1049.  
  1050. You will again be given a list of the loaded sets and prompted for the
  1051. sets to install. Installation of those set will then proceed.
  1052.  
  1053. Following installation you will return to the main menu where you could check
  1054. and install other sets.
  1055.  
  1056. Once the REQUIRED sets have been installed you don't have to install any other
  1057. sets immediately. You can use the inst program at a later date to install
  1058. other sets.
  1059.  
  1060. Appendix H - The alpha2 install proceedure (Not really needed now)
  1061.  
  1062. This install proceedure has been superceded by the inst program.
  1063.  
  1064. 1.  At the shell prompt type
  1065.  
  1066.     Set_tmp_dir
  1067.  
  1068.     and press RETURN. This runs a function in the shell script /.commonutils
  1069.     and will set the temporary directory for the files you will install.
  1070.     You will be prompted to enter a directory
  1071.  
  1072.     What directory should be used to find and/or store installation
  1073.     files ? [/usr/distrib]
  1074.  
  1075.     /usr/distrib is as good a place as any so just press return.
  1076.  
  1077.     Now type
  1078.  
  1079.     Load_fd
  1080.  
  1081.     and press RETURN. This is another shell util that will help
  1082.     with the process of copying from the floppies.
  1083.  
  1084.     You will be prompted for a drive. Ignore what it says about not being
  1085.     able to use the drive you booted from. (That only applies if you
  1086.     do this before reboot from the HD and even then if you use the ramdisc
  1087.     which is new (to NetBSD) (and exclusive to NetBSD/arm32 :-)
  1088.     it does not apply.
  1089.  
  1090.     Enter 0 at the prompt for the floppy drive to read from.
  1091.  
  1092.     You will them be prompted to insert a floppy and press return to copy
  1093.     it or CTRL-C to abort.
  1094.     When the contents of the msdos floppy have been copied you will be
  1095.     prompted to enter another floppy. Repeat this until all the files have
  1096.     been transferred from all the floppy discs.
  1097.  
  1098.  
  1099. Install the files.
  1100.  
  1101. Step 2...
  1102.  
  1103. 2.  Having transferred all the files and pressed CTRL-C at the insert
  1104.     floppy prompt from step 23 you should now be back at the shell.
  1105.  
  1106.     Type
  1107.  
  1108.     Tmp_dir
  1109.  
  1110.     and press RETURN to cd to the directory where all the files have been
  1111.     copied to.
  1112.  
  1113.     Typing ls <RETURN> will show you the files. I did not really need to
  1114.     mention that as anybody installing this version will know that already.
  1115.  
  1116. Actually install something
  1117.  
  1118. Step 2...
  1119.  
  1120. 3.  Type
  1121.  
  1122.     Extract base
  1123.  
  1124.     and press RETURN
  1125.  
  1126.     Again Extract is a shell function written for your convienience :-)
  1127.     You will be prompted as to whether you wish the files to be listed
  1128.     when they are installed. It is up to you whether you say yes or no
  1129.     but I also like to see lots of text going by :-)
  1130.  
  1131.     Assuming you typed yes, you will see the files being extracted from the
  1132.     base set and installed on your HD.
  1133.  
  1134.     Repeat the procedure with for comp text misc etc shells as cc and patch1.
  1135.     Note you do not need to install all these sets unless you want to.
  1136.     A list of which sets are required and which are optional is given
  1137.     at the beginning of the document.
  1138.  
  1139.     i.e.
  1140.  
  1141.     Extract comp
  1142.     Extract text
  1143.     Extract misc
  1144.     Extract etc
  1145.     Extract as
  1146.     Extract cc
  1147.     Extract config
  1148.     Extract local
  1149.  
  1150.     Extract kern????
  1151.  
  1152.     where ???? is the alpha kernel version number
  1153.  
  1154.     Extract any other sets that were copied as well.
  1155.