Preparing the configuration file for Ubuntu


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 filter definitions which determine the metadata and payload that is downloaded from the Shavlik Technologies website.

Note

Ensure that the editor you are using to edit the XML file supports UTF-8 encoding. The downloaded utility expects a configuration file with UTF-8 encoding. If the file uses a different encoding method, the application may fail with parsing errors.

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> parameter in the configuration XML file.

ubuntu_downloader.bat -encode <passwordToEncrypt>

To prepare the configuration file for Ubuntu

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

  3. Define download settings using the following XML tags.

  4. In the <subscription> tag, specify filters for limiting the patches that are included in the download.

    Note

    The same filters entered here must also be entered during catalog creation.

    You can automatically create a filter and append it to the configuration file by entering the following command in command prompt:

    debian_downloader.bat
    -addAptRepository
    -configFile <configFile>
    -debian <flavor>
    -osVersion <version>
    -debArch <arch>
    -debRepo <apt-get repository>

    where,

    <configFile> = Name of configuration file

    <flavor> = Flavor of the OS

    <version> = Version of OS

    <arch> = OS architecture type

    <apt-get repository> = <baseURL> <Distribution> <Component1> <Component2> ... <Component n>

     

    See the table below for a sample command and the corresponding filter that is created and appended to the configuration file.

    Command executed in command prompt

    debian_downloader.bat
    -addAptRepository
    -configFile <configFile>
    -debian Ubuntu
    -osVersion 13.04
    -debArch x86
    -debRepo http://in.archive.ubuntu.com/ubuntu/ raring Main Restricted

    Filter appended in configuration file

    <subscriptions>
           <debian-update arch="x86" version="13.04" os="Ubuntu">
               <base-url>http://in.archive.ubuntu.com/ubuntu/</base-url>
               <distribution-list>
                   <distribution name="raring">
                       <component name="Main"/>
                       <component name="Restricted">
                           <metadata-url>http://in.archive.ubuntu.com/ubuntu/dists/raring/restricted/binary-i386/Packages.gz</metadata-url>
                           <base-payload-url>http://in.archive.ubuntu.com/ubuntu/</base-payload-url>
                       </component>
                   </distribution>
               </distribution-list>
           </debian-update>
       </subscriptions>

     


  5. Save the file.
    The sample-ubuntu-downloader-config.xmlfile is shown below and includes sample data:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <debian-downloader-configuration>
       <config>
           <!--<proxy-settings>
                <port>8080</port>
                <host>127.0.0.1</host>
                <username>user</username>
                <password>password</password>
                <domain-name></domain-name>
                <proxy-type>ntlm</proxy-type>
            </proxy-settings>-->

           <temporary-location>c:\tmp</temporary-location>
           <payload-repository-location>c:\tmp\Ubuntu</payload-repository-location>
           <download-request-retries>3</download-request-retries>
           <download-request-timeout>180000</download-request-timeout>
           <downloader-parallel-threads>50</downloader-parallel-threads>
       </config>
       <subscriptions>
           <debian-update arch="x86" version="13.04" os="Ubuntu">
               <base-url>http://in.archive.ubuntu.com/ubuntu/</base-url>
               <distribution-list>
                   <distribution name="raring">
                       <component name="Main"/>
                       <component name="Restricted">
                           <metadata-url>http://in.archive.ubuntu.com/ubuntu/dists/raring/restricted/binary-i386/Packages.gz</metadata-url>
                           <base-payload-url>http://in.archive.ubuntu.com/ubuntu/</base-payload-url>
                       </component>
                   </distribution>
               </distribution-list>
           </debian-update>
       </subscriptions>
    </debian-downloader-configuration>

Where to go from here

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


 

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