821 lines
		
	
	
	
		
			32 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
			
		
		
	
	
			821 lines
		
	
	
	
		
			32 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
| <!-- $Id: install.sgml,v 1.39 1996-11-04 17:21:20 jhay Exp $ -->
 | |
| <!-- The FreeBSD Documentation Project -->
 | |
| 
 | |
| <!--
 | |
| <!DOCTYPE linuxdoc PUBLIC '-//FreeBSD//DTD linuxdoc//EN'>
 | |
| -->
 | |
| <chapt><heading>Installing FreeBSD<label id="install"></heading>
 | |
| 
 | |
|     <p>So, you would like to try out FreeBSD on your system?
 | |
|       This section is a quick-start guide for what you need to
 | |
|       do.  FreeBSD can be installed from a variety of media
 | |
|       including CD-ROM, floppy disk, magnetic tape, an MS-DOS
 | |
|       partition, and if you have a network connection, via
 | |
|       anonymous ftp or NFS.  
 | |
| 
 | |
|       Regardless of the installation media you choose, you can
 | |
|       get started by downloading the <bf>installation disk</bf>
 | |
|       as described below.  Booting your computer with disk will
 | |
|       provide important information about compatibility between
 | |
|       FreeBSD and your hardware which could dictate which
 | |
|       installation options are possible.  It can also provide
 | |
|       early clues to compatibility problems that could prevent
 | |
|       FreeBSD running on your system at all.  If you plan on
 | |
|       installing via anonymous FTP, then this installation disk
 | |
|       is all you need to download.
 | |
| 
 | |
|       For more information on obtaining the FreeBSD distribution
 | |
|       itself, please see <ref id="mirrors" name="Obtaining
 | |
|       FreeBSD"> in the Appendix.
 | |
| 
 | |
|       So, to get the show on the road, follow these steps:
 | |
|     <enum>
 | |
| 
 | |
|       <item>Review the <ref id="install:hw" name="supported
 | |
| 	  configurations"> section of this installation guide to
 | |
| 	be sure that your hardware is supported by FreeBSD.  It
 | |
| 	  may be helpful to make a list of any special cards you
 | |
| 	  have installed, such as SCSI controllers, Ethernet
 | |
| 	  adapters or sound cards.  This list should include
 | |
| 	  relevant configuration parameters such as interrupts
 | |
| 	  (IRQ) and IO port addresses. </item>
 | |
| 
 | |
|       <item>Download the <url
 | |
| 	  url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/&rel.current;-RELEASE/floppies/boot.flp"
 | |
| 	  name="installation boot disk image"> file to your hard
 | |
| 	  drive, and be sure to tell your browser to
 | |
| 	  <em>save</em> rather than <em>display</em>.
 | |
| 	  <bf>Note:</bf> This disk image can be used for
 | |
| 	  <em>both</em> 1.44 megabyte 3.5 inch floppy disks and
 | |
| 	  1.2 megabyte 5.25 inch floppy disks.</item>
 | |
| 
 | |
|       <item>Make the installation boot disk from the image file:
 | |
| 	<itemize>
 | |
| 	  <item>If you are using MS-DOS download 
 | |
| 	    <url 
 | |
| url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/tools/dos-tools/rawrite.exe"
 | |
| 	      name="rawrite.exe">, then run it:
 | |
| <tscreen><verb>
 | |
| C:\> rawrite
 | |
| </verb></tscreen> The
 | |
| 	    program will prompt you for the floppy drive
 | |
| 	    containing the disk you want to write to (A: or
 | |
| 	    B:) and the name of the file to put on disk (boot.flp).
 | |
| 	  </item>
 | |
| 
 | |
| 	  <item>If you are using a UNIX system:
 | |
| <tscreen>
 | |
| % dd if=boot.flp of=<em>disk_device</em>
 | |
| </tscreen>
 | |
| 	    where <em>disk_device</em> is the <tt>/dev</tt>
 | |
| 	    entry for the floppy drive.  On FreeBSD systems, this
 | |
| 	    is <tt>/dev/fd0</tt> for the A: drive and
 | |
| 	    <tt>/dev/fd1</tt> for the B: drive.
 | |
| 	  </item>
 | |
| 	</itemize>
 | |
| 
 | |
|       </item>
 | |
| 
 | |
|       <item>With the installation disk in the A: drive, reboot your
 | |
| 	computer.  You should get a boot prompt something like this:
 | |
| 	<tscreen>
 | |
| >> FreeBSD BOOT ...<newline>
 | |
| Usage: [[[0:][wd](0,a)]/kernel][-abcCdhrsv]<newline>
 | |
| Use 1:sd(0,a)kernel to boot sd0 if it is BIOS drive 1<newline>
 | |
| Use ? for file list or press Enter for defaults<newline>
 | |
| Boot: 
 | |
| 	</tscreen>
 | |
| 	If you do <em>not</em> type anything, FreeBSD will automatically boot
 | |
| 	with its default configuration after a delay of about
 | |
| 	five seconds.  As FreeBSD boots, it probes your computer
 | |
| 	to determine what hardware is installed.  The results of
 | |
| 	this probing is displayed on the screen.
 | |
|       </item>
 | |
| 
 | |
|       <item>When the booting process is finished, The main FreeBSD
 | |
| 	installation menu will be displayed.</item>
 | |
| 
 | |
|     </enum>
 | |
| 
 | |
|     <p><bf>If something goes wrong...</bf>
 | |
| 
 | |
|     <p>Due to limitations of the PC architecture, it is
 | |
|       impossible for probing to be 100 percent reliable.  In the event
 | |
