/[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.23 - (hide annotations) (download) (as text)
Wed Mar 17 16:42:46 2004 UTC (10 years, 6 months ago) by swift
Branch: MAIN
Changes since 1.22: +2 -3 lines
File MIME type: application/xml
Unmounting /dev isnt needed anymore as we have removed all references to bind-mounting /dev

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.23 <!-- $Header: /home/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-finalise.xml,v 1.22 2004/03/13 18:07:40 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 swift 1.22 <c>tts/0</c> to <path>/etc/securetty</path>:
27 swift 1.11 </p>
28    
29 swift 1.22 <pre caption="Adding tts/0 to /etc/securetty">
30     # <i>echo "tts/0" &gt;&gt; /etc/securetty</i>
31 swift 1.11 </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 swift 1.23 and unmount all mounted partitions. Then type in that
77 swift 1.15 one magical command you have been waiting for: <c>reboot</c>.
78 swift 1.4 </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 swift 1.6 Of course, don't forget to remove the bootable CD, otherwise the CD will be
89 swift 1.4 booted again instead of your new Gentoo system.
90     </p>
91    
92     <p>
93     OldWorld PPC users will boot in MacOS since their bootloader
94     isn't installed yet. Those users should read <uri
95 swift 1.11 link="#doc_chap2_sect2">Optional: Configuring BootX</uri>. MIPS users will have
96     to do some more tweaking in their MIPS PROM to get Gentoo to work. Those users
97     should read <uri link="#doc_chap2_sect3">Optional: Getting Gentoo/MIPS to
98 swift 1.19 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 swift 1.4 link="?part=1&amp;chap=12">Where to go from here?</uri>.
105 swift 1.1 </p>
106    
107     </body>
108 swift 1.3 </subsection>
109     <subsection>
110 swift 1.2 <title>Optional: Configuring BootX</title>
111     <body>
112    
113 swift 1.4 <impo>
114 swift 1.3 This subsection is <e>only</e> for PPC-users who want to use BootX as
115     bootloader. All other readers should skip this subsection.
116 swift 1.4 </impo>
117 swift 1.2
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 swift 1.4 <p>
135     If you are a GRP users you can continue with <uri
136 swift 1.19 link="#doc_chap2_sect4">Optional: Install GRP Packages</uri>, otherwise go to
137 swift 1.4 <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
138     </p>
139    
140 swift 1.2 </body>
141 swift 1.1 </subsection>
142 swift 1.4 <subsection>
143 swift 1.11 <title>Optional: Getting Gentoo/MIPS to Work</title>
144     <body>
145    
146     <p>
147     When you are rebooted, go to the <e>System Maintenance Menu</e> and select
148     <e>Enter Command Monitor</e> (<c>5</c>). If you want to test your new Gentoo
149     installation, you can just run <c>boot -f &lt;kernel name&gt;</c>. To have your
150     system permanently boot into the Gentoo installation, you need to set some
151     variables in the MIPS PROM:
152     </p>
153    
154     <pre caption="Configuring the PROM to Boot Gentoo">
155     1) Start System
156     2) Install System Software
157     3) Run Diagnostics
158     4) Recover System
159     5) Enter Command Monitor
160    
161     Option? <i>5</i>
162     Command Monitor. Type "exit" to return to the menu.
163    
164     <comment>(&lt;root device&gt; = Gentoo's root partition, e.g. /dev/sda3)</comment>
165     &gt;&gt; <i>setenv OSLoadPartition &lt;root device&gt;</i>
166    
167     <comment>(To list the available kernels, type "ls")</comment>
168     &gt;&gt; <i>setenv OSLoader &lt;kernel name&gt;</i>
169     &gt;&gt; <i>setenv OSLoadFilename &lt;kernel name&gt;</i>
170    
171     <comment>(Declare the kernel parameters you want to pass)</comment>
172     &gt;&gt; <i>setenv OSLoadOptions &lt;kernel parameters&gt;</i>
173    
174     <comment>(Provide the location of the Volume Header)</comment>
175     &gt;&gt; <i>setenv SystemPartition scsi(0)disk(1)rdisk(0)partition(8)</i>
176    
177     <comment>(Automatically boot Gentoo)</comment>
178     &gt;&gt; <i>setenv AutoLoad Yes</i>
179    
180     <comment>(Set the timezone)</comment>
181     &gt;&gt; <i>setenv TimeZone EST5EDT</i>
182    
183     <comment>(Use the serial console - graphic adapter users should have "g" instead of "d1" (one))</comment>
184     &gt;&gt; <i>setenv console d1</i>
185     </pre>
186    
187     <p>
188     Now you're ready to enjoy Gentoo!
189     </p>
190    
191     </body>
192     </subsection>
193     <subsection>
194 swift 1.19 <title>Optional: Install GRP Packages</title>
195 swift 1.1 <body>
196    
197 swift 1.4 <impo>
198     This part is for GRP users only. Other users should skip this part and continue
199     with <uri link="?part=1&amp;chap=12">Where to go from here?</uri>.
200     </impo>
201    
202     <p>
203     Now that your system is booted, log on as the user you created (for instance,
204     <c>john</c>) and use <c>su -</c> to gain root privileges:
205     </p>
206    
207     <pre caption="Gaining root privileges">
208     $ <i>su -</i>
209     Password: <comment>(Enter your root password)</comment>
210     </pre>
211    
212     <p>
213 swift 1.20 Now we need to change the Portage configuration to look for the prebuilt
214 swift 1.21 binaries from the second CD (Gentoo Packages CD). First mount this CD:
215 swift 1.4 </p>
216    
217 swift 1.21 <pre caption="Mount the Packages CD">
218 swift 1.17 # <i>mkdir /mnt/cdrom</i>
219 swift 1.21 <comment>(Put the Gentoo Packages CD in the CD tray)</comment>
220 swift 1.4 # <i>mount /mnt/cdrom</i>
221     </pre>
222    
223 swift 1.1 <p>
224 swift 1.20 Now configure Portage to use <path>/mnt/cdrom</path> for its prebuilt packages:
225 swift 1.4 </p>
226    
227 swift 1.20 <pre caption="Configuring Portage to use /mnt/cdrom">
228     # <i>ls /mnt/cdrom</i>
229    
230     <comment>(If there is a /mnt/cdrom/packages directory:)</comment>
231     # <i>export PKGDIR="/mnt/cdrom/packages"</i>
232    
233     <comment>(Otherwise:)</comment>
234     # <i>export PKGDIR="/mnt/cdrom"</i>
235 swift 1.4 </pre>
236    
237     <p>
238 swift 1.21 Now install the packages you want. The Packages CD contains several prebuilt
239     binaries, for instance KDE:
240 swift 1.4 </p>
241    
242     <pre caption="Installing KDE">
243 swift 1.19 # <i>USE="bindist" emerge --usepkg kde</i>
244 swift 1.4 </pre>
245    
246     <p>
247 swift 1.19 The <c>USE="bindist"</c> is needed when you install XFree (either directly or as
248     a dependency). It prevents the downloading of Microsoft's core fonts (which we
249     cannot distribute on our LiveCDs).
250     </p>
251    
252     <p>
253 swift 1.4 Be sure to install the binaries now. When you do an <c>emerge sync</c> to update
254     Portage (as you will learn later), the prebuilt binaries might not match against
255     the ebuilds in your updated Portage. You can try to circumvent this by using
256 swift 1.9 <c>emerge --usepkgonly</c> instead of <c>emerge --usepkg</c>.
257 swift 1.4 </p>
258    
259     <p>
260     Congratulations, your system is now fully equiped! Continue with <uri
261     link="?part=1&amp;chap=12">Where to go from here?</uri> to learn more about
262     Gentoo.
263 swift 1.1 </p>
264    
265     </body>
266 swift 1.4 </subsection>
267 swift 1.1 </section>
268 swift 1.3 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20