package list schema for bcfg2
Narayan Desai, Argonne National Laboratory
Abstract description of a package or package group to be
installed.
Install the named package. Either ``name`` or
:xml:attribute:`PackageStructure:group` must be specified.
Install the named package group. Package groups are only
supported for Yum :xml:element:`Source` repositories, and
only if the :ref:`yum libraries
<native-yum-libraries>` are in use. Either ``group``
or :xml:attribute:`PackageStructure:name` must be specified.
Whether or not to verify the package.
The package set to select from a given package group. Only
meaningful if :xml:attribute:`PackageStructure:group` is
specified.
Whether also the recommended packages should be installed.
This is currently only used with the :ref:`APT
<client-tools-apt>` driver.
Concrete specification of a package to be installed. A
package can be specified in one of two ways:
* A single Package tag that lists all of the attributes for
the single instance of the package that should be installed.
* A Package tag with any number of :xml:element:`Instance`
children, each of which lists the attributes of an instance
of the package that should be installed. In this case, the
Package tag should only have
:xml:attribute:`PackageType:name` and
:xml:attribute:`PackageType:type`.
Note that many of the attributes listed below are specific to
one or a few package drivers.
An Instance element describes a single instance of a
package that may have several different versions, arches,
etc., installed at once.
The architecture of the package to be installed.
The epoch of the package to be installed.
The version of the package to be installed. See
:xml:attribute:`PackageType:version` for details.
The release of the package to be installed.
Package file name. No name parsing is performed, so no
extra fields get set. This is only used for manual
maintenance of ``gpg-pubkey`` packages with the
:ref:`YUM, YUM24, or RPM <client-tools-yum>`
driver.
Whether or not to perform full package verification (file
integrity, etc.) on this package with the :ref:`YUM, YUM24,
or RPM <client-tools-yum>` driver.
Comma-separated list of flags to pass to the package
verification routines of the :ref:`YUM, YUM24, or RPM
<client-tools-yum>` driver. See ``man rpm`` for
details on the flags.
Whether or not to install missing packages. This is
only honored by the the :ref:`RPM
<client-tools-yum>` driver.
Whether or not to upgrade or downgrade packages that
are installed, but have the wrong version. This is
only honored by the :ref:`RPM
<client-tools-yum>` driver.
Whether or not to reinstall packages that fail
verification. This is only honored by the :ref:`RPM
<client-tools-yum>` driver.
Package name.
The architecture of the package to be installed.
The version of the package to be installed. This should
*only* be the version, i.e., not the release. Release should
be specified in :xml:attribute:`PackageType:release`, and it
is an error to append the release to this.
This can also be one of two "special" values:
* ``auto`` will select the newest version of the package
available.
* ``any`` will select any version of the package, and can be
used to ensure that a package is installed without
requiring any particular version.
The release of the package to be installed.
Package file name. Several other attributes (name, version)
can be automatically defined based on regular expressions
defined in the :ref:`server-plugins-generators-pkgmgr`
plugin, which is the only plugin with which this is useful.
Whether or not to perform package verification. This is not
supported by the :ref:`YUM <client-tools-yum>` driver.
Package file name. No name parsing is performed, so no extra
fields get set. This is only used for some edge cases with
:ref:`server-plugins-generators-pkgmgr`.
Comma-separated list of architectures of this package that
should be installed. This is only used by the
:ref:`server-plugins-generators-pkgmgr` plugin.
Filename creation rules for multiarch packages. This is only
used by the :ref:`server-plugins-generators-pkgmgr` plugin.
The package type, which determines which client driver will
handle installation of this package.
The name of the package for installing (as opposed to the
name when verifying) with the Blast and OpenCSW drivers.
Whether or not to perform basic package checks (version,
release, etc.) on this package with the :ref:`YUM, YUM24, or
RPM <client-tools-yum>` driver.
Whether or not to perform full package verification (file
integrity, etc.) on this package with the :ref:`YUM, YUM24,
or RPM <client-tools-yum>` driver.
Flags to pass to the package verification routines of the
:ref:`YUM, YUM24, or RPM <client-tools-yum>` driver.