Gentoo Archives: gentoo-doc

From: Daniel Meltzer <dmeltzer.gentoo@×××××.com>
To: gentoo-doc@l.g.o
Cc: Daniel Meltzer <dmeltzer.gentoo@×××××.com>
Subject: [gentoo-doc] [PATCH 1/3] Bring gentoo-x86-quickinstall in line with many of the changes that have been made to the official handbook. It would probably make sense down the line to turn this into a 64 bit quickinstall guide, as that's rapidly becoming the common denominator for new users. This commit makes the following changes:
Date: Thu, 17 Jan 2013 05:05:23
Message-Id: 1358399053-8527-1-git-send-email-dmeltzer.gentoo@gmail.com
1 * Suggest using emerge-webrsync instead of downloading a portage snapshot and
2 unpacking.
3 * Recommend mounting /sys for grub2 and other bootloader users.
4 * Remove the unnecessary env-update after entering chroot.
5 * Add ext4 to filesystems and suggest it as default for /. We can probably remove
6 jfs and reiserfs from this list to keep it less overwhelming, but thats a debate
7 for another day.
8 * Additional net interfaces should be symlinked to net.lo, not net.eth0, as
9 net.eth0 is itself a symlink to net.lo
10 ---
11 .../doc/en/gentoo-x86-quickinstall-stage.xml | 50 ++++++++--------------
12 .../doc/en/gentoo-x86-quickinstall-system.xml | 8 ++--
13 xml/htdocs/doc/en/gentoo-x86-quickinstall.xml | 18 ++++----
14 3 files changed, 30 insertions(+), 46 deletions(-)
15
16 diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
17 index dd48c41..ccc72ee 100644
18 --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
19 +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml
20 @@ -4,8 +4,8 @@
21
22 <included>
23
24 -<version>14</version>
25 -<date>2012-02-29</date>
26 +<version>15</version>
27 +<date>2013-01-16</date>
28
29 <section>
30 <title>Setting Up The Stage</title>
31 @@ -54,31 +54,6 @@ user 1m2.920s
32 sys 0m7.530s
33 </pre>
34
35 -<p>
36 -Install the latest Portage snapshot. Proceed as for the stage3 archive: choose
37 -a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, download
38 -the latest snapshot and unpack it.
39 -</p>
40 -
41 -<pre caption="Download the latest Portage snapshot">
42 -livecd gentoo # <i>cd /mnt/gentoo/usr</i>
43 -livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
44 -<comment>(Pick a mirror, move to the snapshots/ directory,
45 -highlight <b>portage-latest.tar.bz2</b> and press D to download it)</comment>
46 -
47 -<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
48 -livecd gentoo # <i>cd /mnt/gentoo/usr</i>
49 -livecd usr # <i>wget http://distfiles.gentoo.org/snapshots/portage-latest.tar.bz2</i>
50 -</pre>
51 -
52 -<pre caption="Unpack the Portage snapshot">
53 -livecd usr # <i>time tar xjf portage-lat*</i>
54 -
55 -real 0m40.523s
56 -user 0m28.280s
57 -sys 0m8.240s
58 -</pre>
59 -
60 </body>
61 </section>
62 <section>
63 @@ -86,19 +61,28 @@ sys 0m8.240s
64 <body>
65
66 <p>
67 -Mount the <path>/proc</path> &amp; <path>/dev</path> file systems, copy over
68 -the <path>/etc/resolv.conf</path> file, then chroot into your Gentoo
69 -environment.
70 +Mount the <path>/proc</path>, <path>/dev</path>, and <path>/sys</path> file
71 +systems, copy over the <path>/etc/resolv.conf</path> file, then chroot into
72 +your Gentoo environment.
73 </p>
74
75 <pre caption="Chroot">
76 livecd usr # <i>cd /</i>
77 livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i>
78 livecd / # <i>mount --rbind /dev /mnt/gentoo/dev</i>
79 -livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
80 +livecd / # <i>mount --rbind /sys /mnt/gentoo/sys</i>
81 +livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
82 livecd / # <i>chroot /mnt/gentoo /bin/bash</i>
83 -livecd / # <i>env-update &amp;&amp; source /etc/profile</i>
84 ->>> Regenerating /etc/ld.so.cache...
85 +livecd / # <i>source /etc/profile</i>
86 +</pre>
87 +
88 +<p>
89 +Fetch the latest portage snapshot from the mirrors using emerge-webrsync.
90 +</p>
91 +
92 +<pre caption="Running emerge-webrsync to install a Portage snapshot">
93 +livecd / # <i>mkdir /usr/portage</i>
94 +livecd / # <i>emerge webrsync</i>
95 </pre>
96
97 </body>
98 diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
99 index b4b7e45..34c7b5e 100644
100 --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
101 +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
102 @@ -4,8 +4,8 @@
103
104 <included>
105
106 -<version>7</version>
107 -<date>2012-03-31</date>
108 +<version>8</version>
109 +<date>2013-01-16</date>
110
111 <section>
112 <title>Configure the system</title>
113 @@ -22,7 +22,7 @@ file systems match your installation.
114 livecd linux # <i>cd /etc</i>
115 livecd etc # <i>nano -w fstab</i>
116 /dev/<i>sda1</i> /boot ext2 noauto,noatime 1 2
117 -/dev/<i>sda3</i> / ext3 noatime 0 1
118 +/dev/<i>sda3</i> / ext4 noatime 0 1
119 /dev/<i>sda2</i> none swap sw 0 0
120 </pre>
121
122 @@ -58,7 +58,7 @@ livecd etc # <i>nano -w fstab</i>
123 <p>
124 Configure your network in <path>/etc/conf.d/net</path>. Add the <c>net.eth0</c>
125 init script to the default run level. If you have multiple NICs, symlink them
126 -to the <c>net.eth0</c> init script and add them to the default run level as
127 +to the <c>net.lo</c> init script and add them to the default run level as
128 well. Don't forget to set your hostname too. Either edit
129 <path>/etc/conf.d/net</path> and <path>/etc/conf.d/hostname</path> with
130 <c>nano</c> or use the following commands:
131 diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
132 index 06200d0..90f010d 100644
133 --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
134 +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
135 @@ -29,8 +29,8 @@ want to follow this guide.
136 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
137 <license/>
138
139 -<version>27</version>
140 -<date>2012-03-31</date>
141 +<version>28</version>
142 +<date>2013-01-16</date>
143
144 <chapter>
145 <title>Introduction</title>
146 @@ -112,17 +112,17 @@ Units = cylinders of 16065 * 512 = 8225280 bytes
147 </pre>
148
149 <p>
150 -Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
151 -<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize your
152 -swap partition using <c>mkswap</c> and <c>swapon</c>.
153 +Use <c>mkfs.ext2</c>, <c>mkfs.ext3</c>, <c>mkfs.ext4</c>, <c>mkreiserfs</c>,
154 +<c>mkfs.xfs</c> and <c>mkfs.jfs</c> to create file systems on your Linux
155 +partitions. Initialize your swap partition using <c>mkswap</c> and <c>swapon</c>.
156 </p>
157
158 <pre caption="Create the file systems and activate swap">
159 <comment>(ext2 is all you need on the /boot partition)</comment>
160 -livecd ~ # <i>mke2fs /dev/sda1</i>
161 +livecd ~ # <i>mkfs.ext2 /dev/sda1</i>
162
163 -<comment>(Let's use ext3 on the main partition)</comment>
164 -livecd ~ # <i>mke2fs -j /dev/sda3</i>
165 +<comment>(Let's use ext4 on the main partition)</comment>
166 +livecd ~ # <i>mkfs.ext4 /dev/sda3</i>
167
168 <comment>(Create and activate swap)</comment>
169 livecd ~ # <i>mkswap /dev/sda2 &amp;&amp; swapon /dev/sda2</i>
170 @@ -204,7 +204,7 @@ Exit the chrooted environment, unmount all file systems and reboot:
171 <pre caption="Reboot">
172 livecd conf.d # <i>exit</i>
173 livecd / # <i>umount -l /mnt/gentoo/dev{/shm,/pts,}</i>
174 -livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,}</i>
175 +livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,/sys,}</i>
176 livecd / # <i>reboot</i>
177 <comment>(Don't forget to remove the CD)</comment>
178 </pre>
179 --
180 1.7.12.4

Replies