|       that your hardware is incorrectly identified, or that the
 | |
|       probing causes your computer to lock up, first check the
 | |
| 	<ref id="install:hw" name="supported
 | |
|       configurations"> section of this installation guide to be
 | |
|       sure that your hardware is indeed supported by FreeBSD.  
 | |
| 
 | |
|     <p>If your hardware is supported, reset the computer and when
 | |
|       the <tt>Boot:</tt> prompt comes up, type <bf>-c</bf>.  This puts
 | |
|       FreeBSD into a configuration mode where you can supply
 | |
|       hints about your hardware.  The FreeBSD kernel on the
 | |
|       installation disk is configured assuming that most hardware
 | |
|       devices are in their factory default configuration in terms
 | |
|       of IRQs, IO addresses and DMA channels.  If your hardware
 | |
|       has been reconfigured, you will most likely need to use the
 | |
|       <bf>-c</bf> option at boot to tell FreeBSD where things are.
 | |
| 
 | |
|     <p>It is also possible that a probe for a device not present
 | |
|       will cause a later probe for another device that is present
 | |
|       to fail.  In that case, the probes for the conflicting
 | |
|       driver(s) should be disabled.
 | |
| 
 | |
|     <p>In the configuration mode, you can:
 | |
| 
 | |
|     <itemize>
 | |
|       <item>List the device drivers installed in the kernel.</item>
 | |
|       <item>Disable device drivers for hardware not present in your
 | |
| 	system.</item>
 | |
|       <item>Change the IRQ, DRQ, and IO port addresses used by a
 | |
| 	device driver.</item>
 | |
|     </itemize>
 | |
| 
 | |
|     <p>While at the <tt>config></tt> prompt, type
 | |
|       <tt>help</tt> for more information on the available
 | |
|       commands.  After adjusting the kernel to match how you have
 | |
|       your hardware configured, type <tt>quit</tt> at the
 | |
|       <tt>config></tt> prompt to continue booting with the new
 | |
|       settings.  
 | |
| 
 | |
|       After FreeBSD has been installed, changes made in the
 | |
|       configuration mode will be permanent so you do not have
 | |
|       to reconfigure every time you boot.  Even so, it is likely
 | |
|       that you will want to build a custom kernel to optimize the
 | |
|       performance of your system.  See <ref id="kernelconfig"
 | |
|       name="Kernel configuration"> for more information on
 | |
|       creating custom kernels.
 | |
| 
 | |
|     <sect><heading>Supported Configurations<label id="install:hw"></heading>
 | |
| 
 | |
|       <p>FreeBSD currently runs on a wide variety of ISA, VLB,
 | |
| 	EISA and PCI bus based PC's, ranging from 386sx to
 | |
| 	Pentium class machines (though the 386sx is not
 | |
| 	recommended).  Support for generic IDE or ESDI drive
 | |
| 	configurations, various SCSI controller, network and
 | |
| 	serial cards is also provided.
 | |
| 
 | |
| 	A minimum of four megabytes of RAM is required to run FreeBSD.
 | |
| 	To run the X Window System, eight megabytes of RAM is the
 | |
| 	recommended minimum.
 | |
| 
 | |
| 	Following is a list of all disk controllers and Ethernet
 | |
| 	cards currently known to work with FreeBSD.  Other
 | |
| 	configurations may very well work, and we have simply not
 | |
| 	received any indication of this.
 | |
| 
 | |
|       <sect1><heading>Disk Controllers</heading>
 | |
| 
 | |
| 	<p>
 | |
| 	  <itemize>
 | |
| 	    <item>WD1003 (any generic MFM/RLL)
 | |
| 	    <item>WD1007 (any generic IDE/ESDI)
 | |
| 	    <item>IDE
 | |
| 	    <item>ATA
 | |
| 
 | |
| 	    <item>Adaptec 152x series ISA SCSI controllers
 | |
| 	    <item>Adaptec 154x series ISA SCSI controllers
 | |
| 	    <item>Adaptec 174x series EISA SCSI controller in
 | |
| 	      standard and enhanced mode.
 | |
| 	    <item>Adaptec 274x/284x/2940/3940
 | |
|               (Narrow/Wide/Twin)
 | |
| 	      series EISA/VLB/PCI SCSI controllers
 | |
| 	    <item>Adaptec AIC7850 on-board SCSI controllers
 | |
| 	    <item>Adaptec
 | |
| 	      <!-- AIC-6260 and - actually not working, joerg -->
 | |
| 	      AIC-6360 based boards,
 | |
| 	      which includes the AHA-152x and SoundBlaster SCSI
 | |
| 	      cards.
 | |
| 
 | |
| 	      <bf>Note:</bf> You cannot boot from the
 | |
| 	      SoundBlaster cards as they have no on-board BIOS,
 | |
| 	      which is necessary for mapping the boot device into
 | |
| 	      the system BIOS I/O vectors.  They are perfectly
 | |
| 	      usable for external tapes, CDROMs, etc, however.
 | |
| 	      The same goes for any other AIC-6x60 based card
 | |
| 	      without a boot ROM.  Some systems DO have a boot
 | |
| 	      ROM, which is generally indicated by some sort of
 | |
| 	      message when the system is first powered up or
 | |
| 	      reset.  Check your system/board documentation for
 | |
| 	      more details.
 | |
| 
 | |
| 	    <item>Buslogic 545S & 545c
 | |
| 		<bf>Note:</bf> that Buslogic was formerly known as "Bustek".
 | |
| 	    <item>Buslogic 445S/445c VLB SCSI controller
 | |
