/[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.15 - (show annotations) (download) (as text)
Sat Jan 17 17:08:46 2004 UTC (10 years, 7 months ago) by swift
Branch: MAIN
Changes since 1.14: +4 -3 lines
File MIME type: application/xml
#38514 - Add /dev unmounting

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.14 2004/01/08 14:23:17 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. 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_sect3">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 <comment>(Put CD-2 in the CD tray)</comment>
218 # <i>mount /mnt/cdrom</i>
219 </pre>
220
221 <p>
222 Now copy over all prebuilt binaries from the CD to
223 <path>/usr/portage/packages</path>. Make sure you use the same copy-command!
224 </p>
225
226 <pre caption="Copy over prebuilt binaries">
227 # <i>cp /mnt/cdrom/packages/All/* /usr/portage/packages/All/</i>
228 </pre>
229
230 <p>
231 Now install the packages you want. CD-2 contains several prebuilt binaries, for
232 instance KDE:
233 </p>
234
235 <pre caption="Installing KDE">
236 # <i>emerge --usepkg kde</i>
237 </pre>
238
239 <p>
240 Be sure to install the binaries now. When you do an <c>emerge sync</c> to update
241 Portage (as you will learn later), the prebuilt binaries might not match against
242 the ebuilds in your updated Portage. You can try to circumvent this by using
243 <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
244 </p>
245
246 <p>
247 Congratulations, your system is now fully equiped! Continue with <uri
248 link="?part=1&amp;chap=12">Where to go from here?</uri> to learn more about
249 Gentoo.
250 </p>
251
252 </body>
253 </subsection>
254 </section>
255 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20