From 220605bae5ff362877d558a8a7889f0fc1041049 Mon Sep 17 00:00:00 2001 From: Frans Pop Date: Wed, 27 Dec 2006 02:20:58 +0000 Subject: Minor corrections and some rewrites based on suggestions from Clytie Siddall --- en/using-d-i/components.xml | 14 ++---- en/using-d-i/modules/alpha/aboot-installer.xml | 2 +- en/using-d-i/modules/apt-setup.xml | 30 ++++++------ en/using-d-i/modules/base-installer.xml | 17 +++---- en/using-d-i/modules/ia64/elilo-installer.xml | 8 ++-- en/using-d-i/modules/lowmem.xml | 12 +++-- en/using-d-i/modules/mdcfg.xml | 20 ++++---- en/using-d-i/modules/partman.xml | 40 ++++++++-------- en/using-d-i/modules/shell.xml | 63 +++++++++++++++++--------- en/using-d-i/modules/x86/lilo-installer.xml | 2 +- 10 files changed, 113 insertions(+), 95 deletions(-) (limited to 'en/using-d-i') diff --git a/en/using-d-i/components.xml b/en/using-d-i/components.xml index 5f7dfaa07..b46d750fd 100644 --- a/en/using-d-i/components.xml +++ b/en/using-d-i/components.xml @@ -110,8 +110,8 @@ take some time. After the base system is installed, you have a usable but limited system. -Most users will want to add additional software to the system to tune it to -their needs, and the installer lets you do so. This step can take even +Most users will want to install additional software to the system to tune it to +their needs, and the installer allows you do so. This step can take even longer than installing the base system if you have a slow computer or network. @@ -127,18 +127,10 @@ network. If you are installing a diskless workstation, obviously, booting off the local disk isn't a meaningful option, and this step will be -skipped. You may wish to set the OpenBoot to boot +skipped. You may wish to set OpenBoot to boot from the network by default; see . - - -Note that multiple operating systems booting on a single machine is -still something of a black art. This document does not even attempt -to document the various boot managers, which vary by architecture and -even by subarchitecture. You should see your boot manager's -documentation for more information. - &module-os-prober.xml; diff --git a/en/using-d-i/modules/alpha/aboot-installer.xml b/en/using-d-i/modules/alpha/aboot-installer.xml index 7deaebb5a..1a40905d0 100644 --- a/en/using-d-i/modules/alpha/aboot-installer.xml +++ b/en/using-d-i/modules/alpha/aboot-installer.xml @@ -5,7 +5,7 @@ Install <command>aboot</command> on a Hard Disk -If you have booted from SRM, if you select this option, the installer +If you have booted from SRM and you select this option, the installer will write aboot to the first sector of the disk on which you installed Debian. Be very careful — it is not possible to boot multiple operating diff --git a/en/using-d-i/modules/apt-setup.xml b/en/using-d-i/modules/apt-setup.xml index da181f814..76d530223 100644 --- a/en/using-d-i/modules/apt-setup.xml +++ b/en/using-d-i/modules/apt-setup.xml @@ -6,27 +6,29 @@ -The main means that people use to install packages on their system is -via a program called apt-get, from the -apt package. +One of the tools used to install packages on a &debian; system is +a program called apt-get, from the +apt package -Note that the actual program that installs packages is called +Note that the program which actually installs the packages is called dpkg. However, this program is more of a low-level -tool. apt-get is a higher-level tool as it will -invoke dpkg as appropriate and also because it knows -to install other packages which are required for the package you're -trying to install, as well as how to retrieve the package from your -CD, the network, or wherever. +tool. apt-get is a higher-level tool, which will +invoke dpkg as appropriate. It knows how to retrieve +packages from your CD, the network, or wherever. It is also able to +automatically install other packages which are required to make the +package you're trying to install work correctly. - + +. Other front-ends for package management, like aptitude -and synaptic are also in use and depend on -apt-get. These front-ends are recommended for new users, -since they integrate some additional features (package searching and status checks) -in a nice user interface. +and synaptic, are also in use. +These front-ends are recommended for new users, since they integrate +some additional features (package searching and status checks) +in a nice user interface. In fact, aptitude is now the +recommended utility for package management. diff --git a/en/using-d-i/modules/base-installer.xml b/en/using-d-i/modules/base-installer.xml index e9327eb43..4ba5139d8 100644 --- a/en/using-d-i/modules/base-installer.xml +++ b/en/using-d-i/modules/base-installer.xml @@ -1,24 +1,20 @@ - - Base System Installation - -During the Base installation, package unpacking and setup messages are -redirected to tty4. You can access this -terminal by pressing +During installation of the base system, package unpacking and setup +messages are redirected to tty4. +You can access this terminal by pressing Left AltF4; get back to the main installer process with Left AltF1. - -The unpack/setup messages generated by the base installation are saved in -/var/log/syslog when the installation is -performed over a serial console. +The unpack/setup messages generated during this phase are also saved in +/var/log/syslog. You can check them there if the +installation is performed over a serial console. @@ -28,4 +24,3 @@ hardware. In lower priority modes, you will be able to choose from a list of available kernels. - diff --git a/en/using-d-i/modules/ia64/elilo-installer.xml b/en/using-d-i/modules/ia64/elilo-installer.xml index 6ec6bc26d..5fa5d0efd 100644 --- a/en/using-d-i/modules/ia64/elilo-installer.xml +++ b/en/using-d-i/modules/ia64/elilo-installer.xml @@ -15,10 +15,10 @@ disk partition and modifies the EFI Boot Manager menu in the firmware to point to the files in the EFI partition. The elilo boot loader is really in two parts. The /usr/sbin/elilo command manages the partition and -copies file into it. +copies files into it. The elilo.efi program is copied into the EFI -partition and then run by the EFI Boot Manager to actually -do the work of loading and starting the Linux kernel. +partition and then run by the EFI Boot Manager to +do the actual work of loading and starting the Linux kernel. @@ -41,7 +41,7 @@ filesystem with its boot flag set. &d-i; may show multiple choices depending on what it finds from scanning all of the disks of the system including EFI partitions of other system disks and EFI diagnostic partitions. -Remember, the elilo may format the partition during +Remember, elilo may format the partition during the installation, erasing any previous contents! diff --git a/en/using-d-i/modules/lowmem.xml b/en/using-d-i/modules/lowmem.xml index 013379199..81c1b905f 100644 --- a/en/using-d-i/modules/lowmem.xml +++ b/en/using-d-i/modules/lowmem.xml @@ -13,9 +13,13 @@ you to install &debian; on your system. -During a low memory install, not all components will be available. -One of the limitations is that you won't be able to choose a -language for the installation. +The first measure taken to reduce memory consumption by the installer +is to disable translations. If that is not sufficient, the installer +will only load components essential to complete a basic installation +by default. This reduces the functionality of the installation system. +You will be given the opportunity to load additional components manually, +but you should be aware that each component you select will use +additional memory and thus may cause the installation to fail. - \ No newline at end of file + diff --git a/en/using-d-i/modules/mdcfg.xml b/en/using-d-i/modules/mdcfg.xml index 3fb9ec46f..710c38845 100644 --- a/en/using-d-i/modules/mdcfg.xml +++ b/en/using-d-i/modules/mdcfg.xml @@ -27,7 +27,7 @@ etc.). -The benefit you gain depends on a type of a MD device you are +What benefits this brings depends on the type of MD device you are creating. Currently supported are: @@ -38,7 +38,7 @@ creating. Currently supported are: Is mainly aimed at performance. RAID0 splits all incoming data into stripes and distributes them equally over each disk in the array. This can increase the speed of read/write -operations, but when one of the disks fails, you will loose +operations, but when one of the disks fails, you will lose everything (part of the information is still on the healthy disk(s), the other part was on the failed disk). @@ -54,12 +54,12 @@ The typical use for RAID0 is a partition for video editing. RAID1 Is suitable for setups where reliability is the first concern. It -consists of several (usually two) equally sized partitions where every +consists of several (usually two) equally-sized partitions where every partition contains exactly the same data. This essentially means three things. First, if one of your disks fails, you still have the data mirrored on the remaining disks. Second, you can use only a fraction of the available capacity (more precisely, it is the size of the -smallest partition in the RAID). Third, file reads are load balanced among +smallest partition in the RAID). Third, file-reads are load-balanced among the disks, which can improve performance on a server, such as a file server, that tends to be loaded with more disk reads than writes. @@ -75,8 +75,8 @@ place of the failed disk in the case of failure. RAID5 Is a good compromise between speed, reliability and data redundancy. -RAID5 splits all incomming data into stripes and distributes them -equally on all but one disks (similar to RAID0). Unlike RAID0, RAID5 +RAID5 splits all incoming data into stripes and distributes them +equally on all but one disk (similar to RAID0). Unlike RAID0, RAID5 also computes parity information, which gets written on the remaining disk. The parity disk is not static (that would be called RAID4), but is changing periodically, so the parity @@ -88,9 +88,9 @@ which will take the place of the failed disk in the case of failure. -As you can see, RAID5 has similar degree of reliability like RAID1 -while achieving less redundancy. On the other hand it might be a bit -slower on write operation than RAID0 due to computation of parity +As you can see, RAID5 has a similar degree of reliability to RAID1 +while achieving less redundancy. On the other hand, it might be a bit +slower on write operations than RAID0 due to computation of parity information. @@ -143,7 +143,7 @@ To sum it up: -If you want to know the whole truth about Software RAID, have a look +If you want to know more about Software RAID, have a look at Software RAID HOWTO. diff --git a/en/using-d-i/modules/partman.xml b/en/using-d-i/modules/partman.xml index 6d65457e1..24e6906f4 100644 --- a/en/using-d-i/modules/partman.xml +++ b/en/using-d-i/modules/partman.xml @@ -202,36 +202,40 @@ in the remainder of this section. -If you select a pristine disk which has neither partitions -nor free space on it, you will be offered to create a new partition -table (this is needed so you can create new partitions). After this -a new line entitled FREE SPACE should appear under the -selected disk. +If you select a pristine disk which has neither partitions nor free +space on it, you will be asked if a new partition table should be +created (this is needed so you can create new partitions). After this, +a new line entitled FREE SPACE should appear in the table +under the selected disk. -If you select some free space, you will be offered to create new -partition. You will have to answer a quick series of questions about +If you select some free space, you will have the opportunity to create a +new partition. You will have to answer a quick series of questions about its size, type (primary or logical), and location (beginning or end of -the free space). After this, you will be presented with detailed -overview of your new partition. There are options like mountpoint, -mount options, bootable flag, or way of usage. If you don't like the +the free space). After this, you will be presented with a detailed +overview of your new partition. The main setting is Use +as:, which determines if the partition will have a file +system on it, or be used for swap, software RAID, LVM, an encrypted +file system, or not be used at all. Other settings include +mountpoint, mount options, and bootable flag; which settings are shown +depends on how the partition is to be used. If you don't like the preselected defaults, feel free to change them to your liking. E.g. by selecting the option Use as:, you can -choose different filesystem for this partition including the -possibility to use the partition for swap, software RAID, LVM, or not -use it at all. Other nice feature is the possibility to copy data from -existing partition onto this one. +choose different filesystem for this partition including options +to use the partition for swap, software RAID, LVM, or not +use it at all. Another nice feature is the ability to copy data from +an existing partition onto this one. When you are satisfied with your new partition, select -Done setting up the partition and you will be -thrown back to partman's main screen. +Done setting up the partition and you will +return to partman's main screen. If you decide you want to change something about your partition, simply select the partition, which will bring you to the partition -configuration menu. Because this is the same screen like when creating -a new partition, you can change the same set of options. One thing +configuration menu. This is the same screen like when creating +a new partition, so you can change the same settings. One thing which might not be very obvious at a first glance is that you can resize the partition by selecting the item displaying the size of the partition. Filesystems known to work are at least fat16, fat32, ext2, diff --git a/en/using-d-i/modules/shell.xml b/en/using-d-i/modules/shell.xml index 57081c7a2..796744900 100644 --- a/en/using-d-i/modules/shell.xml +++ b/en/using-d-i/modules/shell.xml @@ -3,39 +3,60 @@ Using the Shell and Viewing the Logs - -There is an Execute a Shell item on the -menu. If the menu is not available when you need to use the shell, -press Left Alt F2 -(on a Mac keyboard, Option F2 -) to switch to the second virtual -console. That's the Alt key on the -left-hand side of the space bar, and the -F2 function key, at the same time. This is a separate -window running a Bourne shell clone called ash. +There are several methods you can use to get a shell while running an +installation. On most systems, and if you are not installing over +serial console, the easiest method is to switch to the second +virtual console by pressing Left +Alt F2 + + +That is: press the Alt key on the left-hand side of the +space bar and the F2 function key +at the same time. + + + (on a Mac keyboard, Option +F2). Use Left Alt +F1 to switch back to installer itself. + + + +If you cannot switch consoles, there is also an Execute +a Shell item on the main menu that can be used to start +a shell. To get back to the installer itself, type +exit to close the shell. At this point you are booted from the RAM disk, and there is a limited set of Unix utilities available for your use. You can see what programs are available with the command ls /bin /sbin /usr/bin -/usr/sbin and by typing help. The -text editor is nano. The shell has some nice features -like autocompletion and history. +/usr/sbin and by typing help. +The shell is a Bourne shell clone called ash and has +some nice features like autocompletion and history. -Use the menus to perform any task that they are able to do — the -shell and commands are only there in case something goes wrong. In -particular, you should always use the menus, not the shell, to -activate your swap partition, because the menu software can't detect -that you've done this from the shell. Press Left -Alt F1 to get back to menus, or -type exit if you used a menu item to open the -shell. +To edit and view files, use the text editor nano. +Log files for the installation system can be found in the +/var/log directory. + + +Although you can do basically anything in a shell that the available +commands allow you to do, the option to use a shell is really only there +in case something goes wrong and for debugging. + + + +Doing things manually from the shell may interfere with the installation +process and result in errors or an incomplete installation. +In particular, you should always use let the installer activate your swap +partition and not do this yourself from a shell. + + diff --git a/en/using-d-i/modules/x86/lilo-installer.xml b/en/using-d-i/modules/x86/lilo-installer.xml index 87053e2bf..4c0547244 100644 --- a/en/using-d-i/modules/x86/lilo-installer.xml +++ b/en/using-d-i/modules/x86/lilo-installer.xml @@ -24,7 +24,7 @@ systems like GNU/Linux and GNU/Hurd after the installation. -&d-i; presents you three choices where to install the +&d-i; offers you three choices on where to install the LILO boot loader: -- cgit v1.2.3