NAME

yum - The LCFG yum component

DESCRIPTION

yum is an interactive, rpm based, package manager. This is an LCFG component for configuring the list of available YUM repositories.

RESOURCES

repositories

This is a list of tags for the repositories you wish to manage with this LCFG component. Each repository has a set of possible options which are configured via the following resources:

id_repo

This is an optional resource for specifying the repository identifier of the repository. If the id is not specified then the LCFG tag for the repository will be used. This is particularly useful if you want to embed characters in the identifier which are not compatible with LCFG resource names (e.g. hyphens).

name_repo

This is the name of the repository, typically this is a longer string than the identifier and describes the contents of the repository in a bit more detail.

baseurl_repo

This is the URL for the repository. This is not essential, you can alternatively use the mirrorlist resource.

enabled_repo

This is a boolean controlling whether or not the particular repository is enabled. The default is true. This is useful for quickly disabling a repository without deleting all of the associated LCFG resources.

metadata_expire_repo

This is the time (in seconds) after which the metadata for the repository will expire. If this resource is not specified then yum uses a default of 1.5 hours.

gpgcheck_repo

This is a boolean which controls whether or not to perform a GPG signature check on packages. The default is true.

gpgkey_repo

This is a URL pointing to the ASCII-armored GPG key file for the repository. This option is used if yum needs a public key to verify a package and the required key has not been imported into the RPM database.

failovermethod_repo

The failovermethod can be either roundrobin or priority. See the yum.conf(5) manual page for details. This defaults to roundrobin if not specified.

mirrorlist_repo

This specifies a URL to a file containing a list of baseurls. This can be used instead of or with the baseurl option.

disable_other_confs

When using this LCFG component to manage a set of YUM repositories it can be useful to automatically disable all other repositories listed in other yum repository files (e.g. those in files installed via packages).

This is a boolean value which controls whether or not any unmanaged repositories found should be disabled. The default value is false. It is possible to leave some configuration files untouched, see the extra_confs resource described below.

extra_confs

When the disable_other_confs resource is enabled all unmanaged repositories will be disabled. This resource can be used to specify a list of yum repository configuration files which should be left untouched. It is only necessary to specfy the filenames in this resource, not the absolute paths.

reposdir

This is the directory in which the yum repository configuration files are stored. You should not normally need to alter this resource. The default is the /etc/yum.repos.d/ directory.

template

This is the template file used to generate the yum configuration file for the list of repositories managed by the component. You should not normally need to alter this resource. The default is /usr/lib/lcfg/conf/yum/repo.tt

configfile

This is the full path to the yum configuration file to be generated with the list of LCFG managed repositories. You should not normally need to alter this resource. The default is /etc/yum.repos.d/lcfg.repo

SEE ALSO

yum(8), yum.conf(5)

PLATFORMS

This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.

ScientificLinux6, ScientificLinux5, Fedora13

BUGS AND LIMITATIONS

Please report any bugs or problems (or praise!) to bugs@lcfg.org, feedback and patches are also always very welcome.

AUTHOR

Stephen Quinney <squinney@inf.ed.ac.uk>

LICENSE

Copyright (C) 2011 University of Edinburgh. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.