com.redhat.rhn.manager.errata

Class ErrataManager

java.lang.Object

com.redhat.rhn.manager.BaseManager

com.redhat.rhn.manager.errata.ErrataManager

public class ErrataManager
extends BaseManager

ErrataManager is the singleton class used to provide business operations on Errata, where those operations interact with other top tier business objects. Operations that require changes to the Errata.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DATE_FORMAT_PARSE_STRING
static long	MAX_ADVISORY_RELEASE

Method Summary

Modifier and Type	Method and Description
static Errata	addChannelsToErrata(Errata errata, java.util.Collection<java.lang.Long> channelIds, User user) Add the channels in the channelIds set to the passed in errata.
static void	addErrataChannelNotifications(java.lang.Long eid, java.lang.Long cid) delete any present and then enqueue a channel notification for the given channel and erratum.
static void	addErrataNotification(Errata e, Channel chan, java.util.Date date) Send errata notifications for a particular errata and channel
static boolean	advisoryNameIsUnique(java.lang.Long eid, java.lang.String name, Org org) Sees if there is an errata with the same advisory name as the errata with eid
static java.util.List<java.lang.String>	advisorySeverityLabels() Returns a list of l10n-ed advisory severity types available for an errata
static java.util.List<java.lang.Integer>	advisorySeverityRanks() Returns a list of advisory severity ranks available for an errata
static java.util.Map<java.lang.String,java.lang.String>	advisorySeverityUntranslatedLabels() Returns untranslated severity labels
static java.util.List<java.lang.String>	advisoryTypeLabels() Returns a list of l10n-ed advisory types available for an errata
static java.util.List<java.lang.String>	advisoryTypes() Returns a list of advisory types available for an errata
static DataResult	affectedChannels(User user, java.lang.Long eid) Returns a list of available channels affected by an errata
static DataResult	allErrata(User user) Returns all of the errata.
static DataResult	allErrataByType(User user, java.lang.String type) Returns all of the errata of specified advisory type.
static DataResult	allSecurityErrata(User user) Returns all of the security errata
static DataResult	applicableChannels(java.lang.Long eid, java.lang.Long orgid, PageControl pc, java.lang.Class clazz) Get a list of channels applicable to the erratum
static java.util.List<java.lang.Long>	applyErrata(User user, java.util.List errataIds, java.util.Date earliest, ActionChain actionChain, java.util.List<java.lang.Long> serverIds) Apply a list of errata to a list of servers, with an optional Action Chain.
static java.util.List<java.lang.Long>	applyErrata(User user, java.util.List errataIds, java.util.Date earliest, java.util.List<java.lang.Long> serverIds) Apply a list of errata to a list of servers.
static java.util.List<java.lang.Long>	applyErrataHelper(User loggedInUser, java.util.List<java.lang.Long> systemIds, java.util.List<java.lang.Integer> errataIds, java.util.Date earliestOccurrence) Apply errata updates to a system list at a specified time.
static DataResult	bugsFixed(java.lang.Long eid) Returns a list of bugs fixed by an errata
static boolean	channelHasPendingAsyncCloneJobs(Channel channel) Check if the channel has pending asynchronous errata clone jobs
static void	clearErrataChannelNotifications(Errata e, Channel c) Delete all errata notifications for an errata in specified channel
static void	clearErrataNotifications(Errata e) Delete all errata notifications for an errata
static DataResult	clonableErrata(java.lang.Long orgid, boolean showCloned) Get List of all cloneable errata for an org
static DataResult	clonableErrataForChannel(java.lang.Long orgid, java.lang.Long cid, boolean showCloned) Get List of cloneable Errata for an org, from a particular channel
static java.util.Set<java.lang.Long>	cloneChannelErrata(java.util.List<ErrataOverview> toClone, java.lang.Long toCid, User user) Clone errata as necessary and link cloned errata with new channel.
static void	cloneChannelErrata(java.lang.Long fromCid, java.lang.Long toCid, User user) Clone errata as necessary and link cloned errata with new channel.
static java.lang.Object[]	cloneErrataApi(Channel chan, java.util.Collection<Errata> errata, User user, boolean inheritPackages) Clone errata to a channel
static java.lang.Object[]	cloneErrataApi(Channel chan, java.util.Collection<Errata> errata, User user, boolean inheritPackages, boolean performPostActions) Clone errata to a channel
static void	cloneErrataApiAsync(Channel chan, java.util.List<java.lang.Long> errata, User user, boolean inheritPackages) Clone errata to a channel asynchronously
static Errata	createClone(User user, Errata e) Create a clone of the errata
static Errata	createNewErrata() Creates a new (Unpublished) Errata object.
static Bug	createNewPublishedBug(java.lang.Long id, java.lang.String summary, java.lang.String url) Creates a new PublishedBug with the id and summary given.
static Bug	createNewUnpublishedBug(java.lang.Long id, java.lang.String summary, java.lang.String url) Creates a new Unpublished Bug with the id and summary given.
static void	deleteErratum(User user, Errata errata) Deletes a single erratum
static void	deletePublishedErrata(User user, java.lang.String label) Delete published errata in the set named as label
static void	deleteUnpublishedErrata(User user, java.lang.String label) Delete unpublished errata in the set named as label
static DataResult	errataCVEs(java.lang.Long eid) Returns a list of CVEs for an errata
static DataResult	errataInChannel(java.lang.Long cid) Returns all of the errata in a channel
static DataResult<ErrataOverview>	errataInSet(User user, java.lang.String setLabel) Return a list of errata overview objects contained in a set
static DataResult	keywords(java.lang.Long eid) Returns a list of keywords for an errata
protected static java.util.List<ChannelOverview>	listChannelForErrataFromSet(RhnSet set) Get a list of channel ids, and labels that a list of errata belongs to.
static DataResult<PackageOverview>	listErrataChannelPacks(Channel customChan, Errata errata, User user) Lists the packages contained in an errata associated to a channel
static java.util.List<java.lang.Long>	listErrataIdsIssuedBetween(java.lang.String start, java.lang.String end) Finds the errata ids issued between start and end dates.
static java.util.List	listErrataNotifications(Errata e) List queued errata notifications
static java.util.List	listPublishedBrothersInChannels(User user, Channel channelFrom, Channel channelTo) Lists errata from channelFrom, that are cloned from the same original as errata in channelTo
static java.util.List	listPublishedClonesInChannels(User user, Channel channelFrom, Channel channelTo) Lists errata from channelFrom, that have clones in channelTo
static java.util.List	listSamePublishedInChannels(User user, Channel channelFrom, Channel channelTo) Lists errata present in both channels
static DataResult<Bug>	lookupBugsForErratum(java.lang.Long erratumId) Finds the bugs associated with an erratum
static Errata	lookupByAdvisory(java.lang.String advisoryName, Org org) Returns the errata with the given advisory name
static java.util.List	lookupByCVE(java.lang.String cve) Looks up errata by CVE string
static java.util.List	lookupByOriginal(User user, Errata original) Lookup all the clones of a particular errata looks up unpublished first, and then if none of those exist, it looks up published ones
static DataResult<CVE>	lookupCvesForErratum(java.lang.Long erratumId) Finds the cves associated with an erratum
static Errata	lookupErrata(java.lang.Long eid, User user) Returns the errata with given id
static java.util.List	lookupErrataByIdentifier(java.lang.String identifier, Org org) Tries to locate errata based on either the errataum's id or the CVE/CAN identifier string.
static java.util.List	lookupErrataByType(java.lang.String advisoryType) Lookup all Errata by Advisory Type
static java.util.List<java.lang.String>	lookupKeywordsForErratum(java.lang.Long erratumId) Finds the keywords associated with an erratum
static DataResult<PackageOverview>	lookupPacksFromErrataForChannel(Channel customChan, Errata errata, User user) Finds the packages contained in an errata that apply to a channel
static DataResult<PackageDto>	lookupPacksFromErrataForChannel(java.lang.Long channelId, java.lang.Long errataId) Finds the packages contained in an errata that apply to a channel
static DataResult<PackageOverview>	lookupPacksFromErrataSet(Channel srcChan, Channel destChan, User user, java.lang.String set) Lookup packages that are associated with errata in the RhnSet "errata_list"
static java.util.List	lookupPublishedByOriginal(User user, Errata original) Lookup all the clones of a particular errata
static Errata	lookupPublishedErrata(java.lang.Long id) Looks up published errata by errata id
static DataResult<ErrataOverview>	lookupSelectedErrataInSystemSet(User user, java.lang.String setLabel) Lookup errata that are in the set and relevant to selected systems (in SSM)
static Errata	publish(Errata unpublished) Takes an unpublished errata and returns a published errata
static Errata	publish(Errata unpublished, java.util.Collection channelIds, User user) Takes an unpublished errata and returns a published errata into the channels we pass in.
static DataResult	publishedInSet(User user, PageControl pc, java.lang.String label) Returns all of the published errata.
static DataResult	publishedOwnedErrata(User user) Returns all of the published errata.
static void	publishErrataToChannelAsync(Channel chan, java.util.Collection<java.lang.Long> errataIds, User user) Publish errata to a channel asynchronously (cloning as necessary), does not do any package push
static DataResult	relevantErrata(ManagedServerGroup serverGroup) Returns errata relevant to given server group.
static DataResult	relevantErrata(User user) Returns the relevant errata.
static DataResult	relevantErrataByType(User user, PageControl pc, java.lang.String typeIn) Returns the relevant errata.
static DataResult	relevantErrataToSystemSet(User user, java.util.List<java.lang.String> types) Returns the relevant errata to the system set (used in SSM).
static DataResult	relevantSecurityErrata(User user, PageControl pc) Returns the relevant security errata.
static DataResult	relevantSystemsInSet(User user, java.lang.String label, java.lang.Long eid, PageControl pc) Returns the systems in the current set that are affected by an errata
static void	removeErratumFromChannel(Errata errata, Channel chan, User user) remove an erratum for a channel and updates the errata cache accordingly
static java.util.List	resolveOvalFiles(java.util.List errataFiles) Converts a list of ErrataFile instances into java.io.File instances If a corresponding java.io.File instance is not found for a given ErrataFile instance then it is skipped and not added to the returned list.
static java.util.List<ErrataOverview>	search(java.util.List eids, Org org) Returns a list of ErrataOverview matching the given errata ids.
static java.util.List<ErrataOverview>	searchByPackageIds(java.util.List pids) Returns a list of ErrataOverview whose errata contains the packages with the given pids.
static java.util.List<ErrataOverview>	searchByPackageIdsWithOrg(java.util.List pids, Org org) Returns a list of ErrataOverview whose errata contains the packages with the given pids.
static DataResult	selectedForCloning(User user, PageControl pc) Returns all errata selected for cloning.
static void	storeErrata(Errata errataIn) Stores an errata to the db
static DataResult<SystemOverview>	systemsAffected(User user, java.lang.Long eid, PageControl pc) Returns the systems affected by a given errata
static DataResult<SystemOverview>	systemsAffected(User user, ManagedServerGroup serverGroup, Errata erratum, PageControl pc) Returns the systems affected by a given errata
static DataResult<SystemOverview>	systemsAffectedInSet(User user, java.lang.Long eid, PageControl pc) Returns the systems affected by a given errata
static DataResult	systemsAffectedXmlRpc(User user, java.lang.Long eid) Returns the system id and system names of the systems affected by a given errata
static DataResult	unpublishedInSet(User user, PageControl pc, java.lang.String label) Returns all of the unpublished errata in the given set.
static DataResult	unpublishedOwnedErrata(User user) Returns all of the unpublished errata.
static DataResult	unpublishedOwnedErrata(User user, java.lang.Class clazz) Returns all of the unpublished errata.

