home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / unix / riscbsd / 1_1_beta / install_tx < prev    next >
Encoding:
Text File  |  1996-10-07  |  35.0 KB  |  1,117 lines

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