[deployment-guide: 105/185] Updated the preface.
Jaromir Hradilek
jhradile at fedoraproject.org
Sun May 15 21:19:57 UTC 2011
commit 1a599006b6358449f5a04a096252218c1ef68489
Author: Jaromir Hradilek <jhradile at redhat.com>
Date: Thu Mar 3 15:51:35 2011 +0100
Updated the preface.
en-US/Book_Info.xml | 2 +-
en-US/Preface.xml | 85 +++++++++++++++++++++++++--------------------------
2 files changed, 43 insertions(+), 44 deletions(-)
---
diff --git a/en-US/Book_Info.xml b/en-US/Book_Info.xml
index ae643b8..654b128 100644
--- a/en-US/Book_Info.xml
+++ b/en-US/Book_Info.xml
@@ -7,7 +7,7 @@
<productname>Red Hat Enterprise Linux</productname>
<productnumber>6</productnumber>
<edition>1</edition>
- <pubsnumber>96</pubsnumber>
+ <pubsnumber>98</pubsnumber>
<abstract>
<para>
The <citetitle pubwork="book">Deployment Guide</citetitle> documents relevant information regarding the deployment, configuration and administration of &MAJOROSVER;. It is oriented towards system administrators with a basic understanding of the system.
diff --git a/en-US/Preface.xml b/en-US/Preface.xml
index b1de8f7..9aaf79b 100644
--- a/en-US/Preface.xml
+++ b/en-US/Preface.xml
@@ -43,7 +43,7 @@
</para>
</section>
<section id="sect-Preface-Book_Organization">
- <title>Organization of the Book</title>
+ <title>How to Read this Book</title>
<para>
This manual is divided into the following main categories:
</para>
@@ -55,13 +55,13 @@
This part covers basic system administration tasks such as keyboard configuration, date and time configuration, and managing users and groups.
</para>
<para>
- <xref linkend="ch-Keyboard_Configuration" /> describes how to change the keyboard layout, add the <application>Keyboard Indicator</application> applet to the panel, and enforce a typing brake.
+ <xref linkend="ch-Keyboard_Configuration" /> covers basic keyboard setup. Read this chapter if you need to to change the keyboard layout, add the <application>Keyboard Indicator</application> applet to the panel, or enforce a periodic typing brake.
</para>
<para>
- <xref linkend="ch-Date_and_Time_Configuration" /> covers setting the system date and time, either manually, or by using the Network Time Protocol (NTP). It also describes how to select a time zone.
+ <xref linkend="ch-Date_and_Time_Configuration" /> covers the configuration of the system date and time. Read this chapter if you need to change the date and time setup, or configure the system to synchronize the clock with a remote Network Time Protocol (NTP) server.
</para>
<para>
- <xref linkend="ch-Managing_Users_and_Groups" /> covers the management of users and groups in a graphical user interface and on the command line. Additionally, it briefly explains the concepts of shadow passwords and password aging.
+ <xref linkend="ch-Managing_Users_and_Groups" /> covers the management of users and groups in a graphical user interface and on the command line. Read this chapter if you need to manage users and groups on your system, or enable password aging.
</para>
</listitem>
</varlistentry>
@@ -72,13 +72,13 @@
This part focuses on product subscriptions and entitlements, and describes how to manage software packages on &MAJOROS; using both <application>Yum</application> and the <application>PackageKit</application> suite of graphical package management tools.
</para>
<para>
- <xref linkend="entitlements" /> provides an overview of suvscription management in &MAJOROS; and the &OSORG; Subscription Manager tools which are available.
+ <xref linkend="entitlements" /> provides an overview of subscription management in &MAJOROS; and the &OSORG; Subscription Manager tools which are available. Read this chapter to learn how to register or unregister a system, activate a machine, and handle product subscripitons and entitlements.
</para>
<para>
- <xref linkend="ch-yum" /> descibes the <application>Yum</application> package manager for the command line. It provides important information on how to search, install, update, and uninstall packages with the <command>yum</command> utility, as well as how to extend it with available plug-ins.
+ <xref linkend="ch-yum" /> describes the <application>Yum</application> package manager. Read this chapter for information how to search, install, update, and uninstall packages on the command line.
</para>
<para>
- <xref linkend="ch-PackageKit" /> describes the <application>PackageKit</application> suite of graphical package management tools. It provides important information on how to search, install, update, and uninstall packages using a graphical user interface.
+ <xref linkend="ch-PackageKit" /> describes the <application>PackageKit</application> suite of graphical package management tools. Read this chapter for information how to search, install, update, and uninstall packages using a graphical user interface.
</para>
</listitem>
</varlistentry>
@@ -89,10 +89,10 @@
This part describes how to configure the network on &MAJOROS;.
</para>
<para>
- <xref linkend="ch-NetworkManager" /> focuses on <application>NetworkManager</application>, a dynamic network control and configuration system that attempts to keep network devices and connections up and active when they are available. It describes how to run the <systemitem class="service">NetworkManager</systemitem> daemon, and how to interact with it using the corresponding applet for the notification area.
+ <xref linkend="ch-NetworkManager" /> focuses on <application>NetworkManager</application>, a dynamic network control and configuration system that attempts to keep network devices and connections up and active when they are available. Read this chapter for information how to run the <systemitem class="service">NetworkManager</systemitem> daemon, and how to interact with it using the corresponding applet for the notification area.
</para>
<para>
- <xref linkend="ch-Network_Interfaces" /> explores various interface configuration files, interface control scripts, and network function files located in the <filename class="directory">/etc/sysconfig/network-scripts/</filename>, and explains how to use them.
+ <xref linkend="ch-Network_Interfaces" /> explores various interface configuration files, interface control scripts, and network function files located in the <filename class="directory">/etc/sysconfig/network-scripts/</filename> directory. Read this chapter for information how to use these files to configure network interfaces.
</para>
</listitem>
</varlistentry>
@@ -103,13 +103,13 @@
This part provides information how to configure services and daemons, configure authentication, and enable remote logins.
</para>
<para>
- <xref linkend="ch-Services_and_Daemons" /> explains the concept of runlevels, and describes how to set the default one. It also covers the configuration of the services to be run in each of these runlevels, and provides information on how to start, stop, and restart a service.
+ <xref linkend="ch-Services_and_Daemons" /> explains the concept of runlevels, and describes how to set the default one. It also covers the configuration of the services to be run in each of these runlevels, and provides information on how to start, stop, and restart a service. Read this chapter to learn how to manage services on your system.
</para>
<para>
- <xref linkend="ch-Configuring_Authentication" /> describes how to configure user information retrieval from Lightweight Directory Access Protocol (LDAP), Network Information Service (NIS), and Winbind user account databases, and provides an introduction to the System Security Services Daemon (SSSD).
+ <xref linkend="ch-Configuring_Authentication" /> describes how to configure user information retrieval from Lightweight Directory Access Protocol (LDAP), Network Information Service (NIS), and Winbind user account databases, and provides an introduction to the System Security Services Daemon (SSSD). Read this chapter if you need to configure authentication on your system.
</para>
<para>
- <xref linkend="ch-OpenSSH" /> describes how to enable a remote login via the SSH protocol. It covers the configuration of the <systemitem class="service">sshd</systemitem> service, as well as a basic usage of the <command>ssh</command>, <command>scp</command>, <command>sftp</command> client utilities.
+ <xref linkend="ch-OpenSSH" /> describes how to enable a remote login via the SSH protocol. It covers the configuration of the <systemitem class="service">sshd</systemitem> service, as well as a basic usage of the <command>ssh</command>, <command>scp</command>, <command>sftp</command> client utilities. Read this chapter if you need a remote access to a machine.
</para>
</listitem>
</varlistentry>
@@ -119,25 +119,24 @@
<para>
This part discusses various topics related to servers such as how to set up a Web server or share files and directories over the network.
</para>
- <para>
- <xref linkend="ch-DHCP_Servers" /> guides you through the installation of a Dynamic Host Configuration Protocol (DHCP) server and client.
- </para>
- <para>
- <xref linkend="ch-DNS_Servers" /> introduces you to Domain Name System (DNS), explains how to install, configure, run, and administer the <application>BIND</application> DNS server.
- </para>
- <para>
- <xref linkend="ch-Web_Servers" /> focuses on the <application>Apache HTTP Server 2.2</application>, a robust, full-featured open source web server developed by the Apache Software Foundation.
- </para>
- <para>
- <xref linkend="ch-Mail_Servers" /> reviews modern email protocols in use today, and some of the programs designed to send and receive email, including <application>Postfix</application>, <application>Sendmail</application>, <application>Fetchmail</application>, and <application>Procmail</application>.
-
- </para>
- <para>
- <xref linkend="ch-Directory_Servers" /> covers the installation and configuration of <application>OpenLDAP 2.4</application>, an open source implementation of the LDAPv2 and LDAPv3 protocols.
- </para>
- <para>
- <xref linkend="ch-File_and_Print_Servers" /> guides you through the installation and configuration of <application>Samba</application>, an open source implementation of the Server Message Block (SMB) protocol, and <application>vsftpd</application>, the primary FTP server shipped with &MAJOROS;. Additionally, it explains how to use the <application>Printer Configuration</application> tool to configure printers.
- </para>
+ <para>
+ <xref linkend="ch-DHCP_Servers" /> guides you through the installation of a Dynamic Host Configuration Protocol (DHCP) server and client. Read this chapter if you need to configure DHCP on your system.
+ </para>
+ <para>
+ <xref linkend="ch-DNS_Servers" /> introduces you to Domain Name System (DNS), explains how to install, configure, run, and administer the <application>BIND</application> DNS server. Read this chapter if you need to configure a DNS server on your system.
+ </para>
+ <para>
+ <xref linkend="ch-Web_Servers" /> focuses on the <application>Apache HTTP Server 2.2</application>, a robust, full-featured open source web server developed by the Apache Software Foundation. Read this chapter if you need to configure a web server on your system.
+ </para>
+ <para>
+ <xref linkend="ch-Mail_Servers" /> reviews modern email protocols in use today, and some of the programs designed to send and receive email, including <application>Postfix</application>, <application>Sendmail</application>, <application>Fetchmail</application>, and <application>Procmail</application>. Read this chapter if you need to configure a mail server on your system.
+ </para>
+ <para>
+ <xref linkend="ch-Directory_Servers" /> covers the installation and configuration of <application>OpenLDAP 2.4</application>, an open source implementation of the LDAPv2 and LDAPv3 protocols. Read this chapter if you need to configure a directory server on your system.
+ </para>
+ <para>
+ <xref linkend="ch-File_and_Print_Servers" /> guides you through the installation and configuration of <application>Samba</application>, an open source implementation of the Server Message Block (SMB) protocol, and <application>vsftpd</application>, the primary FTP server shipped with &MAJOROS;. Additionally, it explains how to use the <application>Printer Configuration</application> tool to configure printers. Read this chapter if you need to configure a file or print server on your system.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -147,19 +146,19 @@
This part describes various tools that allow system administrators to monitor system performance, automate system tasks, and report bugs.
</para>
<para>
- <xref linkend="ch-System_Monitoring_Tools" /> discusses applications and commands that can be used to retreive important information about the system.
+ <xref linkend="ch-System_Monitoring_Tools" /> discusses applications and commands that can be used to retrieve important information about the system. Read this chapter to learn how to gather essential system information.
</para>
<para>
- <xref linkend="ch-Viewing_and_Managing_Log_Files" /> describes the configuration of the <systemitem class="service">rsyslog</systemitem> daemon, and explains how to locate, view, and monitor log files.
+ <xref linkend="ch-Viewing_and_Managing_Log_Files" /> describes the configuration of the <systemitem class="service">rsyslog</systemitem> daemon, and explains how to locate, view, and monitor log files. Read this chapter to learn how to work with log files.
</para>
<para>
- <xref linkend="ch-Automating_System_Tasks" /> provides an overview of the <command>cron</command>, <command>at</command>, and <command>batch</command> utilities, and explains how to use tham to perform automated tasks.
+ <xref linkend="ch-Automating_System_Tasks" /> provides an overview of the <command>cron</command>, <command>at</command>, and <command>batch</command> utilities. Read this chapter to learn how to use these utilities to perform automated tasks.
</para>
<para>
- <xref linkend="ch-abrt" /> concentrates on <application>ABRT</application>, a system service and a set of tools to collect crash data and send a report to the relevant issue tracker.
+ <xref linkend="ch-abrt" /> concentrates on <application>ABRT</application>, a system service and a set of tools to collect crash data and send a report to the relevant issue tracker. Read this chapter to learn how to use <application>ABRT</application> on your system.
</para>
<para>
- <xref linkend="ch-OProfile" /> covers <application>OProfile</application>, a low overhead, system-wide performance monitoring tool.
+ <xref linkend="ch-OProfile" /> covers <application>OProfile</application>, a low overhead, system-wide performance monitoring tool. Read this chapter for information how to use <application>OProfile</application> on your system.
</para>
</listitem>
</varlistentry>
@@ -170,13 +169,13 @@
This part covers various tools that assist administrators with kernel customization.
</para>
<para>
- <xref linkend="ch-Manually_Upgrading_the_Kernel" /> provides important information for users who need to manually update a kernel package using the <command>rpm</command> command instead of <command>yum</command>.
+ <xref linkend="ch-Manually_Upgrading_the_Kernel" /> provides important information how to manually update a kernel package using the <command>rpm</command> command instead of <command>yum</command>. Read this chapter if you cannot update a kernel package with the <application>Yum</application> package manager.
</para>
<para>
- <xref linkend="ch-Working_with_Kernel_Modules" /> explains how to display, query, load, and unload kernel modules and their dependencies, and how to set module parameters. Additionally, it covers specific kernel module capabilities such as using multiple Ethernet cards and using channel bonding.
+ <xref linkend="ch-Working_with_Kernel_Modules" /> explains how to display, query, load, and unload kernel modules and their dependencies, and how to set module parameters. Additionally, it covers specific kernel module capabilities such as using multiple Ethernet cards and using channel bonding. Read this chapter if you need to work wiht kernel modules.
</para>
<para>
- <xref linkend="ch-kdump" /> explains how to configure, test, and use the <systemitem class="service">kdump</systemitem> service in &MAJOROS;, and provides a brief overview of how to analyze the resulting core dump using the <application>crash</application> debugging utility.
+ <xref linkend="ch-kdump" /> explains how to configure, test, and use the <systemitem class="service">kdump</systemitem> service in &MAJOROS;, and provides a brief overview of how to analyze the resulting core dump using the <application>crash</application> debugging utility. Read this chapter to learn how to enable <systemitem class="service">kdump</systemitem> on your system.
</para>
</listitem>
</varlistentry>
@@ -184,7 +183,7 @@
<term><xref linkend="ch-RPM" /></term>
<listitem>
<para>
- This appendix concentrates on the RPM Package Manager (RPM), an open packaging system used by &MAJOROS;, and the use of the <command>rpm</command> utility.
+ This appendix concentrates on the RPM Package Manager (RPM), an open packaging system used by &MAJOROS;, and the use of the <command>rpm</command> utility. Read this appendix if you need to use <command>rpm</command> instead of <command>yum</command>.
</para>
</listitem>
</varlistentry>
@@ -192,7 +191,7 @@
<term><xref linkend="ch-The_X_Window_System" /></term>
<listitem>
<para>
- This appendix covers the configuration of the X Window System, the graphical environment used by &MAJOROS;.
+ This appendix covers the configuration of the X Window System, the graphical environment used by &MAJOROS;. Read this appendix if you need to adjust the configuration of your X Window System.
</para>
</listitem>
</varlistentry>
@@ -200,7 +199,7 @@
<term><xref linkend="ch-The_sysconfig_Directory" /></term>
<listitem>
<para>
- This appendix outlines some of the files and directories located in the <filename class="directory">/etc/sysconfig/</filename> directory, their function, and their contents.
+ This appendix outlines some of the files and directories located in the <filename class="directory">/etc/sysconfig/</filename> directory. Read this appendix if you want to learn more about these files and directories, their function, and their contents.
</para>
</listitem>
</varlistentry>
@@ -208,7 +207,7 @@
<term><xref linkend="ch-proc" /></term>
<listitem>
<para>
- This appendix explains the concept of a virtual file system, and describes some of the top-level files and directories within the <systemitem class="filesystem">proc</systemitem> file system (that is, the <filename class="directory">/proc/</filename> directory).
+ This appendix explains the concept of a virtual file system, and describes some of the top-level files and directories within the <systemitem class="filesystem">proc</systemitem> file system (that is, the <filename class="directory">/proc/</filename> directory). Read this appendix if you want to learn more about this file system.
</para>
</listitem>
</varlistentry>
More information about the docs-commits
mailing list