Methods inherited from class com.redhat.rhn.manager.BaseManager

makeDataResult, makeDataResult, makeDataResult, makeDataResult, makeDataResultNoPagination, makeDataResultNoPagination, processListControl, processPageControl

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DATE_FORMAT_PARSE_STRING

public static final java.lang.String DATE_FORMAT_PARSE_STRING

See Also:

Constant Field Values

MAX_ADVISORY_RELEASE

public static final long MAX_ADVISORY_RELEASE

See Also:

Constant Field Values

Method Detail

resolveOvalFiles

public static java.util.List resolveOvalFiles(java.util.List errataFiles)

Converts a list of ErrataFile instances into java.io.File instances If a corresponding java.io.File instance is not found for a given ErrataFile instance then it is skipped and not added to the returned list.

Parameters:

errataFiles - list of files to resolve

Returns:

list of corresponding java.io.File instances

lookupErrataByIdentifier

public static java.util.List lookupErrataByIdentifier(java.lang.String identifier,
                                                      Org org)

Tries to locate errata based on either the errataum's id or the CVE/CAN identifier string.

Parameters:

identifier - erratum id or CVE/CAN id string

org - User organization

Returns:

list of erratas found

publish

public static Errata publish(Errata unpublished,
                             java.util.Collection channelIds,
                             User user)