| 	    <item>Buslogic 742A/747S/747c EISA SCSI controller.
 | |
| 	    <item>Buslogic 946c PCI SCSI controller
 | |
| 	    <item>Buslogic 956c PCI SCSI controller
 | |
| 
 | |
|             <item>NCR 53C810/53C815/53C825/53C860/53C875 PCI SCSI controller.
 | |
| 	    <item>NCR5380/NCR53400 (``ProAudio Spectrum'') SCSI controller. 
 | |
| 
 | |
| 	    <item>DTC 3290 EISA SCSI controller in 1542 emulation mode.
 | |
| 
 | |
| 	    <item>UltraStor 14F/24F/34F SCSI controllers.
 | |
| 
 | |
| 	    <item>Seagate ST01/02 SCSI controllers.
 | |
| 
 | |
| 	    <item>Future Domain 8xx/950 series SCSI controllers.
 | |
| 
 | |
| 	    <item>WD7000 SCSI controllers.
 | |
| 
 | |
| 	  </itemize>
 | |
| 
 | |
| 	  With all supported SCSI controllers, full support is
 | |
| 	  provided for SCSI-I & SCSI-II peripherals,
 | |
| 	  including Disks, tape drives (including DAT) and CD ROM
 | |
| 	  drives.
 | |
| 
 | |
| 	  The following CD-ROM type systems are supported at this
 | |
| 	  time:
 | |
| 
 | |
| 	  <itemize>
 | |
| 	    <item>SoundBlaster SCSI and ProAudio Spectrum SCSI (<tt>cd</tt>)
 | |
| 	    <item>Mitsumi (all models) proprietary interface (<tt>mcd</tt>)
 | |
| 	    <item>Matsushita/Panasonic (Creative)
 | |
| 	      CR-562/CR-563 proprietary interface (<tt>matcd</tt>) 
 | |
| 	    <item>Sony proprietary interface (<tt>scd</tt>)
 | |
| 	    <item>ATAPI IDE interface 
 | |
|                    (experimental and should be considered ALPHA quality!) 
 | |
|                    (<tt>wcd</tt>)
 | |
| 	  </itemize>
 | |
| 
 | |
|       <sect1><heading>Ethernet cards</heading>
 | |
| 
 | |
| 	<p>
 | |
| 	  <itemize>
 | |
| 
 | |
|             <item>Allied-Telesis AT1700 and RE2000 cards
 | |
| 
 | |
| 	    <item>SMC Elite 16 WD8013 Ethernet interface, and
 | |
| 	      most other WD8003E, WD8003EBT, WD8003W, WD8013W,
 | |
| 	      WD8003S, WD8003SBT and WD8013EBT based clones.  SMC
 | |
| 	      Elite Ultra is also supported.
 | |
| 
 | |
| 	    <item>DEC EtherWORKS III NICs (DE203, DE204, and DE205)
 | |
| 	    <item>DEC EtherWORKS II NICs (DE200, DE201, DE202, and DE422)
 | |
| 	    <item>DEC DC21040/DC21041/DC21140 based NICs:
 | |
| 		<itemize>
 | |
| 		<item>ASUS		PCI-L101-TB
 | |
| 		<item>Accton		ENI1203
 | |
| 		<item>Cogent		EM960PCI
 | |
| 		<item>Compex 		CPXPCI/32C
 | |
| 		<item>D-Link		DE-530
 | |
| 		<item>DEC		DE435
 | |
| 		<item>Danpex		EN-9400P3
 | |
| 		<item>JCIS		Condor JC1260
 | |
| 		<item>Linksys		EtherPCI
 | |
| 		<item>Mylex		LNP101
 | |
| 		<item>SMC		EtherPower 10/100 (Model 9332)
 | |
| 		<item>SMC		EtherPower (Model 8432)
 | |
| 		<item>SMC		EtherPower (2)
 | |
| 		<item>Zynx		ZX342
 | |
| 		</itemize>
 | |
| 	    <item>DEC FDDI (DEFPA/DEFEA) NICs
 | |
| 
 | |
| 	    <item>Fujitsu FMV-181 and FMV-182
 | |
| 
 | |
| 	    <item>Fujitsu MB86960A/MB86965A
 | |
| 
 | |
| 	    <item>Intel EtherExpress
 | |
| 
 | |
| 	    <item>Intel EtherExpress Pro/100B 100Mbit.
 | |
| 
 | |
| 	    <item>Isolan AT 4141-0 (16 bit)
 | |
| 	    <item>Isolink 4110     (8 bit)
 | |
| 
 | |
| 	    <item>Novell NE1000, NE2000, and NE2100 ethernet interface.
 | |
| 
 | |
| 	    <item>3Com 3C501 cards
 | |
| 
 | |
| 	    <item>3Com 3C503 Etherlink II
 | |
| 
 | |
| 	    <item>3Com 3c505 Etherlink/+
 | |
| 
 | |
| 	    <item>3Com 3C507 Etherlink 16/TP
 | |
| 
 | |
| 	    <item>3Com 3C509, 3C579, 3C589 (PCMCIA) Etherlink III
 | |
| 
 | |
| 	    <item>3Com 3C590, 3C595 Etherlink III
 | |
| 
 | |
| 	    <item>HP PC Lan Plus (27247B and 27252A)
 | |
|  
 | |
| 	    <item>Toshiba ethernet cards
 | |
| 
 | |
| 	    <item>PCMCIA ethernet cards from IBM and National
 | |
| 	      Semiconductor are also supported.
 | |
| 	  </itemize>
 | |
| 
 | |
