/[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.27 - (show annotations) (download) (as text)
Sun May 9 11:07:47 2004 UTC (10 years, 5 months ago) by swift
Branch: MAIN
Changes since 1.26: +1 -2 lines
File MIME type: application/xml
#49994 - /mnt/cdrom is automatically created by baselayout

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/hb-install-finalise.xml,v 1.26 2004/04/15 11:59:45 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>tts/0</c> to <path>/etc/securetty</path>:
27 </p>
28
29 <pre caption="Adding tts/0 to /etc/securetty">
30 # <i>echo "tts/0" &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 a user ever needs to perform some task as root, they can use <c>su -</c>
61 to 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. Then type in that
77 one magical command you have been waiting for: <c>reboot</c>.
78 </p>
79
80 <pre caption="Rebooting the system">
81 # <i>exit</i>
82 # <i>cd /</i>
83 # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
84 # <i>reboot</i>
85 </pre>
86
87 <p>
88 Of course, don't forget to remove the bootable CD, otherwise the CD will be
89 booted again instead of your new Gentoo system.
90 </p>
91
92 <p>
93 OldWorld <b>PPC</b> users will boot in MacOS since their bootloader
94 isn't installed yet. Those users should read <uri
95 link="#doc_chap2_sect2">Optional: Configuring BootX</uri>. <b>MIPS</b> users
96 will have to do some more tweaking in their MIPS PROM to get Gentoo to work.
97 Those users should read <uri link="#doc_chap2_sect3">Optional: Getting
98 Gentoo/MIPS to Work</uri>.
99 </p>
100
101 <p>
102 GRP users can continue with <uri link="#doc_chap2_sect4">Optional:
103 Install GRP Packages</uri>, all the rest can finish up with <uri
104 link="?part=1&amp;chap=12">Where to go from here?</uri>.
105 </p>
106
107 </body>
108 </subsection>
109 <subsection>
110 <title>Optional: Configuring BootX</title>
111 <body>
112
113 <impo>
114 This subsection is <e>only</e> for <b>PPC</b> users who want to use BootX as
115 bootloader. All other readers should skip this subsection.
116 </impo>
117
118 <p>
119 Now your machine is booted in MacOS, open the BootX control panel.
120 Select <c>Options</c>, and uncheck <c>Used specified RAM disk</c>. When you
121 return to the BootX main screen, you will now find an option to specify your
122 machine's root disk and partition. Fill these in with the appropriate
123 values.
124 </p>
125
126 <p>
127 BootX can be configured to start Linux upon boot. If you do this, you will
128 first see your machine boot into MacOS then, during startup, BootX will
129 load and start Linux. See the <uri
130 link="http://penguinppc.org/projects/bootx/">BootX home page</uri> for more
131 information.
132 </p>
133
134 <p>
135 If you are a GRP users you can continue with <uri
136 link="#doc_chap2_sect4">Optional: Install GRP Packages</uri>, otherwise go to
137 <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
138 </p>
139
140 </body>
141 </subsection>
142 <subsection>
143 <title>Optional: Getting Gentoo/MIPS to Work</title>
144 <body>
145
146 <impo>
147 This subsection is <e>only</e> for <b>MIPS</b> users! All other readers should
148 skip this subsection.
149 </impo>
150
151 <p>
152 When you are rebooted, go to the <e>System Maintenance Menu</e> and select
153 <e>Enter Command Monitor</e> (<c>5</c>). If you want to test your new Gentoo
154 installation, you can just run <c>boot -f &lt;kernel name&gt;</c>. To have your
155 system permanently boot into the Gentoo installation, you need to set some
156 variables in the MIPS PROM:
157 </p>
158
159 <pre caption="Configuring the PROM to Boot Gentoo">
160 1) Start System
161 2) Install System Software
162 3) Run Diagnostics
163 4) Recover System
164 5) Enter Command Monitor
165
166 Option? <i>5</i>
167 Command Monitor. Type "exit" to return to the menu.
168
169 <comment>(&lt;root device&gt; = Gentoo's root partition, e.g. /dev/sda3)</comment>
170 &gt;&gt; <i>setenv OSLoadPartition &lt;root device&gt;</i>
171
172 <comment>(To list the available kernels, type "ls")</comment>
173 &gt;&gt; <i>setenv OSLoader &lt;kernel name&gt;</i>
174 &gt;&gt; <i>setenv OSLoadFilename &lt;kernel name&gt;</i>
175
176 <comment>(Declare the kernel parameters you want to pass)</comment>
177 &gt;&gt; <i>setenv OSLoadOptions &lt;kernel parameters&gt;</i>
178
179 <comment>(Provide the location of the Volume Header)</comment>
180 &gt;&gt; <i>setenv SystemPartition scsi(0)disk(1)rdisk(0)partition(8)</i>
181
182 <comment>(Automatically boot Gentoo)</comment>
183 &gt;&gt; <i>setenv AutoLoad Yes</i>
184
185 <comment>(Set the timezone)</comment>
186 &gt;&gt; <i>setenv TimeZone EST5EDT</i>
187
188 <comment>(Use the serial console - graphic adapter users should have "g" instead of "d1" (one))</comment>
189 &gt;&gt; <i>setenv console d1</i>
190 </pre>
191
192 <p>
193 Now you're ready to enjoy Gentoo!
194 </p>
195
196 </body>
197 </subsection>
198 <subsection>
199 <title>Optional: Install GRP Packages</title>
200 <body>
201
202 <impo>
203 This part is for GRP users only. Other users should skip this part and continue
204 with <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
205 </impo>
206
207 <p>
208 Now that your system is booted, log on as the user you created (for instance,
209 <c>john</c>) and use <c>su -</c> to gain root privileges:
210 </p>
211
212 <pre caption="Gaining root privileges">
213 $ <i>su -</i>
214 Password: <comment>(Enter your root password)</comment>
215 </pre>
216
217 <p>
218 Now we need to change the Portage configuration to look for the prebuilt
219 binaries from the second CD (Gentoo Packages CD). First mount this CD:
220 </p>
221
222 <pre caption="Mount the Packages CD">
223 <comment>(Put the Gentoo Packages CD in the CD tray)</comment>
224 # <i>mount /mnt/cdrom</i>
225 </pre>
226
227 <p>
228 Now configure Portage to use <path>/mnt/cdrom</path> for its prebuilt packages:
229 </p>
230
231 <pre caption="Configuring Portage to use /mnt/cdrom">
232 # <i>ls /mnt/cdrom</i>
233
234 <comment>(If there is a /mnt/cdrom/packages directory:)</comment>
235 # <i>export PKGDIR="/mnt/cdrom/packages"</i>
236
237 <comment>(Otherwise:)</comment>
238 # <i>export PKGDIR="/mnt/cdrom"</i>
239 </pre>
240
241 <p>
242 Now install the packages you want. The Packages CD contains several prebuilt
243 binaries, for instance KDE:
244 </p>
245
246 <pre caption="Installing KDE">
247 # <i>USE="bindist" emerge --usepkg kde</i>
248 </pre>
249
250 <p>
251 The <c>USE="bindist"</c> is needed when you install XFree (either directly or as
252 a dependency). It prevents the downloading of Microsoft's core fonts (which we
253 cannot distribute on our LiveCDs).
254 </p>
255
256 <p>
257 Be sure to install the binaries now. When you do an <c>emerge sync</c> to update
258 Portage (as you will learn later), the prebuilt binaries might not match against
259 the ebuilds in your updated Portage. You can try to circumvent this by using
260 <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
261 </p>
262
263 <p>
264 Congratulations, your system is now fully equiped! Continue with <uri
265 link="?part=1&amp;chap=12">Where to go from here?</uri> to learn more about
266 Gentoo.
267 </p>
268
269 </body>
270 </subsection>
271 </section>
272 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20