home *** CD-ROM | disk | FTP | other *** search
/ Walnut Creek Sampler 1995 January / Walnut_Creek_Sampler_44_CDROMs_to_Try_Walnut_Creek_January_1995.iso / mac / DISCS / FREEBSD / INSTALL.TXT < prev    next >
Text File  |  1994-05-05  |  37KB  |  1,047 lines
  1.                              INSTALLATION NOTES
  2.                                   FreeBSD
  3.                                 Release 1.1
  4.  
  5.  
  6. Be sure to read _ALL_ of this document before you try to install
  7. FreeBSD.  FreeBSD probably looks a bit similar to things that you've
  8. seen before (perhaps 386BSD), but the installation procedures are quite
  9. different.
  10.  
  11.  
  12. FreeBSD Release Contents:
  13. ------- --- ------- --------
  14.  
  15. The FreeBSD Release consists of the following elements:
  16.  
  17. Bootable Kernel copy floppies
  18.  
  19.     These disks are bootable and have enough utilities on
  20.     board to copy a new kernel to a prepared hard disk.  While
  21.     they are primarily intended for installing FreeBSD, they
  22.     also make upgrading to a new kernel easy:  boot from it,
  23.     and copy a new kernel to disk.
  24.  
  25.     You must choose between one of two kernel copy floppy
  26.     images, depending on your disk controller type.  The
  27.     "kcopy_ah.flp" image supports the Adaptec 154x and 1742
  28.     SCSI adapters, while "kcopy_bt.flp" supports the Bustek
  29.     742 and Ultrastore SCSI adapters.  For systems with only
  30.     MFM, RLL, ESDI or IDE disk controllers, either image can
  31.     be used.
  32.  
  33. Installation floppies
  34.  
  35.     In addition to a bootable floppy, currently two additional
  36.     disks are required to prepare your hard drive for FreeBSD
  37.     and to install the FreeBSD distribution.  Like the boot
  38.     floppies, these are distributed as binary images.  They are
  39.     are referred to below as the  "filesyst.flp" and the
  40.     "cpio.flp".
  41.  
  42.     There is also an optional fourth installation disk referred
  43.     to as the "dos-floppy".  Unlike the other install disks,
  44.     there is no binary image for the dos floppy.  Instead this
  45.     is a regular MS-DOS-formatted floppy disk containing any
  46.     FreeBSD programs you choose to copy to it using mtools or
  47.     even the DOS copy command.  The most commonly requested
  48.     programs have been put in a tools directory at FreeBSD
  49.     archives sites.
  50.  
  51. Upgrade floppies
  52.  
  53.     These facilitate upgrading to FreeBSD from any previous
  54.     patch-kit level of 386BSD 0.1.  They are still in testing,
  55.     but should be available by the time you read this from
  56.     the tools/upgrade directory at FreeBSD archive sites.
  57.     [the current version is: 
  58.     tools/upgrade/386BSD-to-FreeBSD-update-LATE-BETA.tar.gz]
  59.  
  60. FreeBSD distribution sets
  61.  
  62.     These collections contain the complete FreeBSD system and
  63.     utilities in source and binary form.  There are three
  64.     separate sets: the FreeBSD binaries, the FreeBSD sources,
  65.     and the DES sources+binaries.  The DES set contains only
  66.     crypt(3) code and is subject to U.S.A. export restrictions.
  67.  
  68.     The binary distribution set can be found in the "bindist"
  69.     subdirectory of the FreeBSD archive sites.  It consists
  70.     of files named bin_tgz.aa to bin_tgz.ce (i.e., 57 files
  71.     all told).  A CKSUMS file (* see note below) is included
  72.     for verifying the integrity of these.
  73.  
  74.     The source distribution sets can be found in the 
  75.     "srcdist" subdirectory of archive sites. It is consists
  76.     of files named base.aa to usrsbin.ae (i.e., 86 files
  77.     all told), plus the file CKSUMS*.
  78.  
  79.     Finally, the security distribution set contains
  80.     usr/src/libcrypt/*, the source files for the DES encryption
  81.     algorithm, and the binaries which depend on it.  It can
  82.     be found in the "secrdist" subdirectory on sites which
  83.     choose to carry the complete FreeBSD distribution.
  84.  
  85.     The individual files in each collection are no more than
  86.     235 Kbytes in size.  (The last file is just long enough
  87.     to contain the rest of the data for that distribution
  88.     set.)
  89.  
  90.     Each collection is a split, gzip'ed tar archive.  They
  91.     are reassembled and extracted by the install procedure.
  92.     However, to view them without installing FreeBSD, you can
  93.     use, e.g., the command line:
  94.  
  95.         cat bin* | gunzip | tar tvf - | more
  96.  
  97.     or to extract the files themselves:
  98.  
  99.         cat bin* | gunzip | tar xvfp -
  100.  
  101.     Using this method, the files are extracted in the current
  102.     directory.  So to install the binary distribution, for
  103.     instance, you have to run the "tar xvfp" from the root
  104.     directory (/).
  105.  
  106.     In each of the distribution directories, there is a file
  107.     named "CKSUMS" which contains the checksums of the files
  108.     in that directory, as generated by the cksum(1) command.
  109.     You can use cksum to verify the integrity of the archives,
  110.     if you suspect one of the files is corrupted.
  111.  
  112.     N.B.: The CKSUMS files are produced using the 4.4BSD 
  113.     version of cksum which is POSIX-compliant.  The values in
  114.     these file do not match the cksums generated by the 386BSD 0.1
  115.     version  of cksum (which is based on an earlier "standard").
  116.     A copy of the new cksum binary that will run on
  117.     386bsd/Netbsd/FreeBSD can be found in the "tools" subdirectory
  118.     of the distribution.
  119.  
  120.     
  121. System Requirements and Supported Devices:
  122. ------ ------------ --- --------- -------
  123.  
  124. FreeBSD runs on ISA (AT-Bus) and EISA systems, with 386 and 486
  125. processors, with or without math coprocessors.  It does NOT support
  126. Micro-channel systems, such as some IBM PS/2 systems.  The minimal
  127. configuration includes 4Meg of RAM, and an 80Meg hard disk, but to
  128. install the entire system you'll need much more disk space, and to run
  129. X or compile the system more RAM is recommended.  (4Meg will actually
  130. allow you to run X and/or compile, but it's extremely slow.)
  131.  
  132. Supported devices include:
  133.  
  134.     Standard floppy controllers
  135.  
  136.     Standard hard disk controllers:
  137.         MFM
  138.         ESDI
  139.         IDE
  140.         RLL
  141.  
  142.     SCSI hard disk controllers:
  143.         Adaptec 154x series *            [kcopy_ah.flp]
  144.         Adaptec 174x series
  145.         Buslogic 545S
  146.         Bustek 742 (EISA)            [kcopy_bt.flp]
  147.         DTC 3290 in 1542 emulation mode *
  148.         Ultrastor 14f and 34f
  149.  
  150.         * Your system can NOT have more than 16MB of memory with
  151.           these controllers.
  152.  
  153.     Display Adaptors:
  154.         MDA
  155.         CGA
  156.         VGA (and SVGA)
  157.         HGC
  158.  
  159.     Serial communications ports
  160.         8250
  161.         16450
  162.         16550A
  163.         [4-port multi-serial cards - require kernel built
  164.         with MULTI_PORT option]
  165.         [We do not support the Intel 82501 serial chip used
  166.         in some PC's at this time]
  167.  
  168.     Ethernet controllers
  169.         SMC/WD 8003, 8013, and equivalents
  170.             (including the SMC "Elite" series)
  171.         Novell NE1000, NE2000, NE2100
  172.         3COM 3c503
  173.         ISOLAN ISOLink
  174.  
  175.     Tape drives:
  176.         QIC-02 format tape drives
  177.         most SCSI tape/DAT drives
  178.         [an early QIC-40 or QIC-80 tape driver exists,
  179.         but is not yet incorporated into FreeBSD]
  180.  
  181.     CD-ROM drives:
  182.         Mitsumi CDROM drive with Mitsumi Controller
  183.         Most SCSI CD-ROM drives on a supported SCSI controller
  184.  
  185. To be detected by the distributed kernels, the devices must
  186. be configured as follows: (Note: IRQ 9 is the same as IRQ 2
  187. on ISA/EISA based machines)
  188.  
  189. Device        Name    Port    IRQ    DRQ     Misc
  190. ------        ----    ----    ---    ---     ----
  191. Floppy Cntlr.    fd0    0x3f0    6    2
  192.  
  193. Std. Hard Disk Cntlr.
  194.         wd0    0x1f0    14
  195.  
  196. AHA-154x SCSI Cntlr.    0x330    11    5     [kcopy_ah.flp]
  197.  
  198. AHA-174x SCSI Cntlr.    automatically configured [kcopy_ah.flp]
  199.  
  200. BT742 SCSI Cntlr.    0x330    12         [kcopy_bt.flp]
  201.  
  202. UHA-14f    SCSI Cntlr. or
  203. UHA-34f SCSI Cntlr.    0x330    14    5        [kcopy_bt.flp]
  204. (In FreeBSD 1.0 GAMMA and before, UHA was on IRQ 11)
  205.  
  206. SCSI Disks    sd[0-2]    automatically configured
  207.  
  208. SCSI Tapes    st[01]    automatically configured
  209.  
  210. SCSI CD-ROMs    cd0    automatically configured
  211.  
  212. Mitsumi CD-ROMs    mcd0    0x300    10
  213.         mcd1    0x340    11
  214.  
  215. Serial Ports    com0    0x3f8    4
  216.         com1    0x2f8    3
  217.         com2    0x3e8    5
  218.         com3    0x3f8    9
  219.  
  220. SMC/WD Ethernet or
  221. 3COM 3c503    ed0    0x280    5    iomem 0xd8000
  222.  
  223. NOTE for 386bsd users: the we0 device for the WD80xxyy card has been
  224. replaced with an ed0 device. The default settings of 9/280/d000 have
  225. been changed to 5/280/d800 as this address accomdates all of the boards.
  226.  
  227. Novell Ethernet    ed0    0x280    5
  228.  
  229. NOTE for 386bsd users: the ne0 device for the NEx000 card has been
  230. replaced with an ed0 device.  The default settings of 9/300 have
  231. been changed to 5/280.
  232.  
  233. ISOLAN ISOLink    is0    0x280    10    7
  234. Novell NE2100    is0    0x280    10    7
  235.  
  236. QIC-02 Tape    wt0    0x300    5    1
  237.  
  238. Parallel (Printer) Port
  239.         lpt0    0x3BC    7
  240.  
  241. Interruptless Parallel (Printer) Port
  242.         lpa0    0x378
  243.         lpa1    0x278
  244.  
  245. N.B.: Disable the lpt interrupt on the board or you will
  246. have problems using the lpa drivers.
  247.  
  248. Hard-Disk Storage Requirements 
  249. --------- ------- ------------
  250.  
  251. The minimum base installation of FreeBSD requires a free hard disk
  252. partition with at least 16 MB free space.  This is only enough for
  253. the three installation disks, which don't support a multi-user
  254. shell.
  255.  
  256. The full binary distribution  extracts to about 46 MB.
  257. The full source distribution extracts to about 86 MB.
  258. The kernel source only extracts to about 7 MB.
  259. To recompile the sources requires an additional 50 MB.
  260. To recompile the kernel requires an additional 2 MB.
  261.  
  262. Since additional room is required for extracting the distributions,
  263. a full binary installation requires a minimum of about 80 MB (46
  264. MB extracted + 16 MB archived + 8 MB minimum swap + room for
  265. extracting).
  266.  
  267. A complete source + binary distribution requires a minimum of
  268. about 210 MB (assuming a minimum 8 MB swap).
  269.  
  270.  
  271. Getting the System on to Useful Media:
  272. ------- --- ------ -- -- ------ -----
  273.  
  274. Installation is supported from several media types, including:
  275.  
  276.     MS-DOS floppies
  277.     MS-DOS hard disk (Primary partition)
  278.     Tape
  279.     NFS partitions
  280.     FTP
  281.     Kermit
  282.  
  283. No matter what you do, however, you'll need at least three disks (1.2M
  284. or 1.44M) handy, on which you will put the kernel copy image and the
  285. install (or upgrade) floppy images.
  286.  
  287. The images are available from the directory "floppies", under the root
  288. of the FreeBSD/FreeBSD-1.1 tree at your favorite archive site.
  289. They're available both as raw disk images, and gzipped, to save time
  290. downloading.
  291.  
  292. If you are using an AHA-154x or AHA-1742 SCSI host adapter, you need
  293. the kcopy_ah.flp image.  If you're using a BT-742 SCSI host adapter
  294. or an Ultrastor adaptor, then you'll need the kcopy_bt.flp image.
  295. If you're using MFM/RLL/IDE disk controllers, you can use either
  296. kernel copy floppy image.
  297.  
  298. If you are using UNIX to make the floppies, you should use the command
  299. dd(1) to write the raw floppy images (i.e., kcopy_ah.flp or
  300. kcopy_bt.flp, filesyst.flp and cpio.flp) to the floppies.
  301. For example, to write kcopy_ah.flp to a 5.25" 1.2 Mb floppy
  302. disk under 386BSD, use:
  303.  
  304.     $ dd if=kcopy_ah.flp of=/dev/fd0a bs=30b count=80
  305.  
  306. or for a 3.5" 1.44 Mb floppy:
  307.  
  308.     $ dd if=kcopy_ah.flp of=/dev/fd0a bs=36b count=80
  309.  
  310. If you are using DOS to make the floppies, use the rawrite.exe
  311. utility.  This can be found in the "tools" subdirectory of the
  312. archive site.  Copy rawrite.exe and the binary images to a DOS
  313. disk, type "rawrite" under MS-DOS and follow the instructions.
  314. Rawrite can write binary images to either 1.2MB or 1.44MB
  315. MS-DOS-formatted floppies.
  316.  
  317. Any other programs from the tools directory that might be needed
  318. for installing FreeBSD, such as kermit, should be copied to a DOS-
  319. formatted floppy (1.2MB or 1.44MB).  Under 386BSD, they can be
  320. copied to floppy using the mcopy command.  Under DOS, use the DOS
  321. copy command.
  322.  
  323. The steps necessary to prepare the distribution sets for installation
  324. depend on which method of installation you choose.  The various methods
  325. are explained below.
  326.  
  327. To prepare for installing via MS-DOS hard disk:
  328.  
  329.     To prepare FreeBSD for installaton from the MS-DOS C: drive
  330.     of the hard disk, you need to do the following:
  331.  
  332.         If FreeBSD is installed on a hard disk containing
  333.         a Primary MS-DOS partition (as opposed to an
  334.         Extended DOS partition), then the FreeBSD distribution
  335.         files can be read directly from DOS.  Preparation
  336.         is just a matter of copying the FreeBSD distribution
  337.         files onto DOS C: drive of the hard disk.
  338.  
  339.         If FreeBSD is installed on a separate hard disk than
  340.         MS-DOS, it is not currently possible to read the FreeBSD
  341.         distribution files directly from DOS.  In this case,
  342.         a different medium should be used.
  343.  
  344.     Once you have the files on the C: drive, you can proceed to the
  345.     next step in the installation process, viz preparing your hard
  346.     disk.
  347.  
  348. To prepare for installing via MS-DOS floppies:
  349.  
  350.     To prepare FreeBSD for installaton from MS-DOS floppies, you
  351.     need to do the following:
  352.  
  353.         Count the number of "<set>_tgz.xx" files
  354.         you have (these are split, gzip'ed, tar 
  355.         archives).  Call this number N.  You will
  356.         need N/6 1.44M floppies, or N/5 1.2M
  357.         floppies to install the distribution
  358.         in this manner. For the set of bin files
  359.         (i.e., 80 files) and 1.2 Mb floppies you will
  360.         need 16 disks.
  361.  
  362.         Format all of the floppies, with MS-DOS.
  363.         Don't make any of them MS-DOS bootable
  364.         floppies  (i.e., don't use "format /s"!)
  365.         If you use "format /u" then the format
  366.         will run a tad faster.
  367.  
  368.         Copy all of the "<set>_tgz.xx" files on
  369.         the DOS disks.  Under DOS use the DOS copy
  370.         command.    Under 386BSD, use, for instance, 
  371.         the make_floppies script:
  372.  
  373.             #!/bin/sh
  374.             N_PER_DISK=5
  375.  
  376.             x=$N_PER_DISK
  377.             for dist in bin_tgz.*; do
  378.                 if [ $x -ge $N_PER_DISK ]; then
  379.                     x=0
  380.                     echo -n "Insert next disk, "
  381.                     echo -n "and press ENTER... "
  382.                     read reply
  383.                     mdel a:/\*
  384.                 fi
  385.                 mcopy $dist a:/
  386.                 x=`expr $x + 1`
  387.             done
  388.  
  389.         (Or you might use tar instead).
  390.  
  391.     Once you have the files on DOS disks, you can proceed to the
  392.     next step in the installation process, viz preparing your hard
  393.     disk.
  394.  
  395. To prepare for installing via a tape:
  396.  
  397.     To install FreeBSD from a tape, you need to be somehow
  398.     to get the FreeBSD filesets you wish to install on
  399.     your system on to the appropriate kind of tape,
  400.     in tar format.
  401.  
  402.     If you're making the tape on a UN*X system, the easiest
  403.     way to do so is:
  404.  
  405.         tar cvf <tape_device> <files>
  406.  
  407.     where "<tape_device>" is the name of the tape device
  408.     that describes the tape drive you're using (either
  409.     /dev/rst0 for SCSI tape, otherwise /dev/rwt0). 
  410.     If you can't figure it out, ask your system administrator.
  411.     "<files>" are the names of the "<set>.tar.gz.xx" files
  412.     which you want to be placed on the tape.
  413.  
  414.     If your tape drive is not a type recognzed by the
  415.     kernel, then it may be necessary to set the tape density
  416.     using either the st(1) command  (for SCSI tape) or the
  417.     mt(1) command.   Both these programs are available from
  418.     the tools directory of the FreeBSD archive site.
  419.  
  420. To prepare for installing via an NFS partition:
  421.  
  422.     NOTE: this method of installation is recommended
  423.           only for those already familiar with using
  424.           the BSD network-manipulation commands and
  425.           interfaces.  If you aren't, this documentation
  426.           should help, but is not intended to be
  427.           all-encompassing.
  428.  
  429.     Place the FreeBSD software you wish to install into
  430.     a directory on an NFS server, and make that directory
  431.     mountable by the machine which you will be installing
  432.     FreeBSD on.  This will probably require modifying the
  433.     /etc/exports file of the NFS server and resetting
  434.     mountd, acts which will require superuser privileges.
  435.     Make a note of the numeric IP address of the NFS server
  436.     and make a note of the router closest to the the new
  437.     FreeBSD machine if the NFS server is not on a network
  438.     which is directly attached to the FreeBSD machine.
  439.  
  440.     Once you have done this, you can proceed to the next
  441.     step in the installation process, preparing your hard disk.
  442.  
  443. To prepare for installing via FTP:
  444.  
  445.     NOTE: this method of installation is recommended
  446.           only for those already familiar with using
  447.           the BSD network-manipulation commands and
  448.           interfaces.  If you aren't, this documentation
  449.           should help, but is not intended to be
  450.           all-encompassing.
  451.  
  452.     The preparations for this method of installation
  453.     are easy: all you have to do is make sure that
  454.     there's some FTP site from which you can retrieve
  455.     the FreeBSD installation when it's time to do
  456.     the install.  You should know the numeric IP
  457.     address of that site, and the numeric IP address of
  458.     your nearest router if the new FreeBSD computer is
  459.     not on the same net or subnet as the FTP site.
  460.  
  461.     Once you have done this, you can proceed to the next
  462.     step in the installation process, preparing your hard disk.
  463.  
  464. To prepare for installing via Kermit:
  465.  
  466.     The preparations for this method of installation
  467.     require that the kermit program be put on the
  468.     dos-floppy installation disk.  This will be
  469.     loaded as part of the minimum base installation.
  470.     Kermit is available from tools directory of the
  471.     FreeBSD FTP site.  This is a FreeBSD binary and
  472.     only executes under the FreeBSD operating system.
  473.  
  474.     Once you have done this, you can proceed to the next
  475.     step in the installation process, preparing your hard disk.
  476.  
  477. To upgrade:
  478.  
  479.     (The beta upgrade script is available on request from
  480.     FreeBSD-questions@freefall.cdrom.com)
  481.  
  482. Preparing your Hard Disk for FreeBSD Installation:
  483. --------- ---- ---- ---- --- ------ ------------
  484.  
  485. NOTE: If you wish to install FreeBSD on your whole drive, (i.e. you do
  486. not want DOS or any other operating system on your hard disk), you can
  487. skip this section, and go on to "Installing the FreeBSD System."
  488.  
  489. Firstly, be sure you have a reliable backup of any data which you may
  490. want to keep; repartitioning your hard drive is an excellent way to
  491. destroy important data.
  492.  
  493. WARNING: If you are using a disk controller which supports disk
  494. geometry translation, BE SURE TO USE THE SAME PARAMETERS FOR FreeBSD AS
  495. FOR DOS!  If you do not, FreeBSD will not be able to properly coexist
  496. with DOS.
  497.  
  498. Secondly, make sure your disk has at least 16 Mbytes free space (or 
  499. 80 Mbytes for the complete binary distribition).
  500.  
  501. You are now set to install FreeBSD on your hard drive.
  502.  
  503. Installing the FreeBSD System:
  504. ---------- --- ------ ------
  505.  
  506. If DOS or OS/2 is already installed on the hard disk, installation should
  507. be easy.  By default FreeBSD is installed after the last DOS or OS/2
  508. partition.  Otherwise, you may need to specify your hard disk's geometry
  509. (i.e., number of cylinders, heads and sectors per track).
  510.  
  511. For computing partition sizes, it might help to have a calculator handy.
  512.  
  513. And it's finally time to install the system!
  514.  
  515. The following is a walk-through of the steps necessary to get FreeBSD
  516. installed on your hard disk.  If you wish to stop the installation, you
  517. may hit Control-C at any prompt and then type `halt'. 
  518.  
  519.     Boot from the kcopy_ah or kcopy_bt floppy, depending on
  520.     your hard disk controller type.
  521.  
  522.     When prompted to insert the filesystem floppy, remove the
  523.     kcopy floppy from the drive and insert filesystem floppy
  524.     and hit any key.
  525.     N.B.: The filesystem floppy must not be write protected.
  526.     
  527.     [When booting, if no message prompt appears after a
  528.     reasonable period of time, reboot and try it again.  If
  529.     this doesn't work, try disabling your CPU's internal and
  530.     external caches, and then try to boot again. If there is
  531.     still no message prompt, then you can't install FreeBSD
  532.     on your hardware.  If you were able to install 386bsd,
  533.     this is definitely a bug in our software; please report
  534.     it!  Please include your system configuration, and any
  535.     other relevant information in your bug report.]
  536.  
  537.     The boot sequence continues after the filesystem floppy
  538.     has been inserted.   A copyright notice is displayed along
  539.     with a list of the hardware that FreeBSD recognizes as
  540.     being in your machine.  You might want to make a note of
  541.     the disk values for cylinders, heads, sectors etc for
  542.     later use.
  543.  
  544.     After a short while (approximately 30 to 60 seconds), you
  545.     should see a welcome message and a prompt, asking if you
  546.     wish to proceed with the installation.
  547.  
  548.     If you wish to proceed, enter "y" and then return.
  549.  
  550.     You will then be asked what type of disk drive you have.
  551.     The valid options are listed on the screen (e.g., SCSI, ESDI).
  552.  
  553.     You will then be asked for a label name for your disk.
  554.     This should be a short, one-word name for your disk,
  555.     e.g., "cp3100-mine" for a Conner Peripherals "3100" disk.
  556.     You needn't remember this name.
  557.  
  558.     Next, you will be prompted for the geometry information.
  559.     The default values should be correct, in which case just
  560.     hit ENTER to accept them.  Otherwise  enter the values
  561.     that were displayed during the boot sequence as they are
  562.     requested.
  563.  
  564.     The default size of the FreeBSD portion of the disk
  565.     is the maximum available at the end of the disk (which may
  566.     be the whole disk).  Accept the default by hitting ENTER.
  567.     Otherwise, enter an appropriate value using the information
  568.     displayed.
  569.  
  570.     If you are not installing on the whole disk, you will be
  571.     asked for the offset of the FreeBSD partition from the
  572.     beginning of the disk.  Again, hit ENTER to accept the
  573.     default, or enter a cylinder offset from the beginning of
  574.     the disk.
  575.  
  576.     You will then be asked for the size of your root partition,
  577.     in cylinders. The suggested maximum size is 15 Mbytes
  578.     which is used as a default.  Accept this, or enter a
  579.     suitable value (after converting to cylinders using the
  580.     formula displayed).
  581.  
  582.     Next, you will be asked for the size of your swap partition
  583.     - again, you must calculate this in cylinders.  You should
  584.     probably allocate around twice as much swap space as you
  585.     have RAM memory.  If you wish the system to save crash dumps
  586.     when it panics, you will need at least as much swap as you
  587.     have RAM.
  588.  
  589.     The install program will then ask you for information about
  590.     the rest of the partitions you want on your disk.  For the
  591.     purposes of this document, you only want one more: /usr.
  592.     Therefore, at the prompt, when in asks you to enter the size
  593.     of the next partition, enter the number of cylinders remaining
  594.     in the FreeBSD portion of the disk. When it asks you for the
  595.     mount point for this partition, say "/usr".
  596.  
  597.     After the FreeBSD partition have been assigned, install checks
  598.     the disk for an MS-DOS partition.  If one exists, you are prompted
  599.     whether to make this accessible from FreeBSD (i.e., for reading
  600.     and writing).  And if you choose to make the DOS partition
  601.     accessible, you are prompted for what directory it should
  602.     be mounted on.  "/dos" is used by default.  With this
  603.     choice, you could copy the contents of the DOS root
  604.     directory (i.e., C:\), for instance, with the Unix command:
  605.  
  606.         # cp /dos/* .
  607.  
  608.     If have you a DOS partition and you don't want it visible
  609.     from FreeBSD, just respond with "n" when asked whether to
  610.     make it accessible.
  611.  
  612.     YOU ARE NOW AT THE POINT OF NO RETURN.
  613.  
  614.     If you confirm that you want to install FreeBSD, your hard
  615.     drive will be modified, and perhaps it contents scrambled at
  616.     the whim of the install program.  This is especially likely
  617.     if you gave the install program incorrect information.
  618.     Enter "no" at the prompt to get the option of redoing the
  619.     configuration, using your previous choices as defaults.
  620.  
  621.     If you are sure you want to proceed, enter "yes" at the prompt.
  622.  
  623.     The install program now makes the filesystems you specified.
  624.     If all goes well, there should be no errors in this section
  625.     of the installation.  If there are, restart from the the
  626.     beginning of the installation process.
  627.  
  628.     After the installation program prompts you to see if you'd
  629.     like to be told about all of the files it's going to copy
  630.     to your hard drive, it will spend a few minutes copying these
  631.     files and then will print out an informative message and
  632.     place you at a "#" prompt.
  633.  
  634.     Read the message and note which partition (e.g., sd0a or wd0a)
  635.     you need to copy a kernel to.  Reboot the machine off the
  636.     kcopy_xx.flp disk, but this time at the prompt asking
  637.     you to insert a file system floppy, do _not_ replace the
  638.     floppy, just press <enter>.
  639.  
  640.     At the "kc>" prompt, enter "copy" to prepare to copy the
  641.     kernel on the floppy to your hard disk.
  642.  
  643.     At the next "kc>" prompt, enter the disk partition to which
  644.     you want to copy the kernel. (e.g., sd0a or wd0a).
  645.  
  646.     It will work for a minute or two, then present you with
  647.     another "#" prompt.  Follow the instructions given, (i.e.,
  648.     halt the system) and reboot from the hard disk. You will
  649.     probably have to do a hardware reset or else your ethernet
  650.     card might not be recognised at reboot (e.g., if you have a
  651.     WD8003EP card).
  652.  
  653.     When the machine boots, a three-line banner should appear at
  654.     the top of the screen.  In a few seconds, a series of
  655.     messages will appear, describing the hardware in your machine.
  656.     Once again, this stage can take up to two minutes, so DO NOT
  657.     PANIC!
  658.  
  659.     You will be asked to insert the cpio.flp into a floppy
  660.     drive, and enter that drive's number.  "0" corresponds to
  661.     DOS's "A:" drive, "1" corresponds to DOS's "B:" drive.
  662.  
  663.     After you enter the number it will ask you if you'd like to
  664.     watch its progress, and after you answer this question it
  665.     will begin installing still more files on your hard disk.
  666.     This should take no more than 3 minutes.
  667.  
  668.     You are given the option to load the dos-floppy disk.
  669.     In particular, if you want to use kermit for downloading
  670.     the distribution, the dos-floppy should have the kermit
  671.     binary.  Or if you are using SCSI tape, the dos-floppy should
  672.     contain the st command.  
  673.  
  674.     To load the dos-floppy, remove the cpio.flp from the
  675.     drive,  insert the dos-floppy and enter a "yes" response
  676.     at the prompt.  Otherwise, enter "no" at the prompt.
  677.  
  678.     After the dos-floppy has been loaded, you are given (more)
  679.     instructions, (e.g., to halt the system) and you should
  680.     reboot the machine again, from the hard drive and probably
  681.     with a hardware reset to kick your ethernet card back into
  682.     life.
  683.  
  684.     CONGRATULATIONS: You now have the minimum base of FreeBSD
  685.     files on your hard disk!  Now you get to install the
  686.     distribution file sets.  Remember that, at minimum, you must
  687.     install the bin_tgz.xx file set (see below for instructions).
  688.  
  689.     After the machine is done booting, you will be presented
  690.     with a screenful of information about what to do next.
  691.  
  692.     What you do from this point on depends on which media you're
  693.     using to install FreeBSD.  Follow the appropriate
  694.     instructions, given below.
  695.  
  696.     To install from MS-DOS hard disk partition, floppy or tape:
  697.  
  698.         The first thing you should do is to choose a temporary
  699.         directory where the distribution files can be stored.
  700.         To do this, use the command "set_tmp_dir" and enter
  701.         your choice.  The default is /usr/distrib.
  702.  
  703.         After you have chosen a temporary directory,
  704.         you should issue the appropriate load command:
  705.  
  706.             load_dos - for loading from a MS-DOS hard disk 
  707.                 partition, or from floppies,
  708.             
  709.             load_qic_tape - for loading from QIC-02 tape, or
  710.  
  711.             load_scsi_tape - for you're loading from the first
  712.                    SCSI tape drive in the system.
  713.  
  714.         If loading from tape, it may be necessary to first
  715.         set the default density using the mt or st command.
  716.         The low-density device (/dev/rst0 or /dev/rmt0)
  717.         is used by the load_xx_tape command, so to prepare
  718.         a SCSI device for reading QIC-150 tape, you might use:
  719.  
  720.             # st -f /dev/nrst0 rewind
  721.             # st -f /dev/nrst0 low_dnsty 16
  722.             # load_scsi_tape
  723.  
  724.         If loading from floppy or hard disk, the load_dos
  725.         command prompts for information, such as to which
  726.         floppy drive or hard disk directory to load from.
  727.         Additional options are available, e.g., for listing
  728.         and, if loading from hard disk, changing source
  729.         directories.
  730.  
  731.         Go to the directory which contains the first
  732.         distribution set you wish to install.  This is
  733.         either the directory you specified above, if using
  734.         load_dos, or possibly a subdirectory of that
  735.         directory, if you loaded from tape.
  736.  
  737.         When there, run "set_tmp_dir" again, and choose
  738.         the default temporary directory, by hitting
  739.         return at the prompt.
  740.  
  741.         Run the "extract" command, giving it as its sole
  742.         argument the name of the distribution set you
  743.         wish to extract.  For example, to extract the binary
  744.         distribution, use the command:
  745.  
  746.             extract bin
  747.  
  748.         and to extract the source distribution:
  749.  
  750.             extract src
  751.  
  752.         After the extraction is complete, go to the location
  753.         of the next set you want to extract, "set_tmp_dir"
  754.         again, and once again issue the appropriate
  755.         extract command.  Continue this process until
  756.         you've finished installing all of the sets which you
  757.         desire to have on your hard disk.
  758.  
  759.         After each set is finished, if you know that you
  760.         are running low on space you can remove the
  761.         distribution files for that set by saying:
  762.  
  763.             rm <set>*
  764.  
  765.         For example, if you wish to remove the distribution
  766.         files for the binarydist set, after the "extract bin"
  767.         command has completed, issue the command:
  768.  
  769.             rm bin*
  770.  
  771.         Once you have extracted all sets and are at the "#" prompt
  772.         again, proceed to the section "Configuring Your System,"
  773.         below.
  774.  
  775.     To install via FTP or NFS:
  776.  
  777.         First you must decide on a temporary directory to hold
  778.         the <set>.xx files. The directory /usr/distrib
  779.         is suggested. You should cd to it, if necessary do
  780.         a mkdir first. Use set_tmp_dir to identify this 
  781.         directory to the install process.
  782.  
  783.         Configure the appropriate ethernet interface (e.g. ed0,
  784.         ne0, etc.) up, with a command like:
  785.  
  786.             ifconfig <ifname> <ipaddr> [netmask <netmask>]
  787.  
  788.         where <ifname> is the interface name (e.g. ed0, etc.),
  789.         and <ipaddr> is the numeric IP address of the interface.
  790.         If the interface has a special netmask, supply
  791.         the word "netmask" and that netmask at the end of the
  792.         command line.  For instance, without a special netmask:
  793.  
  794.             ifconfig ed0 129.133.10.10
  795.  
  796.         or with a special netmask
  797.  
  798.             ifconfig ed0 128.32.240.167 netmask 0xffffff00
  799.  
  800.         or the equivalent
  801.  
  802.             ifconfig ed0 128.32.240.167 netmask 255.255.255.0
  803.  
  804.         If you are using the AUI connector on a 3C503 card, you
  805.         must also set the LLC0 flag (the default is to use the BNC
  806.         connector):
  807.  
  808.             ifconfig ed0 130.252.23.86 llc0
  809.  
  810.         If the NFS server or FTP server is not on a directly-
  811.         connected network, you should set up a route to it
  812.         with the command:
  813.  
  814.             route add default <gate_ipaddr>
  815.  
  816.         where <gate_ipaddr> is your gateway's numeric IP address.
  817.  
  818.         If you are NFS-mounting the distribution sets,
  819.         mount them on the temporary directory with the command:
  820.  
  821.             mount -t nfs <serv_ipaddr>:<dist_dir> <tmp_dir>
  822.  
  823.         where <serv_ipaddr> is the server's numeric IP address,
  824.         <dist_dir> is the path to the distribution files on
  825.         the server, and <tmp_dir> is the name of the local
  826.         temporary directory (e.g., /usr/distrib). Proceed as if
  827.         you had loaded the files from tape, "cd"ing to the
  828.         appropriate directories and running "set_tmp_dir" and
  829.         "extract" as appropriate.
  830.  
  831.         If you are retrieving the distribution sets using ftp,
  832.         cd into the temp directory, and execute the command:
  833.  
  834.             ftp <serv_ipaddr>
  835.  
  836.         where <serv_ipaddr> is the server's numeric IP address.
  837.         Get the files with FTP, taking care to use binary mode
  838.         to transfer all files. A simple set of commands is
  839.  
  840.             ftp <serv_ipaddr>
  841.             user ftp
  842.             passwd <user-id>@
  843.             hash
  844.             binary
  845.             prompt
  846.             cd <where/the/binarydist/files/are>
  847.             mget *
  848.             cd <where/the/sourcedist/files/are>
  849.             mget *
  850.             quit
  851.  
  852.         Once you have all of the files for the distribution sets
  853.         that you wish to install, you can proceed using the
  854.         instructions above as if you had installed the files
  855.         from a floppy.
  856.  
  857.     To install via Kermit:
  858.  
  859.         First you must decide on a temporary directory to hold
  860.         the <set>.xx files. The directory /usr/distrib
  861.         is suggested. You should cd to it, if necessary do
  862.         a mkdir first. Use set_tmp_dir to identify this 
  863.         directory to the install process.
  864.  
  865.         Invoke kermit and dial the remote kermit server.
  866.         A typical session might be:
  867.         # stty -f /dev/sio01 clocal
  868.         # kermit
  869.         C-Kermit> set file type binary
  870.         C-Kermit> set line /dev/sio01
  871.         C-Kermit> set baud 9600
  872.         C-Kermit> set receive packet 740
  873.         C-Kermit> set window 4
  874.         C-Kermit> set block 2
  875.         C-Kermit> connect
  876.         Connecting to /dev/sio01, speed 9600.
  877.         The escape character is Ctrl-\ (ASCII 28, FS)
  878.         Type the escape character followed by C to get back,
  879.         or followed by ? to see other options.
  880.         atdt 1234567        <-- dial the remote
  881.         Connect 9600 
  882.         login: mylogin        <-- login to the remote
  883.         [...]
  884.         remote$ kermit -ix    <-- remote kermit as binary server
  885.         [...]
  886.         ^\C            <-- return to local kermit
  887.         C-Kermit> get bin_tgz*    <-- request files from remote
  888.         [...]            (wait long for transfer to complete)
  889.         C-Kermit> finish    <-- terminate remote server
  890.         C-Kermit> connect
  891.         C-Kermit> exit        <-- exit remote kermit
  892.         remote$ exit        <-- exit remote host
  893.         ^\C            <-- return to local kermit
  894.         C-Kermit> exit        <-- exit local kermit
  895.  
  896.         At this point the binary distribution should be
  897.         downloaded to the FreeBSD system.  Run the "extract"
  898.         command, giving it as its sole argument the name
  899.         of the distribution set you wish to extract.  For
  900.         example, to extract the binary distribution, use
  901.         the command:
  902.  
  903.             extract bin
  904.  
  905.         and to extract the source distribution:
  906.  
  907.             extract src
  908.  
  909.         After the extraction is complete, go to the location
  910.         of the next set you want to extract, "set_tmp_dir"
  911.         again, and once again issue the appropriate
  912.         extract command.  Continue this process until
  913.         you've finished installing all of the sets which you
  914.         desire to have on your hard disk.
  915.  
  916.         After each set is finished, if you know that you
  917.         are running low on space you can remove the
  918.         distribution files for that set by saying:
  919.  
  920.             rm <set>*
  921.  
  922.         For example, if you wish to remove the distribution
  923.         files for the binarydist set, after the "extract bin"
  924.         command has completed, issue the command:
  925.  
  926.             rm bin*
  927.  
  928.         Once you have extracted all sets and are at the "#" prompt
  929.         again, proceed to the section "Configuring Your System,"
  930.         below.
  931.  
  932.  
  933. Further Tips on Installing FreeBSD
  934. ------- ---- -- ---------- -------
  935.  
  936.     You might wish to install the bindist first, get that
  937.     working, and then at a later point in time have a go at
  938.     installing the sourcedist.
  939.  
  940.     When you are ready to install the sourcedist at some time
  941.     in the future, get into multi-user mode (i.e., the normal
  942.     means of running FreeBSD) and issue this command:
  943.  
  944.         shutdown now
  945.  
  946.     This will cause the system to go into single-user mode.  To
  947.     get the install commands active again issue this command:
  948.  
  949.         . /magic
  950.  
  951.     If your disk has several operating systems, you may want
  952.     to install a boot manager such as Thomas Wolfram's os-bs
  953.     for selecting which system to boot.  os-bs135.exe and other
  954.     boot managers are available from the tools directory of
  955.     the FreeBSD FTP site.  os-bs works well with DOS, OS/2,
  956.     FreeBSD and other systems, however, it cannot currently
  957.     be used to boot FreeBSD from a second hard disk.  Another
  958.     boot manager, such as boot-easy should be used.
  959.  
  960.     To install, for instance,  os-bs, boot the system with
  961.     MS-DOS and insert the dos-floppy containing os-bs135.exe
  962.     in floppy drive A:.  Then enter the DOS commands:
  963.     > A:
  964.     > os-bs135
  965.     > cd os-bs
  966.     > os-bs
  967.     A menu should now appear on the screen. Use the cursor keys
  968.     to highlight the install option, hit ENTER, and follow the
  969.     instructions from there.
  970.  
  971.     For more information about the ob-bs program, including its
  972.     capabilities and limitations, see the file `readme.1st' in the
  973.     os-bs directory.
  974.  
  975.     If your disk has several operating systems and you  choose
  976.     not to install os-bs, then fdisk can be used to change
  977.     the boot system.  This is done by making the primary
  978.     partition for the boot system active.  FreeBSD has an
  979.     fdisk command that can be used for this purpose as well.
  980.  
  981.  
  982. Configuring Your System:
  983. ----------- ---- ------
  984.  
  985. Once you have finished extracting all of the distribution sets that you
  986. want on your hard drive and are back at the "#" prompt, you are ready
  987. to configure your system.
  988.  
  989. The configuration utility expects that you have installed the base
  990. system.  If you have not, you will not be able to run it successfully
  991. (nor will you have a functional system regardless of configuration).
  992.  
  993. To configure the newly installed operating system, run the command
  994. "configure".
  995.  
  996. Configure will ask for the machine's hostname, domain name, and other
  997. network configuration information. You should check that configure has
  998. set up the following files correctly:
  999.  
  1000.     /etc/netstart
  1001.     /etc/myname
  1002.  
  1003. Once you have supplied configure all that it requests, your machine
  1004. will be configured well enough that when you reboot it it will be a
  1005. completely functional FreeBSD system.  It is not completely configured,
  1006. however; you should adjust the /etc/sendmail.cf file as necessary to
  1007. suit your site and/or disable sendmail in /etc/rc and you should look
  1008. in /etc/netstart to make sure the flags are defined correctly for your
  1009. site. You might wish to set up several other tcp/ip files, such as
  1010.  
  1011.     /etc/resolv.conf
  1012.     /etc/networks
  1013.  
  1014. Once you are done with configuration, reboot with the "reboot" command.
  1015.  
  1016. When it boots off of the hard drive, you will have a complete FreeBSD
  1017. system!  CONGRATULATIONS! (You really deserve them!!!)
  1018.  
  1019.  
  1020. Administrivia:
  1021. -------------
  1022.  
  1023. Registration?  What's that?
  1024.  
  1025. If you've got something to say, do so!  We'd like your input.
  1026.  
  1027. Please send random comments to:
  1028.  
  1029.     FreeBSD-questions@freefall.cdrom.com
  1030.  
  1031. Please send bug reports, and that sort of material to:
  1032.  
  1033.     FreeBSD-bugs@freefall.cdrom.com
  1034.  
  1035. If you'd like to help with this effort, and have an idea as to how
  1036. you could be useful, send mail to:
  1037.  
  1038.     FreeBSD-hackers@freefall.cdrom.com
  1039.  
  1040. THANKS FOR USING THIS; that's what makes it all worthwhile.
  1041.  
  1042. [a favor: Please avoid mailing huge documents or files to these mailing lists,
  1043.  as they will end up in our personal mail spools.  We will be
  1044.  happy to make other arrangements]
  1045.  
  1046. This is $Id: install_notes,v 1.13.2.2 1994/05/05 09:08:55 rgrimes Exp $
  1047.