From 47335b7a5347f1ebd6ba154166d5b32d7bfab7f5 Mon Sep 17 00:00:00 2001 From: Dieter Plaetinck Date: Sun, 2 Aug 2009 19:42:56 +0200 Subject: aif and installation media sections --- doc/official_installation_guide_en | 82 +++++++++++++++++++++++++++----------- 1 file changed, 59 insertions(+), 23 deletions(-) diff --git a/doc/official_installation_guide_en b/doc/official_installation_guide_en index f1cba56..1e09b62 100644 --- a/doc/official_installation_guide_en +++ b/doc/official_installation_guide_en @@ -17,17 +17,14 @@ General installation documentation for the Arch Linux distribution. * [2 Pre-Installation](#Pre-Installation) * [2.1 Architectures](#Architectures) * [2.2 Available images](#Available_images) - * [2.3 AIF, the installation tool](#Aif_the_installation_tool) # explain aif, normal and partial procedures (but not really useful for most people) + * [2.3 AIF, the installation tool](#Aif_the_installation_tool) * [2.4 Acquiring Arch Linux](#Acquiring_Arch_Linux) * [2.5 Preparing the Installation Media](#Preparing_the_Installation_Media) * [3 Installing Arch Linux](#Installing_Arch_Linux) * [3.1 Using the Install Media](#Using_the_Install_Media) * [3.1.1 Pre-boot](#Pre_boot) - * [3.1.2 Post-boot](#Post_boot) #login, keymap/font, network settings. prefer aif - * partial procedures over raw commands so settings will be reused - * later the installation. "for your convenience, aif offers - * somepartial procedures which wrap around some basic functionality"everything is in /arch + * [3.1.2 Post-boot](#Post_boot) * [3.2 Performing the installation](#Perform_install) #shortly desc 2 procedures * [3.2.1 Interactive Installation Procedure](#Interactive_Installation_Procedure) #explain running setup here * [3.2.1.1 Select Source](#Select_Source) @@ -118,7 +115,38 @@ networking utilities and drivers. If there's something else you happen to need at runtime, just get your Internet connection up and install it using pacman. A short pacman command reference is available at the end of this document. -#### Installation tool +### AIF, the installation tool + +Arch Linux uses AIF aka 'Arch Linux Installation Framework' to perform installations. +This tool - written in bash - consists of some libraries to perform various functions (installing packages, setting up disks etc) +and some so called procedures which use these libraries to provide an easy means +to do an installation or to smaller related tasks ('partial procedures'). +These procedures are shipped by default: + +* interactive: An interactive installation procedure, which asks you some questions, guides you through an installation + and helps you configuring the target system by automatically changing some settings for you depending on what you did earlier (eg network settings) + (aliased as `/arch/setup`) +* automatic: An automated, deploy-tool-alike procedure. designed for low-to zero interactivity. + uses profiles for configuration of the installation/target system. + See /usr/share/aif/examples/ for example profile files. +* base: basic, little-interactivity installation with some common defaults. + This procedure is used by the others to inherit from, it is NOT meant to be used directly by end users +* partial-configure-network: exposes the network configuration step from the interactive procedure, to help you setup the network in the live environment +* partial-disks: Process disk subsystem or do a rollback +* partial-keymap: change your keymap/console font settings. (aliased as `km`) + +The benefit of procedures such as partial-keymap and +partial-configure-network over direct usage of tools such as loadkeys or +ifconfig is that when running the interactive procedure, you will get asked +if you want to apply your settings to the config files of the target system. + +If you want to go further, you can also: + +* write your own procedures from scratch or by overriding certain parts of other procedures +* write your own libraries, to provide reusable logic that does not come by default +* for certain procedures that use config files (eg automatic), create your own configs + +For more information, consult the readme of AIF. ### Acquiring Arch Linux @@ -174,27 +202,35 @@ Make sure to use /dev/sdX and not /dev/sdX1. This command will irrevocably delete all files on your USB stick, so make sure you don't have any important files on it before doing this. + +## Installing Arch Linux + ### Using the Install Media +#### Pre-boot + Make sure your BIOS is set in a way to allow booting from your CD-ROM or USB device. Reboot your computer with the Arch Linux Installation CD in the drive -or the USB stick plugged in the port. Once the installation medium has booted -you will see the Arch Linux logo and a grub menu waiting for your selection. -Most likely you can just hit enter at this point. At the end of the boot -procedure, you should be at a login prompt with some simple instructions at -the top of the screen. You should login as root. At this point you are ready -to commence the actual installation, or do any manual preparation you consider -necessary. - -Using the available shell tools, experienced users are also able to prepare -the hard drive or any devices needed for the installation before starting the -installer. Note that the Arch Linux installation media also contains a -/arch/quickinst script for experienced users. This script installs the "base" -set of packages to a user-specified destination directory. If you are doing an -install with things like RAID and LVM, or don't want to use the installer at -all, you'll probably want to use the quickinst script. You will have to -configure the system afterwards since no form of auto-configuration takes -place. +or the USB stick plugged in the port. Once the installation medium has +started booting you will see the Arch Linux logo and a grub menu waiting for your selection. +Most likely you can just hit enter at this point. +If Grub hangs, you're one of the unlucky few whose CD-rom drive doesn't work with grub and you should try the isolinux image. + +#### Post-boot +At the end of the boot procedure, you should be at a login prompt with some simple instructions at +the top of the screen. You should login as root. At this point you can +optionally perform manual preparations and commence the actual installation + +* If you prefer a non-US keymap or specific consolefont, type `km` to change any of these. +* If for some reason you need network access before starting the installer (the interactive procedure will let you configure the network if you want to do a NET installation) + you can type `aif -p partial-configure-network` + +For both items, changed settings will be remembered to be optionally applied to the target system when using the interactive procedure. + +There is also an `arch` login which can be usefull if you want to do things as non-privileged user. Most people don't need this. + +You will find that everything you need to perform this installation (a copy of this guide, aif README, shortcuts to common aif procedures) can be found in /arch + ### Interactive Installation Procedure The -- cgit v1.2.3-54-g00ecf