Errata

By default, repositories synchronize any errata in the feed. You can choose to skip errata sync by providing "--no-errata" option when syncing a repository. Errata information is available for review and installation on consumers.


Display

List

All errata, including custom/orphaned errata (not defined by a repository) can be listed using 'errata list' command.

$ pulp-admin errata list
+------------------------------------------+
             Errata Information
+------------------------------------------+

Id                      Type            Title

custom1                 bugfix          customerrata1
custom2                 security        customerrata2
FEDORA-2010-7013        bugfix          python-migrate-0.5.4-1.fc13
FEDORA-2011-0096        security        Django-1.2.4-1.fc13
.....

# Output trimmed for user guide

All errata in a given repository can be found by passing --repoid to the errata list command:

$ pulp-admin errata list --repoid=foo
+------------------------------------------+
       Available Errata in Repo [foo]
+------------------------------------------+

Id                  	Type           	Title

custom3             	bugfix         	customerrata3
custom_4            	enhancement    	customerrata4
custom4             	enhancement    	customerrata4

The errata applicable to a particular consumer, as determined by the consumer's package profile and repository bindings, can be viewed using the

$ pulp-admin errata list --consumerid=consumer1
+------------------------------------------+
 Applicable Errata for consumer [consumer1]
+------------------------------------------+

Id                  	Type           	Title

custom3             	bugfix         	customerrata3

You can pass "--type" option to all above list commands to restrict results to a particular errata type.

$ pulp-admin errata list --repoid=foo --type=enhancement
+------------------------------------------+
       Available Errata in Repo [foo]
+------------------------------------------+

Id                  	Type           	Title

custom_4            	enhancement    	customerrata4
custom4             	enhancement    	customerrata4

In addition, you can search errata using one or more of search options such as bugzilla id, CVE, title etc. Errata satisfying all given parameters will be returned.

$ pulp-admin errata search --help
Usage: pulp-admin <options> errata search <options>

Options:
  -h, --help     show this help message and exit
  --id=ID        errata id
  --title=TITLE  errata title
  --type=TYPE    type of errata to search; eg. security, bugfix etc.
  --bzid=BZID    reference bugzilla id
  --cve=CVE      reference CVE
  --orphaned     search only orphaned packages
$ pulp-admin errata search --type=bugfix --orphaned 

Id                  	Type           	Title

custom1             	bugfix         	customerrata1
custom3             	bugfix         	customerrata3

$ sudo pulp-admin errata search --bzid=433560

Id                  	Type           	Title

RHSA-2008:0194      	security       	Important: xen security and bug fix update

$ sudo pulp-admin errata search --cve=CVE-2007-3919

Id                  	Type           	Title

RHSA-2008:0194      	security       	Important: xen security and bug fix update

$ pulp-admin errata search --title=httpd-2.2.16-1.fc13 --type=security

Id                  	Type           	Title

FEDORA-2010-12478   	security       	httpd-2.2.16-1.fc13


Info

An individual erratum's details are displayed using the errata info command:

$ pulp-admin errata info --id=FEDORA-2010-11507

Id                    	FEDORA-2010-11507        
Title                 	fedora-packager-0.5.1.0-1.fc13
Description           	Massive updates for dist-git production setup.
Type                  	enhancement              
Issued                	2010-07-30 07:44:12      
Updated               	                         
Version               	1.4                      
Release               	Fedora 13                
Status                	stable                   
Packages Effected     	['fedora-packager-0.5.1.0-1.fc13.noarch.rpm', 'fedora-packager-0.5.1.0-1.fc13.src.rpm']
References            	[]              

Installation

Errata can be installed from the pulp-admin script on a remote consumer using the errata install command.

The errata install command takes following arguments:

Name Flag Description
Name -e or --erratum Name of an erratum to install. Multiple errata can be specified with multiple uses of this flag.
Import GPG Keys -i or --importkeys Permits YUM to install GPG keys as needed. Uses consumer.conf gpg.permit_import when not specified.
Future Install Time --when If specified, the installation will take place at a point in the future. Format: yyyy-mm-dd hh:mm
No Wait --nowait Do not wait (block) until operation has completed.
Consumer ID --consumerid ID of the consumer on which to install the errata.
Consumer Group ID --consumergroupid ID of the consumer group on which the errata will be installed.

For example:

$ pulp-admin errata install --consumerid test-consumer RHBA-2010:0826 -i

Create Errata

Create a custom errata in pulp. This will create the errata with given advisory id. This errata needs to be associated to the repo via add_errata call in order to be consumed by subscribed users.

The errata create command takes following arguments:

Name Flag Description
ID --id advisory id of the erratum to be created
TITLE --title title of the erratum
DESCRIPTION --description description of the erratum
VERSION --version version of the erratum
RELEASE --release release of the erratum
TYPE --type type of the erratum.Supported:security, enhancement, bugfix
ISSUED --issued erratum issued date; format:YYYY-MM-DD HH:MM:SS
STATUS --status status of this update. eg:stable
UPDATED --updated erratum updated date; format:YYYY-MM-DD HH:MM:SS
FROMSTR --fromstr from contact string who released the Erratum, eg:updates@fedoraproject.org
PKGCSV --effected-packages a csv file with effected packages; format:name,version,release,epoch,arch,filename,checksum,checksum_type,sourceurl
PUSHCOUNT --pushcount pushcount on the erratum
REFCSV --references A reference csv file; format:href,type,id,title
REBOOT SUGGESTED --reboot-suggested reboot suggested on errata
SHORT --short short release name; eg: F14
SEVERITY --severity optional severity information; eg: Low,Moderate,Critical
RIGHTS --rights optional copyright information
SUMMARY --summary optional summary information
SOLUTION --solution optional solution information

Example: create a custom errata

$ pulp-admin errata create --id=TEST_ERRATA-1 --title=TEST_ERRATA-1 --description="Security fixes." --version=0.1.1 --release=1 --type=security --issued="2012-02-13 14:30:00" --status=stable --fromstr=prad@redhat.com --effected-packages=pkgs.csv
Successfully created an Erratum with id [TEST_ERRATA-1]


Update Errata

Update an existing custom errata in pulp. This will update the errata with given advisory id.

The errata update command takes following arguments:

Name Flag Description
ID --id advisory id of the erratum to be updated
DESCRIPTION --description description of the erratum
VERSION --version version of the erratum
RELEASE --release release of the erratum
TYPE --type type of the erratum.Supported:security, enhancement, bugfix
ISSUED --issued erratum issued date; format:YYYY-MM-DD HH:MM:SS
STATUS --status status of this update. eg:stable
UPDATED --updated erratum updated date; format:YYYY-MM-DD HH:MM:SS
FROMSTR --fromstr from contact string who released the Erratum, eg:updates@fedoraproject.org
PKGCSV --effected-packages a csv file with effected packages; format:name,version,release,epoch,arch,filename,checksum,checksum_type,sourceurl
PUSHCOUNT --pushcount pushcount on the erratum
REFCSV --references A reference csv file; format:href,type,id,title
SHORT --short short release name; eg: F14
SEVERITY --severity optional severity information; eg: Low,Moderate,Critical
RIGHTS --rights optional copyright information
SUMMARY --summary optional summary information
SOLUTION --solution optional solution information

Example: Update a custom errata

$ pulp-admin errata update --id=TEST_ERRATA-1 --title=TEST_ERRATA-1 --description="Security fixes." --version=0.1.2 --release=2 --type=security --issued="2012-02-13 14:30:00" --status=stable --fromstr=prad@redhat.com --effected-packages=pkgs.csv
Successfully updated an Erratum with id [TEST_ERRATA-1]


Delete Errata

Delete an errata from pulp.

The repo delete_errata command takes following arguments:

Name Flag Description
ID --id Errata Id to delete from this repository.

Example: Delete an errata from pulp

$ pulp-admin errata delete --id  TEST_ERRATA-1

Add Errata

Associate an errata and its packages to a repository. Erratum should already exist in pulp to be able to perform this association. When add_errata is invoked, an erratum and its associated packages are selected from a source repository and added to the destination repository. During this process, a dependency lookup happens for the requested package(s) and the call provides a suggestive option to choose to any dependencies required by this call.

The repo add_errata command takes following arguments:

Name Flag Description
ID --id Target repository ID to add the errata.
Errata ID -e or --errata Errata ID to add to this repository.
Source ID --source Source repository with specified errata to perform add.
Assume Yes -y or --assumeyes Assume yes; automatically process dependencies as part of add operation.
Recursive -r or --recursive Recursively lookup the dependency list; defaults to one level of lookup.

Example: Add an errata from source to target repository (top level dependency resolution)

 $ pulp-admin repo add_errata --id=test17 --source=f13-updates -e  FEDORA-2010-5816

Example: Add an errata from source to target repository (recursive)

pulp-admin repo add_errata --id=test17 --source=f13-updates -e FEDORA-2010-5816 -r

Remove Errata

Dis-associate an erratum from repository. When remove_errata is invoked, an errata and its associated packages are selected from a repository and removed. During this process, a dependency lookup happens for the requested package(s) and the call provides a suggestive option to choose to any dependencies required by this call.

The repo delete_errata command takes following arguments:

Name Flag Description
ID --id Target repository Id to delete the errata from.
Errata ID -e or --errata Errata Id to delete from this repository.
Assume Yes -y or --assumeyes Assume yes; automatically process dependencies as part of delete operation.
Recursive -r or --recursive Recursively lookup the dependency list; defaults to one level of lookup.

Example: Remove an errata from repository (top level dependency resolution)

$ pulp-admin repo remove_errata --id test17 -e  FEDORA-2010-5816

Example: Remove an errata from repository (recursive)

$ pulp-admin repo remove_errata --id test17 -e FEDORA-2010-5816 -r