Takes an unpublished errata and returns a published errata into the channels we pass in. NOTE: This method does NOT update the errata cache for the channels. That is done when packages are pushed as part of the errata publication process (which is not done here)

Parameters:

unpublished - The errata to publish

channelIds - The Long channelIds we want to publish this Errata to.

user - who is publishing errata

Returns:

Returns a published errata.

publish

public static Errata publish(Errata unpublished)

Takes an unpublished errata and returns a published errata

Parameters:

unpublished - The errata to publish

Returns:

Returns a published errata.

addChannelsToErrata

public static Errata addChannelsToErrata(Errata errata,
                                         java.util.Collection<java.lang.Long> channelIds,
                                         User user)

Add the channels in the channelIds set to the passed in errata.

Parameters:

errata - to add channels to

channelIds - to add

user - who is adding channels to errata

Returns:

Errata that is reloaded from the DB.

createNewErrata

public static Errata createNewErrata()

Creates a new (Unpublished) Errata object.

Returns:

Returns a fresh errata

createNewUnpublishedBug

public static Bug createNewUnpublishedBug(java.lang.Long id,
                                          java.lang.String summary,
                                          java.lang.String url)

Creates a new Unpublished Bug with the id and summary given.

Parameters:

id - The id for the new bug.

summary - The summary for the new bug.

