From 1ea73eea5ecc6a8ed901316049259aee737ee554 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Fri, 7 Oct 2005 19:51:38 +0000 Subject: move manual to top-level directory, split out of debian-installer package --- eu/install-methods/automatic-install.xml | 88 ++++++ eu/install-methods/boot-drive-files.xml | 202 ++++++++++++++ eu/install-methods/boot-usb-files.xml | 188 +++++++++++++ eu/install-methods/create-floppy.xml | 103 +++++++ eu/install-methods/download/alpha.xml | 36 +++ eu/install-methods/download/arm.xml | 37 +++ eu/install-methods/download/m68k.xml | 102 +++++++ eu/install-methods/download/powerpc.xml | 26 ++ eu/install-methods/downloading-files.xml | 37 +++ eu/install-methods/floppy/i386.xml | 51 ++++ eu/install-methods/floppy/m68k.xml | 31 +++ eu/install-methods/floppy/powerpc.xml | 119 +++++++++ eu/install-methods/install-methods.xml | 16 ++ eu/install-methods/install-tftp.xml | 446 +++++++++++++++++++++++++++++++ eu/install-methods/ipl-tape.xml | 31 +++ eu/install-methods/official-cdrom.xml | 70 +++++ eu/install-methods/tftp/bootp.xml | 78 ++++++ eu/install-methods/tftp/dhcp.xml | 111 ++++++++ eu/install-methods/tftp/rarp.xml | 73 +++++ 19 files changed, 1845 insertions(+) create mode 100644 eu/install-methods/automatic-install.xml create mode 100644 eu/install-methods/boot-drive-files.xml create mode 100644 eu/install-methods/boot-usb-files.xml create mode 100644 eu/install-methods/create-floppy.xml create mode 100644 eu/install-methods/download/alpha.xml create mode 100644 eu/install-methods/download/arm.xml create mode 100644 eu/install-methods/download/m68k.xml create mode 100644 eu/install-methods/download/powerpc.xml create mode 100644 eu/install-methods/downloading-files.xml create mode 100644 eu/install-methods/floppy/i386.xml create mode 100644 eu/install-methods/floppy/m68k.xml create mode 100644 eu/install-methods/floppy/powerpc.xml create mode 100644 eu/install-methods/install-methods.xml create mode 100644 eu/install-methods/install-tftp.xml create mode 100644 eu/install-methods/ipl-tape.xml create mode 100644 eu/install-methods/official-cdrom.xml create mode 100644 eu/install-methods/tftp/bootp.xml create mode 100644 eu/install-methods/tftp/dhcp.xml create mode 100644 eu/install-methods/tftp/rarp.xml (limited to 'eu/install-methods') diff --git a/eu/install-methods/automatic-install.xml b/eu/install-methods/automatic-install.xml new file mode 100644 index 000000000..98cd14814 --- /dev/null +++ b/eu/install-methods/automatic-install.xml @@ -0,0 +1,88 @@ + + + + + Instalazio automatikoa + + +Ordenagailu anitzetan instalatzeko posible da guztiz automatizatutako +instalazio bat egitea. Hau posible egiten duten paketeak: +fai (Instazaio zerbitzari bat erabiltzen duena), +replicator, +systemimager, +autoinstall, eta +Debian Instalatzailea bera dira. + + + + +Debian Instalatzailea erabiliaz instalazio automatikoa + + +Debian instalatzaileak aurrekonfigurazio fitxategien bidez instalazio +automatiko onartzen du. Aurrekonfigurazio fitxategiak sare bidez edo +medio aldagarrien bidez kargatu eta instalazioan egingo diren galderak +erantzuteko erabili daiteke. + + + +Aurrekonfigurazio fitxategia debconf-set-selections komandoak +erabiltzen duen formatuan dago. Ondo dokumentaturiko eta lanean +dagoen editatu dezakezun adibide bat hemen dago: +. + + + +Beste aldetik, aukeratu behar diiren aukera guztien erantzunak +eskuratzeko era bat eskuzko instalazio bat egin eta orduan +debconf-utils paketeko +debconf-get-selections koamdoa erabili +bai debconf eta bai /var/log/debian-installer/cdebconf fitxategiko +cdebconf databaseak fitxategi batetara irauktzeko: + + +debconf-get-selections --installer > fitxategia +debconf-get-selections >> fitxategia + + + + +Hala ere honela sortutako fitxategi batek erantzungabeko galderak eduki +ditzake eta, fitxategia +erabilgarriagoa da erabiltzaile gehienentzat. + + + +Bein aurrekonfigurazio fitxategiarekin, editatu daiteke behar ezkero, +ipini web zerbitzari batetan, edo kopiatu instalatzailearen mediora. +Behin fitxategia erabakitako lekuan ipinita Instalatzaileari +abiarazte garaian komando bat eman behar zaio erabil dezan. + + + +Instalatzaileak sare bidez deskargaturiko aurrekonfigurazio bat +erabiltzeko gehitu preseed/url=http://url/helbidea/preseed.cfg +kernela abiarazteko aukerei. Noski aurrekonfigurazioak ezingo du +lan egin instalatzaileak sarea martxan ipini arte, horregatik +da oso erabilgarria instalatzaileak ezer galdetu gabe DHCP bidez +instalatzeko aukera izatea. Agian instalazio lehentasuna kritikora +ezartzea interesgarri zain daiteke sareari buruzko datu guztiak +konfiguratu daitezen. Begiratu . + + + +Aurrekonfigurazio fitxategia CD batetan ipintzeko, ISO irudi original +nerregin egin behar da berau gehitzeko. mkisofs manual orrialdea +begiratu argibide gehiagorako. Betela fitxategia diskete batetan ipini +eta 'preseed/file=/floppy/preseed.cfg' erabili. + + + +USB memoria baten bidez abiarazi nahi zain ezkeri, orduan kopiatu +aurrekonfigurazio fitxategia memoriaren fitxategi sisteman eta +syslinux.cfg fitxategia editatu preseed/file=/hd-media/preseed.cfg gehitzeko +kernele abiarazte aukeren barruan. + + + + diff --git a/eu/install-methods/boot-drive-files.xml b/eu/install-methods/boot-drive-files.xml new file mode 100644 index 000000000..93325cf72 --- /dev/null +++ b/eu/install-methods/boot-drive-files.xml @@ -0,0 +1,202 @@ + + + + + Preparing Files for Hard Disk Booting + + +The installer may be booted using boot files placed on an +existing hard drive partition, either launched from another operating +system or by invoking a boot loader directly from the BIOS. + + + +A full, "pure network" installation can be achieved using this +technique. This avoids all hassles of removable media, like finding +and burning CD images or struggling with too numerous and + unreliable floppy disks. + + + +The installer cannot boot from files on an NTFS file system. + + + +The installer cannot boot from files on an HFS+ file system. MacOS +System 8.1 and above may use HFS+ file systems; NewWorld PowerMacs all +use HFS+. To determine whether your existing file system is HFS+, +select Get Info for the volume in question. HFS +file systems appear as Mac OS Standard, while +HFS+ file systems say Mac OS Extended. You must +have an HFS partition in order to exchange files between MacOS and +Linux, in particular the installation files you download. + + + +Different programs are used for hard disk installation system booting, +depending on whether the system is a ``NewWorld'' or an ``OldWorld'' +model. + + + + + Hard disk installer booting using <command>LILO</command> or + <command>GRUB</command> + + +This section explains how to add to or even replace an existing linux +installation using either LILO or +GRUB. + + + +At boot time, both bootloaders support loading in memory not +only the kernel, but also a disk image. This RAM disk can be used as +the root file-system by the kernel. Choose the flavor in + that best fits your taste, and you +will be (almost) done. + + + +Copy the following two or three files from the Debian archives in a +convenient location on your hard drive, for instance in +/boot/newinstall/. + + + + +vmlinuz (kernel binary) + + + + +initrd.gz (ramdisk image) + + + + +drivers.tgz (optional kernel modules) + + + + +Extract recursively everything now (easier than +later). Remember on which physical partition +(e.g. /dev/hda4) are the .o +drivers you just extracted from drivers.tgz. + + + +You can also replace vmlinuz and +drivers.tgz by your custom kernel and the +carefully chosen drivers that you will need for the installation, for +instance a module for your exotic and unsupported network interface. +Do not forget that your custom kernel must have (at least) the +RAMDISK and initrd features +built-in. See the very beginning of + for the list of the other +mandatory built-in kernel features required to boot and launch the +installer. The floppy-related stuff after the list of features is +irrelevant to you. + + + +Finally, to configure the bootloader proceed to +. + + + + + + + Hard Disk Installer Booting for OldWorld Macs + + +The boot-floppy-hfs floppy uses +miBoot to launch Linux installation, but +miBoot cannot easily be used for hard disk +booting. BootX, launched from MacOS, +supports booting from files placed on the hard +disk. BootX can also be used to dual-boot +MacOS and Linux after your Debian installation is complete. For the +Performa 6360, it appears that quik cannot make the +hard disk bootable. So BootX is required +on that model. + + + +Download and unstuff the BootX +distribution, available from , +or in the +dists/woody/main/disks-powerpc/current/powermac +directory on Debian http/ftp mirrors and official Debian CDs. Use +Stuffit Expander to extract it from its +archive. Within the package, there is an empty folder called +Linux Kernels. Download +linux.bin and +ramdisk.image.gz from the +disks-powerpc/current/powermac folder, and place +them in the Linux Kernels folder. Then place the +Linux Kernels folder in the active System Folder. + + + + + + Hard Disk Installer Booting for NewWorld Macs + + +NewWorld PowerMacs support booting from a network or an ISO9660 +CD-ROM, as well as loading ELF binaries directly from the hard +disk. These machines will boot Linux directly via +yaboot, which supports loading a kernel and RAMdisk +directly from an ext2 partition, as well as dual-booting with +MacOS. Hard disk booting of the installer is particularly appropriate +for newer machines without floppy drives. BootX is +not supported and must not be used on NewWorld PowerMacs. + + + +Copy (not move) the following four files which +you downloaded earlier from the Debian archives, onto the root level +of your hard drive (this can be accomplished by +option-dragging each file to the hard drive icon). + + + + +linux.bin + + + + +root.bin (from inside the images-1.44 folder) + + + + +yaboot + + + + +yaboot.conf + + + + + + +Make a note of the partition number of the MacOS partition where you +place these files. If you have the MacOS pdisk +program, you can use the L command to check for the partition +number. You will need this partition number for the command you type +at the Open Firmware prompt when you boot the installer. + + + +To boot the installer, proceed to . + + + + diff --git a/eu/install-methods/boot-usb-files.xml b/eu/install-methods/boot-usb-files.xml new file mode 100644 index 000000000..e27166ad7 --- /dev/null +++ b/eu/install-methods/boot-usb-files.xml @@ -0,0 +1,188 @@ + + + + + Preparing Files for USB Memory Stick Booting + + + +For preparing the USB stick you will need a system where GNU/Linux is +already running and where USB is supported. You should assure that the +usb-storage kernel module is loaded (modprobe +usb-storage) and try to find out which SCSI device the USB +stick has been mapped to (in this example +/dev/sda is used). To write to your stick, you +will probably have to turn off its write protection switch. + + + +Note, that the USB stick should be at least 128 MB in size (smaller +setups are possible if you follow ). + + + + + Copying the files - the easy way + + +There is an all-in-one file hd-media/boot.img.gz +which contains all the installer files (including the kernel) as well +as SYSLINUX and its configuration file. You only +have to extract it directly to to your USB stick: + + + +gzip -dc boot.img.gz >/dev/sda + + + +Of course this will destroy anything already on the device, so take +care that you use the correct device name for your USB stick. + + + +After that, mount the USB memory stick (mount /dev/sda +/mnt), which will now have a FAT filesystem on it, and +copy a Debian netinst or businesscard ISO image to it. Please note +that the file name must end in .iso. Unmount the +stick (umount /mnt) and you are done. + + + + + + Copying the files - the flexible way + + +If you like more flexibility or just want to know what's going on, you +should use the following method to put the files on your stick. We +will show how to setup the memory stick to use the first partition, +instead of entire device. + + + +Since most USB sticks come pre-configured with a single FAT16 +partition, you probably won't have to repartition or reformat the +stick. If you have to do that anyway, use cfdisk +or any other partitioning tool for creating a FAT16 partition and then +type + + + +mkdosfs /dev/sda1 + + + +Take care that you use the correct device name for your USB stick. The +mkdosfs command is contained in the +dosfstools Debian package. + + + +In order to start the kernel after booting from the USB stick, we will +put a boot loader on the stick. Although any boot loader +(e.g. LILO) should work, it's convenient to use +SYSLINUX, since it uses a FAT16 partition and can +be reconfigured by just editing a text file. Any operating system +which supports the FAT file system can be used to make changes to the +configuration of the boot loader. + + + +To put SYSLINUX on the FAT16 partition on your USB +stick, install the syslinux and +mtools packages on your system, and type + + + +syslinux /dev/sda1 + + + +Again, take care that you use the correct device name. The partition +must not be mounted when starting SYSLINUX. This +procedure writes a boot sector to the partition and creates the file +ldlinux.sys which contains the boot loader code. + + + +Mount the parition (mount /dev/sda1 /mnt) and +copy the following files from the Debian archives to the stick: + + + + +vmlinuz (kernel binary) + + + + +initrd.gz (initial ramdisk image) + + + + +syslinux.cfg (SYSLINUX configuration file) + + + + +Optional kernel modules + + + + +If you want to rename the files, please note that +SYSLINUX can only process DOS (8.3) file names. + + + +The syslinux.cfg configuration file should +contain the following two lines: + + + +default vmlinuz +append initrd=initrd.gz ramdisk_size=10000 root=/dev/rd/0 init=/linuxrc devfs=mount,dall rw + + + +Please note, that the ramdisk_size parameter +may need to be increased, depending on the image you are booting. + + + +Now you should put any Debian ISO image (businesscard, netinst or even +a full one) onto your stick (if it fits). The file name of such an +image must end in .iso. + + + +If you want to install over the network, without using an ISO image, +you will of course skip the previous step. Moreover you will have to +use the initial ramdisk from the netboot +directory instead of the one from hd-media, +because hd-media/initrd.gz does not have network +support. + + + +When you are done, unmount the USB memory stick (umount +/mnt) and activate its write protection switch. + + + +If your system refuses to boot from the memory stick, the stick may +contain an invalid master boot record (MBR). To fix this, use the +install-mbr command from the package +mbr: + + + +install-mbr /dev/sda + + + + + + diff --git a/eu/install-methods/create-floppy.xml b/eu/install-methods/create-floppy.xml new file mode 100644 index 000000000..2f7fa9d1a --- /dev/null +++ b/eu/install-methods/create-floppy.xml @@ -0,0 +1,103 @@ + + + + + Creating Floppies from Disk Images + + +Bootable floppy disks are commonly used to boot the installer system +for machines with a floppy drive. Floppies can also be used for +installation of the kernel and modules on most systems. + + + +Floppy disk booting reportedly fails on Mac USB floppy drives. + + + +Floppy disk booting is not supported on Amigas or +68k Macs. + + + +Disk images are files containing the complete contents of a floppy +disk in raw form. Disk images, such as +boot.img, cannot simply be copied to floppy +drives. A special program is used to write the image files to floppy +disk in raw mode. This is required because these +images are raw representations of the disk; it is required to do a +sector copy of the data from the file onto the +floppy. + + + +There are different techniques for creating floppies from disk images, +which depend on your platform. This section describes how to create +floppies from disk images on different platforms. + + + +No matter which method you use to create your floppies, you should +remember to flip the tab on the floppies once you have written them, +to ensure they are not damaged unintentionally. + + + + Writing Disk Images From a Linux or Unix System + + +To write the floppy disk image files to the floppy disks, you will +probably need root access to the system. Place a good, blank floppy +in the floppy drive. Next, use the command + + +dd if=file of=/dev/fd0 bs=1024 conv=sync ; sync + + +where file is one of the floppy disk image +files (see for what +file should be). +/dev/fd0 is a commonly used name of the floppy +disk device, it may be different on your workstation (on Solaris, it +is /dev/fd/0). The command may return to the +prompt before Unix has finished writing the floppy disk, so look for +the disk-in-use light on the floppy drive and be sure that the light +is out and the disk has stopped revolving before you remove it from +the drive. On some systems, you'll have to run a command to eject the +floppy from the drive (on Solaris, use eject, see +the manual page). + + + +Some systems attempt to automatically mount a floppy disk when you +place it in the drive. You might have to disable this feature before +the workstation will allow you to write a floppy in raw +mode. Unfortunately, how to accomplish this will vary +based on your operating system. On Solaris, you can work around +volume management to get raw access to the floppy. First, make sure +that the floppy is auto-mounted (using volcheck or +the equivalent command in the file manager). Then use a +dd command of the form given above, just replace +/dev/fd0 with +/vol/rdsk/floppy_name, +where floppy_name is the name the floppy +disk was given when it was formatted (unnamed floppies default to the +name unnamed_floppy). On other systems, ask your +system administrator. + + + +If writing a floppy on powerpc Linux, you will need to eject it. The +eject program handles this nicely; you might need +to install it. + + + + + +&floppy-i386.xml; +&floppy-m68k.xml; +&floppy-powerpc.xml; + + + diff --git a/eu/install-methods/download/alpha.xml b/eu/install-methods/download/alpha.xml new file mode 100644 index 000000000..6aec375c3 --- /dev/null +++ b/eu/install-methods/download/alpha.xml @@ -0,0 +1,36 @@ + + + + + Alpha Installation Files + + +If you choose to boot from ARC console firmware using +MILO, you will also need to prepare a disk +containing MILO and LINLOAD.EXE +from the provided disk images. See +for more information on Alpha +firmware and boot loaders. The floppy images can be found in the +MILO directory as +milo_subarchitecture.bin. + + + +Unfortunately, these MILO images could not be +tested and might not work for all subarchitectures. If you find it +doesn't work for you, try copying the appropriate +MILO binary onto the floppy +(). +Note that those MILOs don't support ext2 ``sparse +superblocks'', so you can't use them to load kernels from newly +generated ext2 file systems. As a workaround, you can put your kernel +onto the FAT partition next to the MILO. + + + +MILO binaries are platform-specific. See + to determine the appropriate +MILO image for your Alpha platform. + + + diff --git a/eu/install-methods/download/arm.xml b/eu/install-methods/download/arm.xml new file mode 100644 index 000000000..f0bc838b0 --- /dev/null +++ b/eu/install-methods/download/arm.xml @@ -0,0 +1,37 @@ + + + + + + RiscPC Installation Files + + +The RiscPC installer is booted initially from RISC OS. All the +necessary files are provided in one Zip archive, &rpc-install-kit;. +Download this file onto the RISC OS machine, copy the +linloader.!Boot components into place, and run +!dInstall. + + + + + + NetWinder Installation Files + + +The easiest way to boot a NetWinder is over the network, using the +supplied TFTP image &netwinder-boot-img;. + + + + + + CATS Installation Files + + +The only supported boot method for CATS is to use the combined image +&cats-boot-img;. This can be loaded from any device accessible to the +Cyclone bootloader. + + + diff --git a/eu/install-methods/download/m68k.xml b/eu/install-methods/download/m68k.xml new file mode 100644 index 000000000..471d64273 --- /dev/null +++ b/eu/install-methods/download/m68k.xml @@ -0,0 +1,102 @@ + + + + + + AmigaOS Installation Files + + + + +Instead of the boot, root, and driver files above, just download +&amiga-install-tarball;. + + + + +Unpack &amiga-install-tarball; into a partition with at least 25MB +free. We recommend you unpack it into a directory named +debian. The &amiga-install-tarball; will create an +amiga subdirectory. + + + + +Write down the Linux partition name for the location where your new +debian directory is. See + for more information on Linux partition +naming. + + + + + + + Atari TOS Installation Files + + + + +Instead of the boot, root, and driver files above, just download +&atari-install-tarball;. + + + + +Unpack &atari-install-tarball; into a partition with at least 25 MB +free. We recommend you unpack it into a directory named +debian. + + + + +After unpacking, you should have an atari +subdirectory. Do not rename any files in this directory. + + + + +Write down the Linux partition name for the location where your new +debian directory is. See + for more +information on Linux partition naming. + + + + + + + 68k MacOS Installation Files + + + + +Instead of the boot, root, and driver files above, just download +&mac-install-tarball;. + + + + +Unpack &mac-install-tarball; into a partition with at least 25 MB +free. We recommend you unpack it into a directory named +debian. Use Stuffit Expander +(at least version 5.5) or MacGZip to extract it +from its archive. + + + + +After unpacking, you should have a mac subdirectory. Do +not rename any files in this directory. Do not allow your +decompression program to decompress drivers.tgz. + + + + +Write down the Linux partition name for the location where your new +debian directory is. See +for more information on Linux partition naming. + + + + diff --git a/eu/install-methods/download/powerpc.xml b/eu/install-methods/download/powerpc.xml new file mode 100644 index 000000000..8797b27fa --- /dev/null +++ b/eu/install-methods/download/powerpc.xml @@ -0,0 +1,26 @@ + + + + + + NewWorld MacOS Installation Files + + +For floppy-less installation on NewWorld Macs, it may be most +convenient to obtain all the necessary files packaged into one Stuffit +archive from + (separate instructions are +included in the archive). Otherwise, obtain the normal installation +files listed above. Retrieve the files to an HFS (not HFS+) partition +on your system. You will also need the yaboot and +yaboot.conf files from the +new-powermac or +powermac archive folder. +However, the newest G4 PowerMacs, and those that work without MacOS 9, +need the newest version of yaboot; the one in the +archive will not work. Obtain the newest version from +. + + + + diff --git a/eu/install-methods/downloading-files.xml b/eu/install-methods/downloading-files.xml new file mode 100644 index 000000000..8d0ebecd3 --- /dev/null +++ b/eu/install-methods/downloading-files.xml @@ -0,0 +1,37 @@ + + + + + Fitxategiak Debian Ispiluetatik Deskargatzen + + + +Gertuen dagoen (eta ziurrenik azkarren) Ispilua bilatzeko begirtatu: +Debian ispilu zerrenda. + + + +Fitxategiak Debian zerbitzaritik deskargatzerakoan, ziurtatu +fitxategiak binary moduan deskargatzen dituzula, +ez testu edo automatiko moduan. + + + + + Non bilatu Instalazio Irudiak + + +Instalazio irudiak Debian ispilu bakoitzeko karpeta honetan daude: +debian/dists/&releasename;/main/installer-&architecture;/current/images/ +-- MANIFEST +fitxategiak irudi bakoitza eta bere erabilpena zerrendatzen ditu. + + +&download-alpha.xml; +&download-arm.xml; +&download-powerpc.xml; +&download-m68k.xml; + + + + diff --git a/eu/install-methods/floppy/i386.xml b/eu/install-methods/floppy/i386.xml new file mode 100644 index 000000000..1ea55234b --- /dev/null +++ b/eu/install-methods/floppy/i386.xml @@ -0,0 +1,51 @@ + + + + + + + + Writing Disk Images From DOS, Windows, or OS/2 + + + +If you have access to an i386 machine, you can use one of the +following programs to copy images to floppies. + + + + +The FDVOL, WrtDsk or RaWrite3 programs can be used under MS-DOS. + + + + + + + + +To use these programs, first make sure that you are booted into +DOS. Trying to use these programs from within a DOS box in Windows, or +double-clicking on these programs from the Windows Explorer is +not expected to work. If you don't know how to +boot into DOS, just hit F8 while booting. + + + +NTRawrite is a freeware contemporary version of +Rawrite/Rawrite3 that is compatible with WinNT and +Win2K. It is a self-explanatory GUI application; you select the disk +drive to write to, browse to the disk image you want to place there +and hit the Write button. + + + + + + + +These tools can be also found on the Official Debian CD-ROMs under the +/tools directory. + + + diff --git a/eu/install-methods/floppy/m68k.xml b/eu/install-methods/floppy/m68k.xml new file mode 100644 index 000000000..0f6c7527b --- /dev/null +++ b/eu/install-methods/floppy/m68k.xml @@ -0,0 +1,31 @@ + + + + + Writing Disk Images on Atari Systems + + +You'll find the &rawwrite.ttp; program in the same directory as the +floppy disk images. Start the program by double clicking on the +program icon, and type in the name of the floppy image file you want +written to the floppy at the TOS program command line dialog box. + + + + + + Writing Disk Images on Macintosh Systems + + +There is no MacOS application to write the +mac/images-1.44/rescue.bin and +mac/images-1.44/driver.bin images to floppy disks +(and there would be no point in doing this as you can't use these +floppies to boot the installation system or install kernel and modules +from on Macintosh). However, these files are needed for the +installation of the operating system and modules, later in the +process. + + + + diff --git a/eu/install-methods/floppy/powerpc.xml b/eu/install-methods/floppy/powerpc.xml new file mode 100644 index 000000000..adc4055da --- /dev/null +++ b/eu/install-methods/floppy/powerpc.xml @@ -0,0 +1,119 @@ + + + + + Writing Disk Images From MacOS + + +An AppleScript, Make Debian Floppy, is +available for burning floppies from the provided disk image files. It +can be downloaded from +. To +use it, just unstuff it on your desktop, and then drag any floppy +image file to it. You must have Applescript installed and enabled in +your extensions manager. Disk Copy will ask you to confirm that you +wish to erase the floppy and proceed to write the file image to it. + + + +You can also use the MacOS utility Disk Copy +directly, or the freeware utility suntar. The +root.bin file is an example of a floppy +image. Use one of the following methods to create a floppy from the +floppy image with these utilities. + + + + + Writing Disk Images with <command>Disk Copy</command> + + +If you are creating the floppy image from files which were originally +on the official &debian; CD, then the Type and Creator are already set +correctly. The following Creator-Changer steps are +only necessary if you downloaded the image files from a Debian mirror. + + + + + +Obtain +Creator-Changer +and use it to open the root.bin file. + + + + +Change the Creator to ddsk (Disk Copy), and the +Type to DDim (binary floppy image). The case is +sensitive for these fields. + + + + +Important: In the Finder, use Get +Info to display the Finder information about the floppy +image, and `X' the File Locked check box so +that MacOS will be unable to remove the boot blocks if the image is +accidentally mounted. + + + + +Obtain Disk Copy; if you have a MacOS system or CD it +will very likely be there already, otherwise try +. + + + + +Run Disk Copy, and select `Make a Floppy' from the +Utilities menu, then select the +locked image file from the resulting dialog. It +will ask you to insert a floppy, then ask if you really want to erase +it. When done it should eject the floppy. + + + + + + + + Writing Disk Images with <command>suntar</command> + + + + + +Obtain suntar from +. Start the suntar program and select +`Overwrite Sectors...' from the Special menu. + + + + +Insert the floppy disk as requested, then hit &enterkey; (start at +sector 0). + + + + +Select the root.bin file in the file-opening dialog. + + + + +After the floppy has been created successfully, select `Eject' from +the File menu. If there are any errors writing +the floppy, simply toss that floppy and try another. + + + + +Before using the floppy you created, set the write protect +tab! Otherwise if you accidentally mount it in MacOS, +MacOS will helpfully ruin it. + + + + diff --git a/eu/install-methods/install-methods.xml b/eu/install-methods/install-methods.xml new file mode 100644 index 000000000..4384df302 --- /dev/null +++ b/eu/install-methods/install-methods.xml @@ -0,0 +1,16 @@ + + + + + Sistema Instalatzeko Medioa Eskuratzen + +&official-cdrom.xml; +&downloading-files.xml; +&ipl-tape.xml; +&create-floppy.xml; +&boot-usb-files.xml; +&boot-drive-files.xml; +&install-tftp.xml; +&automatic-install.xml; + + diff --git a/eu/install-methods/install-tftp.xml b/eu/install-methods/install-tftp.xml new file mode 100644 index 000000000..ddb86ec70 --- /dev/null +++ b/eu/install-methods/install-tftp.xml @@ -0,0 +1,446 @@ + + + + + Preparing Files for TFTP Net Booting + + +If your machine is connected to a local area network, you may be able +to boot it over the network from another machine, using TFTP. If you +intend to boot the installation system from another machine, the +boot files will need to be placed in specific locations on that machine, +and the machine configured to support booting of your specific machine. + + + +You need to setup a TFTP server, and for CATS machines, a BOOTP server +, or RARP server +, or DHCP server. + + + +The Reverse Address Resolution Protocol (RARP) is +one way to tell your client what IP address to use for itself. Another +way is to use the BOOTP protocol. + +BOOTP is an IP protocol that +informs a computer of its IP address and where on the network to obtain +a boot image. + + Yet another alternative exists on VMEbus +systems: the IP address can be manually configured in boot ROM. + +The DHCP (Dynamic Host Configuration +Protocol) is a more flexible, backwards-compatible extension of BOOTP. +Some systems can only be configured via DHCP. + + + +For PowerPC, if you have a NewWorld Power Macintosh machine, it is a +good idea to use DHCP instead of BOOTP. Some of the latest machines +are unable to boot using BOOTP. + + + +Unlike the Open Firmware found on Sparc and PowerPC machines, the SRM +console will not use RARP to obtain its IP +address, and therefore you must use BOOTP for net booting your Alpha. +You can also enter the IP configuration for network interfaces +directly in the SRM console. + + + + +Alpha systems can also be net-booted using the DECNet MOP (Maintenance +Operations Protocol), but this is not covered here. Presumably, your +local OpenVMS operator will be happy to assist you should you have +some burning need to use MOP to boot Linux on your Alpha. + + + + +Some older HPPA machines (e.g. 715/75) use RBOOTD rather than BOOTP. +An RBOOTD package is available on the parisc-linux web site. + + + +The Trivial File Transfer Protocol (TFTP) is used to serve the boot +image to the client. Theoretically, any server, on any platform, +which implements these protocols, may be used. In the examples in +this section, we shall provide commands for SunOS 4.x, SunOS 5.x +(a.k.a. Solaris), and GNU/Linux. + + + +&tftp-rarp.xml; +&tftp-bootp.xml; +&tftp-dhcp.xml; + + + Enabling the TFTP Server + + +To get the TFTP server ready to go, you should first make sure that +tftpd is enabled. This is usually enabled by having +something like the following line in /etc/inetd.conf: + + + +tftp dgram udp wait nobody /usr/sbin/tcpd in.tftpd /tftpboot + + + +Debian packages will in general set this up correctly by default when they +are installed. + + + +Look in that file and remember the directory which is used as the +argument of in.tftpd; you'll need that below. The +-l argument enables some versions of +in.tftpd to log all requests to the system logs; +this is useful for diagnosing boot errors. If you've had to change +/etc/inetd.conf, you'll have to notify the +running inetd process that the file has changed. +On a Debian machine, run /etc/init.d/inetd +reload; on other machines, +find out the process ID for inetd, and run +kill -HUP inetd-pid. + + + +To use the Pre-boot Execution Environment (PXE) method of TFTP +booting, you will need a TFTP server with tsize +support. On a &debian; server, the atftpd and +tftpd-hpa packages qualify. + + + +If your TFTP server is a GNU/Linux box running Linux 2.4.X you'll need +to set the following on your server: + + + +echo 1 > /proc/sys/net/ipv4/ip_no_pmtu_disc + + + +to turn off Path MTU discovery, otherwise the Indy's PROM can't +download the kernel. Furthermore, make sure TFTP packets are sent from +a source port no greater than 32767, or the download will stall after +the first packet. Again, it's Linux 2.4.X tripping this bug in the +PROM, and you can avoid it by setting + + + +echo "2048 32767" > /proc/sys/net/ipv4/ip_local_port_range + + + +to adjust the range of source ports the Linux TFTP server uses. + + + + + + Move TFTP Images Into Place + + +Next, place the TFTP boot image you need, as found in +, in the tftpd +boot image directory. Generally, this directory will be +/tftpboot. You'll have to make a link from that +file to the file which tftpd will use for booting a +particular client. Unfortunately, the file name is determined by the +TFTP client, and there are no strong standards. + + + +On NewWorld Power Macintosh machines, you will need to set up the +yaboot boot loader as the TFTP boot image. +Yaboot will then retrieve the kernel and RAMdisk +images via TFTP itself. For net booting, use the +yaboot-netboot.conf. Just rename this to +yaboot.conf in the TFTP directory. + + + +Often, the file that the TFTP client will look for is +client-ip-in-hexclient-architecture. To +compute client-ip-in-hex, take each byte of +the client IP address and translate it into hexadecimal notation. If +you have a machine handy with the bc program, you +can use the program. First issue the obase=16 +command to set the output to hex, then enter the individual components +of the client IP one at a time. As for +client-architecture, try out some values. + + + +For PXE booting, you can use the boot loader included with +syslinux: pxelinux.0. The boot +loader should be copied into the /tftpboot +folder. Then create a subdirectory within +/tftpboot named +/tftpboot/pxelinux.cfg, and within that directory +create a text file default. Here is an example of +a default file's contents: + + + +default lanlinux +prompt 1 + +label lanlinux + kernel vmlinuz + append initrd=initrd.gz devfs=mount root=/dev/ram + + + +devfs=mount is important, because without it +there may be problems mounting the initrd.gz file system once the +kernel is booted. + + + +Finally, copy the vmlinuz and +initrd.gz files (for the netboot installation method) +from the Debian ftp archive into the /tftpboot folder, +where the bootloader will be looking for them. + + + + + + DECstation TFTP Images + + +For DECstations, there are tftpimage files for each subarchitecture, +which contain both kernel and installer in one file. The naming +convention is tftpimage-subarchitecture or +tftpimage-subarchitecture.gz. If the +tftpimage is gzipped (the name ends with .gz), you need to unpack it +first with gunzip +tftpimage-subarchitecture.gz, +as DECstations cannot boot compressed files by TFTP. Copy the +tftpimage file you would like to use to +/tftpboot/tftpboot.img if you work with the +example BOOTP/DHCP setups described above. + + + +The DECstation firmware boots by TFTP with the command boot +#/tftp, where +# is the number of the TurboChannel device +from which to boot. On most DECstations this is "3". If the +BOOTP/DHCP server does not supply the filename or you need to pass +additional parameters, they can optionally be appended with the +following syntax: + + + +boot #/tftp/filename param1=value1 param2=value2 ... + + + +Several DECstation firmware revisions show a problem with regard to +net booting: the transfer starts, but after some time it stops with +an a.out err. This can have several reasons: + + + + +The firmware does not respond to ARP requests during a TFTP +transfer. This leads to an ARP timeout and the transfer stops. The +solution is to add the MAC address of the Ethernet card in the +DECstation statically to the ARP table of the TFTP server. This is +done by running arp -s +IP-address +MAC-address as root on the +machine acting as TFTP server. The MAC-address of the DECstation can +be read out by entering cnfg at the DECstation +firmware prompt. + + + + +The firmware has a size limit on the files that can be booted +by TFTP. + + + + +There are also firmware revisions that cannot boot via TFTP at all. An +overview about the different firmware revisions can be found at the +NetBSD web pages: +. + + + + + + Alpha TFTP Booting + +On Alpha, you must specify the filename (as a relative path to the +boot image directory) using the -file argument +to the SRM boot command, or by setting the +BOOT_FILE environment variable. Alternatively, +the filename can be given via BOOTP (in ISC dhcpd, +use the filename directive). Unlike Open +Firmware, there is no default filename on SRM, so +you must specify a filename by either one of +these methods. + + + + + + SPARC TFTP Booting + + +SPARC architectures for instance use the subarchitecture names, such +as ``SUN4M'' or ``SUN4C''; in some cases, the architecture is left +blank, so the file the client looks for is just +client-ip-in-hex. Thus, if your system +subarchitecture is a SUN4C, and its IP is 192.168.1.3, the filename +would be C0A80103.SUN4C. + + + +You can also force some sparc systems to look for a specific file name +by adding it to the end of the OpenPROM boot command, such as +boot net my-sparc.image. This must still reside +in the directory that the TFTP server looks in. + + + + + + BVM/Motorola TFTP Booting + + +For BVM and Motorola VMEbus systems copy the files +&bvme6000-tftp-files; to /tftpboot/. + + + +Next, configure your boot ROMs or BOOTP server to initially load the +tftplilo.bvme or +tftplilo.mvme files from the TFTP server. Refer +to the tftplilo.txt file for your subarchitecture +for additional system-specific configuration information. + + + + + + SGI Indys TFTP Booting + + +On SGI Indys you can rely on the bootpd to supply +the name of the TFTP file. It is given either as the +bf= in /etc/bootptab or as +the filename= option in +/etc/dhcpd.conf. + + + + + + + TFTP Installation for Low-Memory Systems + + +On some systems, the standard installation RAMdisk, combined with the +memory requirements of the TFTP boot image, cannot fit in memory. In +this case, you can still install using TFTP, you'll just have to go +through the additional step of NFS mounting your root directory over +the network as well. This type of setup is also appropriate for +diskless or dataless clients. + + + +First, follow all the steps above in . + + + + +Copy the Linux kernel image on your TFTP server using the +a.out image for the architecture you are +booting. + + + + +Untar the root archive on your NFS server (can be the same system as +your TFTP server): + + + +# cd /tftpboot +# tar xvzf root.tar.gz + + + +Be sure to use the GNU tar (other tar programs, like the +SunOS one, badly handle devices as plain files). + + + + +Export your /tftpboot/debian-sparc-root directory +with root access to your client. E.g., add the following line to +/etc/exports (GNU/Linux syntax, should be similar +for SunOS): + + + +/tftpboot/debian-sparc-root client(rw,no_root_squash) + + + +NOTE: "client" is the host name or IP address recognized by the server for +the system you are booting. + + + + +Create a symbolic link from your client IP address in dotted notation +to debian-sparc-root in the +/tftpboot directory. For example, if the client +IP address is 192.168.1.3, do + + + +# ln -s debian-sparc-root 192.168.1.3 + + + + + + + + + + + + Installing with TFTP and NFS Root + + +Installing with TFTP and NFS Root is similar to + because you don't want to +load the RAMdisk anymore but boot from the newly created NFS-root file +system. You then need to replace the symlink to the tftpboot image by +a symlink to the kernel image (for example, +linux-a.out). + + + +RARP/TFTP requires all daemons to be running on the same server (the +workstation is sending a TFTP request back to the server that replied +to its previous RARP request). + + + + + diff --git a/eu/install-methods/ipl-tape.xml b/eu/install-methods/ipl-tape.xml new file mode 100644 index 000000000..7f57a93af --- /dev/null +++ b/eu/install-methods/ipl-tape.xml @@ -0,0 +1,31 @@ + + + + + Creating an IPL tape + + + +If you can't boot (IPL) from the CD-ROM and you are not using VM +you need to create an IPL tape first. This is described in section +3.4.3 in the + +Linux for IBM eServer zSeries and S/390: Distributions +Redbook. The files you +need to write to the tape are (in this order): +kernel.debian, +parmfile.debian, +initrd.debian and optionally a second +initrd with the OCO modules. The first three files can be downloaded +from the tape sub-directory, see +, + + + + + +FIXME: talk more about the second initrd + + + + diff --git a/eu/install-methods/official-cdrom.xml b/eu/install-methods/official-cdrom.xml new file mode 100644 index 000000000..5c44ed425 --- /dev/null +++ b/eu/install-methods/official-cdrom.xml @@ -0,0 +1,70 @@ + + + + + Official &debian; CD-ROM Sets + + +By far the easiest way to install &debian; is from an Official +Debian CD-ROM Set (see the +CD vendors page). +You may also download the CD-ROM images from a Debian mirror and make +your own set, if you have a fast network connection and a CD burner +(see the +Debian CD page for +detailed instructions). If you have a Debian CD set and CDs are +bootable on your machine, you can skip right to +; much effort has been expended to ensure +the files most people need are there on the CD. Although a full set of +binary packages requires several CDs, it is unlikely you will need +packages on the third CD and above. You may also consider using the +DVD version, which saves a lot of space on your shelf and you avoid +the CD shuffling marathon. + + + +If your machine doesn't support CD booting, but you do have a CD set, +you can use an alternative strategy such as + +floppy disk, + +tape, emulated tape, + +hard disk, + +usb stick, + +net boot, + +or manually loading the kernel from the CD to initially boot the +system installer. The files you need for booting by another means are +also on the CD; the Debian network archive and CD folder organization +are identical. So when archive file paths are given below for +particular files you need for booting, look for those files in the +same directories and subdirectories on your CD. + + + +Once the installer is booted, it will be able to obtain all the other +files it needs from the CD. + + + +If you don't have a CD set, then you will need to download the +installer system files and place them on the + +installation tape + +floppy disk or + +hard disk or + +usb stick or + +a connected computer + +so they can be used to boot the installer. + + + + diff --git a/eu/install-methods/tftp/bootp.xml b/eu/install-methods/tftp/bootp.xml new file mode 100644 index 000000000..1b0df1d95 --- /dev/null +++ b/eu/install-methods/tftp/bootp.xml @@ -0,0 +1,78 @@ + + + + + + Setting up BOOTP server + + +There are two BOOTP servers available for GNU/Linux, the CMU +bootpd and the other is actually a DHCP server, ISC +dhcpd, which are contained in the +bootp and dhcp packages +in &debian;. + + + +To use CMU bootpd, you must first uncomment (or +add) the relevant line in /etc/inetd.conf. On +&debian;, you can run update-inetd --enable +bootps, then /etc/init.d/inetd +reload to do so. Elsewhere, the line in question should +look like: + + + +bootps dgram udp wait root /usr/sbin/bootpd bootpd -i -t 120 + + + + + +Now, you must create an /etc/bootptab file. This +has the same sort of familiar and cryptic format as the good old BSD +printcap, termcap, and +disktab files. See the +bootptab manual page for more information. For +CMU bootpd, you will need to know the hardware +(MAC) address of the client. Here is an example +/etc/bootptab: + + + +client:\ + hd=/tftpboot:\ + bf=tftpboot.img:\ + ip=192.168.1.90:\ + sm=255.255.255.0:\ + sa=192.168.1.1:\ + ha=0123456789AB: + + + +You will need to change at least the "ha" option, which specifies the +hardware address of the client. The "bf" option specifies the file a +client should retrieve via TFTP; see + for more details. + + +On SGI Indys you can just enter the command monitor and type +printenv. The value of the +eaddr variable is the machine's MAC address. + + + + +By contrast, setting up BOOTP with ISC dhcpd is +really easy, because it treats BOOTP clients as a moderately special +case of DHCP clients. Some architectures require a complex +configuration for booting clients via BOOTP. If yours is one of +those, read the section . Otherwise, you +will probably be able to get away with simply adding the +allow bootp directive to the configuration +block for the subnet containing the client, and restart +dhcpd with /etc/init.d/dhcpd +restart. + + + diff --git a/eu/install-methods/tftp/dhcp.xml b/eu/install-methods/tftp/dhcp.xml new file mode 100644 index 000000000..a6ba6286e --- /dev/null +++ b/eu/install-methods/tftp/dhcp.xml @@ -0,0 +1,111 @@ + + + + + + Setting up a DHCP server + + +At the time of this writing, there is only one DHCP server which is +free software, namely ISC dhcpd. In &debian;, this +is available in the dhcp package. Here is a +sample configuration file for it (usually +/etc/dhcpd.conf): + + + +option domain-name "example.com"; +option domain-name-servers ns1.example.com; +option subnet-mask 255.255.255.0; +default-lease-time 600; +max-lease-time 7200; +server-name "servername"; + +subnet 192.168.1.0 netmask 255.255.255.0 { + range 192.168.1.200 192.168.1.253; + option routers 192.168.1.1; +} + +host clientname { + filename "/tftpboot/tftpboot.img"; + server-name "servername"; + next-server servername; + hardware ethernet 01:23:45:67:89:AB; + fixed-address 192.168.1.90; +} + + + +Note: the new (and preferred) dhcp3 package uses +/etc/dhcp3/dhcpd.conf. + + + +In this example, there is one server +"servername" which performs all of the work +of DHCP, server, TFTP server, and network gateway. You will almost +certainly need to change the domain-name options, as well as the +server name and client hardware address. The +"filename" option should be the name of the +file which will be retrieved via TFTP. + + + +After you have edited the dhcpd configuration file, +restart it with /etc/init.d/dhcpd restart. + + + + + PXE Booting + +Here is another example for a dhcp.conf using the +Pre-boot Execution Environment (PXE) method of TFTP. + + + +option domain-name "example.com"; + +default-lease-time 6048; +max-lease-time 604800; + +allow booting; +allow bootp; + +# The next paragraph needs to be modified to fit your case +subnet 192.168.1.0 netmask 255.255.255.0 { + range 192.168.1.200 192.168.1.253; + option subnet-mask 255.255.255.0; + option broadcast-address 192.168.1.255; +# the gateway address which can be different +# (access to the internet for instance) + option routers 192.168.1.1; +# indicate the dns you want to use + option domain-name-servers 192.168.1.3; +} + +host tftpserver { +# tftp server ip address + fixed-address 192.168.1.90; +# tftp server hardware address + hardware ethernet 01:23:45:67:89:AB; +} + +group { + next-server 192.168.1.3; + host tftpclient { +# tftp client hardware address + hardware ethernet 00:10:DC:27:6C:15; + filename "/tftpboot/pxelinux.0"; + } +} + + + +Note that for PXE booting, the client filename pxelinux.0 +is a boot loader, not a kernel image (see +below). + + + + diff --git a/eu/install-methods/tftp/rarp.xml b/eu/install-methods/tftp/rarp.xml new file mode 100644 index 000000000..26f2b681a --- /dev/null +++ b/eu/install-methods/tftp/rarp.xml @@ -0,0 +1,73 @@ + + + + + + Setting up RARP server + + +To setup RARP, you need to know the Ethernet address (a.k.a. the MAC address) +of the client computers to be installed. +If you don't know this information, you can + + pick it off the initial OpenPROM boot messages, use the +OpenBoot .enet-addr command, or + +boot into ``Rescue'' mode (e.g., from the rescue floppy) and use the +command /sbin/ifconfig eth0. + + + +On a RARP server system using a Linux 2.2.x kernel, +you need to populate the kernel's RARP table. +To do this, run the following commands: + + + + +/sbin/rarp -s +client-hostname +client-enet-addr + + + + +/usr/sbin/arp -s +client-ip +client-enet-addr + + + + + + +If you get + + +SIOCSRARP: Invalid argument + + +you probably need to load the RARP kernel module or else recompile the +kernel to support RARP. Try modprobe rarp and +then try the rarp command again. + + + +On a RARP server system using a Linux 2.4.x kernel, +there is no RARP module, and +you should instead use the rarpd program. The +procedure is similar to that used under SunOS in the following +paragraph. + + + +Under SunOS, you need to ensure that the Ethernet hardware address for +the client is listed in the ``ethers'' database (either in the +/etc/ethers file, or via NIS/NIS+) and in the +``hosts'' database. Then you need to start the RARP daemon. In SunOS +4, issue the command (as root): +/usr/etc/rarpd -a; in SunOS 5, use +/usr/sbin/rarpd -a. + + + -- cgit v1.2.3