Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

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:

redhat_downloader.bat -encode <passwordToEncrypt>

If running the downloader on UNIX:

sh redhat_downloader.sh -encode <passwordToEncrypt>

To prepare the configuration file on Red Hat Enterprise Linux

Note

You need not perform this migration procedure if you are using the BMC supplied Offline patch downloader utility.

  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>

      Note

      You can specify multiple errata type filters for multiple architectures. See Sample 1 for a sample xml configuration file with multiple architectures.

    • 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.xml file is shown below, including sample data and parameter descriptions for single architecture:

    <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>

    The sample-redhat-downloader-config1.xml file is shown below, including sample data and parameter descriptions for multiple architectures:

    <redhat-downloader-config>
        <config>
         <!--<proxy-settings>
                           <port>8080</port>
                           <host>127.0.0.1</host>
                           <username>user</username>
                           <password></password>
                           <domain-name></domain-name>
                           <proxy-type>ntlm-v2</proxy-type>
          </proxy-settings>-->
          <temporary-location>c:\tmp</temporary-location>
          <payload-repository-location>c:\tmp\deleteme</payload-repository-location>
          <!-- The default value for download-request-retries will be 10 if no value
    is specified -->
          <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-type-filter>
                                                  
                  <os>RHES5</os>
                   <arch>x86_64</arch>
                   <channel-label>rhel-x86_64-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>RHSA-2009:0430</errata-id>
                              <errata-id>RHEA-2009:0422</errata-id>
                              <errata-id>RHBA-2009:0407</errata-id>
                              <errata-id>RHSA-2009:0397</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></os>
                    <arch></arch>
                    <channel-label></channel-label>
                    <update-level></update-level>
                                  
           </update-level-filter> -->
    </subscription>
    </redhat-downloader-config>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*