[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFC] Some updates to the installation guide (2nd round)



On Sun, Aug 24, 2008 at 04:32:37PM +0200, Jérémy Bobbio wrote:
> Attached you will find some updates that I would like to make to the
> installation guide.  Reviews welcome.

More updates attached. More reviews welcome.

Cheers,
-- 
Jérémy Bobbio                        .''`. 
lunar@debian.org                    : :Ⓐ  :  # apt-get install anarchism
                                    `. `'` 
                                      `-   
commit 72d8be9af07d4924a52bb814b4b7e089a0999614
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 14:08:19 2008 +0200

    Mention apt-spy in downloading-files

diff --git a/manual/en/install-methods/downloading-files.xml b/manual/en/install-methods/downloading-files.xml
index c557c1b..70b9764 100644
--- a/manual/en/install-methods/downloading-files.xml
+++ b/manual/en/install-methods/downloading-files.xml
@@ -11,6 +11,11 @@ To find the nearest (and thus probably the fastest) mirror, see the
 
 </para><para>
 
+Using the <classname>apt-spy</classname> package on an already installed
+Debian system can also help you in finding the fastest mirror available.
+
+</para><para>
+
 When downloading files from a Debian mirror, be sure to download the
 files in <emphasis>binary</emphasis> mode, not text or automatic
 mode.

commit 1a2a215a6c895b2a6ae8b516b2e164125ee027a7
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:22:59 2008 +0200

    Make the guided partitioning example a bit more realistic

diff --git a/manual/en/using-d-i/modules/partman.xml b/manual/en/using-d-i/modules/partman.xml
index f0fb3f6..5f126dd 100644
--- a/manual/en/using-d-i/modules/partman.xml
+++ b/manual/en/using-d-i/modules/partman.xml
@@ -174,29 +174,14 @@ formatted and where they will be mounted.
 The list of partitions might look like this:
 
 <informalexample><screen>
-  IDE1 master (hda) - 6.4 GB WDC AC36400L
-        #1 primary   16.4 MB  B f ext2       /boot
-        #2 primary  551.0 MB      swap       swap
-        #3 primary    5.8 GB      ntfs
-           pri/log    8.2 MB      FREE SPACE
-
-  IDE1 slave (hdb) - 80.0 GB ST380021A
-        #1 primary   15.9 MB      ext3
-        #2 primary  996.0 MB      fat16
-        #3 primary    3.9 GB      xfs        /home
-        #5 logical    6.0 GB    f ext3       /
-        #6 logical    1.0 GB    f ext3       /var
-        #7 logical  498.8 MB      ext3
-        #8 logical  551.5 MB      swap       swap
-        #9 logical   65.8 GB      ext2
+  IDE1 master (hda) - 6.7 GB WDC AC36400L
+        #1  primary    2.0 MB  B  f  ext3    /
+        #5  logical  279.6 MB        swap    swap
+        #6  logical    4.4 GB        ext3    /home
 </screen></informalexample>
 
-This example shows two IDE harddrives divided into several partitions;
-the first disk has some free space. Each partition line consists of the
-partition number, its type, size, optional flags, file system, and
-mountpoint (if any). Note: this particular setup cannot be created using
-guided partitioning but it does show possible variation that can be achieved
-using manual partitioning.
+Each partition line consists of the partition number, its type, size, optional
+flags, file system, and mountpoint.
 
 </para><para>
 
@@ -215,11 +200,34 @@ modify the proposed changes as described below for manual partitioning.
    <title>Manual Partitioning</title>
 <para>
 
-A similar screen to the one shown just above will be displayed if you
-choose manual partitioning except that your existing partition table will
-be shown and without the mount points. How to manually setup your partition
-table and the usage of partitions by your new Debian system will be covered
-in the remainder of this section.
+If you choose manual partitioning, you will be presented with a list of
+your existing partitions. How to manually setup your partition table and the
+usage of partitions by your new Debian system will be covered in the remainder
+of this section. After make the necessary changes, the partition list might
+look like this:
+
+<informalexample><screen>
+  IDE1 master (hda) - 6.4 GB WDC AC36400L
+        #1  primary   16.4 MB  B  f  ext2     /boot
+        #2  primary  551.0 MB        swap     swap
+        #3  primary    5.8 GB        ntfs
+            pri/log    8.2 MB        FREE SPACE
+
+  IDE1 slave (hdb) - 80.0 GB ST380021A
+        #1  primary   15.9 MB        ext3
+        #2  primary  996.0 MB        fat16
+        #3  primary    3.9 GB        xfs      /home
+        #5  logical    6.0 GB     f  ext3     /
+        #6  logical    1.0 GB     f  ext3     /var
+        #7  logical  498.8 MB        ext3
+        #8  logical  551.5 MB        swap     swap
+        #9  logical   65.8 GB        ext2
+</screen></informalexample>
+
+This example shows two IDE harddrives divided into several partitions;
+the first disk has some free space. Each partition line consists of the
+partition number, its type, size, optional flags, file system, and
+mountpoint (if any).
 
 </para><para>
 

commit 35b670e52dc4010a7f70c2ab1a643c585800823e
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:32:09 2008 +0200

    Update mount-encrypted-volumes with current features and prompts

diff --git a/manual/en/boot-new/mount-encrypted.xml b/manual/en/boot-new/mount-encrypted.xml
index 68d4d78..d2a4993 100644
--- a/manual/en/boot-new/mount-encrypted.xml
+++ b/manual/en/boot-new/mount-encrypted.xml
@@ -9,7 +9,7 @@
 If you created encrypted volumes during the installation and assigned
 them mount points, you will be asked to enter the passphrase for each
 of these volumes during the boot. The actual procedure differs
-slightly between dm-crypt and loop-AES.
+slightly between dm-crypt (used by default) and loop-AES.
 
 </para>
 
@@ -22,8 +22,8 @@ For partitions encrypted using dm-crypt you will be shown the following
 prompt during the boot:
 
 <informalexample><screen>
-Starting early crypto disks... <replaceable>part</replaceable>_crypt(starting)
-Enter LUKS passphrase:
+Starting early crypto disks... <replaceable>part</replaceable>_crypt(starting).
+Enter passphrase to unlock the disk /dev/<replaceable>part</replaceable> (<replaceable>part</replaceable>_crypt):
 </screen></informalexample>
 
 In the first line of the prompt, <replaceable>part</replaceable> is the
@@ -44,16 +44,8 @@ and <filename>/etc/fstab</filename> of your new system.
 
 </para><para>
 
-The prompt may look somewhat different when an encrypted root file system is
-mounted. This depends on which initramfs generator was used to generate the
-initrd used to boot the system. The example below is for an initrd generated
-using <classname>initramfs-tools</classname>:
-
-<informalexample><screen>
-Begin: Mounting <emphasis>root file system</emphasis>... ...
-Begin: Running /scripts/local-top ...
-Enter LUKS passphrase:
-</screen></informalexample>
+The last line might be the only one displayed when the root file system is
+encrypted.
 
 </para><para>
 
@@ -86,6 +78,11 @@ Password:
 
 </para><para>
 
+The last line might be the only one displayed when the root file system is
+encrypted.
+
+</para><para>
+
 No characters (even asterisks) will be shown while entering the passphrase.
 If you enter the wrong passphrase, you have two more tries to correct it.
 After the third try the boot process will skip this volume and continue to

commit 62f6155651c9d5c49bc16e2dd0d87baf77cc4d1a
Author: Jérémy Bobbio <lunar@debian.org>
Date:   Sun Aug 24 15:14:23 2008 +0200

    64Mb is not really a large partition these days

diff --git a/manual/en/using-d-i/modules/lowmem.xml b/manual/en/using-d-i/modules/lowmem.xml
index 7d7331e..3851ffe 100644
--- a/manual/en/using-d-i/modules/lowmem.xml
+++ b/manual/en/using-d-i/modules/lowmem.xml
@@ -29,13 +29,13 @@ additional memory and thus may cause the installation to fail.
 
 </para><para>
 
-If the installer runs in low memory mode, it is recommended to create
-a relatively large swap partition (64&ndash;128MB). The swap partition
-will be used as virtual memory and thus increases the amount of memory
-available to the system. The installer will activate the swap partition
-as early as possible in the installation process. Note that heavy use
-of swap will reduce performance of your system and may lead to high
-disk activity.
+If the installer runs in low memory mode, it is recommended to create a
+relatively large swap partition (at least 64&ndash;128MB). The swap
+partition will be used as virtual memory and thus increases the amount
+of memory available to the system. The installer will activate the swap
+partition as early as possible in the installation process. Note that
+heavy use of swap will reduce performance of your system and may lead to
+high disk activity.
 
 </para><para>
 

Attachment: signature.asc
Description: Digital signature


Reply to: