/[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.21 - (hide annotations) (download) (as text)
Tue Mar 9 14:35:22 2004 UTC (10 years, 1 month ago) by swift
Branch: MAIN
Changes since 1.20: +6 -6 lines
File MIME type: application/xml
Oops, forgot to s/CD-2/Packages CD/ in this file

1 swift 1.14 <?xml version='1.0' encoding='UTF-8'?>
2     <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3    
4 swift 1.5 <!-- 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 swift 1.21 <!-- $Header: /home/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-finalise.xml,v 1.20 2004/03/08 18:24:42 swift Exp $ -->
8 swift 1.7
9 swift 1.3 <sections>
10 swift 1.1 <section>
11     <title>User Administration</title>
12 swift 1.4 <subsection>
13     <title>Setting a root Password</title>
14 swift 1.1 <body>
15    
16     <p>
17 swift 1.4 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 swift 1.11 <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 swift 1.4 </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 swift 1.10 as much as possible. Therefore it is <e>strongly</e> recommended to add a user
42 swift 1.4 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 swift 1.1 </p>
64    
65     </body>
66 swift 1.4 </subsection>
67 swift 1.3 </section>
68     <section>
69     <title>Reboot and Enjoy</title>
70 swift 1.1 <subsection>
71 swift 1.2 <title>Rebooting</title>
72 swift 1.1 <body>
73    
74     <p>
75 swift 1.18 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 swift 1.15 <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 swift 1.4 </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 swift 1.6 Of course, don't forget to remove the bootable CD, otherwise the CD will be
90 swift 1.4 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 swift 1.11 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 swift 1.19 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 swift 1.4 link="?part=1&amp;chap=12">Where to go from here?</uri>.
106 swift 1.1 </p>
107    
108     </body>
109 swift 1.3 </subsection>
110     <subsection>
111 swift 1.2 <title>Optional: Configuring BootX</title>
112     <body>
113    
114 swift 1.4 <impo>
115 swift 1.3 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 swift 1.4 </impo>
118 swift 1.2
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 swift 1.4 <p>
136     If you are a GRP users you can continue with <uri
137 swift 1.19 link="#doc_chap2_sect4">Optional: Install GRP Packages</uri>, otherwise go to
138 swift 1.4 <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
139     </p>
140    
141 swift 1.2 </body>
142 swift 1.1 </subsection>
143 swift 1.4 <subsection>
144 swift 1.11 <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 swift 1.19 <title>Optional: Install GRP Packages</title>
196 swift 1.1 <body>
197    
198 swift 1.4 <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 swift 1.20 Now we need to change the Portage configuration to look for the prebuilt
215 swift 1.21 binaries from the second CD (Gentoo Packages CD). First mount this CD:
216 swift 1.4 </p>
217    
218 swift 1.21 <pre caption="Mount the Packages CD">
219 swift 1.17 # <i>mkdir /mnt/cdrom</i>
220 swift 1.21 <comment>(Put the Gentoo Packages CD in the CD tray)</comment>
221 swift 1.4 # <i>mount /mnt/cdrom</i>
222     </pre>
223    
224 swift 1.1 <p>
225 swift 1.20 Now configure Portage to use <path>/mnt/cdrom</path> for its prebuilt packages:
226 swift 1.4 </p>
227    
228 swift 1.20 <pre caption="Configuring Portage to use /mnt/cdrom">
229     # <i>ls /mnt/cdrom</i>
230    
231     <comment>(If there is a /mnt/cdrom/packages directory:)</comment>
232     # <i>export PKGDIR="/mnt/cdrom/packages"</i>
233    
234     <comment>(Otherwise:)</comment>
235     # <i>export PKGDIR="/mnt/cdrom"</i>
236 swift 1.4 </pre>
237    
238     <p>
239 swift 1.21 Now install the packages you want. The Packages CD contains several prebuilt
240     binaries, for instance KDE:
241 swift 1.4 </p>
242    
243     <pre caption="Installing KDE">
244 swift 1.19 # <i>USE="bindist" emerge --usepkg kde</i>
245 swift 1.4 </pre>
246    
247     <p>
248 swift 1.19 The <c>USE="bindist"</c> is needed when you install XFree (either directly or as
249     a dependency). It prevents the downloading of Microsoft's core fonts (which we
250     cannot distribute on our LiveCDs).
251     </p>
252    
253     <p>
254 swift 1.4 Be sure to install the binaries now. When you do an <c>emerge sync</c> to update
255     Portage (as you will learn later), the prebuilt binaries might not match against
256     the ebuilds in your updated Portage. You can try to circumvent this by using
257 swift 1.9 <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
258 swift 1.4 </p>
259    
260     <p>
261     Congratulations, your system is now fully equiped! Continue with <uri
262     link="?part=1&amp;chap=12">Where to go from here?</uri> to learn more about
263     Gentoo.
264 swift 1.1 </p>
265    
266     </body>
267 swift 1.4 </subsection>
268 swift 1.1 </section>
269 swift 1.3 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20