|         <p><em>Note:</em> FreeBSD does not currently support
 | |
|           PnP (plug-n-play) features present on some ethernet
 | |
|           cards.  If your card has PnP and is giving you problems,
 | |
|           try disabling its PnP features.
 | |
| 
 | |
|       <sect1><heading>Miscellaneous devices</heading>
 | |
| 
 | |
| 	<p>
 | |
| 	  <itemize>
 | |
| 	    <item>AST 4 port serial card using shared IRQ.
 | |
| 
 | |
| 	    <item>ARNET 8 port serial card using shared IRQ.
 | |
| 
 | |
| 	    <item>BOCA IOAT66 6 port serial card using shared IRQ.
 | |
| 
 | |
| 	    <item>BOCA 2016 16 port serial card using shared IRQ.
 | |
| 
 | |
| 	    <item>Cyclades Cyclom-y Serial Board.
 | |
| 
 | |
| 	    <item>STB 4 port card using shared IRQ.
 | |
| 
 | |
| 	    <item>SDL Communications Riscom/8 Serial Board.
 | |
| 
 | |
| 	    <item>SDL Communications RISCom/N2 and N2pci sync serial cards.
 | |
| 
 | |
| 	    <item>Digiboard Sync/570i high-speed sync serial card.
 | |
| 
 | |
| 	    <item>Adlib, SoundBlaster, SoundBlaster Pro,
 | |
| 	      ProAudioSpectrum, Gravis UltraSound, Gravis UltraSound MAX
 | |
| 	      and Roland MPU-401 sound cards.
 | |
| 
 | |
| 	  </itemize>
 | |
| 
 | |
| 	  FreeBSD does not currently support IBM's microchannel (MCA) bus.
 | |
| 
 | |
|     <sect><heading>Preparing for the installation</heading>
 | |
| 
 | |
|       <p>There are a number of different methods by which FreeBSD
 | |
| 	can be installed.  The following describes what
 | |
| 	preparation needs to be done for each type.
 | |
| 
 | |
|       <sect1><heading>Before installing from CDROM</heading>
 | |
| 
 | |
| 	<p>If your CDROM is of an unsupported type, then please
 | |
| 	  skip to <ref id="install:msdos" name="MS-DOS Preparation">.
 | |
| 
 | |
| 	  There is not a lot of preparatory work that needs to be done to
 | |
| 	  successfully install from one of Walnut Creek's FreeBSD CDROMs (other
 | |
| 	  CDROM distributions may work as well, though we cannot say for certain
 | |
| 	  as we have no hand or say in how they are created).  You can either
 | |
| 	  boot into the CD installation directly from DOS using Walnut Creek's
 | |
| 	  supplied ``install.bat'' batch file or you can make a boot floppy with
 | |
| 	  the ``makeflp.bat'' command.  [NOTE:  If you are running
 | |
| 	  FreeBSD 2.1-RELEASE and have an IDE CDROM, use the
 | |
| 	  inst_ide.bat or atapiflp.bat batch files instead].
 | |
| 
 | |
| 	  For the easiest interface of all (from DOS), type
 | |
| 	  ``view''.  This will bring up a DOS menu utility that
 | |
| 	  leads you through all the available options.
 | |
| 
 | |
| 	  If you are creating the boot floppy from a UNIX machine,
 | |
| 	  see <ref id="install" name="the beginning of this
 | |
| 	  guide"> for examples. of how to create the boot floppy.
 | |
| 
 | |
| 	  Once you have booted from DOS or floppy, you should then
 | |
| 	  be able to select CDROM as the media type in the Media
 | |
| 	  menu and load the entire distribution from CDROM.  No
 | |
| 	  other types of installation media should be required.
 | |
| 
 | |
| 	  After your system is fully installed and you have rebooted
 | |
| 	  from the hard disk, you can mount the CDROM at any time by
 | |
| 	  typing: <tt>mount /cdrom</tt>
 | |
| 
 | |
| 	  Before removing the CD again, also note that it is necessary to first
 | |
| 	  type: <tt>umount /cdrom</tt>.  Do not just remove it from the drive!
 | |
| 
 | |
| 	  <quote><bf>Special note:</bf> Before invoking the
 | |
| 	    installation, be sure that the CDROM is in the drive
 | |
| 	    so that the install probe can find it.  This is also
 | |
| 	    true if you wish the CDROM to be added to the default
 | |
| 	    system configuration automatically during the install
 | |
| 	    (whether or not you actually use it as the
 | |
| 	    installation media).
 | |
| 	  </quote>
 | |
| 
 | |
| 	  Finally, if you would like people to be able to FTP
 | |
| 	  install FreeBSD directly from the CDROM in your
 | |
| 	  machine, you will find it quite easy.  After the machine
 | |
| 	  is fully installed, you simply need to add the
 | |
| 	  following line to the password file (using the vipw
 | |
| 	  command):
 | |
| 
 | |
| <tscreen><verb>
 | |
| ftp:*:99:99::0:0:FTP:/cdrom:/nonexistent
 | |
| </verb></tscreen>
 | |
| 
 | |
| 	  Anyone with network connectivity to your machine (and permission
 | |
| 	  to log into it) can now chose a Media type of FTP and type
 | |
| 	  in: <tt>ftp://<em>your machine</em></tt> after picking ``Other''
 | |
| 	  in the ftp sites menu.
 | |
| 
 | |
|       <sect1><heading>Before installing from Floppy</heading>
 | |
| 
 | |
| 	<p>If you must install from floppy disks, either due to
 | |
| 	  unsupported hardware or simply because you enjoy doing
 | |
