yum-software-management yum-software-management-en.xml,1.48,1.49
Stuart Ellis (elliss)
fedora-docs-commits at redhat.com
Tue Nov 15 00:13:11 UTC 2005
- Previous message (by thread): rpm-guide rpm-guide-advanced-packaging-en.xml, 1.4, 1.5 rpm-guide-creating-rpms-en.xml, 1.4, 1.5 rpm-guide-intro-packaging-en.xml, 1.4, 1.5 rpm-guide-other-os-en.xml, 1.4, 1.5 rpm-guide-package-structure-en.xml, 1.2, 1.3 rpm-guide-programming-c-en.xml, 1.4, 1.5 rpm-guide-rpmbuild-en.xml, 1.4, 1.5 rpm-guide-specfile-syntax-en.xml, 1.3, 1.4 rpm-guide-specfiles-en.xml, 1.4, 1.5 rpm-guide-transactions-en.xml, 1.4, 1.5 rpm-guide-using-rpm-en.xml, 1.4, 1.5
- Next message (by thread): mirror-tutorial mirror-tutorial-en.xml,1.17,1.18
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
Author: elliss
Update of /cvs/docs/yum-software-management
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17177
Modified Files:
yum-software-management-en.xml
Log Message:
- Fixed bug 166122
- Revised information on Fedora repositories to mention development repositories
- Renamed "Manual Installation" section for clarity
- Updated section on proxy servers
Index: yum-software-management-en.xml
===================================================================
RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -r1.48 -r1.49
--- yum-software-management-en.xml 13 Oct 2005 11:34:47 -0000 1.48
+++ yum-software-management-en.xml 15 Nov 2005 00:13:03 -0000 1.49
@@ -4,7 +4,7 @@
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../docs-common/common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;
-<!ENTITY BOOKID "yum-software-management-1.0.3 (2005-10-13)"> <!-- change version of manual and date here -->
+<!ENTITY BOOKID "yum-software-management-1.0.4 (2005-11-15)"> <!-- change version of manual and date here -->
<!-- Bugzilla bug number for the draft notice -->
<!ENTITY BUG-NUM "155190">
@@ -68,35 +68,45 @@
</revdescription>
</revision>
<revision>
- <revnumber>1.0.1</revnumber>
- <date>2005-08-18</date>
- <authorinitials>StuartEllis</authorinitials>
- <revdescription>
- <para>
- Added information on installing without repository and
- manually adding keys.
- </para>
- </revdescription>
+ <revnumber>1.0.1</revnumber>
+ <date>2005-08-18</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Added information on installing without repository and
+ manually adding keys.
+ </para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>1.0.2</revnumber>
+ <date>2005-08-26</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Fix localinstall information.
+ </para>
+ </revdescription>
</revision>
<revision>
- <revnumber>1.0.2</revnumber>
- <date>2005-08-26</date>
- <authorinitials>StuartEllis</authorinitials>
- <revdescription>
- <para>
- Fix localinstall information.
- </para>
- </revdescription>
+ <revnumber>1.0.3</revnumber>
+ <date>2005-10-13</date>
+ <authorinitials>PaulWFrields</authorinitials>
+ <revdescription>
+ <para>
+ Fix wording (#170584).
+ </para>
+ </revdescription>
</revision>
<revision>
- <revnumber>1.0.3</revnumber>
- <date>2005-10-13</date>
- <authorinitials>PaulWFrields</authorinitials>
- <revdescription>
- <para>
- Fix wording (#170584).
- </para>
- </revdescription>
+ <revnumber>1.0.4</revnumber>
+ <date>2005-11-15</date>
+ <authorinitials>StuartEllis</authorinitials>
+ <revdescription>
+ <para>
+ Updated section on proxy servers. Fixed #166122.
+ </para>
+ </revdescription>
</revision>
</revhistory>
</articleinfo>
@@ -184,12 +194,11 @@
<section id="sn-yum-additional-resources">
<title>Additional Resources</title>
<indexterm>
- <primary>yum</primary>
- <secondary>documentation</secondary>
- </indexterm>
- <indexterm>
- <primary>yum</primary>
- <secondary>man pages</secondary>
+ <primary>yum</primary>
+ <secondary>documentation</secondary>
+ </indexterm> <indexterm>
+ <primary>yum</primary>
+ <secondary>man pages</secondary>
</indexterm>
<para>
The <command>yum</command> utility has features and options not
@@ -203,19 +212,12 @@
man yum.conf</userinput>
</screen>
<indexterm>
- <primary>yum</primary>
- <secondary>web sites</secondary>
- </indexterm>
- <indexterm>
- <primary>yum</primary>
- <secondary>mailing lists</secondary>
+ <primary>yum</primary>
+ <secondary>web sites</secondary>
+ </indexterm> <indexterm>
+ <primary>yum</primary>
+ <secondary>mailing lists</secondary>
</indexterm>
-<!-- Hopefully this is not too confusing below. This is sort of a -->
-<!-- grammar/usage issue. If you use a variablelist, you don't want to -->
-<!-- use sentences, but rather headings, in the term area. Alternately, -->
-<!-- if you like sentences, just use a para instead for the whole -->
-<!-- collection of links. [PWF] -->
-<!-- SE: Multiple links in a paragraph is pretty ugly. Not that I like this layout either :) -->
<para>
Other useful <command>yum</command> resources on the Internet
include:
@@ -255,6 +257,17 @@
</listitem>
</varlistentry>
</variablelist>
+ <tip>
+ <title>Check &BZ; First</title>
+ <para>
+ If you encounter a persistent error with a specific operation,
+ visit &BZ-URL; and review the bug reports for the package or
+ packages involved. An error in a package may cause all
+ <command>yum</command> operations that rely on that package to
+ fail. Please file bug reports for &FED; packages, including
+ <command>yum</command>, on this &BZ; web site.
+ </para>
+ </tip>
</section>
</section>
@@ -264,8 +277,8 @@
<section id="sn-about-packages">
<title>About Packages</title>
<indexterm>
- <primary>packages</primary>
- <secondary>defined</secondary>
+ <primary>packages</primary>
+ <secondary>defined</secondary>
</indexterm>
<para>
&FED; software and documentation is supplied in the form of
@@ -287,13 +300,23 @@
the public keys for approved package sources. The system
administrator configures these approved package sources.
</para>
+
+ <note>
+ <title>All &FED; Packages are Open Source Software</title>
+
+ <para>
+ All of the software provided by the &FP; is open source
+ software. You may download and install &FED; packages on as
+ many systems as desired.
+ </para>
+ </note>
</section>
<section id="sn-about-repositories">
<title>About Repositories</title>
<indexterm>
- <primary>repositories</primary>
- <secondary>defined</secondary>
+ <primary>repositories</primary>
+ <secondary>defined</secondary>
</indexterm>
<para>
A <firstterm>repository</firstterm> is a prepared directory or
@@ -307,48 +330,71 @@
</para>
<para>
- The package management utilities in &FC; are already configured
- to use a network of servers that provide three repositories:
+ A network of servers provide several repositories for each
+ version of &FED;. The package management utilities in &FC; are
+ already configured to use three of these repositories:
</para>
- <itemizedlist>
- <listitem>
- <para>
- The packages that make up &FC;, as it is released on disc
- </para>
- </listitem>
- <listitem>
- <para>
- Updated versions of &FC; software
- </para>
- </listitem>
- <listitem>
- <para>
- A large selection of additional software, known as &FEX;
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ Base
+ </term>
+ <listitem>
+ <para>
+ The packages that make up a &FC; release, as it is on disc
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ Updates
+ </term>
+ <listitem>
+ <para>
+ Updated versions of packages that are provided in Base
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ &EX;
+ </term>
+ <listitem>
+ <para>
+ Packages for a large selection of additional software
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<note>
<title>Previous Versions of &FED;</title>
<para>
- &FED; &FCLOCALVER; automatically supports all three
- repositories. You must manually configure &FED; 3 systems to
- use &FEX;, as noted in
+ &FED; &FCLOCALVER; automatically supports the three
+ repositories listed above. You must manually configure &FED; 3
+ systems to use &FEX;, as noted in
<xref linkend="sn-using-repositories"/>.
</para>
</note>
- <note>
- <title>All &FED; Packages are Open Source Software</title>
+ <warning>
+ <title>&FED; Development Repositories</title>
<para>
- All of the software provided by the &FP; is open source
- software. You may download and install software from the &FP;
- network of repositories on as many systems as desired.
+ &FC; also includes settings for several alternative
+ repositories. These provide packages for various types of test
+ system, and replace one or more of the standard repositories.
+ Only enable support for one of the following repositories if
+ you test or develop &FED; software:
+ <filename>fedora-devel</filename> (Rawhide),
+ <filename>fedora-extras-devel</filename>, and
+ <filename>updates-testing</filename>.
</para>
- </note>
+ </warning>
<para>
Third-party software developers also provide repositories for
@@ -357,8 +403,8 @@
<xref linkend="sn-using-repositories"/>.
</para>
<indexterm>
- <primary>package groups</primary>
- <secondary>defined</secondary>
+ <primary>package groups</primary>
+ <secondary>defined</secondary>
</indexterm>
<para>
You may also use the <firstterm>package groups</firstterm>
@@ -408,8 +454,8 @@
<section id="sn-about-dependencies">
<title>About Dependencies</title>
<indexterm>
- <primary>dependencies</primary>
- <secondary>defined</secondary>
+ <primary>dependencies</primary>
+ <secondary>defined</secondary>
</indexterm>
<para>
Some of the files installed on a &FED; distribution are
@@ -436,17 +482,16 @@
<section id="sn-package-names">
<title>Understanding Package Names</title>
<indexterm>
- <primary>packages</primary>
- <secondary>hardware compatibility</secondary>
- </indexterm>
- <indexterm>
- <primary>packages</primary>
- <secondary>naming</secondary>
+ <primary>packages</primary>
+ <secondary>hardware compatibility</secondary>
+ </indexterm> <indexterm>
+ <primary>packages</primary>
+ <secondary>naming</secondary>
</indexterm>
<para>
Each package file has a long name that indicates several key
- pieces of information. This is the full name of the
- <filename>tsclient</filename> package supplied with &FC;:
+ pieces of information. For example, this is the full name of a
+ <filename>tsclient</filename> package:
</para>
<screen>
<filename>tsclient-0.132-6.i386.rpm</filename>
@@ -582,18 +627,16 @@
<section id="sn-software-management-tools">
<title>Software Management Tools in &FC;</title>
<indexterm>
- <primary>Add/Remove Applications utility</primary>
- </indexterm>
- <indexterm>
- <primary>Alert Icon</primary>
- </indexterm>
- <indexterm>
- <primary>up2date</primary>
+ <primary>Add/Remove Applications utility</primary>
+ </indexterm> <indexterm>
+ <primary>Alert Icon</primary>
+ </indexterm> <indexterm>
+ <primary>up2date</primary>
</indexterm>
<para>
The <command>yum</command> utility is a complete software
- management system. &FC; also includes several other
- applications that can supplement <command>yum</command>.
+ management system. &FC; also includes several other applications
+ that can supplement <command>yum</command>.
</para>
<para>
@@ -644,8 +687,8 @@
<section id="sn-managing-packages">
<title>Managing Software with <command>yum</command></title>
<indexterm>
- <primary>yum</primary>
- <secondary>software management</secondary>
+ <primary>yum</primary>
+ <secondary>software management</secondary>
</indexterm>
<para>
Use the <command>yum</command> utility to modify the software on
@@ -778,7 +821,7 @@
<para>
Check the public key, and then press <keycap>y</keycap> to import
the key and authorize the key for use. If you press
- <keycap>N</keycap> or <keycap>Enter</keycap> ,
+ <keycap>N</keycap> or <keycap>Enter</keycap>,
<command>yum</command> stops without installing any packages.
</para>
@@ -789,6 +832,13 @@
packages required for the transaction are successfully downloaded
and verified, <command>yum</command> applies them to your system.
</para>
+
+ <para>
+ Every completed transaction records the affected packages in the
+ log file <filename>/var/log/yum.log</filename>. You may only read
+ this file with <systemitem class="username">root</systemitem>
+ access.
+ </para>
<tip>
<title>Downloads are Cached</title>
<para>
@@ -803,12 +853,11 @@
<section id="sn-yum-installing-withrepositories">
<title>Installing New Software with <command>yum</command></title>
<indexterm>
- <primary>installing software</primary>
- <see>software, installing</see>
- </indexterm>
- <indexterm>
- <primary>software</primary>
- <secondary>installing</secondary>
+ <primary>installing software</primary>
+ <see>software, installing</see>
+ </indexterm> <indexterm>
+ <primary>software</primary>
+ <secondary>installing</secondary>
</indexterm>
<para>
To install the package <filename>tsclient</filename>, enter the
@@ -854,12 +903,11 @@
<section id="sn-yum-updating-withrepositories">
<title>Updating Software with <command>yum</command></title>
<indexterm>
- <primary>updating</primary>
- <secondary>software packages</secondary>
- </indexterm>
- <indexterm>
- <primary>software</primary>
- <secondary>updating</secondary>
+ <primary>updating</primary>
+ <secondary>software packages</secondary>
+ </indexterm> <indexterm>
+ <primary>software</primary>
+ <secondary>updating</secondary>
</indexterm>
<para>
To update the <filename>tsclient</filename> package to the
@@ -913,11 +961,10 @@
<section id="sn-yum-removing-software">
<title>Removing Software with <command>yum</command></title>
<indexterm>
- <primary>removing software</primary>
- </indexterm>
- <indexterm>
- <primary>software</primary>
- <secondary>removing</secondary>
+ <primary>removing software</primary>
+ </indexterm> <indexterm>
+ <primary>software</primary>
+ <secondary>removing</secondary>
</indexterm>
<para>
To remove software, <command>yum</command> examines your system
@@ -968,12 +1015,11 @@
<section id="sn-searching-packages">
<title>Searching for Packages with <command>yum</command></title>
<indexterm>
- <primary>packages</primary>
- <secondary>locating</secondary>
- </indexterm>
- <indexterm>
- <primary>searching</primary>
- <secondary>for packages</secondary>
+ <primary>packages</primary>
+ <secondary>locating</secondary>
+ </indexterm> <indexterm>
+ <primary>searching</primary>
+ <secondary>for packages</secondary>
</indexterm>
<para>
Use the search features of <command>yum</command> to find software
@@ -1126,12 +1172,11 @@
<section id="sn-updating-your-system">
<title>Updating Your System with <command>yum</command></title>
<indexterm>
- <primary>updating</primary>
- <secondary>full system</secondary>
- </indexterm>
- <indexterm>
- <primary>yum</primary>
- <secondary>updating full system</secondary>
+ <primary>updating</primary>
+ <secondary>full system</secondary>
+ </indexterm> <indexterm>
+ <primary>yum</primary>
+ <secondary>updating full system</secondary>
</indexterm>
<para>
Use the <option>update</option> option to upgrade all of your
@@ -1153,7 +1198,7 @@
<section id="sn-automatic-updating">
<title>Automatically Updating Your System</title>
<indexterm>
- <primary>automatic updating</primary>
+ <primary>automatic updating</primary>
</indexterm>
<para>
The <filename>yum</filename> package supplied with &FC; includes
@@ -1187,15 +1232,13 @@
<section id="sn-using-repositories">
<title>Using Other Software Repositories</title>
<indexterm>
- <primary>&FEX;</primary>
- </indexterm>
- <indexterm>
- <primary>repositories</primary>
- <secondary>finding</secondary>
- </indexterm>
- <indexterm>
- <primary>searching</primary>
- <secondary>for repositories</secondary>
+ <primary>&FEX;</primary>
+ </indexterm> <indexterm>
+ <primary>repositories</primary>
+ <secondary>finding</secondary>
+ </indexterm> <indexterm>
+ <primary>searching</primary>
+ <secondary>for repositories</secondary>
</indexterm>
<para>
&FED; systems automatically use the &FP; repositories. These
@@ -1230,8 +1273,8 @@
<section id="sn-adding-repositories">
<title>Adding a Repository as a Package Source</title>
<indexterm>
- <primary>repositories</primary>
- <secondary>adding to yum</secondary>
+ <primary>repositories</primary>
+ <secondary>adding to yum</secondary>
</indexterm>
<para>
To add an extra repository, place a definition file in the
@@ -1287,8 +1330,8 @@
<section id="sn-authorizing-package-sources">
<title>Manually Authorizing Package Sources</title>
<indexterm>
- <primary>public keys</primary>
- <secondary>adding</secondary>
+ <primary>public keys</primary>
+ <secondary>adding</secondary>
</indexterm>
<para>
To manually add a public key to your <command>rpm</command>
@@ -1334,12 +1377,11 @@
<section id="sn-compat-repositories">
<title>Understanding Repository Compatibility</title>
<indexterm>
- <primary>packages</primary>
- <secondary>software compatibility</secondary>
- </indexterm>
- <indexterm>
- <primary>repositories</primary>
- <secondary>compatibility</secondary>
+ <primary>packages</primary>
+ <secondary>software compatibility</secondary>
+ </indexterm> <indexterm>
+ <primary>repositories</primary>
+ <secondary>compatibility</secondary>
</indexterm>
<para>
The &FEX; repository provides packages which are built to the
@@ -1394,6 +1436,78 @@
</section>
</section>
+ <section id="sn-yum-installing-frompackage">
+ <title>Installing Software from an Isolated Package</title>
+ <indexterm>
+ <primary>installing software</primary>
+ <secondary>from a package</secondary>
+ <see>software, installing from a package</see>
+ </indexterm> <indexterm>
+ <primary>software</primary>
+ <secondary>installing from a package</secondary>
+ </indexterm>
+ <para>
+ Use repositories and the standard <command>yum</command> commands
+ to locate and install new software, unless the software package is
+ not available from any repository. In these cases, use the
+ <option>localinstall</option> function to install the software
+ from the package file.
+ </para>
+
+ <important>
+ <title>Public Key is Required</title>
+
+ <para>
+ Ensure that the public key for the package source has been
+ imported before you install a package without a repository.
+ Refer to <xref linkend="sn-authorizing-package-sources"/>.
+ </para>
+ </important>
+
+ <para>
+ Enter this command to install the package
+ <filename>tsclient-0.132-4.i386.rpm</filename>:
+ </para>
+<screen>
+<userinput>su -c 'yum localinstall <replaceable>tsclient-0.132-4.i386.rpm</replaceable>'</userinput>
+</screen>
+ <para>
+ At the prompt, enter the
+ <systemitem
+ class="username">root</systemitem> password.
+ </para>
+
+ <note>
+ <title>Previously Installed Software is Updated</title>
+
+ <para>
+ If the package provides a later version of software that is
+ already installed on your system, <command>yum</command> updates
+ the installed software.
+ </para>
+ </note>
+
+ <para>
+ If the package requires software that is not installed on your
+ system, <command>yum</command> attempts to meet the dependencies
+ with packages from the configured repositories. You may need to
+ manually download and install additional packages in order to
+ satisfy all of the dependencies.
+ </para>
+
+ <caution>
+ <title>Maintaining Manually Installed Software</title>
+
+ <para>
+ If you install software that is not provided by a repository,
+ <command>yum update</command> cannot automatically upgrade it as
+ new versions become available. To ensure that you have the
+ latest packages, subscribe to e-mail or RSS services that notify
+ you when new versions are released.
+ </para>
+ </caution>
+ </section>
+
<section id="sn-yum-maintenance">
<title>Maintaining <command>yum</command></title>
@@ -1409,12 +1523,11 @@
<section id="sn-removing-sources">
<title>Disabling or Removing Package Sources</title>
<indexterm>
- <primary>repositories</primary>
- <secondary>disabling in yum</secondary>
- </indexterm>
- <indexterm>
- <primary>repositories</primary>
- <secondary>removing from yum</secondary>
+ <primary>repositories</primary>
+ <secondary>disabling in yum</secondary>
+ </indexterm> <indexterm>
+ <primary>repositories</primary>
+ <secondary>removing from yum</secondary>
</indexterm>
<para>
Set <command>enable=0</command> in a definition file to prevent
@@ -1526,8 +1639,8 @@
<section id="sn-yum-clearance">
<title>Clearing the <command>yum</command> Caches</title>
<indexterm>
- <primary>yum</primary>
- <secondary>cleaning caches</secondary>
+ <primary>yum</primary>
+ <secondary>cleaning caches</secondary>
</indexterm>
<para>
By default, <command>yum</command> retains the packages and
@@ -1558,114 +1671,61 @@
</section>
</section>
-<!-- SE: The sections below are important, but only for certain situations - they do not represent the normal use of yum. Perhaps they should be explicitly marked as appendices ? -->
-
- <section id="sn-yum-installing-frompackage">
- <title>Manually Installing Software</title>
- <indexterm>
- <primary>installing software</primary>
- <secondary>from a package</secondary>
- <see>software, installing from a package</see>
- </indexterm>
+ <section id="sn-yum-proxy-server">
+ <title>Using <command>yum</command> with a Proxy Server</title>
<indexterm>
- <primary>software</primary>
- <secondary>installing from a package</secondary>
+ <primary>proxy server</primary>
+ </indexterm> <indexterm>
+ <primary>yum</primary>
+ <secondary>using with a proxy server</secondary>
</indexterm>
<para>
- Use repositories and the standard <command>yum</command> commands
- to locate and install new software, unless the software package is
- not available from any repository. In these cases, use the
- <option>localinstall</option> function to install the software
- from the package file.
+ By default, <command>yum</command> accesses network repositories
+ with HTTP. All <command>yum</command> HTTP operations use
+ HTTP/1.1, and are compatible with web proxy servers that support
+ this standard. You may also access FTP repositories, and configure
+ <command>yum</command> to use an FTP proxy server. The
+ <filename>squid</filename> package provides a proxy service for
+ both HTTP/1.1 and FTP connections.
</para>
-
- <important>
- <title>Public Key is Required</title>
-
+ <tip>
+ <title>Modifying <command>yum</command> for Network Compatibility</title>
<para>
- Ensure that the public key for the package source has been
- imported before you install a package without a repository.
- Refer to <xref linkend="sn-authorizing-package-sources"/>.
+ Refer to the <command>man</command> page for
+ <filename>yum.conf</filename> for information on HTTP settings
+ that may be modified for compatibility with nonstandard web
+ proxy servers. Alternatively, configure <command>yum</command>
+ to use an FTP proxy server, and access repositories that support
+ FTP. The &FED; repositories support both HTTP and FTP.
</para>
- </important>
-
- <para>
- Enter this command to install the package
- <filename>tsclient-0.132-4.i386.rpm</filename>:
- </para>
-<screen>
-<userinput>su -c 'yum localinstall <replaceable>tsclient-0.132-4.i386.rpm</replaceable>'</userinput>
-</screen>
- <para>
- At the prompt, enter the
- <systemitem
- class="username">root</systemitem> password.
- </para>
-
- <note>
- <title>Previously Installed Software is Updated</title>
+ </tip>
+ <section id="sn-yum-proxy-server-global">
+ <title>Configuring Proxy Server Access</title>
<para>
- If the package provides a later version of software that is
- already installed on your system, <command>yum</command> updates
- the installed software.
+ To enable all <command>yum</command> operations to use a proxy
+ server, specify the proxy server details in
+ <filename>/etc/yum.conf</filename>. The <option>proxy</option>
+ setting must specify the proxy server as a complete URL,
+ including the TCP port number. If your proxy server requires a
+ username and password, specify these by adding
+ <option>proxy_username</option> and
+ <option>proxy_password</option> settings.
</para>
- </note>
-
- <para>
- If the package requires software that is not installed on your
- system, <command>yum</command> attempts to meet the dependencies
- with packages from the configured repositories. You may need to
- manually download and install additional packages in order to
- satisfy all of the dependencies.
- </para>
-
- <caution>
- <title>Maintaining Manually Installed Software</title>
<para>
- If you install software that is not provided by a repository,
- <command>yum update</command> cannot automatically upgrade it as
- new versions become available. To ensure that you have the
- latest packages, subscribe to e-mail or RSS services that notify
- you when new versions are released.
- </para>
- </caution>
- </section>
-
- <section id="sn-yum-proxy-server">
- <title>Using <command>yum</command> with a Proxy Server</title>
- <indexterm>
- <primary>proxy server</primary>
- </indexterm>
- <indexterm>
- <primary>yum</primary>
- <secondary>using with a proxy server</secondary>
- </indexterm>
- <para>
- You may access repositories through standard web proxy servers. If
- your system accesses the Internet through a web proxy server,
- specify the proxy server details in
- <filename>/etc/yum.conf</filename>. The <option>proxy</option>
- setting must specify the proxy server as a complete URL, including
- the TCP port number. If your proxy server requires a username and
- password, specify these by adding <option>proxy_username</option>
- and <option>proxy_password</option> settings.
- </para>
-
- <para>
- The settings below enable <command>yum</command> to use the proxy
- server
- <systemitem
+ The settings below enable <command>yum</command> to use the
+ proxy server
+ <systemitem
class="systemname">mycache.mydomain.com</systemitem>,
- connecting to port 3128, with the username
- <systemitem
+ connecting to port 3128, with the username
+ <systemitem
class="username">yum-user</systemitem> and the
- password <systemitem>qwerty</systemitem>.
- </para>
+ password <systemitem>qwerty</systemitem>.
+ </para>
- <example id="config-file-httpproxy">
- <title>Configuration File Settings for Using A Proxy Server</title>
+ <example id="config-file-httpproxy">
+ <title>Configuration File Settings for Using A Proxy Server</title>
<screen>
<computeroutput># The proxy server - proxy server:port number
proxy=http://mycache.mydomain.com:3128
@@ -1673,67 +1733,72 @@
proxy_username=yum-user
proxy_password=qwerty</computeroutput>
</screen>
- </example>
+ </example>
- <note>
- <title>Global Settings</title>
+ <note>
+ <title>Global Settings</title>
- <para>
- If you define a proxy server in
- <filename>/etc/yum.conf</filename>, <emphasis>all</emphasis>
- users connect to the proxy server with those details when using
- <command>yum</command>.
- </para>
- </note>
+ <para>
+ If you define a proxy server in
+ <filename>/etc/yum.conf</filename>, <emphasis>all</emphasis>
+ users connect to the proxy server with those details when
+ using <command>yum</command>.
+ </para>
+ </note>
+ </section>
- <para>
- To enable proxy access for a specific user, add the lines in the
- example box below to the user's shell profile. For the default
- <command>bash</command> shell, the profile is the file
- <filename>~/.bash_profile</filename>. The settings below enable
- <command>yum</command> to use the proxy server
- <systemitem
+ <section id="sn-yum-proxy-server-peruser">
+ <title>Configuring Proxy Server Access for a Single User</title>
+
+ <para>
+ To enable proxy access for a specific user, add the lines in the
+ example box below to the user's shell profile. For the default
+ <command>bash</command> shell, the profile is the file
+ <filename>~/.bash_profile</filename>. The settings below enable
+ <command>yum</command> to use the proxy server
+ <systemitem
class="systemname">mycache.mydomain.com</systemitem>,
- connecting to port 3128.
- </para>
+ connecting to port 3128.
+ </para>
- <example id="profile-script-httpproxy">
- <title>Profile Settings for Using a Proxy Server</title>
+ <example id="profile-script-httpproxy">
+ <title>Profile Settings for Using a Proxy Server</title>
<screen>
<computeroutput># The Web proxy server used by this account
http_proxy="http://mycache.mydomain.com:3128"
export http_proxy</computeroutput>
</screen>
- </example>
+ </example>
- <para>
- If the proxy server requires a username and password, add these to
- the URL. To include the username
- <systemitem class="username">yum-user</systemitem> and the
- password <systemitem>qwerty</systemitem>, add these settings:
- </para>
+ <para>
+ If the proxy server requires a username and password, add these
+ to the URL. To include the username
+ <systemitem class="username">yum-user</systemitem> and the
+ password <systemitem>qwerty</systemitem>, add these settings:
+ </para>
- <example id="profile-script-httpproxy-withpassword">
- <title>Profile Settings for a Secured Proxy Server</title>
+ <example id="profile-script-httpproxy-withpassword">
+ <title>Profile Settings for a Secured Proxy Server</title>
<screen>
<computeroutput># The Web proxy server, with the username and password for this account
http_proxy="http://yum-user:qwerty@mycache.mydomain.com:3128"
export http_proxy</computeroutput>
</screen>
- </example>
+ </example>
- <note>
- <title>The <option>http_proxy</option> Environment Variable</title>
+ <note>
+ <title>The <option>http_proxy</option> Environment Variable</title>
- <para>
- The <command>http_proxy</command> environment variable is also
- used by <command>curl</command> and other utilities. Although
- <command>yum</command> itself may use
- <command>http_proxy</command> in either upper-case or
- lower-case, <command>curl</command> requires the name of the
- variable to be in lower-case.
- </para>
- </note>
+ <para>
+ The <command>http_proxy</command> environment variable is also
+ used by <command>curl</command> and other utilities. Although
+ <command>yum</command> itself may use
+ <command>http_proxy</command> in either upper-case or
+ lower-case, <command>curl</command> requires the name of the
+ variable to be in lower-case.
+ </para>
+ </note>
+ </section>
</section>
<!-- SE: This is at the end of the document, since it looks out of place in section 1 -->
- Previous message (by thread): rpm-guide rpm-guide-advanced-packaging-en.xml, 1.4, 1.5 rpm-guide-creating-rpms-en.xml, 1.4, 1.5 rpm-guide-intro-packaging-en.xml, 1.4, 1.5 rpm-guide-other-os-en.xml, 1.4, 1.5 rpm-guide-package-structure-en.xml, 1.2, 1.3 rpm-guide-programming-c-en.xml, 1.4, 1.5 rpm-guide-rpmbuild-en.xml, 1.4, 1.5 rpm-guide-specfile-syntax-en.xml, 1.3, 1.4 rpm-guide-specfiles-en.xml, 1.4, 1.5 rpm-guide-transactions-en.xml, 1.4, 1.5 rpm-guide-using-rpm-en.xml, 1.4, 1.5
- Next message (by thread): mirror-tutorial mirror-tutorial-en.xml,1.17,1.18
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
More information about the Fedora-docs-commits
mailing list