/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-finalise.xml
Gentoo

Contents of /xml/htdocs/doc/en/handbook/hb-install-finalise.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.19 - (show annotations) (download) (as text)
Mon Mar 1 05:43:41 2004 UTC (10 years, 9 months ago) by swift
Branch: MAIN
Changes since 1.18: +16 -6 lines
File MIME type: application/xml
Move from draft - 2004.0 is released

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6
7 <!-- $Header: /home/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-finalise.xml,v 1.5 2004/02/25 15:24:21 swift Exp $ -->
8
9 <sections>
10 <section>
11 <title>User Administration</title>
12 <subsection>
13 <title>Setting a root Password</title>
14 <body>
15
16 <p>
17 Before you forget, set the root password by typing:
18 </p>
19
20 <pre caption="Setting the root password">
21 # <i>passwd</i>
22 </pre>
23
24 <p>
25 If you want root to be able to log on through the serial console, add
26 <c>ttyS0</c> to <path>/etc/securetty</path>.
27 </p>
28
29 <pre caption="Adding ttyS0 to /etc/securetty">
30 # <i>echo "ttyS0" &gt;&gt; /etc/securetty</i>
31 </pre>
32
33 </body>
34 </subsection>
35 <subsection>
36 <title>Adding a User for Daily Use</title>
37 <body>
38
39 <p>
40 Working as root on a Unix/Linux system is <e>dangerous</e> and should be avoided
41 as much as possible. Therefore it is <e>strongly</e> recommended to add a user
42 for day-to-day use.
43 </p>
44
45 <p>
46 For instance, to create a user called <c>john</c> who is member of the
47 <c>wheel</c> group (be able to change to root using <c>su</c>), <c>users</c>
48 group (default for all users) and <c>audio</c> group (be able to use audio
49 devices):
50 </p>
51
52 <pre caption="Adding a user for day-to-day use">
53 # <i>useradd john -m -G users,wheel,audio -s /bin/bash</i>
54 # <i>passwd john</i>
55 Password: <comment>(Enter the password for john)</comment>
56 Re-enter password: <comment>(Re-enter the password to verify)</comment>
57 </pre>
58
59 <p>
60 If this user ever needs to perform some task as root, he can use <c>su -</c> to
61 temporarily receive root privileges. Another way is to use the <c>sudo</c>
62 package which is, if correctly configured, very secure.
63 </p>
64
65 </body>
66 </subsection>
67 </section>
68 <section>
69 <title>Reboot and Enjoy</title>
70 <subsection>
71 <title>Rebooting</title>
72 <body>
73
74 <p>
75 Congratulations! Your Gentoo system is now ready. Exit the chrooted environment
76 and unmount all mounted partitions and, in case you had to bind-mount
77 <path>/mnt/gentoo/dev</path>, don't forget to unmount it too. Then type in that
78 one magical command you have been waiting for: <c>reboot</c>.
79 </p>
80
81 <pre caption="Rebooting the system">
82 # <i>exit</i>
83 # <i>cd /</i>
84 # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
85 # <i>reboot</i>
86 </pre>
87
88 <p>
89 Of course, don't forget to remove the bootable CD, otherwise the CD will be
90 booted again instead of your new Gentoo system.
91 </p>
92
93 <p>
94 OldWorld PPC users will boot in MacOS since their bootloader
95 isn't installed yet. Those users should read <uri
96 link="#doc_chap2_sect2">Optional: Configuring BootX</uri>. MIPS users will have
97 to do some more tweaking in their MIPS PROM to get Gentoo to work. Those users
98 should read <uri link="#doc_chap2_sect3">Optional: Getting Gentoo/MIPS to
99 Work</uri>.
100 </p>
101
102 <p>
103 GRP users can continue with <uri link="#doc_chap2_sect4">Optional:
104 Install GRP Packages</uri>, all the rest can finish up with <uri
105 link="?part=1&amp;chap=12">Where to go from here?</uri>.
106 </p>
107
108 </body>
109 </subsection>
110 <subsection>
111 <title>Optional: Configuring BootX</title>
112 <body>
113
114 <impo>
115 This subsection is <e>only</e> for PPC-users who want to use BootX as
116 bootloader. All other readers should skip this subsection.
117 </impo>
118
119 <p>
120 Now your machine is booted in MacOS, open the BootX control panel.
121 Select <c>Options</c>, and uncheck <c>Used specified RAM disk</c>. When you
122 return to the BootX main screen, you will now find an option to specify your
123 machine's root disk and partition. Fill these in with the appropriate
124 values.
125 </p>
126
127 <p>
128 BootX can be configured to start Linux upon boot. If you do this, you will
129 first see your machine boot into MacOS then, during startup, BootX will
130 load and start Linux. See the <uri
131 link="http://penguinppc.org/projects/bootx/">BootX home page</uri> for more
132 information.
133 </p>
134
135 <p>
136 If you are a GRP users you can continue with <uri
137 link="#doc_chap2_sect4">Optional: Install GRP Packages</uri>, otherwise go to
138 <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
139 </p>
140
141 </body>
142 </subsection>
143 <subsection>
144 <title>Optional: Getting Gentoo/MIPS to Work</title>
145 <body>
146
147 <p>
148 When you are rebooted, go to the <e>System Maintenance Menu</e> and select
149 <e>Enter Command Monitor</e> (<c>5</c>). If you want to test your new Gentoo
150 installation, you can just run <c>boot -f &lt;kernel name&gt;</c>. To have your
151 system permanently boot into the Gentoo installation, you need to set some
152 variables in the MIPS PROM:
153 </p>
154
155 <pre caption="Configuring the PROM to Boot Gentoo">
156 1) Start System
157 2) Install System Software
158 3) Run Diagnostics
159 4) Recover System
160 5) Enter Command Monitor
161
162 Option? <i>5</i>
163 Command Monitor. Type "exit" to return to the menu.
164
165 <comment>(&lt;root device&gt; = Gentoo's root partition, e.g. /dev/sda3)</comment>
166 &gt;&gt; <i>setenv OSLoadPartition &lt;root device&gt;</i>
167
168 <comment>(To list the available kernels, type "ls")</comment>
169 &gt;&gt; <i>setenv OSLoader &lt;kernel name&gt;</i>
170 &gt;&gt; <i>setenv OSLoadFilename &lt;kernel name&gt;</i>
171
172 <comment>(Declare the kernel parameters you want to pass)</comment>
173 &gt;&gt; <i>setenv OSLoadOptions &lt;kernel parameters&gt;</i>
174
175 <comment>(Provide the location of the Volume Header)</comment>
176 &gt;&gt; <i>setenv SystemPartition scsi(0)disk(1)rdisk(0)partition(8)</i>
177
178 <comment>(Automatically boot Gentoo)</comment>
179 &gt;&gt; <i>setenv AutoLoad Yes</i>
180
181 <comment>(Set the timezone)</comment>
182 &gt;&gt; <i>setenv TimeZone EST5EDT</i>
183
184 <comment>(Use the serial console - graphic adapter users should have "g" instead of "d1" (one))</comment>
185 &gt;&gt; <i>setenv console d1</i>
186 </pre>
187
188 <p>
189 Now you're ready to enjoy Gentoo!
190 </p>
191
192 </body>
193 </subsection>
194 <subsection>
195 <title>Optional: Install GRP Packages</title>
196 <body>
197
198 <impo>
199 This part is for GRP users only. Other users should skip this part and continue
200 with <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
201 </impo>
202
203 <p>
204 Now that your system is booted, log on as the user you created (for instance,
205 <c>john</c>) and use <c>su -</c> to gain root privileges:
206 </p>
207
208 <pre caption="Gaining root privileges">
209 $ <i>su -</i>
210 Password: <comment>(Enter your root password)</comment>
211 </pre>
212
213 <p>
214 Now we need to copy over the prebuilt binaries from the second CD (CD-2) if you
215 have it. First mount this CD:
216 </p>
217
218 <pre caption="Mount the CD-2">
219 # <i>mkdir /mnt/cdrom</i>
220 <comment>(Put CD-2 in the CD tray)</comment>
221 # <i>mount /mnt/cdrom</i>
222 </pre>
223
224 <p>
225 Now copy over all prebuilt binaries from the CD to
226 <path>/usr/portage/packages</path>. Make sure you use the same copy-command!
227 </p>
228
229 <pre caption="Copy over prebuilt binaries">
230 # <i>cp /mnt/cdrom/packages/All/* /usr/portage/packages/All/</i>
231 </pre>
232
233 <p>
234 Now install the packages you want. CD-2 contains several prebuilt binaries, for
235 instance KDE:
236 </p>
237
238 <pre caption="Installing KDE">
239 # <i>USE="bindist" emerge --usepkg kde</i>
240 </pre>
241
242 <p>
243 The <c>USE="bindist"</c> is needed when you install XFree (either directly or as
244 a dependency). It prevents the downloading of Microsoft's core fonts (which we
245 cannot distribute on our LiveCDs).
246 </p>
247
248 <p>
249 Be sure to install the binaries now. When you do an <c>emerge sync</c> to update
250 Portage (as you will learn later), the prebuilt binaries might not match against
251 the ebuilds in your updated Portage. You can try to circumvent this by using
252 <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
253 </p>
254
255 <p>
256 Congratulations, your system is now fully equiped! Continue with <uri
257 link="?part=1&amp;chap=12">Where to go from here?</uri> to learn more about
258 Gentoo.
259 </p>
260
261 </body>
262 </subsection>
263 </section>
264 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20