url - The url for the new bug.

Returns:

Returns a Bug object.

createNewPublishedBug

public static Bug createNewPublishedBug(java.lang.Long id,
                                        java.lang.String summary,
                                        java.lang.String url)

Creates a new PublishedBug with the id and summary given.

Parameters:

id - The id for the new bug

summary - The summary for the new bug

url - The url for the new bug.

Returns:

Returns a Bug object

allErrata

public static DataResult allErrata(User user)

Returns all of the errata.

Parameters:

user - Currently logged in user.

Returns:

all of the errata.

allErrataByType

public static DataResult allErrataByType(User user,
                                         java.lang.String type)

Returns all of the errata of specified advisory type.

Parameters:

user - Currently logged in user.

type - advisory type

Returns:

all errata of specified advisory type

allSecurityErrata

public static DataResult allSecurityErrata(User user)

Returns all of the security errata

Parameters:

user - Currently logged in user.

Returns:

all security errata

errataInChannel

public static DataResult errataInChannel(java.lang.Long cid)

Returns all of the errata in a channel

Parameters:

cid - the channel id

Returns:

all of the errata in the channel.

searchByPackageIds

public static java.util.List<ErrataOverview> searchByPackageIds(java.util.List pids)

Returns a list of ErrataOverview whose errata contains the packages with the given pids.

Parameters:

pids - list of package ids whose errata are sought.

Returns:

a list of ErrataOverview whose errata contains the packages with the given pids.

searchByPackageIdsWithOrg

public static java.util.List<ErrataOverview> searchByPackageIdsWithOrg(java.util.List pids,
                                                                       Org org)

Returns a list of ErrataOverview whose errata contains the packages with the given pids.

Parameters:

pids - list of package ids whose errata are sought.

org - Organization to match results with

Returns:

a list of ErrataOverview whose errata contains the packages with the given pids.

search

public static java.util.List<ErrataOverview> search(java.util.List eids,
                                                    Org org)

Returns a list of ErrataOverview matching the given errata ids.

Parameters:

eids - Errata ids sought.

org - Organization to match results with

Returns:

a list of ErrataOverview matching the given errata ids.

relevantErrata

public static DataResult relevantErrata(ManagedServerGroup serverGroup)

Returns errata relevant to given server group.

Parameters:

serverGroup - Server group.

Returns:

Relevant errata for server group.

relevantErrataToSystemSet

public static DataResult relevantErrataToSystemSet(User user,
                                                   java.util.List<java.lang.String> types)

Returns the relevant errata to the system set (used in SSM).

Parameters:

user - Currently logged in user.

types - List of errata types to include

Returns:

relevant errata.

relevantErrata

public static DataResult relevantErrata(User user)

Returns the relevant errata.

Parameters:

user - Currently logged in user.

Returns:

relevant errata.

relevantErrataByType

public static DataResult relevantErrataByType(User user,
                                              PageControl pc,
                                              java.lang.String typeIn)

Returns the relevant errata.

Parameters:

user - Currently logged in user.

pc - PageControl

typeIn - String type of errata. See ErrataFactory.ERRATA_TYPE_*

Returns:

relevant errata.

relevantSecurityErrata

public static DataResult relevantSecurityErrata(User user,
                                                PageControl pc)

Returns the relevant security errata.

Parameters:

user - Currently logged in user.

pc - PageControl

Returns:

relevant errata.

unpublishedOwnedErrata

public static DataResult unpublishedOwnedErrata(User user)

Returns all of the unpublished errata.

Parameters:

user - Currently logged in user.

Returns:

all of the errata.

unpublishedOwnedErrata

public static DataResult unpublishedOwnedErrata(User user,
                                                java.lang.Class clazz)

Returns all of the unpublished errata.

Parameters:

user - Currently logged in user.

clazz - The class you would like the return values represented as

Returns:

all of the errata.

unpublishedInSet

public static DataResult unpublishedInSet(User user,
                                          PageControl pc,
                                          java.lang.String label)

Returns all of the unpublished errata in the given set.

Parameters:

user - Currently logged in user.

