summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDieter Plaetinck <dieter@plaetinck.be>2009-08-02 19:42:56 +0200
committerDieter Plaetinck <dieter@plaetinck.be>2009-08-02 19:42:56 +0200
commit47335b7a5347f1ebd6ba154166d5b32d7bfab7f5 (patch)
treec403836a70531eeadbf86fc01dd9beb16d3a9911
parent634e70cf97013fbf67133962fd02468f6c32fbc5 (diff)
aif and installation media sections
-rw-r--r--doc/official_installation_guide_en82
1 files 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