Preparing the configuration file for Red Hat Enterprise Linux

In the configuration file, you provide information that is used by the Patch Downloader utility. This information includes definition of a proxy server (if one is used), identification of a local, temporary directory on the server that is used by the Patch Downloader utility during download, and download filter definitions.

Before you begin

Use the following command to encrypt the password supplied to the proxy server by the Patch Downloader utility. You must specify the resulting encrypted password in the <password></password> tag in the configuration XML file.
If running the downloader on Microsoft Windows:

If running the downloader on UNIX:

To prepare the configuration file on Red Hat Enterprise Linux

1. Edit the sample XML configuration file (sample-redhat-downloader-config.xml) for use as the configuration file.

2. (Optional) Add proxy information using the following XML tags:

3. Add download information using the following XML tags:
4. Modify filters, in the <subscription> tag. These define patches that are included in the download:

   • To create a filter that downloads the latest RPMs by errata type, use the following syntax:

     <errata-type-filter>
      <os></os>
      <arch></arch>
      <channel-label></channel-label>
      <errata-severity>
        <critical></critical>
        <high></high>
        <moderate></moderate>
        <low></low>
      </errata-severity>
      <errata-type>
        <security></security>
        <bugfix></bugfix>
        <enhancement></enhancement>
      </errata-type>
     </errata-type-filter>

   • To create a filter that downloads a specific errata by errata id, use the following syntax:

     <errata-ids-filter>
      <os></os>
      <arch></arch>
      <channel-label></channel-label>
      <errata-ids>
        <errata-id></errata-id>
      </errata-ids>
     </errata-ids-filter>

     Parameter	Description
     <os></os>	OS for the channel label
     <arch></arch>	Architecture for the channel label
     <channel-label></channel-label>	Channel label that you want to download
     <errata-id></errata-id>	A valid Errata ID for the channel label specified in the filter

   • To create a filter that downloads a specific update level, use the following syntax:

     <update-level-filter>
      <os></os>
      <arch></arch>
      <channel-label></channel-label>
      <update-level></update-level>
     </update-level-filter>

     Parameter	Description
     <os></os>	OS for the channel label
     <arch></arch>	Architecture for the channel label
     <channel-label></channel-label>	Channel label you want to download
     <update-level></update-level>	A valid update level for the channel label specified in the filter Note: The update-level filter works only on Linux computers. It does not work on windows computers.

5. Save the file.
   The sample-redhat-downloader-config.xmlfile is shown below, including sample data and parameter descriptions:

   <redhat-downloader-config>
    <config>
      <!--<proxy-settings>
        <port>8080</port>
        <host>_IPAddress_</host>
        <username>patch</username>
        <password>NWKIPRTPCWEB</password>
        <domain-name />
        <proxy-type>ntlm</proxy-type>
      </proxy-settings> -->
      <temporary-location>c:\tmp</temporary-location>
    <payload-repository-location>/home/repo/</payload-repository-location>
      <download-request-retries>10</download-request-retries>
      <download-request-timeout>180000</download-request-timeout>
      <downloader-parallel-threads>10</downloader-parallel-threads>
    </config>
    <subscription>
      <errata-type-filter>
        <os>RHES5</os>
        <arch>x86</arch>
        <channel-label>rhel-i386-server-5</channel-label>
        <errata-severity>
          <critical>true</critical>
          <high>true</high>
          <moderate>true</moderate>
          <low>true</low>
        </errata-severity>
        <errata-type>
          <security>true</security>
          <bugfix>true</bugfix>
          <enhancement>true</enhancement>
        </errata-type>
      </errata-type-filter>
      <errata-ids-filter>
        <os>RHAS4</os>
        <arch>x86</arch>
        <channel-label>rhel-i386-as-4</channel-label>
        <errata-ids>
          <errata-id>RHSA-2009:0429</errata-id>
          <errata-id>RHBA-2009:0388</errata-id>
        </errata-ids>
      </errata-ids-filter>
   <!-- This filter should be used only if the downloader is executed on a Linux machine -->
   <!-- This filter should not be used if the downloader is executed on a Windows machine -->
      <update-level-filter>
        <os>RHAS4</os>
        <arch>x86</arch>
        <channel-label>rhel-i386-as-4</channel-label>
        <update-level>5</update-level>
    </update-level-filter>
    </subscription>
   </redhat-downloader-config>