Changes between Initial Version and Version 1 of Tools/DebianPkgmgrCreationScript


Ignore:
Timestamp:
06/01/10 05:15:59 (12 years ago)
Author:
http://fab.id.fedoraproject.org/
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Tools/DebianPkgmgrCreationScript

    v1 v1  
     1= Debian Pkgmgr Creation Script = 
     2 
     3The tool [https://trac.mcs.anl.gov/projects/bcfg2/browser/trunk/bcfg2/tools/create-debian-pkglist-gp.py create-debian-pkglist-gp.py] is a Python script that generates the required XML files in the Pkgmgr directory for Bcfg2 to install software with the APT driver ("gp" stands for the initials of the author, Guillaume Pratte, as the script is not officially incorporated in Bcfg2 for now, and as an previous version of this script exists as "create-debian-pkglist.py"). 
     4 
     5== The configuration file == 
     6 
     7The tool reads it's configuration from a file named `$REPOS/etc/debian-pkglist.conf`, where `$REPOS` is the path to the Bcfg2 repository (for example, `/var/lib/bcfg2`). Here is an example of this file : 
     8 
     9{{{ 
     10[ubuntu-dapper] 
     11deb_url=deb http://gulus.usherbrooke.ca/ubuntu dapper main restricted universe 
     12deb_url2=deb http://gulus.usherbrooke.ca/ubuntu dapper-updates main restricted universe 
     13deb_url3=deb http://gulus.usherbrooke.ca/ubuntu dapper-security main restricted universe 
     14priority=0 
     15architectures=i386,amd64 
     16group_names=dapper 
     17 
     18[ubuntu-feisty] 
     19deb_url=deb http://gulus.usherbrooke.ca/ubuntu feisty main universe multiverse restricted 
     20deb_url2=deb http://gulus.usherbrooke.ca/ubuntu feisty-updates main universe multiverse restricted 
     21deb_url3=deb http://gulus.usherbrooke.ca/ubuntu feisty-security main universe multiverse restricted 
     22priority=0 
     23architectures=i386,amd64 
     24group_names=feisty 
     25}}} 
     26 
     27This will create two files in the `Pkgmgr` directory, one named "ubuntu-dapper.xml", and the other "ubuntu-feisty.xml". The file is named after the sections of the configuration file (i.e. the file name is the string between the brackets). The ubuntu-dapper.xml file will be the result of the fusion of the three URLs specified. This fusion is done by comparing packages versions with dpkg and keeping only the most recent version of the packages. 
     28 
     29Here is a description of the options : 
     30 
     31'''deb_url''' 
     32  Specify the Debian URL(s) to use to generate the file. The format of this URL is the same as the URLs in /etc/apt/sources.list. Up to 9 URLs can be specified : deb_url, deb_url2, deb_url3, ..., deb_url9. The order of these URLs is not important. If a package is present in more than one URL, the most recent version of the package is kept. The package version comparison is done with the command "dpkg --compare-versions". 
     33 
     34'''priority''' 
     35  The priority to put in the PackageList tag of the generated XML file. A higher number means a higher priority. This priority is used by Bcfg2 to determine what package version to use if two XML lists contains the same package with a different version number. 
     36 
     37'''architectures''' 
     38  A list of one or more architectures. For example : 
     39   {{{architectures=i386}}} 
     40  or : 
     41   {{{architectures=i386, amd64}}} 
     42  If more than one architecture is specified, groups will be used to differenciate the versions for each architecture in the XML file. Packages which have the same versions across all architectures will have no architecture-based group. 
     43 
     44'''group_names''' 
     45  A list of one or more groups that all packages will belong to. As a consequence, packages will be available for the client only if it belong to these groups. It is suggested to use the code name of the distribution as defined in the metadata (for instance, in the [https://svn.mcs.anl.gov/repos/bcfg/trunk/repository/Metadata/bcfg2-os.xml bcfg-os.xml] file). 
     46 
     47== Download == 
     48 
     49This tool is available here : [https://trac.mcs.anl.gov/projects/bcfg2/browser/trunk/bcfg2/tools/create-debian-pkglist-gp.py create-debian-pkglist-gp.py] 
     50 
     51The file '''must''' be saved into `$REPOS/etc/` (where `$REPOS` is the path to the Bcfg2 repository (for example, `/var/lib/bcfg2`)). 
     52 
     53== Script invokation == 
     54 
     55The script must be invoked like this : 
     56{{{python create-debian-pkglist.py}}} 
     57 
     58Invoking with `-v` will ouput the URLs beeing processed. 
     59