install-guide fedora-install-guide-en.xml, 1.12, 1.13 fedora-install-guide-nextsteps-en.xml, 1.3, 1.4
Stuart Ellis (elliss)
fedora-docs-commits at redhat.com
Mon May 16 23:57:47 UTC 2005
Author: elliss
Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv21752
Modified Files:
fedora-install-guide-en.xml
fedora-install-guide-nextsteps-en.xml
Log Message:
Put an initial revision of "Next Steps" back in for people to look at. Obviously this can be disabled (again) for release if necessary.
Index: fedora-install-guide-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-en.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- fedora-install-guide-en.xml 15 May 2005 18:44:39 -0000 1.12
+++ fedora-install-guide-en.xml 16 May 2005 23:57:45 -0000 1.13
@@ -128,6 +128,8 @@
&FIRSTBOOT;
+ &NEXTSTEPS;
+
&ACKNOWLEDGEMENTS;
<index id="generated-index">
Index: fedora-install-guide-nextsteps-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-nextsteps-en.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- fedora-install-guide-nextsteps-en.xml 3 May 2005 12:19:44 -0000 1.3
+++ fedora-install-guide-nextsteps-en.xml 16 May 2005 23:57:45 -0000 1.4
@@ -4,32 +4,101 @@
<title>Your Next Steps</title>
<para>
- Once you have installed &FC; you have a complete system at your
- disposal. This chapter will help you to find your way around this
- new environment.
+ Once you have installed &FC; you have a complete operating system at your
+ disposal. This chapter enables you to take the next steps.
</para>
+
+ <section id="sn-concepts">
+ <title>Concepts</title>
+
<para>
- &FED; is a <firstterm>multi-user</firstterm> system that enables
- many users to be logged in to the same system simultaneously, and
- the same user to log in more than once. With network logins there
- is no limit to the number of these <firstterm>sessions</firstterm>,
- other than the capacity of your machine.
+ The installation process shows some of the aspects of Linux-based
+ systems that may be unfamiliar to users of other operating
+ systems. These are explained below.
</para>
- <sect1 id="s1-fedora-desktop">
- <title>Logging in to the &FED; Desktop</title>
+ <section id="sn-concepts-accounts">
+ <title>User Accounts and the Root Account</title>
- <para>
- Several different graphical environments can be installed on a
- &FED; system, enabling you to use whichever type of desktop you
- wish. If your system has more than one graphical environment
- available, you can select which one will load from the
- <guilabel>Session</guilabel> menu on the login screen. You then
- login with the same user account, but will see a different
- environment.
+ <para>
+ User accounts on Linux-based systems do not have unrestricted
+ access to the system. Only the root account has such access,
+ and users use tools to gain root access for a specific program, or for
+ short periods of time. This protects the system from both user
+ error and hostile software.
+ </para>
+
+ </section>
+
+
+ <section id="sn-concepts-sessions">
+ <title>Logins and Sessions</title>
+
+ <para>
+ &FED; is a <firstterm>multi-user</firstterm> system, enabling many
+ users to be logged in to the same system simultaneously. Each
+ user may also log in more than once. Individual <firstterm>sessions</firstterm>
+ can either be applications, graphical desktops or command-line
+ environments. The maximum number of local and remote sessions is
+ only limited by the resources of your machine.
+ </para>
+
+ <note>
+ <title>Console sessions</title>
+ <para>
+ The sessions that use the keyboard and display attached to the
+ machine can use discs and shutdown the machine without root access.
</para>
+ </note>
+
+ <para>
+ OpenSSH is automatically installed on all &FED; systems to
+ provide secure remote access. The SSH service enables users to
+ transfer files, run applications, and login to command-line
+ sessions from other systems.
+ </para>
+
+ <para>
+ To support multi-user access, the graphical software is <firstterm>network
+ transparent</firstterm>, a feature of the X-Windows technology
+ used by all UNIX-like systems. This network transparency means
+ that you can launch graphical applications on remote systems and
+ have them appear on your current desktop when logged into any
+ system that includes both SSH and X-Windows software.
+ </para>
+
+ <para>
+ X-Windows enables network desktop sessions with XDMCP (X
+ Display Manager Control Protocol). &FC; also includes VNC,
+ which provides additional features for remote desktop access.
+ </para>
+
+ <para>
+ For more information, refer to the <ulink
+ url="http://www.tldp.org/HOWTO/XDMCP-HOWTO/">Linux XDMCP HOWTO</ulink>.
+ </para>
+
+ <caution>
+ <title>X-Windows and VNC Are Only Secure With SSH</title>
+ <para>
+ SSH encrypts all of the connections that it makes between
+ systems. X-Windows and VNC connections are not encrypted
+ unless made with SSH.
+ </para>
+ </caution>
+
+ </section>
+
+
+ <section id="sn-concepts-environments">
+ <title>Environments</title>
+
+ <para>
+ &FED; systems may have multiple graphical and command-line
+ environments installed. Applications run in all environments.
+ </para>
<para>
By default, the GNOME desktop is installed with &FC;, providing an
@@ -40,45 +109,200 @@
<para>
&FC; also includes the KDE environment, a highly customizable
- desktop which offers an extensive range of features. Additional
+ desktop that offers an extensive range of features. Additional
graphical environments are available from &FED; Extras.
</para>
- <note>
- <title>Applications will run in any graphical environment</title>
+ <para>
+ For more information on these desktop environments, refer to the
+ <xref linkend="sn-desktop-help"></xref>.
+ </para>
+
+ <para>
+ GNU <command>bash</command> is the default command-line
+ environment, or <firstterm>shell</firstterm>, for &FED;. For
+ more information on <command>bash</command>, refer to the
+ following documents:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink url="http://www.tldp.org/LDP/Bash-Beginners-Guide/html">Bash Guide for Beginners</ulink>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.tldp.org/LDP/abs/html">Advanced Bash-Scripting Guide</ulink>.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ You are not required to use only one environment. The settings
+ for each environment are stored in separate files in your home directory.
+ </para>
+
+ </section>
+
+
+ <section id="sn-concepts-networking">
+ <title>Networking</title>
+
+ <para>
+ UNIX-like systems such as &FED; use the same network
+ technologies as the Internet. For example:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ TCP/IP is the basic protocol for networking.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Automated processes use e-mail to report to the system administrator.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Many applications use HTTP (HyperText Transfer Protocol)
+ as the default method for transferring files.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ For more information on networking concepts, refer to <ulink
+ url="http://www.tldp.org/LDP/nag2/">Chapters 1 and 2 of the
+ Linux Network Administrators Guide</ulink>.
+ </para>
+
+ </section>
+
+
+ <section id="sn-concepts-packages">
+ <title>Software Packages</title>
+
+ <para>
+ All of the software and documentation prepared for use with
+ &FED; is supplied in the form of files called RPM
+ <firstterm>packages</firstterm>. Each package is a compressed
+ archive containing product information, program files,
+ documentation and management scripts. Packages also include a
+ digital signature to prove their source. These files are used
+ by management applications to safely locate, install, update and
+ remove software.
+ </para>
+
+ <para>
+ The &FED; installation process uses the packages supplied with
+ &FC; to build or upgrade a system to your requirements. After
+ the installation, use <application>up2date</application> and
+ <command>yum</command> to install and manage the software on
+ your &FED; system.
+ </para>
+
+ <para>
+ Both of these applications automatically locate and obtain
+ packages from <firstterm>repositories</firstterm>, which are prepared
+ directories or Websites. The &FP; has a network of repository
+ servers to provide software. These repositories hold the
+ packages included with &FC; and a large selection of additional
+ software, known as &FED; Extras. Third-party software
+ developers also provide repositories for their &FED; compatible packages.
+ </para>
+
+ <note>
+ <title>All &FED; packages are Free Software</title>
+ <para>
+ All of the software provided by the &FP; is Free Software, or Open
+ Source, and can therefore be downloaded and installed without restrictions.
+ </para>
+ </note>
+
+ </section>
+
+
+ <section id="sn-concepts-partitioning">
+ <title>Access Control - File Permissions and &SEL;</title>
+
+ <para>
+ <remark role="FIXME">INCOMPLETE - link to &SEL; FAQ etc. here.</remark>
+ </para>
+
+ </section>
+
+
+ <section id="sn-concepts-partitions">
+ <title>Disks and Partitions</title>
+
<para>
- The applications supplied with &FC; are available in all of the
- graphical environments.
- </para>
- </note>
+ <remark role="FIXME">Needs a bit of prefacing text.</remark>
+ </para>
- </sect1>
+ <para>
+ For more information on partitioning, refer to <ulink
+ url="http://www.tldp.org/HOWTO/Partition/">Linux Partition HOWTO</ulink>.
+ </para>
+ <para>
+ For more information on the directory structure, refer to the
+ <ulink url="http://www.pathname.com/fhs/">Filesystem
+ Hierarchy Standard</ulink>.
+ </para>
- <sect1 id="s1-fedora-commandline">
+ </section>
+
+ </section>
+
+
+ <section id="sn-common-tasks">
+ <title>Common Tasks</title>
+
+ <para>
+ These are common tasks when first beginning to use a &FED; system.
+ </para>
+
+
+ <section id="sn-fedora-desktop">
+ <title>Logging in to the &FED; Desktop</title>
+
+ <para>
+ To log in to the graphical interface, type your username at the
+ prompt and press Enter. Type your password at the next prompt and
+ press Enter once more. Your default graphical environment loads
+ on the screen.
+ </para>
+
+ <para>
+ To use another graphical environment, click <guilabel>Session</guilabel>
+ menu on the login screen and select the environment from the
+ drop-down list. Enter your username and password as normal.
+ </para>
+
+ </section>
+
+
+ <section id="sn-fedora-commandline">
<title>Accessing the Command-line</title>
<para>
- There are three methods for accessing the command-line on a &FED;
+ There are three standard methods for accessing the command-line on a &FED;
system:
</para>
<itemizedlist>
<listitem>
- <para>By running the <application>gnome-terminal</application>
- application. From the main menu, choose
- <menuchoice><guimenu>System
- Tools</guimenu><guimenuitem>Terminal</guimenuitem></menuchoice>.
-
- A
- terminal window will then appear on your desktop.</para>
+ <para>Run the <application>gnome-terminal</application>
+ application. From the <guimenu>Applications</guimenu> menu, choose
+ <menuchoice><guimenu>System Tools</guimenu><guimenuitem>Terminal</guimenuitem></menuchoice>.</para>
</listitem>
<listitem>
- <para>By logging in to your system over the network with
- SSH.</para>
+ <para>Log in to your system over the network with SSH.</para>
</listitem>
<listitem>
- <para>By changing virtual consoles.</para>
+ <para>Change virtual consoles.</para>
</listitem>
</itemizedlist>
@@ -88,88 +312,55 @@
</para>
- <sect2 id="s2-vconsoles">
+ <section id="sn-vconsoles">
<title>Virtual Consoles</title>
<para>
You can login to your system more than once by switching between
- the <firstterm>virtual consoles</firstterm>. By default there
- are four active virtual consoles that are command-line only.
- The graphical login screen is configured as virtual console
- seven.
+ the <firstterm>virtual consoles</firstterm>. There are four
+ active virtual consoles that are command-line only. The
+ graphical interface is configured as virtual console seven.
</para>
<para>
To switch to a different virtual console, press
<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap></keycombo>
- and the Function key that matches the number of that console.
+ and the Function key that matches the number of that console.
+ For example, press
+ <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F1</keycap></keycombo>
+ to switch to virtual console one, and press
+ <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F7</keycap></keycombo>
+ to return to the graphical interface.
</para>
- </sect2>
-
- </sect1>
-
+ </section>
- <sect1 id="s1-fedora-management">
- <title>Managing Your &FED; System</title>
+ </section>
- <para>
- <remark role="FIXME">INCOMPLETE - This is where we hook to other
- tutorials as they are available. Some of these sections will
- inevitably be altered or dropped for version 1.0, based on
- availability of the tutorials.</remark>
- </para>
-
-
- <sect2 id="s2-fedora-admintools">
- <title>Administration Tools</title>
-
- <para>
- <remark role="FIXME">INCOMPLETE - We've got graphical admin
- tools under System Settings, plus System Tools and
- Preferences. Explain the difference between a Setting, a
- Preference and a Tool.</remark>
- </para>
-
- </sect2>
-
- <sect2 id="s2-fedora-rootaccess">
+ <section id="sn-fedora-rootaccess">
<title>Using the Root Account</title>
-
+
<para>
<remark role="FIXME">INCOMPLETE - Explain the cryptic stuff in
- the Root Password section about using su here. Link to sudo
- tutorial with a Tip if it's available.</remark>
+ the Root Password section about using su here.</remark>
</para>
- </sect2>
-
+ </section>
- <sect2 id="s2-fedora-updating">
- <title>Updating Your System</title>
-
- <para>
- <remark role="FIXME">INCOMPLETE - paragraph to link to up2date
- tutorial.</remark>
- </para>
- </sect2>
+ <section id="sn-fedora-updating">
+ <title>Updating Your System</title>
+ <para>
+ <remark role="FIXME">INCOMPLETE - Link to update tutorial.</remark>
+ </para>
- <sect2 id="s2-fedora-newsoftware">
- <title>Installing New Software</title>
-
- <para>
- <remark role="FIXME">INCOMPLETE - paragraph to link to yum
- tutorial.</remark>
- </para>
-
- </sect2>
+ </section>
- <sect2 id="s2-fedora-adminmail">
- <title>Enabling E-mail Reports</title>
+ <section id="sn-fedora-adminmail">
+ <title>Enabling E-mail Reports</title>
<para>
<remark role="FIXME">INCOMPLETE - Edit the aliases to point root
@@ -177,39 +368,22 @@
this up by default.</remark>
</para>
- </sect2>
-
- </sect1>
+ </section>
+ </section>
- <sect1 id="s1-fedora-remoteaccess">
- <title>Remote Access to Your &FED; System</title>
- <para>
- <remark role="FIXME">INCOMPLETE - This is the real payoff for the
- sessions paragraph in the top section. Mention SSH and XDCMP,
- and name check VNC and desktop sharing. The Terminal Server
- Client app provides a universal client. We can't really explain
- these things here, but we can provide an overview and Caution
- the reader not to do something silly with unencrypted
- connections. SE has an OpenSSH tutorial that can be Docbooked
- and linked to.</remark>
- </para>
-
- </sect1>
-
-
- <sect1 id="s1-finding-help">
+ <section id="sn-finding-help">
<title>Finding Help</title>
<para>
Each graphical application has a <guilabel>Help</guilabel>
- facility. Other types of software also have help systems and
+ facility. Other types of software also have help systems and
documentation that you can access.
</para>
- <sect2 id="s2-desktop-help">
+ <section id="sn-desktop-help">
<title>Desktop Help</title>
<para>
@@ -218,9 +392,10 @@
the GNOME desktop environment.
</para>
- </sect2>
+ </section>
+
- <sect2 id="s2-commandline-help">
+ <section id="sn-commandline-help">
<title>Help for Command-line Applications</title>
<para>
@@ -235,25 +410,25 @@
You can also read the page for an application or file by using
the <command>man</command> command in a terminal window. For
example, to read the page for the file
- <filename>yum.conf</filename> you would type:
+ <filename>yum.conf</filename>, type:
</para>
- <para>
+ <screen>
<userinput>man yum.conf</userinput>
- </para>
+ </screen>
<para>
To see the various search options available with
<command>man</command>, type:
</para>
- <para>
+ <screen>
<userinput>man man</userinput>
- </para>
+ </screen>
<para>
The utilities supplied by the GNU project have complete manuals
- organised in a help system, as well as individual
+ organized in a help system, as well as individual
<command>man</command> pages.
</para>
@@ -264,94 +439,96 @@
like this:
</para>
- <para>
+ <screen>
<userinput>info chown</userinput>
- </para>
+ </screen>
+
+ </section>
- </sect2>
- <sect2 id="s2-perl-help">
+ <section id="sn-perl-help">
<title>Perl Documentation</title>
<para>
- You can also use <command>man</command> to read the
+ The <command>man</command> command also provides access to the
documentation for the Perl scripting language. Each tutorial,
- reference work and module has a page. This command displays the
- page for the <command>Net::Time</command> Perl module:
+ reference work and module has a page. As an example, this
+ command displays the page for the <command>Net::Time</command> Perl module:
</para>
- <para>
+ <screen>
<userinput>man Net::Time</userinput>
- </para>
+ </screen>
<para>
The <option>perltoc</option> page gives a complete list of the
documentation pages available for Perl:
</para>
- <para>
+ <screen>
<userinput>man perltoc</userinput>
- </para>
+ </screen>
<para>
Using <command>man</command> accesses the same documentation as
the <command>perldoc</command> utility supplied with Perl. You
may wish to use <command>perldoc</command> to carry out
- specialised searches in the Perl documentation. For example,
+ specialized searches in the Perl documentation. For example,
type this command to look up the Perl function
<option>chomp</option>:
</para>
- <para>
+ <screen>
<userinput>perldoc -f chomp</userinput>
- </para>
+ </screen>
- </sect2>
+ </section>
- <sect2 id="s2-packaged-help">
+ <section id="sn-packaged-help">
<title>Manufacturer Documentation</title>
<para>
The software packages provided by the &FP; include the
- documentation provided by the original developers of the
+ documentation supplied by the original developers of the
software. Where developers have provided a large quantity of
- extra documentation for their product, the &FP; supplies this
- documentation in a separate package to the software itself. The
- developers of the software use the file formats that they
- consider appropriate, and commonly provide a combination of
- HTML, PDF and plain-text files, as well as
- <command>man</command> pages.
+ extra documentation for their product, the &FP; delivers this
+ documentation in a separate package to the software itself.
</para>
<para>
- When you install an RPM package containing documentation, a
- directory with the same name as the package is created in
- <filename>/usr/share/doc/</filename> to hold the files. For
+ Installing a package that contains documentation creates a
+ directory with the same name as the package <filename>/usr/share/doc/</filename>. For
example, the name of the package for Samba 3.0.8 is
- <filename>samba-3.0.8-0.pre1.i386.rpm</filename>, and it will
- place the documentation from the Samba Team in the directory
- <filename>/usr/share/doc/samba-3.0.8/</filename> when installed.
+ <filename>samba-3.0.10-1.i386.rpm</filename>, and the
+ package places the documentation from the Samba Team in the directory
+ <filename>/usr/share/doc/samba-3.0.10/</filename> when installed.
</para>
<para>
- The Apache Web server is an exception, and uses the directory
- <filename>/var/www/manual/</filename> to store the main manual,
- which is written in HTML. This enables you to access the manual
- through the server itself by opening the virtual directory
- <filename>/manual/</filename>. For example, you could read the
- manual on the server
- <wordasword>myserver.mydomain.com</wordasword> by entering the
- URL
+ The developers of the software use the file formats that they
+ consider appropriate, and commonly provide a combination of
+ HTML, PDF and text files, as well as <command>man</command> pages.
+ </para>
+
+ <note>
+ <title>The Apache Manual</title>
+ <para>
+ The main manual for the Apache Web server is accessed through
+ the server at <wordasword>/manual/</wordasword>. For example,
+ enter the URL
<wordasword>http://myserver.mydomain.com/manual/</wordasword> in
- your Web browser.
+ your Web browser to read the manual on the server
+ <wordasword>myserver.mydomain.com</wordasword>. The files are
+ stored in the directory <filename>/var/www/manual/</filename>.
</para>
+ </note>
- </sect2>
+ </section>
- <sect2 id="s2-online-help">
- <title>Help on the Web</title>
+ <section id="sn-web-help">
+ <title>Documentation on the Web</title>
<para>
The official documentation for &FC; is available from the &FP;
@@ -364,8 +541,34 @@
</para>
<para>
- The &FED; community provides support through mailing lists and
- Web forums.
+ The Linux Documentation Project (LDP) produces books and tutorials:
+ </para>
+
+ <para>
+ <ulink
+ url="http://www.tldp.org/">http://www.tldp.org/</ulink>
+ </para>
+
+ <para>
+ Many other organizations and individuals also provide tutorials
+ and HOWTOs for &FED; on their Websites. You can locate
+ information on any topic by using Google:
+ </para>
+
+ <para>
+ <ulink
+ url="http://www.google.com/linux/">http://www.google.com/linux/</ulink>
+ </para>
+
+ </section>
+
+
+ <section id="sn-community-help">
+ <title>Community Support</title>
+
+ <para>
+ Members of the &FED; community provides support through mailing
+ lists, web forums and Linux User Groups (LUGs) across the world.
</para>
<para>
@@ -377,21 +580,32 @@
url="http://forums.fedoraforum.org/">http://forums.fedoraforum.org/</ulink>
</para>
+ </section>
+
+ </section>
+
+
+ <section id="sn-community">
+ <title>Joining The &FED; Community</title>
+
+ <para>
+ The &FP; is driven by the individuals that contribute to it. Community
+ members provide support to other users, help to improve the
+ software included in &FC; by testing, and develop new software
+ alongside the developers employed by &RH;. The results of this
+ work are available to all.
+ </para>
+
<para>
- Many other organisations and individuals also provide tutorials
- and HOWTOs for &FED; on their Websites. You can locate
- information on any topic by querying the Linux search facility
- provided by Google:
+ To make a difference, start here:
</para>
<para>
<ulink
- url="http://www.google.com/linux/">http://www.google.com/linux/</ulink>
+ url="http://fedora.redhat.com/participate/">http://fedora.redhat.com/participate/</ulink>
</para>
- </sect2>
-
- </sect1>
+ </section>
</chapter>
More information about the Fedora-docs-commits
mailing list