/[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.17 - (show annotations) (download) (as text)
Thu Feb 12 07:50:50 2004 UTC (10 years, 8 months ago) by swift
Branch: MAIN
Changes since 1.16: +2 -1 lines
File MIME type: application/xml
Add "mkdir /mnt/cdrom" instruction before trying to mount the cd

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

  ViewVC Help
Powered by ViewVC 1.1.20