/[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.16 - (hide annotations) (download) (as text)
Sun Jan 25 10:28:12 2004 UTC (10 years, 9 months ago) by neysx
Branch: MAIN
Changes since 1.15: +2 -2 lines
File MIME type: application/xml
#39323

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 neysx 1.16 <!-- $Header: /home/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-finalise.xml,v 1.15 2004/01/17 17:08:46 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.4 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 swift 1.15 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 swift 1.4 </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 swift 1.6 Of course, don't forget to remove the bootable CD, otherwise the CD will be
92 swift 1.4 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 swift 1.11 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 swift 1.4 link="?part=1&amp;chap=12">Where to go from here?</uri>.
104 swift 1.1 </p>
105    
106     </body>
107 swift 1.3 </subsection>
108     <subsection>
109 swift 1.2 <title>Optional: Configuring BootX</title>
110     <body>
111    
112 swift 1.4 <impo>
113 swift 1.3 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 swift 1.4 </impo>
116 swift 1.2
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 swift 1.4 <p>
134     If you are a GRP users you can continue with <uri
135 neysx 1.16 link="#doc_chap2_sect4">Optional: Install Extra Packages</uri>, otherwise go to
136 swift 1.4 <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
137     </p>
138    
139 swift 1.2 </body>
140 swift 1.1 </subsection>
141 swift 1.4 <subsection>
142 swift 1.11 <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 swift 1.1 <title>Optional: Install Extra Packages</title>
194     <body>
195    
196 swift 1.4 <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 swift 1.13 Now we need to copy over the prebuilt binaries from the second CD (CD-2) if you
213 swift 1.4 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 swift 1.1 <p>
222 swift 1.13 Now copy over all prebuilt binaries from the CD to
223 swift 1.8 <path>/usr/portage/packages</path>. Make sure you use the same copy-command!
224 swift 1.4 </p>
225    
226 swift 1.13 <pre caption="Copy over prebuilt binaries">
227 swift 1.12 # <i>cp /mnt/cdrom/packages/All/* /usr/portage/packages/All/</i>
228 swift 1.4 </pre>
229    
230     <p>
231 swift 1.13 Now install the packages you want. CD-2 contains several prebuilt binaries, for
232 swift 1.4 instance KDE:
233     </p>
234    
235     <pre caption="Installing KDE">
236 swift 1.9 # <i>emerge --usepkg kde</i>
237 swift 1.4 </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 swift 1.9 <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
244 swift 1.4 </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 swift 1.1 </p>
251    
252     </body>
253 swift 1.4 </subsection>
254 swift 1.1 </section>
255 swift 1.3 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20