desktop-up2date desktop-up2date-en.xml,1.4,1.5
Stuart Ellis (elliss)
fedora-docs-commits at redhat.com
Tue Jul 12 00:11:37 UTC 2005
Author: elliss
Update of /cvs/docs/desktop-up2date
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17286
Modified Files:
desktop-up2date-en.xml
Log Message:
Minor edits.
Index: desktop-up2date-en.xml
===================================================================
RCS file: /cvs/docs/desktop-up2date/desktop-up2date-en.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- desktop-up2date-en.xml 14 Jun 2005 22:30:42 -0000 1.4
+++ desktop-up2date-en.xml 12 Jul 2005 00:11:33 -0000 1.5
@@ -4,13 +4,13 @@
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../docs-common/common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;
-<!ENTITY BOOKID "desktop-up2date-0.3 (2005-06-05)"> <!-- change version of manual and date here -->
+<!ENTITY BOOKID "desktop-up2date-0.4 (2005-07-10)"> <!-- change version of manual and date here -->
<!ENTITY LEGALNOTICE SYSTEM "../docs-common/common/legalnotice-en.xml">
<!-- Bugzilla bug number for the draft notice -->
<!ENTITY BUG-NUM "155180">
-<!ENTITY FCLOCALVER "3">
+<!ENTITY FCLOCALVER "4">
<!ENTITY DRAFTNOTICE SYSTEM "../docs-common/common/draftnotice-en.xml">
]>
@@ -24,20 +24,30 @@
</copyright>
<authorgroup>
<author>
- <surname>Ellis</surname>
- <firstname>Stuart</firstname>
+ <surname>Ellis</surname>
+ <firstname>Stuart</firstname>
</author>
</authorgroup>
<revhistory>
<revision>
- <revnumber>0.3</revnumber>
- <date>2005-06-05</date>
- <authorinitials>StuartEllis</authorinitials>
- <revdescription>
- <para>
+ <revnumber>0.3</revnumber>
+ <date>2005-06-05</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
Initial CVS commit.
</para>
- </revdescription>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>0.4</revnumber>
+ <date>2005-07-10</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Minor revisions.
+ </para>
+ </revdescription>
</revision>
</revhistory>
&LEGALNOTICE;
@@ -47,385 +57,468 @@
<section id="sn-desktop-up2date-audience">
<title>Audience</title>
+
<para>
- This tutorial is intended for new users. It explains how to use the
- supplied graphical tools to keep a &FED; desktop system updated.
- Experienced users may still find this software useful, but are likely to use <command>yum</command> to both update their systems and install new software.
+ This tutorial is intended for new users. It explains how to use
+ the supplied graphical tools to keep a &FED; desktop system
+ updated. Experienced users may still find this software useful,
+ but are likely to use <command>yum</command> to both update their
+ systems and install new software.
</para>
- </section>
+ </section>
-
- <section id="sn-desktop-up2date-intro">
+ <section id="sn-desktop-up2date-intro">
<title>Introduction</title>
- <para>
- &FC; provides a pair of utilities that work together to enable desktop
- users to update their systems. The <application>Alert
- Icon</application> on your desktop keeps you informed about package updates. Until
- your system is updated this appears as a red circle with a flashing
- exclamation mark. The <application>Alert Icon</application> is integrated with
- <application>up2date</application>, which enables you to easily install
- updates for your system.
- </para>
- <para>
- In addition to these tools, &FC; also includes <command>yum</command>, a
- command-line utility that is the current recommmended option for software
- administration. The <command>yum</command> utility enables you to
- automatically locate, install and update any software with the latest version.
- </para>
- <note>
- <title>Command-Line Version of <application>up2date</application></title>
- <para>
- This tutorial does not document the command-line version of
- <command>up2date</command>, which provides some of the features of <command>yum</command>.
- </para>
- </note>
-
-
- <section id="sn-about-packages">
- <title>About Packages</title>
- <indexterm>
- <primary>packages, defined</primary>
- </indexterm>
- <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, icons, 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. For
- example, the &FED; installation process uses the packages
- supplied with &FC; to build or upgrade a system to your requirements.
+
+ <para>
+ &FC; provides a pair of utilities that work together to enable
+ desktop users to update their systems. The <application>Alert
+ Icon</application> on your desktop keeps you informed about
+ package updates. Until your system is updated this appears as a
+ red circle with a flashing exclamation mark. The
+ <application>Alert Icon</application> is integrated with
+ <application>up2date</application>, which enables you to easily
+ install updates for your system.
+ </para>
+
+ <para>
+ In addition to these tools, &FC; also includes
+ <command>yum</command>, a command-line utility that is the current
+ recommended option for software administration. The
+ <command>yum</command> utility enables you to automatically
+ locate, install and update any software with the latest version.
</para>
+
+ <note>
+ <title>Command-Line Version of <application>up2date</application></title>
+
+ <para>
+ This tutorial does not document the command-line version of
+ <command>up2date</command>, which provides some of the features
+ of <command>yum</command>.
+ </para>
+ </note>
+
+ <section id="sn-about-packages">
+ <title>About Packages</title>
+ <indexterm>
+ <primary>packages, defined</primary>
+ </indexterm>
+ <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, icons,
+ 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. For example, the &FED; installation process
+ uses the packages supplied with &FC; to build or upgrade a
+ system to your requirements.
+ </para>
+
<important>
- <title>Verifying Packages</title>
+ <title>Verifying Packages</title>
+
<para>
- The <application>up2date</application> application automatically
- downloads the &FP; public keys used to verify the digital
- signatures of updated packages.
- </para>
+ The <application>up2date</application> application
+ automatically downloads the &FP; public keys used to verify
+ the digital signatures of updated packages.
+ </para>
</important>
- </section>
-
+ </section>
- <section id="sn-about-channels">
- <title>About Channels</title>
- <indexterm>
- <primary>channels, defined</primary>
- </indexterm>
- <para>
- The <application>up2date</application> application uses
- <firstterm>repositories</firstterm>, specially prepared Web and FTP sites
- that hold software packages. Whatever their type, they are all described
- as <firstterm>channels</firstterm> within <application>up2date</application>.
- </para>
- <para>
- These repositories are also used by software management systems like
- <command>yum</command> to install and update software. If you configure
- <command>yum</command> to use additional repositories then you should add
- these to <command>up2date</command> as well.
- </para>
- </section>
- </section>
+ <section id="sn-about-channels">
+ <title>About Channels</title>
+ <indexterm>
+ <primary>channels, defined</primary>
+ </indexterm>
+ <para>
+ The <application>up2date</application> application uses
+ <firstterm>repositories</firstterm>, specially prepared Web and
+ FTP sites that hold software packages. Whatever their type, they
+ are all described as <firstterm>channels</firstterm> within
+ <application>up2date</application>.
+ </para>
+ <para>
+ These repositories are also used by software management systems
+ like <command>yum</command> to install and update software. If
+ you configure <command>yum</command> to use additional
+ repositories then you should add these to
+ <command>up2date</command> as well.
+ </para>
+ </section>
+ </section>
- <section id="sn-applet-managing">
+ <section id="sn-applet-managing">
<title>Enabling and Disabling the <application>Alert Icon</application></title>
<indexterm>
- <primary><application>Alert Icon</application>, enabling</primary>
+ <primary><application>Alert Icon</application>, enabling</primary>
</indexterm>
<para>
- To enable the <application>Alert Icon</application>, either double-click it, or right-click it and
- select <guilabel>Configuration</guilabel>. Click
- <guibutton>Forward</guibutton> to move to the <guilabel>Terms of
- Service</guilabel>. Click <guibutton>Forward</guibutton> once more to agree to the terms and move
- on to the <guilabel>Proxy Configuration</guilabel>.
+ To enable the <application>Alert Icon</application>, either
+ double-click it, or right-click it and select
+ <guilabel>Configuration</guilabel>. Click
+ <guibutton>Forward</guibutton>
+ to move to the <guilabel>Terms of Service</guilabel>. Click
+ <guibutton>Forward</guibutton>
+ once more to agree to the terms and move on to the <guilabel>Proxy
+ Configuration</guilabel>.
</para>
<indexterm>
- <primary>proxy server, with the <application>Alert Icon</application></primary>
+ <primary>proxy server, with the <application>Alert Icon</application>
+ </primary>
</indexterm>
<para>
- To use a Web proxy server, enter the settings in the <guilabel>Proxy Configuration</guilabel>. Select the check-box next to <guilabel>Enable HTTP
- Proxy</guilabel> and enter the name of your proxy server. If your
- proxy server requires a username and password to access the Internet select the check-box next to <guilabel>Use
- Authentication</guilabel> and enter the relevant
- <guilabel>Username</guilabel> and <guilabel>Password</guilabel>.
- </para>
- <para>
- Click <guibutton>Forward</guibutton> a third time to complete the
- configuration. Select <guibutton>Apply</guibutton> to confirm the settings
- and immediately start an update.
+ To use a Web proxy server, enter the settings in the
+ <guilabel>Proxy Configuration</guilabel>. Select the check-box
+ next to <guilabel>Enable HTTP Proxy</guilabel> and enter the name
+ of your proxy server. If your proxy server requires a username and
+ password to access the Internet select the check-box next to
+ <guilabel>Use Authentication</guilabel> and enter the relevant
+ <guilabel>Username</guilabel> and <guilabel>Password</guilabel>.
</para>
- <section id="sn-applet-disabling">
- <title>Disabling the Update <application>Alert Icon</application></title>
+
+ <para>
+ Click
+ <guibutton>Forward</guibutton>
+ a third time to complete the configuration. Select
+ <guibutton>Apply</guibutton>
+ to confirm the settings and immediately start an update.
+ </para>
+
+ <section id="sn-applet-disabling">
+ <title>Disabling the Update <application>Alert Icon</application></title>
+ <indexterm>
+ <primary><application>Alert Icon</application>, disabling</primary>
+ </indexterm>
+ <para>
+ To disable the <application>Alert Icon</application>, follow
+ these steps:
+ <orderedlist>
+ <listitem>
+ <para>
+ Right-click it and select
+ <guilabel>Configuration</guilabel>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click
+ <guibutton>Forward</guibutton>
+ to move to the next screen.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click
+ <guibutton>Remove From Panel</guibutton>
+ .
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <tip>
+ <title>Re-enabling The <application>Alert Icon</application></title>
+ <para>
+ You can re-enable the <application>Alert Icon</application> by
+ selecting <menuchoice><guimenu>System
+ Tools</guimenu><guimenuitem>Red Hat Network Alert
+ Icon</guimenuitem></menuchoice> from the main menu.
+ </para>
+ </tip>
+ </section>
+ </section>
+
+ <section id="sn-applet-using">
+ <title>Using the <application>Alert Icon</application></title>
<indexterm>
- <primary><application>Alert Icon</application>, disabling</primary>
+ <primary><application>Alert Icon</application>, using</primary>
</indexterm>
- <para>
- To disable the <application>Alert Icon</application>, follow these steps:
- <orderedlist>
+ <para>
+ Once the <application>Alert Icon</application> is configured the
+ <command>rhnsd</command> service on your system periodically
+ checks for updates, and changes the icon to reflect the status of
+ your system. The default period is every two hours. You may check
+ for updates at any time by either double-clicking the icon, or by
+ right-clicking it and selecting <guilabel>Check for
+ updates</guilabel>.
+ </para>
+
+ <para>
+ The icon displays the status of your system by showing one of six
+ states:
+ <itemizedlist>
<listitem>
- <para>Right-click it and select <guilabel>Configuration</guilabel>.
- </para>
+ <para>
+ Grey with a check mark: the first check is in progress.
+ </para>
</listitem>
<listitem>
- <para>Click <guibutton>Forward</guibutton> to move to the next screen.
- </para>
+ <para>
+ Blue with a check mark: your system is up to date.
+ </para>
</listitem>
<listitem>
- <para>Click <guibutton>Remove From Panel</guibutton>.
- </para>
- </listitem>
- </orderedlist>
- </para>
-
- <tip>
- <title>Re-enabling The <application>Alert Icon</application></title>
- <para>
- You can re-enable the <application>Alert Icon</application> by selecting
- <menuchoice><guimenu>System Tools</guimenu><guimenuitem>Red Hat
- Network Alert Icon</guimenuitem></menuchoice> from the main menu.
+ <para>
+ Green with double arrows: currently checking for updates.
</para>
- </tip>
-
- </section>
-
- </section>
-
-
- <section id="sn-applet-using">
- <title>Using the <application>Alert Icon</application></title>
- <indexterm>
- <primary><application>Alert Icon</application>, using</primary>
- </indexterm>
- <para>
- Once the <application>Alert Icon</application> is configured the <command>rhnsd</command> service
- on your system periodically checks for updates, and changes the icon to
- reflect the status of your system. The default period is every two
- hours. You may check for updates at any time by either double-clicking
- the icon, or by right-clicking it and selecting <guilabel>Check for
- updates</guilabel>.
- </para>
- <para>
- The icon displays the status of your system by showing one of four states:
- <itemizedlist>
- <listitem>
- <para>Grey with a check mark: the first check is in progress.
- </para>
- </listitem>
- <listitem>
- <para>Blue with a check mark: your system is up to date.
+ </listitem>
+ <listitem>
+ <para>
+ Red with a flashing exclamation mark: there are newer
+ packages available for the software installed on your
+ system.
</para>
- </listitem>
- <listitem>
- <para>Green with double arrows: currently checking for updates.
+ </listitem>
+ <listitem>
+ <para>
+ Grey with a question mark:
+ <application>up2date</application> is not able to obtain
+ update information from the server.
</para>
- </listitem>
- <listitem>
- <para>Red with a flashing exclamation mark: there are newer
- packages available for the software installed on your system.
+ </listitem>
+ <listitem>
+ <para>
+ Grey with double arrows, struck-through with a red line: No
+ network connection to the server.
</para>
- </listitem>
- </itemizedlist>
- </para>
+ </listitem>
+ </itemizedlist>
+ </para>
- <para>
- Rest your mouse pointer over the icon to show the number of outstanding updates for your system.
- </para>
+ <para>
+ Rest your mouse pointer over the icon to show the number of
+ outstanding updates for your system.
+ </para>
- <note>
+ <note>
<title>Only &FED; Updates are Shown</title>
- <para>The <application>Alert Icon</application> can only inform you of updates for the packages
- provided by the &FP;. To update all of the packages on your system, use
- <command>yum</command>.
- </para>
- </note>
-
- </section>
+ <para>
+ The <application>Alert Icon</application> can only inform you of
+ updates for the packages provided by the &FP;. To update all of
+ the packages on your system, use <command>yum</command>.
+ </para>
+ </note>
+ </section>
- <section id="sn-up2date-configuring">
- <title>Configuring <application>up2date</application></title>
- <indexterm>
+ <section id="sn-up2date-configuring">
+ <title>Configuring <application>up2date</application></title>
+ <indexterm>
<primary>up2date, configuring</primary>
- </indexterm>
- <para>
- If you select <guilabel>Check for updates</guilabel> you are shown a list of
- available updates, and can <guibutton>Launch Up2date</guibutton> by
- clicking the button. Alternatively, you can right-click the <application>Alert Icon</application>
- and select <guilabel>Launch Up2date</guilabel>. You are prompted for
- the root password before the application continues.
- </para>
- <indexterm>
+ </indexterm>
+ <para>
+ If you select <guilabel>Check for updates</guilabel> you are shown
+ a list of available updates, and can
+ <guibutton>Launch Up2date</guibutton>
+ by clicking the button. Alternatively, you can right-click the
+ <application>Alert Icon</application> and select <guilabel>Launch
+ Up2date</guilabel>. You are prompted for the
+ <systemitem class="username">root</systemitem> password before the
+ application continues.
+ </para>
+ <indexterm>
<primary>proxy server, with up2date</primary>
- </indexterm>
- <para>
- The configuration screen is displayed the first time that you run
- <application>up2date</application>. This has the same proxy server
- options as the <application>Alert Icon</application>. If you use a proxy server you should enter
- the same settings again.
- </para>
- <para>
- By default <application>up2date</application> has two safety restrictions that
- you may wish to remove. The first is that it will not update any
- package where the configuration files have been modified. To remove
- this safety restriction, click on the
- <guilabel>Retrieval/Installation</guilabel> tab and clear the check-box
- for <guilabel>Do not upgrade packages where the local configuration file
- has been modified</guilabel>. The other safety measure is that it will
- not automatically update the kernel on your system. Click on the
- <guilabel>Package exceptions</guilabel> tab, select
- <guilabel>kernel*</guilabel> and then click
- <guibutton>Remove</guibutton> to enable kernel updates.
- </para>
- <para>
- Click <guibutton>OK</guibutton> when you have finished configuring
- <application>up2date</application>.
+ </indexterm>
+ <para>
+ The configuration screen is displayed the first time that you run
+ <application>up2date</application>. This has the same proxy server
+ options as the <application>Alert Icon</application>. If you use a
+ proxy server you should enter the same settings again.
+ </para>
+
+ <para>
+ By default <application>up2date</application> has two safety
+ restrictions that you may wish to remove. The first is that it
+ will not update any package where the configuration files have
+ been modified. To remove this safety restriction, click on the
+ <guilabel>Retrieval/Installation</guilabel> tab and clear the
+ check-box for <guilabel>Do not upgrade packages where the local
+ configuration file has been modified</guilabel>. The other safety
+ measure is that it will not automatically update the kernel on
+ your system. Click on the <guilabel>Package exceptions</guilabel>
+ tab, select <guilabel>kernel*</guilabel> and then click
+ <guibutton>Remove</guibutton>
+ to enable kernel updates.
</para>
+
<para>
- If this is the first time that you have run
- <application>up2date</application> the &FED; public key is downloaded. Click <guibutton>Yes</guibutton>.
+ Click
+ <guibutton>OK</guibutton>
+ when you have finished configuring
+ <application>up2date</application>.
</para>
- </section>
+ <para>
+ If this is the first time that you have run
+ <application>up2date</application> the &FED; public key is
+ downloaded. Click
+ <guibutton>Yes</guibutton>
+ .
+ </para>
+ </section>
- <section id="sn-up2date-usage">
+ <section id="sn-up2date-usage">
<title>Updating Your System with <application>up2date</application></title>
<indexterm>
- <primary>up2date, using</primary>
+ <primary>up2date, using</primary>
</indexterm>
<para>
- However you launched <application>up2date</application>, you begin
- with the <guilabel>Welcome to Red Hat Update Agent</guilabel> screen. Click
- <guibutton>Forward</guibutton> to move to the
- <guilabel>Channels</guilabel> screen. You may choose not to check a
- channel for updates by clearing the check-box next to the channel name.
+ However you launched <application>up2date</application>, you begin
+ with the <guilabel>Welcome to Red Hat Update Agent</guilabel>
+ screen. Click
+ <guibutton>Forward</guibutton>
+ to move to the <guilabel>Channels</guilabel> screen. You may
+ choose not to check a channel for updates by clearing the
+ check-box next to the channel name.
</para>
+
<para>
- Click <guibutton>Forward</guibutton> to continue, or
- <guibutton>Cancel</guibutton> to abort. If you continue all of the chosen
- channels are checked for updates to the packages installed on your
- system, and a list of packages is displayed.
+ Click
+ <guibutton>Forward</guibutton>
+ to continue, or
+ <guibutton>Cancel</guibutton>
+ to abort. If you continue all of the chosen channels are checked
+ for updates to the packages installed on your system, and a list
+ of packages is displayed.
</para>
+
<para>
- Click the check-box next to the name of the package to select it for
- updating. To select all of the packages on the list, click <guilabel>Select all packages</guilabel>.
+ Click the check-box next to the name of the package to select it
+ for updating. To select all of the packages on the list, click
+ <guilabel>Select all packages</guilabel>.
</para>
+
<para>
- Click <guibutton>Forward</guibutton> to begin the update process. This
- may take some time as the new packages are downloaded. The <guilabel>Retrieving
- Packages</guilabel> screen displays the progress of the downloads.
+ Click
+ <guibutton>Forward</guibutton>
+ to begin the update process. This may take some time as the new
+ packages are downloaded. The <guilabel>Retrieving
+ Packages</guilabel> screen displays the progress of the downloads.
</para>
+
<para>
- Once the downloads have completed, click <guibutton>Forward</guibutton>. Your
- updates are then installed in the correct sequence, replacing older
- versions of the same packages.
+ Once the downloads have completed, click
+ <guibutton>Forward</guibutton>
+ . Your updates are then installed in the correct sequence,
+ replacing older versions of the same packages.
</para>
+
<para>
- Click <guibutton>Forward</guibutton> to move on to the <guilabel>Finish
- Page</guilabel>. This lists all of the updates that have been installed.
+ Click
+ <guibutton>Forward</guibutton>
+ to move on to the <guilabel>Finish Page</guilabel>. This lists all
+ of the updates that have been installed.
</para>
- </section>
-
+ </section>
- <section id="sn-up2date-managing-channels">
+ <section id="sn-up2date-managing-channels">
<title>Managing <application>up2date</application> Channels</title>
+
<para>
- You may add or remove channels from <application>up2date</application> by editing
- <filename>/etc/sysconfig/rhn/sources</filename>. Each channel is
- defined by a line in this file. The &FP; repositories are already
- listed, with standard repositories enabled, and the package repositories
- for test versions of packages disabled.
- </para>
- <tip>
+ You may add or remove channels from
+ <application>up2date</application> by editing
+ <filename>/etc/sysconfig/rhn/sources</filename>. Each channel is
+ defined by a line in this file. The &FP; repositories are already
+ listed, with standard repositories enabled, and the package
+ repositories for test versions of packages disabled.
+ </para>
+ <tip>
<title>Software Repository Types</title>
- <para>
- Any software repository that supports <command>apt</command> or
- <command>yum</command> can be used as an
- <application>up2date</application> channel.
- </para>
- </tip>
-
-
+ <para>
+ Any software repository that supports <command>apt</command> or
+ <command>yum</command> can be used as an
+ <application>up2date</application> channel.
+ </para>
+ </tip>
<section id="sn-up2date-toggling-channels">
- <title>Enabling and Disabling Channels</title>
- <indexterm>
- <primary>channels, enabling</primary>
- </indexterm>
- <indexterm>
- <primary>channels, disabling</primary>
- </indexterm>
- <para>
- Channels are disabled by placing a comment marker at the beginning of
- the line. To re-enable a channel, remove the # character at the
- beginning of the line.
- </para>
+ <title>Enabling and Disabling Channels</title>
+ <indexterm>
+ <primary>channels, enabling</primary>
+ </indexterm>
+ <indexterm>
+ <primary>channels, disabling</primary>
+ </indexterm>
+ <para>
+ Channels are disabled by placing a comment marker at the
+ beginning of the line. To re-enable a channel, remove the #
+ character at the beginning of the line.
+ </para>
</section>
-
<section id="sn-up2date-changing-channels">
- <title>Adding and Removing Channels</title>
- <indexterm>
- <primary>channels, adding</primary>
- </indexterm>
- <indexterm>
- <primary>channels, removing</primary>
- </indexterm>
- <para>
- To add a new channel, add a new line to <filename>/etc/sysconfig/rhn/sources</filename>.
- </para>
- <para>
- You must specify three settings for each channel. The <command>type</command>
- should be <command>yum</command> unless the provider is using an
- alternate system. The <command>channel-label</command> is the name
- that the channel will be known by. The <command>url</command> is the
- full URL to the directory holding the RPM packages.
- </para>
- <para>
- This is an example channel listing, for a repository hosted on the
- server <wordasword>fedora.multikabel.nl</wordasword>:
- </para>
- <example id="up2date-channel-format">
- <title>Format of <application>up2date</application> Channels</title>
- <programlisting>
+ <title>Adding and Removing Channels</title>
+ <indexterm>
+ <primary>channels, adding</primary>
+ </indexterm>
+ <indexterm>
+ <primary>channels, removing</primary>
+ </indexterm>
+ <para>
+ To add a new channel, add a new line to
+ <filename>/etc/sysconfig/rhn/sources</filename>.
+ </para>
+
+ <para>
+ You must specify three settings for each channel. The
+ <command>type</command> should be <command>yum</command> unless
+ the provider is using an alternate system. The
+ <command>channel-label</command> is the name that the channel
+ will be known by. The <command>url</command> is the full URL to
+ the directory holding the RPM packages.
+ </para>
+
+ <para>
+ This is an example channel listing, for a repository hosted on
+ the server <wordasword>fedora.multikabel.nl</wordasword>:
+ </para>
+
+ <example id="up2date-channel-format">
+ <title>Format of <application>up2date</application> Channels</title>
+<programlisting>
<![CDATA[
- yum fedora-us-stable-2 http://fedora.multikabel.nl/fedora/fedora/3/$ARCH/RPMS.stable
+ yum fedora-us-stable-2 http://fedora.multikabel.nl/fedora/fedora/4/$ARCH/RPMS.stable
]]>
</programlisting>
- </example>
- <para>
- The &FC; channels use <command>yum-mirror</command>, rather than
- <command>yum</command>. This means that
- <application>up2date</application> automatically fetches a list of
- servers from the file specified by the <command>url</command>, and
- then randomly select a download server from the list. Another server
- is automatically chosen if the selected server fail to respond.
- </para>
- <tip>
- <title>Repositories for <command>apt</command></title>
- <para>Some third-party package providers use <command>apt</command>, rather than
- <command>yum</command>. Many support both types to ensure
- compatibility. If the provider requires <command>apt</command>,
- then substitute <command>apt</command> for <command>yum</command> in
- your channel definition.
- </para>
- </tip>
- <para>
- To remove a channel, delete the relevant line from <filename>/etc/sysconfig/rhn/sources</filename>.
- </para>
+ </example>
+
+ <para>
+ The &FC; channels use <command>yum-mirror</command>, rather than
+ <command>yum</command>. This means that
+ <application>up2date</application> automatically fetches a list
+ of servers from the file specified by the
+ <command>url</command>, and then randomly select a download
+ server from the list. Another server is automatically chosen if
+ the selected server fail to respond.
+ </para>
+ <tip>
+ <title>Repositories for <command>apt</command></title>
+ <para>
+ Some third-party package providers use <command>apt</command>,
+ rather than <command>yum</command>. Many support both types to
+ ensure compatibility. If the provider requires
+ <command>apt</command>, then substitute <command>apt</command>
+ for <command>yum</command> in your channel definition.
+ </para>
+ </tip>
+ <para>
+ To remove a channel, delete the relevant line from
+ <filename>/etc/sysconfig/rhn/sources</filename>.
+ </para>
+
<important>
- <title>Managing Public Keys</title>
+ <title>Managing Public Keys</title>
+
<para>
- Remember to add or remove the public key for the package provider
- from your software management system when adding or removing channels
- for third-party packages.
- </para>
+ Remember to add or remove the public key for the package
+ provider from your software management system when adding or
+ removing channels for third-party packages.
+ </para>
</important>
-
</section>
+ </section>
- </section>
-
-
-<index id="generated-index"></index>
+ <index id="generated-index"></index>
</article>
More information about the Fedora-docs-commits
mailing list