/[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.18 - (hide annotations) (download) (as text)
Tue Feb 24 18:56:50 2004 UTC (10 years, 6 months ago) by swift
Branch: MAIN
Changes since 1.17: +3 -5 lines
File MIME type: application/xml
#42719 - Remove etc-update command; it isnt needed for a succesful installation and the user should really read up on etc-update later on

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

  ViewVC Help
Powered by ViewVC 1.1.20