pc - PageControl

label - Set label

Returns:

all of the errata.

publishedOwnedErrata

public static DataResult publishedOwnedErrata(User user)

Returns all of the published errata.

Parameters:

user - Currently logged in user.

Returns:

all of the errata.

publishedInSet

public static DataResult publishedInSet(User user,
                                        PageControl pc,
                                        java.lang.String label)

Returns all of the published errata.

Parameters:

user - Currently logged in user.

pc - PageControl

label - Set label

Returns:

all of the errata.

selectedForCloning

public static DataResult selectedForCloning(User user,
                                            PageControl pc)

Returns all errata selected for cloning.

Parameters:

user - Currently logged in user.

pc - PageControl

Returns:

errata selected for cloning

errataInSet

public static DataResult<ErrataOverview> errataInSet(User user,
                                                     java.lang.String setLabel)

Return a list of errata overview objects contained in a set

Parameters:

user - the user doing the lookup

setLabel - the set

Returns:

the set of ErrataOverview

deletePublishedErrata

public static void deletePublishedErrata(User user,
                                         java.lang.String label)

Delete published errata in the set named as label

Parameters:

user - User performing the operation

label - name of the set that contains the id's of the errata to be deleted

deleteUnpublishedErrata

public static void deleteUnpublishedErrata(User user,
                                           java.lang.String label)

Delete unpublished errata in the set named as label

Parameters:

user - User performing the operation

label - name of the set that contains the id's of the errata to be deleted

deleteErratum

public static void deleteErratum(User user,
                                 Errata errata)

Deletes a single erratum

Parameters:

user - doing the deleting

errata - The erratum for deletion

listChannelForErrataFromSet

protected static java.util.List<ChannelOverview> listChannelForErrataFromSet(RhnSet set)

Get a list of channel ids, and labels that a list of errata belongs to.

Parameters:

set - the set of errata ids to retrieve channels for

Returns:

list of Channel OVerview Objects

lookupErrata

public static Errata lookupErrata(java.lang.Long eid,
                                  User user)

Returns the errata with given id

Parameters:

eid - errata id

user - The user performing the lookup

Returns:

Errata the requested errata

lookupByAdvisory

public static Errata lookupByAdvisory(java.lang.String advisoryName,
                                      Org org)

Returns the errata with the given advisory name

Parameters:

advisoryName - The advisory name of the errata you're looking for

org - User organization

Returns:

Returns the requested Errata

lookupByCVE

public static java.util.List lookupByCVE(java.lang.String cve)

Looks up errata by CVE string

Parameters:

cve - errata's CVE string

Returns:

Errata if found, otherwise null

lookupErrataByType

public static java.util.List lookupErrataByType(java.lang.String advisoryType)

Lookup all Errata by Advisory Type

Parameters:

advisoryType - the advisory type to use to query the set of Errata

Returns:

List of Errata found

lookupPublishedErrata

public static Errata lookupPublishedErrata(java.lang.Long id)

Looks up published errata by errata id

Parameters:

id - errata id

Returns:

Errata if found, otherwise null

systemsAffected

public static DataResult<SystemOverview> systemsAffected(User user,
                                                         java.lang.Long eid,
                                                         PageControl pc)

Returns the systems affected by a given errata

Parameters:

user - The current user

eid - The errata id

pc - PageControl

Returns:

systems affected by current errata

systemsAffected

public static DataResult<SystemOverview> systemsAffected(User user,
                                                         ManagedServerGroup serverGroup,
                                                         Errata erratum,
                                                         PageControl pc)

Returns the systems affected by a given errata

Parameters:

user - Logged-in user.

serverGroup - Server group.

erratum - Errata ID.

pc - PageControl

Returns:

systems Affected by current errata, that are in serverGroup.

systemsAffectedInSet

public static DataResult<SystemOverview> systemsAffectedInSet(User user,
                                                              java.lang.Long eid,
                                                              PageControl pc)

Returns the systems affected by a given errata

Parameters:

user - Logged-in user.

eid - Errata ID.

pc - PageControl

Returns:

systems Affected by current errata, that are in the set of SSM.

systemsAffectedXmlRpc

public static DataResult systemsAffectedXmlRpc(User user,
                                               java.lang.Long eid)

Returns the system id and system names of the systems affected by a given errata

Parameters:

user - The logged in user

eid - The id of the errata in question

Returns:

Returns the system id and system names of the systems affected by a given errata

relevantSystemsInSet

public static DataResult relevantSystemsInSet(User user,
                                              java.lang.String label,
                                              java.lang.Long eid,
                                              PageControl pc)

Returns the systems in the current set that are affected by an errata

Parameters:

user - The current user

