Preparing the configuration file for AIX

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 within the <password></password> tag in the configuration XML file.

If running the downloader on Microsoft Windows:

aix_downloader.bat -encode <passwordToEncrypt>

If running the downloader on AIX or Linux:

sh aix_downloader.sh -encode <passwordToEncrypt>

To prepare the configuration file for AIX

  1. Edit the sample XML configuration file (sample-aix-downloader-config.xml) for use as the configuration file.
  2. (Optional) Add proxy information using the following XML tags:

    Tag

    Description

    <port></port>

    Port number used to communicate with the proxy server

    <host></host>

    IP address or host name of the proxy server

    <username></username>

    User name required for authentication prior to communication with the proxy server

    <password></password>

    The encrypted password for the specified user name

    <domain-name></domain-name>

    Domain name of the proxy server

    <proxy-type></proxy-type>

    Type of proxy server used. Valid values are:

    • None — indicates that no proxy server is used
    • NTLM
    • NTLM-V2
    • Squid
  3. Add download information using the following XML tags:

    Tag

    Description

    <temporary-location></temporary-location>>

    Location where files can be stored temporarily during the download process

    <payload-repository-location></payload-repository-location>

    Local location of the patch repository where metadata and payload are stored

    <download-request-retries></download-request-retries>

    Number of times the download utility attempts to download if the first attempt at downloading a payload fails

    <download-request-timeout></download-request-timeout>

    Number of milliseconds that the utility waits for a response before considering the attempt as failed
    This parameter is useful if the http response is slow.

    <downloader-parallel-threads></downloader-parallel-threads>

    Number of downloads that can be performed in parallel

  4. In the <subscription> tag, specify filters for defining the patches that are included in the download. Use the following XML tags:

    Tag

    Description

    <level-type-filter>
      <level-number></level-number>
      <level_type></level_type>
    </level-type-filter>

    You can define a filter for either a Technology Level (TL) or a Service Pack (SP) but you must use the version identifier provided by AIX FixGet. Use the following tags:

    • <level-number> is a version identifier provided by AIX FixGet.
    • <level_type> is the filter type.
      Valid values are:
      • TL — Technology Level
      • SP — Service Pack
    <apar-ids-filter>
      <currentoslevel></currentoslevel>
      <apar-id></apar-id>
    </apar-ids-filter>

    APAR filters use the OS level used by the servers and a specific APAR identifier. Use the following tags:

    • <currentoslevel> is the OS level used by the servers that you want to patch.
    • <apar-id> is the identifier for the APAR you want to install on the servers.
    <ptf-ids-filter>
      <currentoslevel></currentoslevel>
      <ptf-id></ptf-id>
    </ptf-ids-filter>

    PTF filters use the OS level used by the servers and a specific PTF identifier. Use the following tags:

    • <currentoslevel> is the OS level used by the servers that you want to patch.
    • <ptf-id> is the identifier for the PTF you want to install on the servers.
    <update-type-filter>
      <currentoslevel></currentoslevel>
      <update-type></update-type>
    </update-type-filter>

    Update filters use the OS level used by the servers that you want to patch as well as the update type. Use the following tags:

    • <currentoslevel> is the OS level used by the servers that you want to patch.
    • <update-type>can be one of three update types:
      • security
      • critical
      • latest
  5. Save the file.

The sample-aix-downloader-config.xml file with sample data is shown below.

<aix-downloader-config>
  <config>
    <!--<proxy-settings>
      <port>8080</port>
      <host>IPAddress</host>
      <username>patch</username>
      <password>NWKIPRTPCWEB</password>
      <domain-name></domain-name>
      <proxy-type>ntlm-v2</proxy-type>
    </proxy-settings>-->
    <temporary-location></temporary-location>
    <payload-repository-location></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>
    <level-type-filter>
      <level_number>V530011</level_number>
      <level_type>TL</level_type>
    </level-type-filter>
    <level-type-filter>
      <level_number>V53000007CSP</level_number>
      <level_type>SP</level_type>
    </level-type-filter>
    <apar-ids-filter>
      <currentoslevel>V610004</currentoslevel>
      <apar-id>IZ62630</apar-id>
    </apar-ids-filter>
    <ptf-ids-filter>
      <currentoslevel>V520000</currentoslevel>
      <ptf-id>U497901</ptf-id>
    </ptf-ids-filter>
    <update-type-filter>
      <currentoslevel>V520000</currentoslevel>
      <update-type>security</update-type>
    </update-type-filter>
    <update-type-filter>
      <currentoslevel>V610001</currentoslevel>
      <update-type>critical</update-type>
    </update-type-filter>
  </subscription>
</aix-downloader-config>

Where to go from here

Use the command in Downloading AIX patches using defined filters and pass the configuration file as a parameter to download the patches.

Was this page helpful? Yes No Submitting... Thank you

Comments