diff options
author | Joey Hess <joeyh@debian.org> | 2005-10-07 19:51:38 +0000 |
---|---|---|
committer | Joey Hess <joeyh@debian.org> | 2005-10-07 19:51:38 +0000 |
commit | 1ea73eea5ecc6a8ed901316049259aee737ee554 (patch) | |
tree | 03a077f0b1b1548f3c806bd1c5795964fba0fb52 /ca/boot-installer/ia64.xml | |
download | installation-guide-1ea73eea5ecc6a8ed901316049259aee737ee554.zip |
move manual to top-level directory, split out of debian-installer package
Diffstat (limited to 'ca/boot-installer/ia64.xml')
-rw-r--r-- | ca/boot-installer/ia64.xml | 464 |
1 files changed, 464 insertions, 0 deletions
diff --git a/ca/boot-installer/ia64.xml b/ca/boot-installer/ia64.xml new file mode 100644 index 000000000..9afc8b61e --- /dev/null +++ b/ca/boot-installer/ia64.xml @@ -0,0 +1,464 @@ +<!-- retain these comments for translator revision tracking --> +<!-- original version: 28672 untranslated --> + + <sect2 arch="ia64"><title>Booting from a CD-ROM</title> + +&boot-installer-intro-cd.xml; + + <note> + <title>CD Contents</title> + +<para> + +There are three basic variations of Debian Install CDs. +The <emphasis>Business Card</emphasis> CD has a minimal installation +that will fit on the small form factor CD media. +It requires a network connection in order to install the rest of the +base installation and make a usable system. +The <emphasis>Network Install</emphasis> CD has all of the packages +for a base install but requires a network connection to a Debian +mirror site in order to install the +extra packages one would want for a complete system . +The set of Debian CDs can install a complete system from the wide +range of packages without needing access to the network. +</para> + </note> + +<para> + +The IA-64 architecture uses the next generation Extensible Firmware Interface +(EFI) from Intel. +Unlike the traditional x86 BIOS which knows little about the boot +device other than the partition table and Master Boot Record (MBR), +EFI can read and write files from FAT16 or FAT32 formatted disk +partitions. +This simplifies the often arcane process of starting a system. +The system boot loader and the EFI firmware that supports it have +a full filesystem to store the files necessary for booting the +machine. +This means that the system disk on an IA-64 system has an additional +disk partition dedicated to EFI instead of the simple MBR or boot +block on more conventional systems. + +</para><para> + +The Debian Installer CD contains a small EFI partition where the +<command>ELILO</command> bootloader, its configuration file, the installer's +kernel, and initial filesystem (initrd) are located. +The running system also contains an EFI partition where the necessary +files for booting the system reside. +These files are readable from the EFI Shell as described below. + +</para><para> + +Most of the details of how <command>ELILO</command> actually loads and +starts a system are transparent to the system installer. +However, the installer must set up an EFI partition prior to installing +the base system. Otherwise, the installation of <command>ELILO</command> +will fail, rendering the system un-bootable. +The EFI partition is allocated and formatted in the partitioning step +of the installation prior to loading any packages on the system disk. +The partitioning task also verifies that a suitable EFI partition is +present before allowing the installation to proceed. + +</para><para> + +The EFI Boot Manager is presented as the last step of the firmware +initialization. +It displays a menu list from which the user can select +an option. +Depending on the model of system and what other software has been +loaded on the system, this menu may be different from one system +to another. +There should be at least two menu items displayed, +<command>Boot Option Maintenance Menu</command> and +<command>EFI Shell (Built-in)</command>. +Using the first option is preferred, however, if that +option is not available or the CD for some reason does not +boot with it, use the second option. + +</para> + + <warning> + <title>IMPORTANT</title> +<para> +The EFI Boot Manager will select a default boot action, typically +the first menu choice, within a pre-set number of seconds. +This is indicated by a countdown at the bottom of the screen. +Once the timer expires and the systems starts the default action, +you may have to reboot the machine in order to continue the installation. +If the default action is the EFI Shell, you can return to the Boot Manager +by running <command>exit</command> at the shell prompt. +</para> + </warning> + + <sect3 arch="ia64" id="bootable-cd"> + <title>Option 1: Booting from the Boot Option Maintenance Menu</title> +<para> + +</para> + +<itemizedlist> + +<listitem><para> +Insert the CD in the DVD/CD drive and reboot the machine. +The firmware will display the EFI Boot Manager page and menu after +it completes its system initialization. +</para></listitem> + +<listitem><para> +Select <command>Boot Maintenance Menu</command> from the menu +with the arrow keys and press <command>ENTER</command>. +This will display a new menu. +</para></listitem> + +<listitem><para> +Select <command>Boot From a File</command> from the menu +with the arrow keys and press <command>ENTER</command>. +This will display a list of devices probed by the firmware. +You should see two menu lines containing either the label +<command>Debian Inst [Acpi ...</command> or +<command>Removable Media Boot</command>. +If you examine the rest of the menu line, you will notice that +the device and controller information should be the same. +</para></listitem> + +<listitem><para> +You can choose either of the entries that refer to the CD/DVD +drive. +Select your choice with the arrow keys and press <command>ENTER</command>. +If you choose <command>Removable Media Boot</command> the machine +will immediately start the boot load sequence. +If you choose <command>Debian Inst [Acpi ...</command> instead, it +will display a directory listing of the bootable portion of the +CD, requiring you to proceed to the next (additional) step. +</para></listitem> + +<listitem><para> +You will only need this step if you chose +<command>Debian Inst [Acpi ...</command>. +The directory listing will also show +<command>[Treat like Removable Media Boot]</command> on the next to +the last line. +Select this line with the arrow keys and press <command>ENTER</command>. +This will start the boot load sequence. +</para></listitem> + +</itemizedlist> + +<para> + +These steps start the Debian boot loader which will display a +menu page for you to select a boot kernel and options. +Proceed to selecting the boot kernel and options. + +</para> + </sect3> + + <sect3 arch="ia64" id="boot-with-efi"> + <title>Option 2: Booting from the EFI Shell</title> +<para> + +If, for some reason, option 1 is not successful, reboot the machine +and when the EFI Boot Manager screen appears there should be +one option called <command>EFI Shell [Built-in]</command>. +Boot the Debian Installer CD with the following steps: + +</para> + +<itemizedlist> + +<listitem><para> +Insert the CD in the DVD/CD drive and reboot the machine. +The firmware will display the EFI Boot Manager page and menu after +it completes system initialization. +</para></listitem> + +<listitem><para> +Select <command>EFI Shell</command> from the menu with the arrow keys +and press <command>ENTER</command>. +The EFI Shell will scan all of the bootable devices and display +them to the console before displaying its command prompt. +The recognized bootable partitions on devices will show a device name of +<filename>fs<replaceable>n</replaceable>:</filename>. +All other recognized partitions will be named +<filename>blk<replaceable>n</replaceable>:</filename>. +If you inserted the CD just before entering the shell, this may +take a few extra seconds as it initializes the CD drive. +</para> +</listitem> + +<listitem><para> +Examine the output from the shell looking for the CDROM drive. +It is most likely the <filename>fs0:</filename> device although +other devices with bootable partitions will also show up as +<filename>fs<replaceable>n</replaceable></filename>. +</para></listitem> + +<listitem><para> +Enter <command>fs<replaceable>n</replaceable>:</command> and press +<command>ENTER</command> to select that +device where <replaceable>n</replaceable> is the partition number for the +CDROM. The shell will now display the partition number as its prompt. +</para></listitem> + +<listitem><para> +Enter <command>elilo</command> and press <command>ENTER</command>. +This will start the boot load sequence. +</para></listitem> + +</itemizedlist> + +<para> + +As with option 1, these steps start the Debian boot loader which will +display a menu page for you to select a boot kernel and options. +You can also enter the shorter +<command>fs<replaceable>n</replaceable>:elilo</command> command at +the shell prompt. +Proceed to selecting the boot kernel and options. + +</para> + + </sect3> + + <sect3 arch="ia64" id="serial-console"> + <title>Installing using a Serial Console</title> + +<para> + +You may choose to perform an install using a monitor and keyboard +or using a serial connection. To use a monitor/keyboard setup, +select an option containing the string [VGA console]. To install +over a serial connection, choose an option containing the string +[<replaceable>BAUD</replaceable> baud serial console], where +<replaceable>BAUD</replaceable> is the speed of your serial console. +Menu items for the most typical baud rate settings on the ttyS0 +device are preconfigured. + +</para><para> + +In most circumstances, you will want the installer to use the same +baud rate as your connection to the EFI console. If you aren't +sure what this setting is, you can obtain it using the command +<command>baud</command> at the EFI shell. + +</para><para> + +If there is not an option available that is configured for the serial +device or baud rate you would like to use, you may override the console setting +for one of the existing menu options. For example, to use a +57600 baud console over the ttyS1 device, enter +<command>console=ttyS1,57600n8</command> into +the <classname>Boot:</classname> text window. + +</para> + +<note><para> +Most IA-64 boxes ship with a default console setting of 9600 baud. +This setting is rather slow, and the normal installation process +will take a significant time to draw each screen. You should consider +either increasing the baud rate used for performing the installation, +or performing a Text Mode installation. See the <classname>Params</classname> +help menu for instructions on starting the installer in Text Mode. +</para></note> + +<warning><para> +If you select the wrong console type, you +will be able to select the kernel and enter parameters but both +the display and your input will go dead as soon as the kernel starts, +requiring you to reboot before you can begin the installation. +</para></warning> + </sect3> + + <sect3 arch="ia64" id="kernel-option-menu"> + <title>Selecting the Boot Kernel and Options</title> + +<para> + +The boot loader will display a form with a menu list and a text +window with a <classname>Boot:</classname> prompt. +The arrow keys select an item from the menu and any text typed +at the keyboard will appear in the text window. +There are also help screens which can be displayed by pressing +the appropriate function key. +The <classname>General</classname> help screen explains the menu +choices and the <classname>Params</classname> screen explains +the common command line options. + +</para><para> + +Consult the <classname>General</classname> help screen for the +description of the kernels and install modes most appropriate +for your installation. +You should also consult <xref linkend="boot-parms"/> below for any additional +parameters that you may want to set in the <classname>Boot:</classname> +text window. +The kernel version you choose selects the kernel version that will be +used for both the installation process and the installed system. +If you encounter kernel problems with the installation, you may also +have those same problems with the system you install. +The following two steps will select and start the install: + +</para> + +<itemizedlist> + +<listitem><para> +Select the kernel version and installation mode most +appropriate to your needs with the arrow keys. +</para></listitem> + +<listitem><para> +Enter any boot parameters by typing at the keyboard. +The text will be displayed directly in the text window. +This is where kernel parameters (such as serial console +settings) are specified. +</para></listitem> + +<listitem><para> +Press <command>ENTER</command>. This will load and start the +kernel. +The kernel will display its usual initialization messages followed +by the first screen of the Debian Installer. +</para></listitem> + +</itemizedlist> + +<para> + +Proceed to the next chapter to continue the installation where you will +set up the language locale, network, and disk partitions. + +</para> + </sect3> + </sect2> + + <sect2 arch="ia64" id="boot-tftp"><title>Booting with TFTP</title> + +<para> +Booting an IA64 system from the network is similar to a CD boot. +The only difference is how the installation kernel is loaded. +The EFI Boot Manager can load and start programs from a server on +the network. +Once the installation kernel is loaded and starts, the system install +will proceed thru the same steps as the CD install with the exception +that the packages of the base install will be loaded from the network +rather than the CD drive. + +</para> + +&boot-installer-intro-net.xml; + +<para> + +Network booting an ia64 system requires two architecture-specific actions. +On the boot server, DHCP and TFTP must be configured to deliver +<command>elilo</command>. +On the client a new boot option must be defined in the EFI boot manager +to enable loading over a network. + +</para> + + <sect3 arch="ia64" id="boot-tftp-server"> + <title>Configuring the Server</title> +<para> + +A suitable TFTP entry for network booting an ia64 system looks something +like this: + +<informalexample><screen> +host mcmuffin { + hardware ethernet 00:30:6e:1e:0e:83; + fixed-address 10.0.0.21; + filename "debian-installer/ia64/elilo.efi"; +} +</screen></informalexample> + +Note that the goal is to get <command>elilo.efi</command> running on +the client. + +</para><para> + +Extract the <filename>netboot.tar.gz</filename> file into the directory used +as the root for your tftp server. Typical tftp root directories include +<filename>/var/lib/tftp</filename> and <filename>/tftpboot</filename>. +This will create a <filename>debian-installer</filename> directory +tree containing the boot files for an IA-64 system. + +</para><para> + +<informalexample><screen> +# cd /var/lib/tftp +# tar xvfz /home/user/netboot.tar.gz +./ +./debian-installer/ +./debian-installer/ia64/ +[...] +</screen></informalexample> + +The <filename>netboot.tar.gz</filename> contains an +<filename>elilo.conf</filename> file that should work for most configurations. +However, should you need to make changes to this file, you can find it in the +<filename>debian-installer/ia64/</filename> directory. + +It is possible to have different config files for different clients by naming +them using the client's IP address in hex with the suffix +<filename>.conf</filename> instead of <filename>elilo.conf</filename>. +See documentation provided in the <classname>elilo</classname> package +for details. + +</para> + </sect3> + + <sect3 arch="ia64" id="boot-tftp-client"> + <title>Configuring the Client</title> +<para> + +To configure the client to support TFTP booting, start by booting to +EFI and entering the <guimenu>Boot Option Maintenance Menu</guimenu>. + +<itemizedlist> +<listitem><para> + +Add a boot option. + +</para></listitem> +<listitem><para> + +You should see one or more lines with the text +<guimenuitem>Load File [Acpi()/.../Mac()]</guimenuitem>. If more +than one of these entries exist, choose the one containing the +MAC address of the interface from which you'll be booting. +Use the arrow keys to highlight your choice, then press enter. + +</para></listitem> +<listitem><para> + +Name the entry <userinput>Netboot</userinput> or something similar, +save, and exit back to the boot options menu. + +</para></listitem> +</itemizedlist> + +You should see the new boot option you just created, and selecting it +should initiate a DHCP query, leading to a TFTP load of +<filename>elilo.efi</filename> from the server. + +</para><para> + +The boot loader will display its prompt after it has downloaded and +processed its configuration file. +At this point, the installation proceeds with the same steps as a +CD install. Select a boot option as in above and when the kernel +has completed installing itself from the network, it will start the +Debian Installer. + +</para><para> + +Proceed to the next chapter to continue the installation where +you will set up the language locale, network, and the disk partitions. + +</para> + </sect3> + </sect2> |