label - The name of the set

eid - Errata id

pc - PageControl

Returns:

DataResult of systems

affectedChannels

public static DataResult affectedChannels(User user,
                                          java.lang.Long eid)

Returns a list of available channels affected by an errata

Parameters:

user - The user (to determine available channels)

eid - The errata id

Returns:

channels affected

bugsFixed

public static DataResult bugsFixed(java.lang.Long eid)

Returns a list of bugs fixed by an errata

Parameters:

eid - The errata id

Returns:

bugs fixed

errataCVEs

public static DataResult errataCVEs(java.lang.Long eid)

Returns a list of CVEs for an errata

Parameters:

eid - The errata id

Returns:

common vulnerabilities and exposures

keywords

public static DataResult keywords(java.lang.Long eid)

Returns a list of keywords for an errata

Parameters:

eid - The errata id

Returns:

keywords

advisoryTypes

public static java.util.List<java.lang.String> advisoryTypes()

Returns a list of advisory types available for an errata

Returns:

advisory types

advisoryTypeLabels

public static java.util.List<java.lang.String> advisoryTypeLabels()

Returns a list of l10n-ed advisory types available for an errata

Returns:

l10n-ed advisory type labels

advisorySeverityLabels

public static java.util.List<java.lang.String> advisorySeverityLabels()

Returns a list of l10n-ed advisory severity types available for an errata

Returns:

l10n-ed advisory severity labels

advisorySeverityUntranslatedLabels

public static java.util.Map<java.lang.String,java.lang.String> advisorySeverityUntranslatedLabels()

Returns untranslated severity labels

Returns:

Untranslated advisory severity labels

advisorySeverityRanks

public static java.util.List<java.lang.Integer> advisorySeverityRanks()

Returns a list of advisory severity ranks available for an errata

Returns:

advisory severity ranks

storeErrata

public static void storeErrata(Errata errataIn)

Stores an errata to the db

Parameters:

errataIn - The errata to store.

advisoryNameIsUnique

public static boolean advisoryNameIsUnique(java.lang.Long eid,
                                           java.lang.String name,
                                           Org org)

Sees if there is an errata with the same advisory name as the errata with eid

Parameters:

eid - The id of the errata you're checking

name - The advisory name you're checking

org - User organization

Returns:

Returns true if no other errata exists with the same advisoryName, false otherwise.

clonableErrata

public static DataResult clonableErrata(java.lang.Long orgid,
                                        boolean showCloned)

Get List of all cloneable errata for an org

Parameters:

orgid - org we want to lookup against

showCloned - whether we should show errata that have already been cloned

Returns:

List of cloneableErrata

clonableErrataForChannel

public static DataResult clonableErrataForChannel(java.lang.Long orgid,
                                                  java.lang.Long cid,
                                                  boolean showCloned)

Get List of cloneable Errata for an org, from a particular channel

Parameters:

orgid - org we want to lookup against

cid - channelid

showCloned - whether we should show errata that have already been cloned

Returns:

List of cloneableErrata

applicableChannels

public static DataResult applicableChannels(java.lang.Long eid,
                                            java.lang.Long orgid,
                                            PageControl pc,
                                            java.lang.Class clazz)

Get a list of channels applicable to the erratum

Parameters:

eid - The id of the erratum

orgid - The id for the org we want to lookup against

pc - The page control for the user

clazz - The class you would like the return values represented as

Returns:

List of applicable channels for the erratum (that the org has access to)

createClone

public static Errata createClone(User user,
                                 Errata e)

Create a clone of the errata

Parameters:

user - user performing the cloning

e - errata to be cloned

Returns:

clone of the errata

lookupByOriginal

public static java.util.List lookupByOriginal(User user,
                                              Errata original)

Lookup all the clones of a particular errata looks up unpublished first, and then if none of those exist, it looks up published ones

Parameters:

user - User that is performing the cloning operation

original - Original errata that the clones are clones of

Returns:

list of clones of the errata

lookupPublishedByOriginal

public static java.util.List lookupPublishedByOriginal(User user,
                                                       Errata original)

Lookup all the clones of a particular errata

Parameters:

user - User that is performing the cloning operation

original - Original errata that the clones are clones of

Returns:

list of clones of the errata

listSamePublishedInChannels

public static java.util.List listSamePublishedInChannels(User user,
                                                         Channel channelFrom,
                                                         Channel channelTo)

Lists errata present in both channels

Parameters:

user - user

channelFrom - channel1

channelTo - channel2

Returns:

list of errata

listPublishedBrothersInChannels

public static java.util.List listPublishedBrothersInChannels(User user,
                                                             Channel channelFrom,
                                                             Channel channelTo)

