home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 15 / boot-disc-1997-11.iso / Debian / Docs / INSTALL.TXT < prev    next >
Text File  |  1997-09-15  |  51KB  |  1,004 lines
  1.  
  2.                         Installing Debian GNU/Linux 1.3
  3.                                        
  4. About Copyrights and Software Licenses
  5.  
  6.    I'm sure you've read the licenses that come with most commercial
  7.    software - they say you can only use one copy of the software on one
  8.    computer. The Debian GNU/Linux System isn't like that. We encourage
  9.    you to put a copy on every computer in your school or place of
  10.    business. Lend it to your friends, and help them install it on their
  11.    computers. You can even make thousands of copies and sell them - with
  12.    a few restrictions. That's because Debian is based on free software.
  13.    
  14.    Free software doesn't mean that it doesn't have a copyright, and it
  15.    doesn't mean that the CD you buy containing this software is
  16.    distributed at no charge, it simply means that the licenses of
  17.    individual programs do not require you to pay for the privilege of
  18.    copying the programs. There are other sorts of restrictions on how you
  19.    copy the software, which you can read about once you've installed the
  20.    system. For example, many of the programs in the system are licensed
  21.    under the GNU General Public License, or GPL. The GPL requires that
  22.    you make the source code of the programs available whenever you
  23.    distribute a copy of the program. Thus, we've included the source code
  24.    for all of those programs in the Debian system. There are several
  25.    other forms of copyright and software license used on the programs in
  26.    Debian. You can find the copyrights and licenses of every program by
  27.    looking in the directory /usr/doc/program-name/copyright once you've
  28.    installed your system.
  29.    
  30.    The most important legal notice is that this software comes with no
  31.    warranties. People who write free software can't afford to be sued.
  32.    
  33. System Requirements
  34.  
  35.   CPU
  36.   
  37.    Your computer must have a 386, 486, Pentium, or Pentium Pro processor,
  38.    or one of the clones of those processors made by manufacturers such as
  39.    Cyrix, AMD, TI, IBM, etc. If your processor has letters like "sx",
  40.    "sl", "slc", etc. after the number as in "386sx", that's fine. The
  41.    system will not run on the 286 or lower processors.
  42.    
  43.   I/O Bus
  44.   
  45.    Your computer must use the ISA, EISA, PCI, or VL bus. The VL bus is
  46.    also known as VESA Local Bus or VLB. Computers that have PCI or VLB
  47.    generally have ISA or EISA slots as well. Linux offers some support
  48.    for the Micro-Channel bus used in IBM PS/2 computers, but this is not
  49.    included on the Debian rescue disk.
  50.    
  51.   RAM and Disk
  52.   
  53.    You must have at least 4MB of RAM and 40MB of hard disk. If you want
  54.    to install everything from the chess game through the printed-circuit
  55.    design software, you'll need 300MB or more. The disk interfaces that
  56.    emulate the "AT" hard disk interface which are often called MFM, RLL,
  57.    IDE, or ATA are supported. SCSI disk controllers from many different
  58.    manufacturers are supported. See the [1]Linux Hardware Compatibility
  59.    HOWTO for more details.
  60.    
  61.   Display
  62.   
  63.    You should be using a VGA-compatible display interface for the console
  64.    terminal. Nearly every modern display card is compatible with VGA.
  65.    CGA, MDA, or HGA work OK for text, but they won't work with the X
  66.    Window System, and we haven't tested them. Use of a serial terminal
  67.    for the console is not yet supported.
  68.    
  69.   Other Hardware
  70.   
  71.    Linux supports a large variety hardware devices such as mice,
  72.    printers, scanners, modems, network cards, etc. However, none of these
  73.    devices are required while installing the system.
  74.    
  75. Before You Start
  76.  
  77.   Backups
  78.   
  79.    Before you start, make sure to back up every file that is now on your
  80.    system. The installation procedure can wipe out all of the data on a
  81.    hard disk!
  82.    
  83.   Information You'll Need
  84.   
  85.    Besides this document, you'll need the [2]cfdisk manual page, the
  86.    [3]Dselect Tutorial, the [4]Linux Hardware Compatibility HOWTO, and
  87.    the [5]X11 Release note for non-US-keyboard users.
  88.    
  89.    If your computer is connected to a network, you should ask your
  90.    network's system administrator for this information:
  91.    
  92.      * Your host name (you may be able to decide this on your own).
  93.      * Your domain name.
  94.      * Your computer's IP address.
  95.      * The netmask to use with your network.
  96.      * The IP address of your network.
  97.      * The broadcast address to use on your network.
  98.      * The IP address of the default gateway system you should route to,
  99.        if your network has a gateway.
  100.      * The system on your network that you should use as a DNS (Domain
  101.        Name Service) server.
  102.      * Which network type you use to connect to the network (Ethernet,
  103.        Token Ring).
  104.        
  105. Configuring Your System
  106.  
  107.   Disks
  108.   
  109.    There are some hardware details you should look into. First, decide
  110.    which disk you want to place the Linux system on. You've backed that
  111.    up along with your other disks already, right?
  112.    
  113.   The BIOS Set-Up Menu
  114.   
  115.    Your motherboard probably provides a BIOS set-up menu. Some systems
  116.    start this menu if you press DEL while the system is booting, some
  117.    require a SETUP disk, and some have other means of invoking the BIOS
  118.    set-up menu. If you can start this menu, use it to control the
  119.    features discussed in the following several paragraphs.
  120.    
  121.   Boot Device Selection
  122.   
  123.    Many BIOS set-up menus allow you to select the devices that will be
  124.    used to bootstrap the system. Set this to look for a bootable
  125.    operating system on a:, (the first floppy disk), and then c: (the
  126.    first hard disk). Since you'll boot Linux from a floppy while
  127.    installing it, it's important that the BIOS enables booting from a
  128.    floppy disk.
  129.    
  130.   Extended vs. Expanded Memory
  131.   
  132.    If your system provides both extended and expanded memory, set it so
  133.    that there is as much extended and as little expanded memory as
  134.    possible. Linux requires extended memory and can not use expanded
  135.    memory.
  136.    
  137.   Virus Protection
  138.   
  139.    Disable any virus-warning features your BIOS may provide. If you have
  140.    a virus-protection board or other special hardware, make sure it is
  141.    disabled or physically removed while running Linux. These aren't
  142.    compatible with Linux, and Linux has a better method of protecting you
  143.    from viruses.
  144.    
  145.   Shadow Ram
  146.   
  147.    Your motherboard probably provides shadow RAM. You may see settings
  148.    for "Video BIOS Shadow", "C800-CBFF Shadow", etc. Disable all shadow
  149.    RAM. Shadow RAM is used to accellerate access to the ROMs on your
  150.    motherboard and on some of the controller cards. Linux avoids using
  151.    these ROMs once it has booted because it provides its own faster
  152.    32-bit software in place of the 16-bit programs in the ROMs. Disabling
  153.    the shadow RAM may make some of it available for programs to use as
  154.    normal memory. Leaving the shadow RAM enabled may interfere with Linux
  155.    access to hardware devices.
  156.    
  157.   Advanced Power Management
  158.   
  159.    If your motherboard provides Advanced Power Management (APM),
  160.    configure it so that power management is controlled by APM. Disable
  161.    the doze, standby, suspend, nap, and sleep modes, and disable the
  162.    hard-disk power-down timer. Linux can take over control of these
  163.    modes, and can do a better job of power-management than the BIOS. The
  164.    version of the operating system kernel on the installation floppies
  165.    does not, however, use APM, because we've had reports of one laptop
  166.    system crashing when the Linux APM driver is configured. Once you've
  167.    installed Linux, you can install the kernel-source package and build a
  168.    custom-configured version of the operating system kernel to enable APM
  169.    and other features.
  170.    
  171.   The Turbo Switch
  172.   
  173.    Many systems have a turbo switch that controls the speed of the CPU.
  174.    Select the high-speed setting. If your BIOS allows you to disable
  175.    software control of the turbo switch (or software control of CPU
  176.    speed), do so and lock the system in high-speed mode. We have one
  177.    report that on a particular system, while Linux is auto-probing
  178.    (looking for hardware devices) it can accidentaly touch the software
  179.    control for the turbo switch.
  180.    
  181.   Over-Clocking your CPU
  182.   
  183.    Many people have tried operating their 90 MHz CPU at 100 MHz, etc. It
  184.    sometimes works, but is sensitive to temperature and other factors and
  185.    can actually damage your system. The author of this document
  186.    overclocked his own system for a year, and then the system started
  187.    aborting the gcc program with an unexpected signal while it was
  188.    compiling the operating system kernel. Turning the CPU speed back down
  189.    to its rated value solved the problem.
  190.    
  191.   Bad RAM
  192.   
  193.    The gcc compiler is often the first thing to die from bad RAM (or
  194.    other hardware problems that change data unpredictably) because it
  195.    builds huge data structures that it traverses repeatedly. An error in
  196.    these data structures will cause it to execute an illegal instruction
  197.    or access a non-existant address. The symptom of this will be gcc
  198.    dying from an unexpected signal.
  199.    
  200.    The very best motherboards support parity RAM and will actually tell
  201.    you if your system has a single-bit error in RAM. Unfortunately, they
  202.    don't have a way to fix the error, thus they generally crash
  203.    immediately after they tell you about the bad RAM. Still, it's better
  204.    to be told you have bad memory than to have it silently insert errors
  205.    in your data. Thus, the best systems have motherboards that support
  206.    parity and true-parity SIMMs.
  207.    
  208.   Fake or ("virtual") Parity RAM
  209.   
  210.    If you ask for Parity RAM in a computer store, you'll probably get
  211.    virtual parity SIMMs instead of true parity ones. Virtual parity SIMMs
  212.    can often (but not always) be distinguished because they only have one
  213.    more chip than an equivalent non-parity SIMM, and that one extra chip
  214.    is smaller than all the others. Virtual-parity SIMMs work exactly like
  215.    non-parity memory. They can't tell you when you have a single-bit RAM
  216.    error the way true-parity SIMMs do in a motherboard that implements
  217.    parity. Don't ever pay more for a virtual-parity SIMM than a
  218.    non-parity one. Do expect to pay a little more for true-parity SIMMs,
  219.    because you are actually buying one extra bit of memory for every 8
  220.    bits.
  221.    
  222.    If you do have true-parity RAM and your motherboard can handle it, be
  223.    sure to enable any BIOS settings that cause the motherboard to
  224.    interrupt on memory parity errors.
  225.    
  226.   Cyrix CPUs and Floppy Disk Errors
  227.   
  228.    Many users of Cyrix CPUs have had to disable the cache in their
  229.    systems during installation, because the floppy disk has errors if
  230.    they do not. If you have to do this, be sure to re-enable your cache
  231.    when you are finished with installation, as the system runs much
  232.    slower with the cache disabled.
  233.    
  234.    We don't think this is necessarily the fault of the Cyrix CPU. It may
  235.    be something that Linux can work around. We'll continue to look into
  236.    the problem. For the technically curious, we suspect a problem with
  237.    the cache being invalid after a switch from 16-bit to 32-bit code.
  238.    
  239.   Multiple Processors
  240.   
  241.    We have several reports that Debian runs well (and very fast) on
  242.    systems with two (or more) Pentium or Pentium Pro processors on the
  243.    same motherboard. To take advantage of multiple processors, you'll
  244.    have to install the kernel-source package and then re-compile the
  245.    kernel with symmetric multiprocessing support enabled. At this time
  246.    (kernel version 2.0.30) the way you enable that is to edit the
  247.    top-level Makefile for the kernel and un-comment the line that says
  248.    "SMP = 1". If you compile software on a multiprocessor system, look
  249.    for the "-j" flag in the documentation on "make".
  250.    
  251.   BIOS Settings to Watch Out For
  252.   
  253.    If your BIOS offers something like "15-16 MB Memory Hole", please
  254.    disable that. Linux expects to find memory there if you have that much
  255.    RAM.
  256.    
  257.    We have a report of an Intel Endeavor motherboard on which there is an
  258.    option called "LFB" or "Linear Frame Buffer". This had two settings:
  259.    "Disabled" and "1 Megabyte". Set it to "1 Megabyte". When disabled,
  260.    the installation floppy was not read correctly, and the system
  261.    eventually crashed. At this writing we don't understand what's going
  262.    on with this particular device - it just worked with that setting and
  263.    not without it.
  264.    
  265.   Hardware Settings to Watch Out For
  266.   
  267.    If any cards provide "mapped memory", the memory should be mapped
  268.    somewhere between 0xA0000 and 0xFFFFF (from 640K to just below 1
  269.    megabyte) or at an address at least 1 megabyte greater than the total
  270.    amount of RAM in your system.
  271.    
  272.   Windows-specific Hardware
  273.   
  274.    A disturbing trend is the proliferation of Windows modems and
  275.    printers. In some cases these are specially designed to be operated by
  276.    the Microsoft Windows operating system and bear the legend WinModem or
  277.    Made expecially for Windows-based computers. This is generally done by
  278.    removing the embedded processors of the hardware and shifting the work
  279.    they do over to a Windows driver that is run by your computer's main
  280.    CPU. This strategy makes the hardware less expensive, but the savings
  281.    are often not passed on to the user and this hardware may even be more
  282.    expensive than equivalent devices that retain their embedded
  283.    intellegence.
  284.    
  285.    You should avoid Windows-specific hardware for two reasons. The first
  286.    is that the manufacturers do not generally make the resources
  287.    available to write a Linux driver. Generally, the hardware and
  288.    software interface to the device is proprietary, and documentation is
  289.    not available without a non-disclosure agreement, if it is available
  290.    at all. This precludes its being used for free software, since free
  291.    software writers disclose the source code of their programs. The
  292.    second reason is that when devices like these have had their embedded
  293.    processors removed, the operating system must perform the work of the
  294.    embedded processors, often at real-time priority, and thus the CPU is
  295.    not available to run your programs while it is driving these devices.
  296.    Since the typical Windows user does not multi-process as intensively
  297.    as a Linux user, the manufacturers hope that the Windows user simply
  298.    won't notice the burden this hardware places on their CPU. However,
  299.    any multi-processing operating system, even Windows 95 or NT, is
  300.    degraded when peripheral manufacturers skimp on the embedded
  301.    processing power of their hardware.
  302.    
  303.    You can help this situation by encouraging these manufacturers to
  304.    release the documentation and other resources necessary for us to
  305.    program their hardware, but the best strategy is simply to avoid this
  306.    sort of hardware until it is listed as working in the [6]Linux
  307.    Hardware Compatibility HOWTO.
  308.    
  309.   Other Closed Hardware
  310.   
  311.    Some hardware manufacturers simply won't tell us how to write drivers
  312.    for their hardware, or they won't allow us access to the documentation
  313.    without a non-disclosure agreement that would prevent us from
  314.    releasing the Linux source code. One example is the IBM laptop DSP
  315.    sound system used in recent ThinkPad systems - some of these systems
  316.    also couple the sound system to the modem. Since we haven't been
  317.    granted access to the documentation on these devices, they simply
  318.    won't work under Linux. You can help by asking the manufacturers of
  319.    such hardware to release the documentation. If enough people ask, they
  320.    will realize that Linux is an important market. The [7]Linux Hardware
  321.    Compatibility HOWTO provides information about what devices currently
  322.    have Linux drivers.
  323.    
  324. Methods for Installing Debian
  325.  
  326.    In order to install Debian you need an Initial Boot Medium. After
  327.    booting from this you install the Kernel and the Modules, the Base
  328.    System and the Debian Packages. (Detailed installation instructions
  329.    follow below.)
  330.    
  331.    The following list shows which media can be used as source for these
  332.    components.
  333.    
  334.    Initial Boot Medium
  335.           The Initial Boot Medium is used to start the Debian
  336.           installation. It boots the installation system and runs the
  337.           installation program. The installation system can be booted
  338.           from:
  339.           
  340.           floppy disk
  341.             The required disk is called the Rescue Disk. The Rescue Disk
  342.             (usually) contains the kernel and the root filesystem that
  343.             provides the files and programs needed for the basic
  344.             installation.
  345.           CD-ROM
  346.             You need Debian on a bootable CD and the computer must be
  347.             able to boot from the CD-ROM drive.
  348.           Loadlin on a running DOS system
  349.             You need an already-running DOS system. Copy linux and
  350.             root.bin on this system, in addition you need loadlin from
  351.             the tools directory.
  352.             Loadlin is used to boot the kernel: loadlin linux
  353.             root=/dev/ram initrd=root.bin
  354.             
  355.           In some cases the root filesystem must be loaded from an extra
  356.           disk:
  357.           
  358.           When you boot from a 1.2MB floppy disk, you need the Root Disk
  359.             because the disk image file doesn't fit on the first 1.2MB
  360.             floppy disk.
  361.           When you have less than 6MB RAM, you need a special Low-Memory
  362.             Root Disk. You must boot from floppy disk.
  363.             
  364.    Kernel and Driver Modules
  365.           The Linux kernel and the modules can be installed from:
  366.           
  367.           floppy disk (Rescue Disk and Driver Disk)
  368.           filesystem on the local harddisk (msdos, minix or ext2)
  369.           CD-ROM
  370.             
  371.           In all but the first case you need a directory that contains
  372.           the files [8]resc1440.bin and [9]drv1440.bin on the medium.
  373.           
  374.           If you have a CD-ROM drive with a proprietary interface
  375.           (neither SCSI nor ATAPI) you need the Driver Disk in order to
  376.           install the CD-ROM interface driver from floppy.
  377.           
  378.    Base system
  379.           The Base system contains the initial Debian system that will be
  380.           copied to the hard disk. The Base system can be installed from:
  381.           
  382.           floppy disk (five 3,5" or 5,25"floppies)
  383.           filesystem on a local harddisk (msdos, minix or ext2)
  384.           CD-ROM
  385.           NFS (Network File System)
  386.             
  387.           In all but the first case you need a directory that contains
  388.           the file [10]base1_3.tgz on the medium.
  389.           
  390.    Debian Packages
  391.           Once you installed the Base system and rebooted into the fresh
  392.           system dselect offers install more Debian Packages. These
  393.           Packages can be installed from:
  394.           
  395.           floppy disk (you will need many floppies, try to avoid this!)
  396.           filesystem on a local harddisk (msdos, minix or ext2)
  397.           CD-ROM
  398.           NFS
  399.           FTP
  400.             
  401. Writing the Floppy Disk Image Files to Floppy Disk
  402.  
  403.    The following disks may be needed for installing Debian (Read above
  404.    section to decide which disks you need) :
  405.    
  406.    Rescue Disk
  407.           If your a: drive of the system upon which you will install
  408.           Linux uses 1.44MB floppy disks, you will need the file
  409.           [11]resc1440.bin; if it uses 1.2MB floppy disks, you will need
  410.           the file [12]resc1200.bin,
  411.           
  412.    Driver Disk
  413.           If your a: drive of the system upon which you will install
  414.           Linux uses 1.44MB floppy disks, you will need the file
  415.           [13]drv1440.bin; if it uses 1.2MB floppy disks, you will need
  416.           the file [14]drv1200.bin,
  417.           
  418.    Root Disk
  419.           The Root Disk can be created from the file [15]root.bin.
  420.           
  421.    Low-Memory Root Disk
  422.           The Low-Memory Root Disk can be created from the file
  423.           [16]lmemroot.bin. This file is 1.2MB large, so it fits on both
  424.           3,5" and 5,25" high density floppies.
  425.           
  426.    Base Disks
  427.           These disks will be generated from the files files
  428.           [17]base-1.bin, [18]base-2.bin, [19]base-3.bin, [20]base-4.bin,
  429.           and [21]base-5.bin. These files are 1.2MB large, so they fit on
  430.           both 3,5" and 5,25" high density floppies.
  431.           
  432.    If you are using a web browser on a networked computer to read this
  433.    document, you can probably retrieve the files by selecting their names
  434.    in your web browser. Otherwise, you can retrieve them from
  435.    [22]ftp://ftp.debian.org/debian/stable/disks-i386/current/ , or a
  436.    similar directory in any of the Debian FTP mirror sites. All of these
  437.    are floppy disk image files, which means that each file contains the
  438.    complete contents of a floppy disk in raw form. A special program is
  439.    used to write the image files to floppy disk in raw mode.
  440.    
  441.    Find (up to) 8 formatted floppy disks. Mark them with as "Rescue",
  442.    "Device Drivers", "Custom Boot", "Base 1", "Base 2", "Base 3", and
  443.    "Base 4".
  444.    
  445.    No file is written to the Custom Boot floppy, that will be written by
  446.    the Debian system while it is being installed.
  447.    
  448.   Writing from a DOS, Windows, or OS-2 System
  449.   
  450.    You'll find the [23]rawrite2.exe program in the same directory as the
  451.    floppy disk images. There's also a [24]rawrite2.txt file containing
  452.    instructions for rawrite2.exe .
  453.    
  454.    To write the floppy disk image files to the floppy disks, use the
  455.    command
  456.    
  457.         rawrite2 -f file -d drive
  458.  
  459.    where file is one of the floppy disk image files, and drive is either
  460.    a: or b:.
  461.    
  462.   Special Installation disk sets
  463.   
  464.    Sometimes certain hardware requires special Linux kernel versions or
  465.    specially patched kernels are needed in order to run Linux. Therefore
  466.    disk images using these special kernels are available. They are placed
  467.    in subdircetories of [25]special/. If you have any problems with
  468.    installing Debian check the README files in these diretories in order
  469.    to find out whether you should try these disk images.
  470.    
  471.   Writing from a Linux or Unix System
  472.   
  473.    Some systems attempt to automatically mount a floppy disk when you
  474.    place it in the drive. You might have to disable this feature before
  475.    the workstation will allow you to write a floppy in raw mode.
  476.    Unfortunately, I don't know the command necessary to do this for your
  477.    particular workstation. Ask your system administrator.
  478.    
  479.    To write the floppy disk image files to the floppy disks, use the
  480.    command
  481.    
  482.    dd if=file of=/dev/fd0 bs=512 conv=sync ; sync
  483.        
  484.    where file is one of the floppy disk image files. /dev/fd0 is a
  485.    commonly used name of the floppy-disk device, it may be different on
  486.    your workstation. The command may return to the prompt before Unix has
  487.    finished writing the floppy disk, so look for the disk-in-use light on
  488.    the floppy drive and be sure that the light is out and the disk has
  489.    stopped revolving before you remove it from the drive. On some
  490.    systems, you'll have to run a command to eject the floppy from the
  491.    drive.
  492.    
  493. Installing the System
  494.  
  495.   Floppy-disk Reliability
  496.   
  497.    The number one problem of people installing Debian for the first time
  498.    seems to be floppy-disk reliability.
  499.    
  500.    The Rescue Floppy is the one with the worst problems, because that
  501.    floppy is read by BIOS before Linux boots. BIOS doesn't seem to read
  502.    as reliably as the Linux floppy disk driver, and may just stop without
  503.    printing an error message if it reads incorrect data. There can also
  504.    be failures in the drivers floppy and the base floppies, most of which
  505.    indicate themselves with a flood of messages about disk I/O errors.
  506.    
  507.    If you are having the installation stall at a particular floppy, the
  508.    first thing you should do is re-download the floppy disk image and
  509.    write it to a different floppy. Simply reformatting the old floppy is
  510.    not sufficient, even if it appears that the floppy was reformatted and
  511.    written with no errors. It's sometimes useful to try writing the
  512.    floppy on a different system.
  513.    
  514.    One user reports he had to write three boot floppies before one
  515.    worked, and then everything was fine with the third floppy.
  516.    
  517.   The Rescue Floppy
  518.   
  519.    Place the Rescue floppy in the a: floppy drive, and reset the system
  520.    by pressing reset, turning the system off and then on, or by pressing
  521.    Control-Alt-Del on the keyboard. The floppy disk should be accessed,
  522.    and you should then see a screen that introduces the rescue floppy and
  523.    ends with the boot: prompt. It's called the Rescue floppy because you
  524.    can use it to boot your system and perform repairs if there is ever a
  525.    problem that makes your hard disk unbootable. Thus, you should save
  526.    this floppy after you've installed your system. Pressing F3 will give
  527.    further information on this.
  528.    
  529.    You can do two things at the boot: prompt. You can press the function
  530.    keys F1 through F10 to view a few pages of helpful information, or you
  531.    can boot the system. If you have less than 6MB RAM, you have to use a
  532.    floppy boot method (the boot methods are listed by pressing F3), and
  533.    you have to insert the Low-Memory Root Disk when being prompted for
  534.    the root floppy. This floppy must not be write proteced. If you boot
  535.    from a 1.2MB floppy drive, you have to use a ramdisk boot method, and
  536.    you will need the Root Disk. If you have any hardware devices that
  537.    aren't made accessable from Linux correctly when Linux boots, you may
  538.    find a parameter to add to the boot command line in the screens you
  539.    see by pressing F4 and F5. If you add any parameters to the boot
  540.    command line, be sure to type the boot method (the default is linux)
  541.    and a space before the first parameter. If you simply press Enter,
  542.    that's the same as typing linux without any special parameters.
  543.    
  544.    If this is the first time you're booting the system, just press Enter
  545.    and see if it works correctly. It probably will. If not, you can
  546.    reboot later and look for any special parameters that inform the
  547.    system about your hardware.
  548.    
  549.    Once you press Enter, you should see the message Loading..., and then
  550.    Uncompressing Linux..., and then a page or so of cryptic information
  551.    about the hardware in your system. There may be a many messages in the
  552.    form can't find something, or something not present, can't initialize
  553.    something, or even this driver release depends on something. Most of
  554.    these messages are harmless. You see them because the installation
  555.    boot disk is built to run on computers with many different peripheral
  556.    devices. Obviously, no one computer will have every possible
  557.    peripheral device, so the operating system may emit a few complaints
  558.    while it looks for peripherals you don't own. You may also see the
  559.    system pause for a while. This happens when it is waiting for a device
  560.    to respond, and that device is not present on your system. If you find
  561.    the time it takes to boot the system unacceptably long, you can create
  562.    a custom kernel once you've installed your system without all of the
  563.    drivers for non-existant devices.
  564.    
  565.    If you choose a non-default boot method, e.g. ramdisk or floppy, you
  566.    will be prompted to insert the Root floppy. Insert the Root Floppy
  567.    into the first disk drive and press Enter. (If you choose floppy1
  568.    insert the Root Floppy into the second disk drive.)
  569.    
  570.   Low-Memory Systems
  571.   
  572.    If you system has less than 6MB RAM , a paragraph about low memory and
  573.    a text menu with four choices can be displayed. This means that the
  574.    system detected that you don't have enough memory for a normal
  575.    installation, hence must follow a special low-memory installation
  576.    procedure. Go through the menu selections in order:
  577.      Use fdisk to create a Linux Swap partition (type 82). The swap
  578.        partition is needed to provide virtual memory during the
  579.        installation process, since that process will use more memory than
  580.        you have in your system. Select the size for the amount of virtual
  581.        memory you intend to use once your system is installed. 16
  582.        megabytes is probably the lowest amount that's practical, use 32
  583.        megabytes if you can spare the space, and 64 if your disk is large
  584.        enough that you won't miss that much.
  585.        In addition create a MINIX partition (type 81). This will hold the
  586.        root filesystem in the early installation process. Its size should
  587.        be at least 2 megabytes. This partition can be deleted when the
  588.        installation is finished.
  589.        Now create the ext2 partitions (type 83) on which you will install
  590.        Debian.
  591.      Activate the swap partition.
  592.      Copy the root filesystem to disk.
  593.      Reboot: boot the system again using the boot options that are shown.
  594.        
  595.   The Color-or-Monochrome Dialog Box
  596.   
  597.    Once the system has finished booting, you should see the color or
  598.    monochrome choice dialog box. If your monitor displays
  599.    black-and-white, press Enter to continue with the installation.
  600.    Otherwise, use the arrow key to move the cursor to the Color menu item
  601.    and then press Enter. The display should change from black-and-white
  602.    to color. Then press Enter again to continue with the installation.
  603.    
  604.   The Main Menu
  605.   
  606.    You may see a dialog box that says The installation program is
  607.    determining the current state of your system. On some systems, this
  608.    will go by too quickly to read. You'll see this dialog box between
  609.    steps in the main menu. The installation program will check the state
  610.    of the system in between each step. This checking allows you to
  611.    re-start the installation without losing the work you have already
  612.    done if you happen to halt your system in the middle of the
  613.    installation process. If you have to restart an installation, you will
  614.    have to configure color-or-monochrome, configure your keyboard,
  615.    re-activate your swap partition, and re-mount any disks that have been
  616.    initialized. Anything else that you have done with the installation
  617.    system will be saved.
  618.    
  619.    During the entire installation process, you will be presented with the
  620.    main menu. The choices at the top of the menu will change to indicate
  621.    your progress in installing the system. Phil Hughes wrote in Linux
  622.    Journal that you could teach a chicken to install Debian! He meant
  623.    that the installation process was mostly just pecking at the return
  624.    key. The first choice on the installation menu is the next action that
  625.    you should perform according to what the system detects you have
  626.    already done. It should say Next, and at this point the next item
  627.    should be Configure the Keyboard.
  628.    
  629.   Configuring the Keyboard
  630.   
  631.    Make sure the highlight is on the Next item, and Press Enter to go to
  632.    the keyboard configuration menu. Select a keyboard that conforms to
  633.    the layout used for your national language, or select something close
  634.    if the keyboard layout you want isn't represented. Once the system is
  635.    installed, you'll be able to select a keyboard layout from a wider
  636.    range of choices. Move the highlight to the keyboard selection you
  637.    desire and press Enter. Use the arrow keys to move the highlight -
  638.    they are in the same place in all national language keyboard layouts,
  639.    so they are independent of the keyboard configuration.
  640.    
  641.   The Shell
  642.   
  643.    If you are an experienced Unix or Linux user, press LeftAlt-F2 to get
  644.    to the second virtual console. That's the Alt key on the left-hand
  645.    side of the space bar, and the F2 function key, at the same time. This
  646.    is a separate window running a Bourne shell clone called ash. At this
  647.    point you are booted from the RAM disk, and there is a limited set of
  648.    Unix utilities available for your use. You can see what programs are
  649.    available with the command ls /bin /sbin /usr/bin /usr/sbin. Use the
  650.    menus to perform any task that they are able to do - the shell and
  651.    commands are only there in case something goes wrong. In particular,
  652.    you should always use the menus, not the shell, to activate your swap
  653.    partition, because the menu software can't detect that you've done
  654.    this from the shell. Press LeftAlt-F1 to get back to menus. Linux
  655.    provides up to 64 virtual consoles, although the Rescue floppy only
  656.    uses a few of them.
  657.    
  658.   Last Chance!
  659.   
  660.    Did we tell you to back up your disks? Here's your first chance to
  661.    wipe out all of the data on your disks, and your last chance to save
  662.    your old system. If you haven't backed up all of your disks, remove
  663.    the floppy from the drive, reset the system, and run backups.
  664.    
  665.   Partition Your Hard Disks
  666.   
  667.    If you have not already partitioned your disks for Linux native and
  668.    Linux swap filesystems, the menu item Next will be Partition a Hard
  669.    Disk. If you have already created at least one Linux Native and one
  670.    Linux Swap disk partition, the Next menu selection will be Initialize
  671.    and Activate the Swap Disk Partition, or you may even skip that step
  672.    if your system had low memory and you were asked to activate the swap
  673.    partition as soon as the system started. Whatever the Next menu
  674.    selection is, you can use the down-arrow key to select Partition a
  675.    Hard Disk.
  676.    
  677.    The Partition a Hard Disk menu item presents you with a list of disk
  678.    drives you can partition, and runs the cfdisk program, which allows
  679.    you to create and edit disk partitions. The [26]cfdisk manual page is
  680.    included with this document, and you should read it now. You must
  681.    create at least one "Linux" (type 83) disk partition, and one "Linux
  682.    Swap" (type 82) partition.
  683.    
  684.    Your swap partition will be used to provide virtual memory for the
  685.    system and should be between 16 and 128 megabytes in size, depending
  686.    on how much disk space you have and how many large programs you want
  687.    to run. Linux will not use more than 128 megabytes of swap, so there's
  688.    no reason to make your swap partition larger than that. A swap
  689.    partition is strongly recommended, but you can do without one if you
  690.    insist, and if your system has more than 16 megabytes of RAM. If you
  691.    wish to do this, please select the Do Without a Swap Partition item
  692.    from the menu.
  693.    
  694.    The "Linux" disk partition will hold all of your files, and you may
  695.    make it any size between 40 megabytes and the maximum size of your
  696.    disk minus the size of the swap partition. If you are already familiar
  697.    with Unix or Linux, you may want to make additional partitions - for
  698.    example, you can make partitions that will hold the /var, and /usr,
  699.    filesystems.
  700.    
  701.   Initialize and Activate the Swap Disk Partition
  702.   
  703.    This will be the Next menu item once you have created one disk
  704.    partition. You have the choice of initializing and activating a new
  705.    swap partition, activating a previously-initialized one, and doing
  706.    without a swap partition. It's always permissible to re-initialize a
  707.    swap partition, so select Initialize and Activate the Swap Disk
  708.    Partition unless you are sure you know what you are doing. This menu
  709.    choice will give you the option to scan the entire partition for
  710.    un-readable disk blocks caused by defects on the surface of the hard
  711.    disk platters. This is useful if you have MFM, RLL, or older SCSI
  712.    disks, and never hurts. Properly-working IDE disks don't need this
  713.    choice, as they have their own internal mechanism for mapping out bad
  714.    disk blocks.
  715.    
  716.    The swap partition provides virtual memory to supplement the RAM
  717.    memory that you've installed in your system. It's even used for
  718.    virtual memory while the system is being installed. That's why we
  719.    initialize it first.
  720.    
  721.   Initialize a Linux Disk Partition
  722.   
  723.    At this point, the Next menu item should be Initialize a Linux Disk
  724.    Partition. If it isn't, it's because you haven't completed the disk
  725.    partitioning process, or you haven't made one of the menu choices
  726.    dealing with your swap partition.
  727.    
  728.    You can initialize a Linux Disk partition, or alternatedly you can
  729.    mount a previously-initialized one.
  730.    
  731.    These floppies will not upgrade an old system without removing the
  732.    files - Debian provides a different procedure than using the boot
  733.    floppies for upgrading existing Debian systems. Thus, if you are using
  734.    old disk partitions that are not empty, you should initialize them
  735.    (which erases all files) here. You must initialize any partitions that
  736.    you created in the disk partitioning step. About the only reason to
  737.    mount a partition without initializing it at this point would be to
  738.    mount a partition upon which you have already performed some part of
  739.    the installation process using this same set of installation floppies.
  740.    
  741.    Select the Next menu item to initialize and mount the / disk
  742.    partition. The first partition that you mount or initialize will be
  743.    the one mounted as / (pronounced root). You will be offered the choice
  744.    to scan the disk partition for bad blocks, as you were when you
  745.    initialized the swap partition. It never hurts to scan for bad blocks,
  746.    but it could take 10 minutes or more to do so if you have a large
  747.    disk.
  748.    
  749.    Once you've mounted the / partition, the Next menu item will be
  750.    Install the Operating System Kernel and the Device Drivers unless
  751.    you've already performed some of the installation steps. You can use
  752.    the arrow keys to select the menu items to initialize and/or mount
  753.    disk partitions if you have any more partitions to set up. If you have
  754.    created separate partitions for /var, /usr, or other filesystems, you
  755.    should initialize and/or mount them now.
  756.    
  757.   Install the Operating System Kernel and the Device Drivers
  758.   
  759.    This should be the Next menu step after you've mounted your / disk,
  760.    unless you've already performed some of the installation steps on /.
  761.    Select it, and you will be offered a menu of drives to use to read the
  762.    kernel. If you choose to install from floppy disk insert the Rescue
  763.    Floppy as requested, and the kernel will be copied on to the hard
  764.    disk. In a later step this kernel will be used to create a custom boot
  765.    floppy for your system, and to make the hard disk bootable without a
  766.    floppy.
  767.    
  768.    If you choose to install from floppy disk you will be prompted to
  769.    insert the device drivers floppy. The device drivers will be copied to
  770.    your hard disk.
  771.    
  772.   Configure the Device Drivers
  773.   
  774.    Select the Configure Device Drivers menu item and look for devices
  775.    that are on your system. Configure those device drivers, and they will
  776.    be loaded whenever your system boots. If you want to install the base
  777.    system via NFS you must load and configure the driver module for your
  778.    network card.
  779.    
  780.    You can't load PCMCIA device drivers here. Once your system is
  781.    installed, you can install the pcmcia-cs package. This detects
  782.    PCMCIA cards automatically, and configures the ones it finds. It also
  783.    copes with hot-plugging the cards while the system is booted - they
  784.    will all be configured as they are plugged in, and de-configured when
  785.    you unplug them.
  786.    
  787.   Configure the Network
  788.   
  789.    You'll have to configure the network even if you don't have a network,
  790.    but you'll only have to answer the first two questions - what is the
  791.    name of your computer?, and is your system connected to a network?.
  792.    
  793.    If you are connected to a network, here come some questions that you
  794.    may not be able to figure out on your own - check with your network
  795.    administrator if you don't know:
  796.    
  797.      * Your host name.
  798.      * Your domain name.
  799.      * Your computer's IP address.
  800.      * The netmask to use with your network.
  801.      * The broadcast address to use on your network.
  802.      * The IP address of the default gateway system you should route to,
  803.        if your network has a gateway.
  804.      * The system on your network that you should use as a DNS (Domain
  805.        Name Service) server.
  806.      * The type of your network (Ethernet, Token Ring) and whether you
  807.        use a PCMCIA adapter. (If you choose to configure a PCMCIA network
  808.        adapter it won't work yet. You have to get and install the
  809.        pcmcia-cs package first.)
  810.        
  811.    Some technical details you might, or might not, find handy: the
  812.    program assumes the network IP address is the bitwise-AND of your
  813.    system's IP address and your netmask. It will guess the broadcast
  814.    address is the bitwise OR of your system's IP address with the bitwise
  815.    negation of the netmask. It will guess that your gateway system is
  816.    also your DNS server. If you can't find any of these answers, use the
  817.    system's guesses - you can change them once the system has been
  818.    installed, if necessary, by editing /etc/init.d/network .
  819.    
  820.   Install the Base System
  821.   
  822.    Select the Install the Base System menu item. You'll be offered a menu
  823.    of drives to use to read the base floppies. Select the appropriate
  824.    drive. If you choose to install from floppy disk feed in the Base 1,
  825.    2, 3, 4 and 5 as requested by the program. If one of the base floppies
  826.    is unreadable, you'll have to create a replacement floppy and feed all
  827.    floppies into the system again. Once the floppies have all been read,
  828.    the system will install the files it's read from them. This could take
  829.    10 minutes or more on slow systems, less on faster ones.
  830.    
  831.   Configure the Base System
  832.   
  833.    At this point you've read in all of the files that make up a minimal
  834.    Debian system, but you must perform some configuration before the
  835.    system will run. Select the Configure the Base System menu item.
  836.    
  837.    You'll be asked to select your time zone. Look for your time zone or
  838.    region of the world in the menu, and type it at the prompt. This may
  839.    lead to another menu, in which you can select your actual time zone.
  840.    
  841.    Next, you'll be asked if your system clock is to be set to GMT or
  842.    local time. Select GMT if you will only be running Linux and Unix on
  843.    your system, and select local time if you will be running another
  844.    operating system such as DOS or Windows. Unix and Linux keep GMT time
  845.    on the system clock and use software to convert it to the local time
  846.    zone. This allows them to keep track of daylight savings time and leap
  847.    years, and even allows users who are logged in from other time zones
  848.    to individually set the time zone used on their terminal. If you run
  849.    the system clock on GMT and your locality uses daylight savings time,
  850.    you'll find that the system adjusts for daylight savings time properly
  851.    on the days that it starts and ends.
  852.    
  853.   Make the Hard Disk Bootable
  854.   
  855.    If you select to make the hard disk boot directly to Linux, you will
  856.    be asked to install a master boot record. If you aren't using a boot
  857.    manager (and this is probably the case if you don't know what a boot
  858.    manager is), answer yes to this question. The next question will be
  859.    whether you want to boot Linux automatically from the hard disk when
  860.    you turn on your system. This sets Linux to be the bootable partition
  861.    - the one that will be loaded from the hard disk. If you answer no to
  862.    this question, you can set the bootable partition later using the DOS
  863.    fdisk program, or with the Linux fdisk or activate programs.
  864.    
  865.    If you are installing Linux on a drive other than the first hard disk
  866.    in your system, be sure to make a boot floppy. The boot ROM of most
  867.    systems is only capable of directly booting from the first hard drive,
  868.    not the second one. You can, however, work around this problem once
  869.    you've installed your system. To do so, read the instructions in the
  870.    directory /usr/doc/lilo.
  871.    
  872.   Make a Boot Floppy
  873.   
  874.    You should make a boot floppy even if you intend to boot the system
  875.    from the hard disk. The reason for this is that it's possible for the
  876.    hard disk bootstrap to be mis-installed, but a boot floppy will almost
  877.    always work. Select Make a Boot Floppy from the menu and feed the
  878.    system a blank floppy as directed. Make sure the floppy isn't
  879.    write-protected, as the software will format and write it. Mark this
  880.    the "Custom Boot" floppy and write-protect it once it has been
  881.    written.
  882.    
  883.   The Moment of Truth
  884.   
  885.    This is what electrical engineers call the smoke test - what happens
  886.    when you turn on a new system for the first time. Remove the floppy
  887.    disk from the floppy drive, and select the Reboot the System menu
  888.    item. If the Linux system doesn't start up, insert the Custom Boot
  889.    floppy you created and reset your system. Linux should boot. You
  890.    should see the same messages as when you first booted the installation
  891.    boot floppy, followed by some new messages.
  892.    
  893.   Set the Root Password
  894.   
  895.    This is the password for the super-user, a login that bypasses all
  896.    security protection on your system. It should only be used to perform
  897.    system administration, and only for as short a time as possible. Do
  898.    not use root as your personal login. You will be prompted to create a
  899.    personal login as well, and that's the one you should use to send and
  900.    receive e-mail and perform most of your work - not root. The reason to
  901.    avoid using root's privileges is that you might be tricked into
  902.    running a trojan-horse program - that is a program that takes
  903.    advantage of your super-user power to compromise the security of your
  904.    system behind your back. Any good book on Unix system administration
  905.    will cover this topic in more detail - consider reading one if it's
  906.    new to you. The good news is that Linux is probably more secure than
  907.    other operating systems you might run on your PC. DOS and Windows, for
  908.    example, give all programs super-user privilege. That's one reason
  909.    that they have been so plagued by viruses.
  910.    
  911.    All of the passwords you create should contain from 6 to 8 characters,
  912.    and should contain both upper and lower-case characters, as well as
  913.    punctuation characters.
  914.    
  915.    Once you've added both logins, you'll be dropped into the dselect
  916.    program. The [27]Dselect Tutorial is required reading before you run
  917.    dselect. Dselect allows you to select packages to be installed on your
  918.    system. If you have a CD-ROM or hard disk containing the additional
  919.    Debian packages that you want to install on your system, or you are
  920.    connected to the Internet, this will be useful to you right away.
  921.    Otherwise, you may want to quit dselect and start it later, once you
  922.    have transported the Debian package files to your system. You must be
  923.    the super-user (root) when you run dselect. If you are about to
  924.    install the X Window system and you do not use a US keyboard, you
  925.    should read the [28]X11 Release note for non-US-keyboard users.
  926.    
  927.   Log In
  928.   
  929.    After you've quit dselect, you'll be presented with the login prompt.
  930.    Log in using the personal login and password you selected. Your system
  931.    is now ready to use.
  932.    
  933. Technical Information on the Boot Floppies
  934.  
  935.   Source Code
  936.   
  937.    The "boot-floppies" package contains all of the source code for the
  938.    installaton floppies.
  939.    
  940.   The Rescue Floppy
  941.   
  942.    The Rescue Floppy is an MS-DOS filesystem, and you should be able to
  943.    access it from a DOS or Windows system or anything else that can mount
  944.    DOS disks. The Linux kernel is in the file "linux". The file root.bin
  945.    is a gzip-compressed disk image of a 1.44 MB Minix filesystem, and
  946.    will be loaded into the RAM disk and used as the root filesystem.
  947.    
  948.   Replacing the Kernel
  949.   
  950.    If you find it necessary to replace the kernel on the Rescue Floppy,
  951.    you must configure your new kernel with these features linked in, not
  952.    in loadable modules:
  953.      * Initial RAM disk.
  954.      * MSDOS, Minix, and EXT2 filesystems.
  955.      * ELF executables.
  956.        
  957.    Copy your new kernel to the file "linux" on the Rescue Floppy, and
  958.    then run the shell script "rdev.sh" that you'll find on the floppy.
  959.    
  960.   The Base Floppies
  961.   
  962.    The base floppies contain a 512-byte header followed by a portion of a
  963.    gzip-compressed "tar" archive. If you strip off the headers and then
  964.    concatenate the contents of the base floppies, the result should be
  965.    the compressed tar archive. The archive contains the base system that
  966.    will be installed on your hard disk. Once this archive is installed,
  967.    you must go through the Configure the Base System menu item in the
  968.    installation system and other menu items to configure the network and
  969.    install the operating system kernel and modules before the system will
  970.    be usable.
  971.    
  972. Last Update
  973.  
  974.    The last update of this document was made on August 01, 1997.
  975.    
  976. Copyright of This Document
  977.  
  978.    Copyright 1996 Bruce Perens; 1996, 1997 Sven Rudolph. This document
  979.    may be distributed under the terms of the GNU General Public License.
  980.    
  981. Trademark Acknowledgement
  982.  
  983.    Trademarks that are not explicitly acknowledged here are the property
  984.    of their respective holders. 386, 386sx, 486, Pentium, and Pentium Pro
  985.    are the property of Intel. Windows and WinModem are a trademark of
  986.    Microsoft. ThinkPad and PS/2 are the property of IBM.
  987.  
  988. References
  989.  
  990.    1. http://sunsite.unc.edu/mdw/HOWTO/Hardware-HOWTO.html
  991.    2. ftp:cfdisk.txt
  992.    3. ftp:dselect.beginner.6.html
  993.    4. http://sunsite.unc.edu/mdw/HOWTO/Hardware-HOWTO.html
  994.    5. ftp:X11_release_note.txt
  995.    6. http://sunsite.unc.edu/mdw/HOWTO/Hardware-HOWTO.html
  996.    7. http://sunsite.unc.edu/mdw/HOWTO/Hardware-HOWTO.html
  997.   22. ftp://ftp.debian.org/debian/stable/disks-i386/current/
  998.   23. ftp:rawrite2.exe
  999.   24. ftp:rawrite2.txt
  1000.   25. ftp://ftp.debian.org/debian/stable/disks-i386/current/special
  1001.   26. ftp:cfdisk.txt
  1002.   27. ftp:dselect.beginner.6.html
  1003.   28. ftp:X11_release_note.txt
  1004.