| 	  things the hard way, you must first prepare some
 | |
| 	  floppies for the install.
 | |
| 
 | |
| 
 | |
| 	  The first floppy that you will need in addition to the boot.flp 
 | |
| 	  image is ``floppies/root.flp'', which is somewhat special in that 
 | |
| 	  it is not a DOS filesystem floppy at all, but rather a floppy "image" 
 | |
| 	  (it's actually a gzip'd cpio file).  You can create this floppy in 
 | |
| 	  the same way that you created the boot floppy <ref id="install"
 | |
| 	    name="the beginning of this guide">.  Once this floppy is
 | |
| 	  made, you can go on to make the distribution set floppies
 | |
| 	  using ordinary DOS or UFS (if you are preparing the floppies on
 | |
| 	  another FreeBSD machine) formatted diskettes.
 | |
| 
 | |
| 	  You will need, at minimum, as many 1.44MB or 1.2MB floppies as
 | |
| 	  it takes to hold all files in the bin (binary distribution)
 | |
| 	  directory.  If you are preparing these floppies under DOS, then
 | |
| 	  THESE floppies *must* be formatted using the MS-DOS FORMAT
 | |
| 	  command.  If you are using Windows, use the Windows File
 | |
| 	  Manager format command.
 | |
| 
 | |
| 	  Do <em>not</em> trust Factory Preformatted floppies!  Format
 | |
| 	  them again yourself, just to make sure.  Many problems
 | |
| 	  reported by our users in the past have resulted from the use
 | |
| 	  of improperly formatted media, which is why I am taking such
 | |
| 	  special care to mention it here!
 | |
| 
 | |
| 	  If you are creating the floppies from another FreeBSD machine,
 | |
| 	  a format is still not a bad idea though you do nott need to put
 | |
| 	  a DOS filesystem on each floppy.  You can use the `disklabel'
 | |
| 	  and `newfs' commands to put a UFS filesystem on them instead,
 | |
| 	  as the following sequence of commands (for a 3.5" 1.44MB floppy
 | |
| 	  disk) illustrates:
 | |
| 
 | |
| <tscreen><verb>
 | |
|         fdformat -f 1440 fd0.1440
 | |
|         disklabel -w -r fd0.1440 floppy3
 | |
|         newfs -t 2 -u 18 -l 1 -i 65536 /dev/rfd0
 | |
|         
 | |