Lists errata from channelFrom, that are cloned from the same original as errata in channelTo

Parameters:

user - user

channelFrom - channel1

channelTo - channel2

Returns:

list of errata

listPublishedClonesInChannels

public static java.util.List listPublishedClonesInChannels(User user,
                                                           Channel channelFrom,
                                                           Channel channelTo)

Lists errata from channelFrom, that have clones in channelTo

Parameters:

user - user

channelFrom - channel1

channelTo - channel2

Returns:

list of errata

lookupPacksFromErrataSet

public static DataResult<PackageOverview> lookupPacksFromErrataSet(Channel srcChan,
                                                                   Channel destChan,
                                                                   User user,
                                                                   java.lang.String set)

Lookup packages that are associated with errata in the RhnSet "errata_list"

Parameters:

srcChan - the source channel to find the package associations with

destChan - if srcChan is not available, we will match package associations based on packages in the destChan

user - the user doing the query

set - the set label

Returns:

List of packages

lookupSelectedErrataInSystemSet

public static DataResult<ErrataOverview> lookupSelectedErrataInSystemSet(User user,
                                                                         java.lang.String setLabel)

Lookup errata that are in the set and relevant to selected systems (in SSM)

Parameters:

user - the user to search the set for

setLabel - the set label

Returns:

list of Errata Overview Objects

lookupPacksFromErrataForChannel

public static DataResult<PackageOverview> lookupPacksFromErrataForChannel(Channel customChan,
                                                                          Errata errata,
                                                                          User user)

Finds the packages contained in an errata that apply to a channel

Parameters:

customChan - the channel to look in

errata - the errata to look for packs with

user - the user doing the request.

Returns:

collection of PackageOverview objects

lookupPacksFromErrataForChannel

public static DataResult<PackageDto> lookupPacksFromErrataForChannel(java.lang.Long channelId,
                                                                     java.lang.Long errataId)

Finds the packages contained in an errata that apply to a channel

Parameters:

channelId - the channel to look in

errataId - the errata to look for packs with

Returns:

collection of PackageDto objects

lookupBugsForErratum

public static DataResult<Bug> lookupBugsForErratum(java.lang.Long erratumId)

Finds the bugs associated with an erratum

Parameters:

erratumId - the erratum to look for

Returns:

collection of Bug (dto) objects

lookupCvesForErratum

public static DataResult<CVE> lookupCvesForErratum(java.lang.Long erratumId)

Finds the cves associated with an erratum

Parameters:

erratumId - the erratum to look for

Returns:

collection of cves (String)

lookupKeywordsForErratum

public static java.util.List<java.lang.String> lookupKeywordsForErratum(java.lang.Long erratumId)

Finds the keywords associated with an erratum

Parameters:

erratumId - the erratum to look for

Returns:

collection of keywords (String)

listErrataChannelPacks

public static DataResult<PackageOverview> listErrataChannelPacks(Channel customChan,
                                                                 Errata errata,
                                                                 User user)

Lists the packages contained in an errata associated to a channel

Parameters:

customChan - the channel to look in

errata - the errata to look for packs with

user - the user doing the request.

Returns:

collection of PackageOverview objects

listErrataIdsIssuedBetween

public static java.util.List<java.lang.Long> listErrataIdsIssuedBetween(java.lang.String start,
                                                                        java.lang.String end)

Finds the errata ids issued between start and end dates.

Parameters:

start - String start date

end - String end date

Returns:

errata ids issued between start -> end

removeErratumFromChannel

public static void removeErratumFromChannel(Errata errata,
                                            Channel chan,
                                            User user)

remove an erratum for a channel and updates the errata cache accordingly

Parameters:

errata - the errata to remove

chan - the channel to remove the erratum from

user - the user doing the removing

publishErrataToChannelAsync

public static void publishErrataToChannelAsync(Channel chan,
                                               java.util.Collection<java.lang.Long> errataIds,
                                               User user)

Publish errata to a channel asynchronously (cloning as necessary), does not do any package push

Parameters:

chan - the channel

errataIds - list of errata ids

user - the user doing the push

cloneErrataApi

public static java.lang.Object[] cloneErrataApi(Channel chan,
                                                java.util.Collection<Errata> errata,
                                                User user,
                                                boolean inheritPackages)

Clone errata to a channel

Parameters:

chan - the channel

errata - list of errata ids

user - the user doing the push

inheritPackages - inherit packages from the original bug (instaed of the clone in the case of a clone of a clone)

Returns:

an array of Errata that have been published

cloneErrataApi

public static java.lang.Object[] cloneErrataApi(Channel chan,
                                                java.util.Collection<Errata> errata,
                                                User user,
                                                boolean inheritPackages,
                                                boolean performPostActions)

