en-US/beginninginstallation.xml en-US/nextsteps.xml

[Rüdiger Landmann]

 en-US/beginninginstallation.xml |   38 ++-----
 en-US/nextsteps.xml             |  209 +++++++++++++++++++++++++++++++++++-----
 2 files changed, 198 insertions(+), 49 deletions(-)

New commits:
commit 147ea26251968ac82a29bf79ef9e41c958283675
Author: Ruediger Landmann <r.landmann(a)redhat.com&gt;
Date:   Wed Jan 6 16:56:30 2010 +1000

    Expand switching to a graphical login BZ#552071

diff --git a/en-US/beginninginstallation.xml b/en-US/beginninginstallation.xml
index b189ea5..dbbd44e 100644
--- a/en-US/beginninginstallation.xml
+++ b/en-US/beginninginstallation.xml
@@ -320,23 +320,26 @@
   </section>
   <section id="sn-graphics-problem">
     <title>Graphical and Text Interfaces</title>
+    <important>
+      <title>Graphical Interface Usage</title>
+      <para>Installing in text mode does <emphasis
role="strong">not</emphasis>
+	prevent you from using a graphical interface on your system once
+	it is installed.</para>
+    </important>
+    <important>
+      <title>Installation requires at least 128 MB of RAM</title>
+      <para>If your system has less than 128 MB of RAM, installation will not
continue.</para>
+    </important>
     <para>Fedora &PRODVER; supports graphical and text-based installations. 
-	However, the installer image must either fit in RAM or appear on 
-	local storage, such as the installation DVD or Live Media. Therefore, 
-	only systems with more than 384&nbsp;MB of RAM or that boot from the 
-	installation DVD or Live Media can use the graphical installer. Systems 
-	with 384&nbsp;MB RAM or less automatically scale back to using the text-based 
-	installer. Note that you must still have a minimum of 128&nbsp;MB of RAM for
installation to proceed in text mode. If you prefer to use the text-based installer, type
<option>linux text</option> at the 
-	<prompt>boot:</prompt> prompt.</para>
-	<para>If one of the following situations occurs, the installation
-      program uses a text mode:</para>
+	Only systems with more than about 400&nbsp;MB of RAM can use the graphical
installer. Systems with less RAM automatically scale back to using the text-based
installer. Note that you must still have a minimum of 128&nbsp;MB of RAM for
installation to proceed in text mode. If you prefer to use the text-based installer, type
<option>linux text</option> at the <prompt>boot:</prompt>
prompt.</para> <para>If one of the following situations occurs, the
installation program uses a text mode:
+    </para>
     <itemizedlist>
       <listitem>
 	<para>The installation system fails to identify the display
 	  hardware on your computer</para>
       </listitem>
       <listitem>
-	<para>Your computer has less than 384 MB of RAM</para>
+	<para>Your computer has less than about 400&nbsp;MB of RAM</para>
       </listitem>
       <listitem>
 	<para>You choose the text mode installation from the boot
@@ -345,20 +348,7 @@
     </itemizedlist>
     <para>The text screens provide most of the same functions as the standard
       screens, although disk partitioning is simplified, and bootloader configuration and
package selection are handled automatically in text mode. If you choose to install Fedora
in text mode, you can still configure your system to use a graphical interface
-      after installation.</para>
-    <important>
-      <title>Graphical Interface Usage</title>
-      <para>Installing in text mode does <emphasis
role="strong">not</emphasis>
-	prevent you from using a graphical interface on your system once
-	it is installed.  If you have trouble configuring your system
-	for graphical interface use, consult other sources for
-	troubleshooting help as shown in <xref
-	  linkend="sn-additional-help"/>.</para>
-    </important>
-    <important>
-      <title>Installation requires at least 128 MB of RAM</title>
-      <para>If your system has less than 128 MB of RAM, installation will not
continue.</para>
-    </important>
+      after installation. Refer to <xref
linkend="sn-switching-to-gui-login"/> for instructions.</para>
   </section>
 </chapter>
 
diff --git a/en-US/nextsteps.xml b/en-US/nextsteps.xml
index f2a7d1c..8811191 100644
--- a/en-US/nextsteps.xml
+++ b/en-US/nextsteps.xml
@@ -186,6 +186,12 @@
   </section>
   <section id="sn-switching-to-gui-login">
     <title>Switching to a Graphical Login</title>
+    <important>
+		<title>Important — Access to Software Repositories Might Be
Required</title>
+		<para>
+			To switch to a graphical environment, you might need to install extra software from a
<firstterm>repository</firstterm>. You can access Fedora repositories through
the Internet or use a Fedora installation CD or DVD as a repository. Refer to <xref
linkend="sn-enabling-repos"/>.
+		</para>
+	</important>
     <para>
       If you installed using a text login and wish to switch to a
       graphical login, follow this procedure.
@@ -193,20 +199,27 @@
     <procedure>
       <step>
 	<para>
-	  Switch users to the <systemitem>root</systemitem> account:
+	  If you are not already root, switch users to the
<systemitem>root</systemitem> account:
 	</para>