| (Use "fd0.1200" and "floppy5" for 5.25" 1.2MB disks).
 | |
| </verb></tscreen>
 | |
| 
 | |
| 	  Then you can mount and write to them like any other file
 | |
| 	  system.
 | |
| 
 | |
| 	  After you have formatted the floppies, you will need to copy
 | |
| 	  the files onto them.  The distribution files are split into
 | |
| 	  chunks conveniently sized so that 5 of them will fit on a
 | |
| 	  conventional 1.44MB floppy.  Go through all your floppies,
 | |
| 	  packing as many files as will fit on each one, until you have
 | |
| 	  got all the distributions you want packed up in this fashion.
 | |
| 	  Each distribution should go into a subdirectory on the
 | |
| 	  floppy, e.g.: <bf>a:\bin\bin.aa</bf>,
 | |
| 	  <bf>a:\bin\bin.ab</bf>, and so on.
 | |
| 
 | |
| 	  Once you come to the Media screen of the install,
 | |
| 	  select ``Floppy'' and you will be prompted for the rest.
 | |
| 
 | |
| 
 | |
| 
 | |
|       <sect1><heading>Before installing from a MS-DOS partition<label id="install:msdos"></heading>
 | |
| 
 | |
| 	<p>To prepare for installation from an MS-DOS partition,
 | |
| 	  copy the files from the distribution into a directory
 | |
| 	  called <tt>C:\FREEBSD</tt>.  The directory tree structure
 | |
| 	  of the CDROM must be partially reproduced within this directory
 | |
| 	  so we suggest using the DOS <tt>xcopy</tt>
 | |
| 	  command.  For example, to prepare for a minimal installation of
 | |
| 	  FreeBSD:
 | |
| <tscreen><verb>
 | |
| C> MD C:\FREEBSD
 | |
| C> XCOPY /S E:\DISTS\BIN C:\FREEBSD\BIN\
 | |
| C> XCOPY /S E:\FLOPPIES C:\FREEBSD\FLOPPIES\
 | |
| </verb></tscreen>
 | |
| 	  assuming that <tt>C:</tt> is where you have free space
 | |
| 	  and <tt>E:</tt> is where your CDROM is mounted.  Note
 | |
| 	  that you need the <tt>FLOPPIES</tt> directory because
 | |
| 	  the <tt>root.flp</tt> image is needed during an MS-DOS
 | |
| 	  installation.
 | |
| 
 | |
| 	  For as many `DISTS' you wish to install from MS-DOS
 | |
| 	  (and you have free space for), install each one under
 | |
| 	  <tt>C:\FREEBSD</tt> - the <tt>BIN</tt> dist is only the
 | |
| 	  minimal requirement.  If you have room on your MS-DOS
 | |
| 	  partition for all the distributions, you could replace
 | |
| 	  the last line above with:
 | |
| <tscreen><verb>
 | |
| C> XCOPY /S E:\DISTS C:\FREEBSD\
 | |
| </verb></tscreen>
 | |
| 	  which would copy all the subdirectories of 
 | |
|           <tt>E:\DISTS</tt> to <tt>C:\FREEBSD</tt>.
 | |
| 
 | |
|       <sect1><heading>Before installing from QIC/SCSI Tape</heading>
 | |
| 
 | |
| 	<p>Installing from tape is probably the easiest method,
 | |
| 	  short of an on-line install using FTP or a CDROM
 | |
| 	  install.  The installation program expects the files to
 | |
| 	  be simply tar'ed onto the tape, so after getting all of
 | |
| 	  the files for distribution you are interested in, simply
 | |
| 	  tar them onto the tape with a command like:
 | |
| <tscreen>
 | |
| cd /freebsd/distdir<newline>
 | |
| tar cvf /dev/rwt0 (or /dev/rst0) dist1 .. dist2
 | |
| </tscreen>
 | |
| 	  Make sure that the `floppies/' directory is one of the
 | |
| 	  ``dists'' given above, since the installation will look
 | |
| 	  for `floppies/root.flp' on the tape.
 | |
| 
 | |
| 	  When you go to do the installation, you should also
 | |
| 	  make sure that you leave enough room in some temporary
 | |
| 	  directory (which you will be allowed to choose) to
 | |
| 	  accommodate the <bf>full</bf> contents of the tape you have
 | |
| 	  created.  Due to the non-random access nature of tapes,
 | |
| 	  this method of installation requires quite a bit of
 | |
| 	  temporary storage.  You should expect to require as
 | |
| 	  much temporary storage as you have stuff written on
 | |
| 	  tape.
 | |
| 
 | |
| 	  <quote><bf>Note:</bf> When going to do the
 | |
| 	    installation, the tape must be in the drive
 | |
| 	    <em>before</em> booting from the boot floppy.  The
 | |
| 	    installation probe may otherwise fail to find it.</quote>
 | |
| 
 | |
| 
 | |
| <sect1><heading>Before installing over a network</heading>
 | |
| 
 | |
|       <p>You can do network installations over 3 types of
 | |
| 	communications links:
 | |
| 	<descrip>
 | |
|         <tag>Serial port</tag> SLIP or PPP 
 | |
|         <tag>Parallel port</tag> PLIP (laplink cable) 
 | |
|         <tag>Ethernet</tag> A
 | |
|         standard ethernet controller (includes some PCMCIA).
 | |
| 	</descrip>
 | |
| 
 | |
| 	  SLIP support is rather primitive, and limited primarily
 | |
| 	  to hard-wired links, such as a serial cable running
 | |
| 	  between a laptop computer and another computer.  The
 | |
| 	  link should be hard-wired as the SLIP installation
 | |
| 	  does not currently offer a dialing capability; that
 | |
| 	  facility is provided with the PPP utility, which should
 | |
| 	  be used in preference to SLIP whenever possible.
 | |
| 
 | |
| 	  If you are using a modem, then PPP is almost certainly
 | |
| 	  your only choice.  Make sure that you have your service
 | |
| 	  provider's information handy as you will need to know it
 | |
| 	  fairly soon in the installation process.  You will need
 | |
| 	  to know, at the minimum, your service provider's IP
 | |
| 	  address and possibly your own (though you can also
 | |
| 	  leave it blank and allow PPP to negotiate it with your
 | |
| 	  ISP).  You also need to know how to use the various ``AT
 | |
| 	  commands'' to dial the ISP with your particular modem as
 | |
| 	  the PPP dialer provides only a very simple terminal
 | |
| 	  emulator.
 | |
| 
 | |
| 	  If a hard-wired connection to another FreeBSD (2.0R or
 | |
| 	  later) machine is available, you might also consider
 | |
| 	  installing over a ``laplink'' parallel port cable.  The
 | |
| 	  data rate over the parallel port is much higher than
 | |
| 	  what is typically possible over a serial line (up to
 | |
| 	  50k/sec), thus resulting in a quicker installation.
 | |
| 
 | |
| 	  Finally, for the fastest possible network installation,
 | |
| 	  an ethernet adaptor is always a good choice!  FreeBSD
 | |
| 	  supports most common PC ethernet cards, a table of
 | |
| 	  supported cards (and their required settings) is
 | |
| 	  provided in <ref id="install:hw" name="Supported
 | |
| 	  Hardware">.  If you are using one of the supported
 | |
| 	  PCMCIA ethernet cards, also be sure that it is plugged
 | |
| 	  in <em>before</em> the laptop is powered on!  FreeBSD
 | |
| 	  does not, unfortunately, currently support hot
 | |
| 	  insertion of PCMCIA cards during installation.
 | |
| 
 | |
| 	  You will also need to know your IP address on the
 | |
| 	  network, the netmask value for your address class,
 | |
| 	  and the name of your machine.  Your system
 | |
| 	  administrator can tell you which values to use for your
 | |
| 	  particular network setup.  If you will be referring to
 | |
| 	  other hosts by name rather than IP address, you will also
 | |
| 	  need a name server and possibly the address of a
 | |
| 	  gateway (if you are using PPP, it is your provider's IP
 | |
| 	  address) to use in talking to it.  If you do not know
 | |
| 	  the answers to all or most of these questions, then you
 | |
| 	  should really probably talk to your system
 | |
| 	  administrator <em>first</em> before trying this type of
 | |
| 	  installation.
 | |
| 
 | |
| 	  Once you have a network link of some sort working, the
 | |
| 	  installation can continue over NFS or FTP.
 | |
| 
 | |
| 	<sect2><heading>Preparing for NFS installation</heading>
 | |
| 
 | |
| 	  <p>NFS installation is fairly straight-forward: Simply
 | |
| 	    copy the FreeBSD distribution files you want onto a
 | |
| 	    server somewhere and then point the NFS media
 | |
| 	    selection at it.
 | |
| 
 | |
| 	    If this server supports only ``privileged port'' access
 | |
| 	    (as is generally the default for Sun workstations),
 | |
| 	    you will need to set this option in the Options menu
 | |
| 	    before installation can proceed.
 | |
| 
 | |
| 	    If you have a poor quality ethernet card which
 | |
| 	    suffers from very slow transfer rates, you may also
 | |
| 	    wish to toggle the appropriate Options flag.
 | |
| 
 | |
| 	    In order for NFS installation to work, the server
 | |
| 	    must support subdir mounts, e.g., if your FreeBSD
 | |
| 	    &rel.current; distribution directory lives on:
 | |
| 	    <bf>ziggy:/usr/archive/stuff/FreeBSD</bf> Then ziggy will have
 | |
| 	    to allow the direct mounting of
 | |
| 	    <bf>/usr/archive/stuff/FreeBSD</bf>, not just <bf>/usr</bf> or
 | |
| 	    <bf>/usr/archive/stuff</bf>.
 | |
| 
 | |
| 	    In FreeBSD's <bf>/etc/exports</bf> file, this is controlled by
 | |
| 	    the ``<tt>-alldirs</tt>'' option.  Other NFS servers may have
 | |
| 	    different conventions.  If you are getting
 | |
| 	    `Permission Denied' messages from the server then
 | |
| 	    it is likely that you do not have this enabled
 | |
| 	    properly.
 | |
| 
 | |
| 	<sect2><heading>Preparing for FTP Installation</heading>
 | |
| 
 | |
| 	  <p>FTP installation may be done from any mirror site
 | |
| 	    containing a reasonably up-to-date version of FreeBSD
 | |
| 	    &rel.current;.  A full menu of reasonable choices from almost
 | |
| 	    anywhere in the world is provided by the FTP site
 | |
| 	    menu.
 | |
| 
 | |
| 	    If you are installing from some other FTP site not
 | |
| 	    listed in this menu, or you are having troubles
 | |
| 	    getting your name server configured properly, you can
 | |
| 	    also specify your own URL by selecting the ``Other''
 | |
| 	    choice in that menu.  A URL can also be a direct IP
 | |
| 	    address, so the following would work in the absence
 | |
| 	    of a name server:
 | |
| 
 | |
| <tscreen><verb>
 | |
| ftp://192.216.222.4/pub/FreeBSD/&rel.current;-RELEASE
 | |
| </verb></tscreen>
 | |
|         
 | |
| 	    There are two FTP installation modes you can use:
 | |
| 
 | |
| 	    <descrip>
 | |
| 	      <tag>FTP Active</tag>
 | |
| 
 | |
| 		For all FTP transfers, use ``Active'' mode.  This
 | |
| 		will not work through firewalls, but will often
 | |
| 		work with older ftp servers that do not support
 | |
| 		passive mode.  If your connection hangs with
 | |
| 		passive mode (the default), try active!
 | |
| 
 | |
| 	      <tag>FTP Passive</tag>
 | |
| 
 | |
| 		For all FTP transfers, use ``Passive'' mode.  This
 | |
| 		allows the user to pass through firewalls that do
 | |
| 		not allow incoming connections on random port
 | |
| 		addresses.
 | |
| 
 | |
| 	    </descrip>
 | |
| 
 | |
| 	    <quote><bf>Note:</bf> Active and passive modes are
 | |
| 	      not the same as a `proxy' connection, where a proxy
 | |
| 	      ftp server is listening on a different port!</quote>
 | |
| 
 | |
| 	    In such instances, you should specify the URL as something like:
 | |
| <tscreen><verb>
 | |
| ftp://foo.bar.com:1234/pub/FreeBSD
 | |
| </verb></tscreen>
 | |
| 
 | |
|         Where ``1234'' is the port number of the proxy ftp server.
 | |
| 
 | |
|     <sect><heading>Installing FreeBSD</heading>
 | |
| 
 | |
|       <p>Once you have taken note of the appropriate
 | |
| 	preinstallation steps, you should be able to install
 | |
| 	FreeBSD without any further trouble.
 | |
| 
 | |
| 	Should this not be true, then you may wish to go back and
 | |
| 	re-read the relevant preparation section above
 | |
| 	for the installation media type you are trying to use,
 | |
| 	perhaps there is a helpful hint there that you missed the
 | |
| 	first time?  If you are having hardware trouble, or
 | |
| 	FreeBSD refuses to boot at all, read the Hardware Guide
 | |
| 	provided on the boot floppy for a list of possible
 | |
| 	solutions.
 | |
| 
 | |
| 	The FreeBSD boot floppy contains all the on-line
 | |
| 	documentation you should need to be able to navigate
 | |
| 	through an installation and if it does not then we would
 | |
| 	like to know what you found most confusing.  Send your
 | |
| 	comments to the &a.doc;.
 | |
| 	It is the objective of the
 | |
| 	FreeBSD installation program (sysinstall) to be
 | |
| 	self-documenting enough that painful ``step-by-step''
 | |
| 	guides are no longer necessary.  It may take us a little
 | |
| 	while to reach that objective, but that is the objective!
 | |
| 
 | |
| 	Meanwhile, you may also find the following ``typical
 | |
| 	installation sequence'' to be helpful:
 | |
| 
 | |
| 	<enum>
 | |
| 	  <item>Boot the boot floppy.  After a boot sequence
 | |
| 	    which can take anywhere from 30 seconds to 3
 | |
| 	    minutes, depending on your hardware, you should be
 | |
| 	    presented with a menu of initial choices.  If the
 | |
| 	    floppy does not boot at all, or the boot hangs at some
 | |
| 	    stage, go read the Q&A section of the Hardware Guide
 | |
| 	    for possible causes.
 | |
| 
 | |
| 	  <item>Press F1.  You should see some basic usage
 | |
| 	    instructions on the menu system and general
 | |
| 	    navigation.  If you have not used this menu system
 | |
| 	    before then PLEASE read this thoroughly!
 | |
| 
 | |
| 	  <item>Select the Options item and set any special
 | |
| 	    preferences you may have.
 | |
| 
 | |
| 	  <item>Select a Novice, Custom or Express install, depending on
 | |
| 	    whether or not you would like the installation to help
 | |
| 	    you through a typical installation, give you a high degree of
 | |
| 	    control over each step of the installation or simply whizz
 | |
| 	    through it (using reasonable defaults when possible) as fast
 | |
| 	    as possible.  If you've never used FreeBSD before then the
 | |
| 	    Novice installation method is most recommended.
 | |
| 
 | |
| 	  <item>The final configuration menu choice allows you to
 | |
| 	    further configure your FreeBSD installation by giving you
 | |
| 	    menu-driven access to various system defaults.  Some
 | |
| 	    items, like networking, may be especially important
 | |
| 	    if you did a CDROM/Tape/Floppy installation and have
 | |
| 	    not yet configured your network interfaces (assuming
 | |
| 	    you have any).  Properly configuring such interfaces
 | |
| 	    here will allow FreeBSD to come up on the network
 | |
| 	    when you first reboot from the hard disk.
 | |
| 	</enum>
 | |
| 
 | |
|     <sect><heading>MS-DOS user's Questions and Answers</heading>
 | |
| 
 | |
|     <p>Many FreeBSD users wish to install FreeBSD on PCs inhabited
 | |
|     by MS-DOS.  Here are some commonly asked questions about
 | |
|     installing FreeBSD on such systems.
 | |
| 
 | |
|       <p><bf>Help!  I have no space!  Do I need to delete
 | |
| 	  everything first?</bf>
 | |
| 
 | |
| 	If your machine is already running MS-DOS and has little
 | |
| 	or no free space available for FreeBSD's installation,
 | |
| 	all is not lost!  You may find the FIPS utility, provided
 | |
| 	in the <tt>tools</tt> directory on the FreeBSD CDROM or
 | |
| 	on the various FreeBSD ftp sites, to be quite useful.
 | |
| 
 | |
| 	FIPS allows you to split an existing MS-DOS partition
 | |
| 	into two pieces, preserving the original partition and
 | |
| 	allowing you to install onto the second free piece.  You
 | |
| 	first defragment your MS-DOS partition, using the DOS
 | |
| 	6.xx DEFRAG utility or the Norton Disk tools, then run
 | |
| 	FIPS.  It will prompt you for the rest of the information
 | |
| 	it needs.  Afterwards, you can reboot and install FreeBSD
 | |
| 	on the new free slice.  See the <em>Distributions</em>
 | |
| 	menu for an estimation of how much free space you will need
 | |
| 	for the kind of installation you want.
 | |
| 
 | |
| 
 | |
| 	<bf>Can I use compressed MS-DOS filesystems from
 | |
| 	  FreeBSD?</bf>
 | |
| 
 | |
| 	No.  If you are using a utility such as Stacker(tm) or
 | |
| 	DoubleSpace(tm), FreeBSD will only be able to use
 | |
| 	whatever portion of the filesystem you leave
 | |
| 	uncompressed.  The rest of the filesystem will show up as
 | |
| 	one large file (the stacked/dblspaced file!).  <bf>Do not
 | |
| 	remove that file!</bf> You will probably regret it
 | |
| 	greatly!
 | |
| 
 | |
| 	It is probably better to create another uncompressed
 | |
| 	MS-DOS primary partition and use this for communications
 | |
| 	between MS-DOS and FreeBSD.
 | |
| 
 | |
| 
 | |
| 	<bf>Can I mount my MS-DOS extended partitions?</bf>
 | |
| 
 | |
| 	Yes. DOS extended partitions are mapped in at the end of the other
 | |
| 	``slices'' in FreeBSD, e.g. your D: drive might be /dev/sd0s5,
 | |
| 	your E: drive /dev/sd0s6, and so on. This example assumes, of
 | |
| 	course, that your extended partition is on SCSI drive 0. For IDE drives,
 | |
| 	substitute ``wd'' for ``sd'' appropriately. You otherwise mount extended
 | |
| 	partitions exactly like you would mount any other DOS drive, e.g.:
 | |
| 
 | |
| <tscreen><verb>
 | |
| mount -t msdos /dev/sd0s5 /dos_d
 | |
| </verb></tscreen>
 | |
| 
 | |
| 	<bf>Can I run MS-DOS binaries under FreeBSD?</bf>
 | |
| 
 | |
| 	Not yet!  We would like to add support for this someday, but
 | |
| 	are still lacking anyone to actually do the work.  BSDI has
 | |
| 	also donated their DOS emulator to the BSD world and this is slowly
 | |
| 	being ported to FreeBSD-current.
 | |
| 
 | |
| 	Send mail to the &a.emulation if you're interested in joining
 | |
| 	this effort!
 | |
| 
 | |
| 	In the interim, there is a nice application available in the
 | |
| 	<ref id="ports" name="The Ports Collection"> called pcemu
 | |
| 	which allows you to run many basic MS-DOS text-mode binaries
 | |
| 	by entirely emulating an 8088 CPU.
 |