Clone errata to a channel

Parameters:

chan - the channel

errata - list of errata ids

user - the user doing the push

inheritPackages - inherit packages from the original bug (instaed of the clone in the case of a clone of a clone)

performPostActions - true (default) if you want to refresh newest package cache and schedule repomd regeneration. False only if you're going to do those things yourself.

Returns:

an array of Errata that have been published

cloneChannelErrata

public static void cloneChannelErrata(java.lang.Long fromCid,
                                      java.lang.Long toCid,
                                      User user)

Clone errata as necessary and link cloned errata with new channel. Warning: this does not clone packages or schedule channel repomd regeneration. You must do that yourself!

Parameters:

fromCid - id of old channel

toCid - id of channel to clone into

user - the requesting user

cloneChannelErrata

public static java.util.Set<java.lang.Long> cloneChannelErrata(java.util.List<ErrataOverview> toClone,
                                                               java.lang.Long toCid,
                                                               User user)

Clone errata as necessary and link cloned errata with new channel. Warning: this does not clone packages or schedule channel repomd regeneration. You must do that yourself!

Parameters:

toClone - List of ErrataOverview to clone

toCid - Channel id to clone them into

user - the requesting user

Returns:

list of errata ids that were published into channel

cloneErrataApiAsync

public static void cloneErrataApiAsync(Channel chan,
                                       java.util.List<java.lang.Long> errata,
                                       User user,
                                       boolean inheritPackages)

Clone errata to a channel asynchronously

Parameters:

chan - the channel

errata - list of errata ids

user - the user doing the push

inheritPackages - inherit packages from the original bug (instead of the clone in the case of a clone of a clone)

channelHasPendingAsyncCloneJobs

public static boolean channelHasPendingAsyncCloneJobs(Channel channel)

Check if the channel has pending asynchronous errata clone jobs

Parameters:

channel - channel to check

Returns:

true if there are pending jobs, false otherwise

addErrataNotification

public static void addErrataNotification(Errata e,
                                         Channel chan,
                                         java.util.Date date)

Send errata notifications for a particular errata and channel

Parameters:

e - the errata to send notifications about

chan - the channel with which to decide which systems and users to send errata for

date - the date

clearErrataNotifications

public static void clearErrataNotifications(Errata e)

Delete all errata notifications for an errata

Parameters:

e - the errata to clear notifications for

addErrataChannelNotifications

public static void addErrataChannelNotifications(java.lang.Long eid,
                                                 java.lang.Long cid)

delete any present and then enqueue a channel notification for the given channel and erratum. This will trigger the taskomatic ErrataQueue task to take a look, ensuring things like auto-errata-updates.

Parameters:

eid - the errata to enqueue

cid - affected channel

clearErrataChannelNotifications

public static void clearErrataChannelNotifications(Errata e,
                                                   Channel c)

Delete all errata notifications for an errata in specified channel

Parameters:

e - the errata to clear notifications for

c - affected channel

listErrataNotifications

public static java.util.List listErrataNotifications(Errata e)

List queued errata notifications

Parameters:

e - the errata

Returns:

list of maps

applyErrataHelper

public static java.util.List<java.lang.Long> applyErrataHelper(User loggedInUser,
                                                               java.util.List<java.lang.Long> systemIds,
                                                               java.util.List<java.lang.Integer> errataIds,
                                                               java.util.Date earliestOccurrence)

Apply errata updates to a system list at a specified time.

Parameters:

loggedInUser - The logged in user

systemIds - list of system IDs

errataIds - List of errata IDs to apply (as Integers)

earliestOccurrence - Earliest occurrence of the errata update

Returns:

list of action ids

applyErrata

public static java.util.List<java.lang.Long> applyErrata(User user,
                                                         java.util.List errataIds,
                                                         java.util.Date earliest,
                                                         java.util.List<java.lang.Long> serverIds)

Apply a list of errata to a list of servers.

Parameters:

user - user

errataIds - errata ids

earliest - schedule time

serverIds - server ids

Returns:

list of action ids

applyErrata

public static java.util.List<java.lang.Long> applyErrata(User user,
                                                         java.util.List errataIds,
                                                         java.util.Date earliest,
                                                         ActionChain actionChain,
                                                         java.util.List<java.lang.Long> serverIds)

Apply a list of errata to a list of servers, with an optional Action Chain. Note that not all erratas are applied to all systems. Systems get only the erratas relevant for them.

Parameters:

user - user

errataIds - errata ids

earliest - schedule time

actionChain - the action chain to add the action to or null

serverIds - server ids

Returns:

list of action ids