-	<screen><![CDATA[su -]]></screen>
+<screen><command>su -</command></screen>
 	<para>
 	  Provide the administrator password when prompted.
 	</para>
       </step>
       <step>
 	<para>
-	  If you have not already done so, install one of the graphical
-	  desktop environments.  For instance, to install the GNOME
+	  If you have not already done so, install the <application>X Window
System</application> and a graphical desktop environment. For example, to install
the GNOME
 	  desktop environment, use this command:
 	</para>
-	<screen><![CDATA[yum groupinstall "GNOME Desktop
Environment"]]></screen> 
+<screen><command>yum groupinstall "X Window System" "GNOME
Desktop Environment"</command></screen> 
+	<para>
+		To install the KDE desktop environment, use:
+	</para>
+<screen><command>yum groupinstall "X Window System"
KDE</command></screen> 
+	<para>
+		To install the XFCE desktop environment, use:
+	</para>
+<screen><command>yum groupinstall "X Window System"
XFCE</command></screen> 
 	<para>
 	  This step may take some time as your Fedora system downloads
 	  and installs additional software.  You may be asked to provide
@@ -219,38 +232,184 @@
 	  Run the following command to edit the
 	  <filename>/etc/inittab</filename> file:
 	</para>
-	<screen><![CDATA[nano /etc/inittab]]></screen>
-      </step>
-      <step>
-	<para>
-	  Find the line that includes the text <literal>initdefault</literal>. 
Change the numeral <literal>3</literal> to <literal>5</literal>.
-	</para>
+<screen><command>vi /etc/inittab</command></screen>
       </step>
       <step>
-	<para>
-	  Hit
-	 
<keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>
-	  to write the file to disk, and then hit
-	 
<keycombo><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>
-	  to exit the program.
-	</para>
+	      <para>
+		      Press the <keycap>I</keycap> key to enter
<literal>insert</literal> mode.
+	      </para>
       </step>
       <step>
 	<para>
-	  Type <command>exit</command> to logout of the administrator account.
+	  Find the line that includes the text <literal>initdefault</literal>. 
Change the numeral <literal>3</literal> to <literal>5</literal>.
 	</para>
       </step>
+	<step>
+		<para>
+			Type <literal>:wq</literal> and press the
<keycap>Enter</keycap> key to save the file and exit the
<application>vi</application> text editor.
+		</para>
+	</step>
     </procedure>
     <para>
-      If desired, you can reboot the system using the
+      Reboot the system using the
       <command>reboot</command> command.  Your system will restart and
       present a graphical login.
     </para>
-    <para>
-      If you encounter any problems with the graphical login, consult
-      one of the help sources listed in <xref
-      linkend="sn-additional-help"/>.
-    </para>
+	<para>
+		If you encounter any problems with the graphical login, refer to <xref
linkend="ch-trouble-x86"/> or consult one of the help sources listed in
<xref linkend="sn-additional-help"/>.
+	</para>
+	 <section id="sn-enabling-repos">
+	 <title>Enabling Access to Software Repositories from the Command
Line</title>
+		<para>
+			The usual way to install new software on a Fedora system is through a software
repository. You can access Fedora repositories through the Internet, or use a Fedora
installation CD or DVD as a repository. The software that you access through online
repositories is more up-to-date than what is available on an installation CD or DVD.
Furthermore, configuring a Fedora system to access online repositories is generally easier
than configuring the system to use an installation CD or DVD as a repository, as long as
you have an existing, wired network connection available. 
+		</para>
+		<section id="sn-enabling-repos-internet">
+			<title>Enabling Access to Software Repositories Through the
Internet</title>
+			<para>
+				By default, every Fedora installation is already configured to access Fedora
repositories through the Internet. Therefore, all you must do is ensure that the system
can access the Internet. If you have an existing, wired network connection available, this
process is straightforward:
+			</para>
+			<procedure>
+				<step>
+					<para>
+						If you are not already root, switch users to the
<systemitem>root</systemitem> account:
+					</para>
+<screen><command>su -</command></screen>
+				</step>
+				<step>
+					<para>
+						Ensure that the system is plugged into your network. Note that your network might
be as small as two devices — a computer and an external modem/router.
+					</para>
+				</step>
+				<step>
+					<para>
+						Run <command>system-config-network</command>. The network configuration
tool starts and displays the <guilabel>Select Action</guilabel> screen.
+					</para>
+				</step>
+				<step>
+					<para>
+						Select <guimenuitem>Edit a device params</guimenuitem> and press
<keycap>Enter</keycap>. The network configuration tool displays the
<guilabel>Select A Device</guilabel> screen with a list of network interfaces
present on your system. The first interface is named
<systemitem>eth0</systemitem> by default.
+					</para>
+				</step>
+				<step>
+					<para>
+						Select a network interface to configure and press
<keycap>Enter</keycap>. The network configuration tool takes you to the
<guilabel>Network Configuration</guilabel> screen.
+					</para>
+				</step>
+				<step>
+					<para>
+						You can manually configure a static IP, gateway, and DNS servers on this screen or
leave these fields blank to accept the default values. When you have chosen a
configuration, select <guibutton>OK</guibutton>, and press
<keycap>Enter</keycap>. The network configuration tool takes you back to the
<guilabel>Select A Device</guilabel> screen.
+					</para>
+				</step>
+				<step>
+					<para>
+						Select <guibutton>Save</guibutton> and press
<keycap>Enter</keycap>. The network configuration tool takes you back to the
<guilabel>Select Action</guilabel> screen.
+					</para>
+				</step>
+				<step>
+					<para>
+						Select <guibutton>Save&amp;Quit</guibutton> and press
<keycap>Enter</keycap>. The network configuration tool saves your settings and
exits.
+					</para>
+				</step>
+				<step>
+					<para>
+						Run <command>ifup
<replaceable>interface</replaceable></command>, where
<replaceable>interface</replaceable> is the network interface that you
configured with the network configuration tool. For example, run <command>ifup
eth0</command> to start <systemitem>eth0</systemitem>.
+					</para>
+				</step>
+			</procedure>
+			<para>
+				Configuration of dial-up or wireless Internet connections is more complicated and
beyond the scope of this guide.
+			</para>
+		</section>
+		<section id="sn-enabling-repos-disc">
+			<title>Using a Fedora Installation CD or DVD as a Software
Repository</title>
+			<para>
+				To use a Fedora installation CD or DVD as a software repository:
+			</para>
+			<procedure>
+				<step>
+					<para>
+						Insert the CD or DVD into your computer.
+					</para>
+				</step>
+				<step>
+					<para>
+						If you are not already root, switch users to the
<systemitem>root</systemitem> account:
+					</para>
+<screen><command>su -</command></screen>
+				</step>
+				<step>
+					<para>
+						Create a <firstterm>mount point</firstterm> for the repository:
+					</para>
+<screen><command>mkdir -p
<replaceable>/path/to/repo</replaceable></command></screen>
+					<para>
+						where <replaceable>/path/to/repo</replaceable> is a location for the
repository, for example, <filename>/mnt/repo</filename>
+					</para>
+				</step>
+				<step>
+					<para>
+						<firstterm>Mount</firstterm> the CD or DVD on the mount point that you
just created. You need to know the <firstterm>device name</firstterm> of your
CD or DVD drive. You can find the names of any CD or DVD drives on your system with the
command <command>cat /proc/sys/dev/cdrom/info</command>. The first CD or DVD
drive on the system is typically named <literal>sr0</literal>. When you know
the device name, mount the CD or DVD:
+					</para>
+<screen><command>mount -r -t iso9660
/dev/<replaceable>device_name</replaceable>
<replaceable>/path/to/repo</replaceable></command></screen>
+					<para>
+						For example: <command>mount -r -t iso9660 /dev/sr0 /mnt/repo</command>
+					</para>
+				</step>
+				<step>
+					<para>
+						Edit the <filename>/etc/yum.repos.d/fedora.repo</filename> and
<filename>/etc/yum.repos.d/fedora-updates.repo</filename> files to use the new
repository. In each case:
+					</para>
+					<procedure>
+						<step>
+							<para>
+								Open the file with the <application>vi</application> text editor. For
example:
+							</para>
+<screen><command>vi
/etc/yum.repos.d/fedora.repo</command></screen>
+						</step>
+						<step>
+							<para>
+								Press the <keycap>I</keycap> key to enter
<literal>insert</literal> mode.
+							</para>
+						</step>
+						<step>
+							<para>
+								Type a <literal>#</literal> character at the start of any line in the
file that starts with <literal>baseurl</literal> or
<literal>mirrorlist</literal>. The <literal>#</literal> character
<firstterm>comments out</firstterm> the line so that the package management
software ignores it.
+							</para>
+						</step>
+						<step>
+							<para>
+								Find the <literal>[fedora]</literal> section of the
<filename>fedora.repo</filename> file or the
<literal>[updates]</literal> section of the
<filename>fedora-updates.repo</filename> file. Note that this section includes
a line that now starts <literal># baseurl</literal> that you previously
commented out.
+							</para>
+						</step>
+						<step>
+							<para>
+								Insert a new line after the line that starts <literal>#
baseurl</literal>:
+							</para>
+<screen>baseurl=file://<replaceable>/path/to/repo</replaceable></screen>
+							<para>
+								For example, <literal>baseurl=file:///mnt/repo</literal>
+							</para>
+						</step>
+						<step>
+							<para>
+								Press the <keycap>Esc</keycap> key to exit
<literal>insert</literal> mode.
+							</para>
+						</step>
+						<step>
+							<para>
+								Type <literal>:wq</literal> and press the
<keycap>Enter</keycap> key to save the file and exit the
<application>vi</application> text editor.
+							</para>
+						</step>
+						<step>
+							<para>
+								After installing or upgrading software from the CD or DVD, edit the
<filename>/etc/yum.repos.d/fedora.repo</filename> and
<filename>/etc/yum.repos.d/fedora-updates.repo</filename> files again to undo
the changes that you made.
+							</para>
+						</step>
+					</procedure>
+				</step>
+			</procedure>
+		</section>
+	 </section>
   </section>
   <section id="sn-news-subscriptions">
     <title>Subscribing to Fedora Announcements and News</title>