com.redhat.rhn.manager.action

Class ActionManager

java.lang.Object

com.redhat.rhn.manager.BaseManager

com.redhat.rhn.manager.action.ActionManager

public class ActionManager
extends BaseManager

ActionManager - the singleton class used to provide Business Operations on Actions where those operations interact with other top tier Business Objects. Operations that require the Action make changes to

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String[]	PACKAGES_NOT_REMOVABLE

Method Summary

Modifier and Type	Method and Description
static void	addConfigurationRevisionsToAction(User user, java.util.Collection<java.lang.Long> revisions, ConfigAction configAction, Server server) Adds configuration revisions to a ConfigurationAction object
static void	addPackageActionDetails(Action action, java.util.List packages) Adds package details to an Action
static void	addServerToAction(java.lang.Long sid, Action action) Adds a server to an action
static void	addServerToAction(Server server, Action action) Adds a server to an action
static DataResult	allActions(User user, PageControl pc) Retrieve the list of all actions for a particular user.
static void	archiveActions(User user, java.lang.String label) Archives the action set with the given label.
static DataResult	archivedActions(User user, PageControl pc) Retrieve the list of completed actions for a particular user
static void	cancelAction(User user, Action action) Cancels the server actions associated with a given action, and if required deals with associated pending kickstart actions.
static void	cancelActions(User user, java.util.List actionsToCancel) Cancels all actions in given list.
static void	checkConfigActionOnServer(ActionType type, Server server) Checks that a server can be the target of a ConfigAction
static void	checkScriptingOnServers(java.util.List<java.lang.Long> sids) Checks that ScriptRunActions can be run on the servers with specified IDs.
static DataResult	completedActions(User user, PageControl pc) Retrieve the list of completed actions for a particular user
static DataResult	completedSystems(User user, Action action, PageControl pc) Retrieves the systems that have completed a given action
static Action	createAction(User user, ActionType type, java.lang.String name, java.util.Date earliestAction) Creates, saves and returns a new Action
static Action	createBaseAction(User user, Server server, ActionType type)
static ConfigAction	createConfigAction(User user, ActionType type, java.util.Date earliest) Returns a new ConfigAction object
static Action	createConfigAction(User user, java.util.Collection<java.lang.Long> revisions, java.util.Collection<java.lang.Long> serverIds, ActionType type, java.util.Date earliest) Create a Config Action.
static Action	createConfigActionForServers(User user, java.util.Collection<java.lang.Long> revisions, java.util.Collection<Server> servers, ActionType type, java.util.Date earliest) Create a Config Action.
static Action	createConfigDiffAction(User user, java.util.Collection<java.lang.Long> revisions, java.util.Collection<java.lang.Long> serverIds) Create a Config File Diff action.
static Action	createConfigUploadAction(User user, java.util.Set filenames, Server server, ConfigChannel channel, java.util.Date earliest) Create a Config Upload action.
static Action	createDeployImageAction(User user, java.lang.String imageUrl, java.lang.Long vcpus, java.lang.Long memkb, java.lang.String bridge, ProxyConfig proxy) Schedule deployment of an image to a vhost.
static ErrataAction	createErrataAction(Org org, Errata errata) Creates an errata action with the specified Org
static Action	createErrataAction(User user, Errata errata) Creates an errata action
static ScriptActionDetails	createScript(java.lang.String username, java.lang.String groupname, java.lang.Long timeout, java.lang.String script) Creates a ScriptActionDetails which contains an arbitrary script to be run by a ScriptRunAction.
static void	deleteActions(User user, java.lang.String label) Deletes the action set with the given label.
static void	deleteActionsById(User user, java.util.List actionsIds) Deletes the archived actions
static DataResult	failedActions(User user, PageControl pc) Retrieve the list of failed actions for a particular user
static DataResult	failedSystems(User user, Action action, PageControl pc) Retrieves the systems that failed completing a given action
static int	failSystemAction(User loggedInUser, java.lang.Long serverId, java.lang.Long actionId, java.lang.String message) Mark action as failed for specified system
static java.lang.String	getActionName(ActionType type) Returns a name string from an Action type
static DataResult	getConfigFileDeployList(java.lang.Long aid) Returns the list of details associated with a config file deploy action.
static DataResult	getConfigFileDiffList(java.lang.Long aid) Returns the list of details associated with a config file diff action.
static DataResult	getConfigFileUploadList(java.lang.Long aid) Returns the list of details associated with a config file upload action.
static DataResult	getErrataList(java.lang.Long aid) Returns the list of errata associated with a specific action.
static DataResult	getPackageList(java.lang.Long aid, PageControl pc) Returns the list of packages associated with a specific action.
static DataResult	inProgressSystems(User user, Action action, PageControl pc) Retrieves the systems that are in the process of completing a given action
static Action	lookupAction(User user, java.lang.Long aid) Retreive the specified Action, assuming that the User making the request has the required permissions.
static Action	lookupLastCompletedAction(User user, ActionType type, Server server) Lookup the last completed Action on a Server given the user, action type and server.
static DataResult	pendingActions(User user, PageControl pc) Retrieve the list of pending actions for a particular user
static DataResult	pendingActionsInSet(User user, PageControl pc, java.lang.String setLabel) Retrieve the list of pending actions for a particular user within the given set.
static DataResult	pendingActionsToDeleteInSet(User user, PageControl pc, java.lang.String setLabel, java.lang.Long sid) Retrieve the list of pending actions for a particular user within the given set.
static DataResult	recentlyScheduledActions(User user, PageControl pc, long age) Retrieve the list of unarchived scheduled actions for the current user
static int	removeActions(java.util.List actionIds) Removes a list of actions.
static void	rescheduleAction(Action action) Reschedule the action so it can be attempted again.
static void	rescheduleAction(Action action, boolean onlyFailed) Reschedule the action so it can be attempted again.
static void	scheduleAllErrataUpdate(User scheduler, Server srvr, java.util.Date earliest) Schedules all Errata for the given system.
static Action	scheduleCertificateUpdate(User scheduler, Server server, java.util.Date earliestAction) scheduleCertificateUpdate
static void	scheduleForExecution(Action action, java.util.Set<java.lang.Long> serverIds) Schedules an action for execution on one or more servers (adding rows to rhnServerAction)
static Action	scheduleHardwareRefreshAction(User scheduler, java.util.Date earliestAction, java.util.Set<java.lang.Long> serverIds) Schedule a scheduleHardwareRefreshAction against a system or systems
static Action	scheduleHardwareRefreshAction(User scheduler, Server srvr, java.util.Date earliestAction) Schedule a scheduleHardwareRefreshAction against a system
static KickstartAction	scheduleKickstartAction(KickstartData ksdata, User scheduler, Server srvr, java.util.Date earliestAction, java.lang.String appendString, java.lang.String kickstartHost) Schedule a KickstartAction against a system
static KickstartAction	scheduleKickstartAction(java.util.Set<FileList> fileList, User scheduler, Server srvr, java.util.Date earliestAction, java.lang.String appendString, java.lang.String kickstartHost) Schedule a KickstartAction against a system
static KickstartGuestAction	scheduleKickstartGuestAction(ProvisionVirtualInstanceCommand pcmd, java.lang.Long ksSessionId) Schedule a KickstartGuestAction against a system
static Action	schedulePackageAction(User scheduler, java.util.List pkgs, ActionType type, java.util.Date earliestAction, Server... servers) Schedules a package action of the given type for the given server with the packages given as a list.
static Action	schedulePackageAction(User scheduler, java.util.List pkgs, ActionType type, java.util.Date earliestAction, java.util.Set<java.lang.Long> serverIds) Schedules a package action of the given type for the given server with the packages given as a list.
static PackageAction	schedulePackageInstall(User scheduler, Server srvr, java.util.List pkgs, java.util.Date earliestAction) Schedules one or more package installation actions for the given server.
static Action	schedulePackageInstall(User scheduler, Server srvr, java.lang.Long nameId, java.lang.Long evrId, java.lang.Long archId) Schedules an install of a package
static PackageAction	schedulePackageRefresh(User scheduler, Server server) Schedules a package list refresh action for the given server.
static PackageAction	schedulePackageRefresh(User scheduler, Server server, java.util.Date earliest) Schedules a package list refresh action for the given server.
static PackageAction	schedulePackageRemoval(User scheduler, Server srvr, java.util.List<java.util.Map<java.lang.String,java.lang.Long>> pkgs, java.util.Date earliestAction) Schedules one or more package removal actions for the given server.
static PackageAction	schedulePackageRemoval(User scheduler, Server srvr, RhnSet pkgs, java.util.Date earliestAction) Schedules one or more package removal actions for the given server.
static PackageAction	schedulePackageRunTransaction(User scheduler, Server server, java.util.List pkgs, java.util.Date earliest) Schedules a package runtransaction action.
static PackageAction	schedulePackageVerify(User scheduler, Server srvr, RhnSet pkgs, java.util.Date earliest) Schedules one or more package verification actions for the given server.
static Action	scheduleReboot(User scheduler, Server server, java.util.Date earliestAction) Schedule machine reboot.
static Action	scheduleRebootAction(User scheduler, Server srvr, java.util.Date earliestAction) Schedule a scheduleRebootAction against a system
static ScriptRunAction	scheduleScriptRun(User scheduler, java.util.List<java.lang.Long> sids, java.lang.String name, ScriptActionDetails script, java.util.Date earliest) Schedules a script action for the given servers
static ScapAction	scheduleXccdfEval(User scheduler, Server srvr, java.lang.String path, java.lang.String parameters, java.util.Date earliestAction) Schedules Xccdf evaluation.
static ScapAction	scheduleXccdfEval(User scheduler, java.util.Set<java.lang.Long> serverIds, java.lang.String path, java.lang.String parameters, java.util.Date earliestAction) Schedules Xccdf evaluation.
static Action	storeAction(Action actionIn) Stores the action in the database through hibernate

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

PACKAGES_NOT_REMOVABLE

public static final java.lang.String[] PACKAGES_NOT_REMOVABLE

Method Detail

removeActions

public static int removeActions(java.util.List actionIds)

Removes a list of actions.

Parameters:

actionIds - actions to remove

Returns:

int the number of failed action removals

failSystemAction

public static int failSystemAction(User loggedInUser,
                                   java.lang.Long serverId,
                                   java.lang.Long actionId,
                                   java.lang.String message)

Mark action as failed for specified system

Parameters:

loggedInUser - The user making the request.

serverId - server id

actionId - The id of the Action to be set as failed

message - Message from user, reason of this fail

Returns:

int 1 if succeed

lookupAction

public static Action lookupAction(User user,
                                  java.lang.Long aid)

Retreive the specified Action, assuming that the User making the request has the required permissions.

Parameters:

user - The user making the lookup request.

aid - The id of the Action to lookup.

Returns:

the specified Action.

Throws:

LookupException - if the Action can't be looked up.

lookupLastCompletedAction

public static Action lookupLastCompletedAction(User user,
                                               ActionType type,
                                               Server server)

Lookup the last completed Action on a Server given the user, action type and server. This is useful especially in cases where we want to find the last deployed config action ...

Parameters:

user - the user doing the search (needed for permssion checking)

type - the action type of the action to be queried.

server - the server who's latest completed action is desired.

Returns:

the Action found or null if none exists

deleteActions

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

Deletes the action set with the given label.

Parameters:

user - User associated with the set of actions.

label - Action label to be updated.

archiveActions

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

Archives the action set with the given label.

Parameters:

user - User associated with the set of actions.

label - Action label to be updated.

cancelActions

public static void cancelActions(User user,
                                 java.util.List actionsToCancel)

Cancels all actions in given list.

Parameters:

user - User associated with the set of actions.

actionsToCancel - List of actions to be cancelled.

cancelAction

public static void cancelAction(User user,
                                Action action)

Cancels the server actions associated with a given action, and if required deals with associated pending kickstart actions. Actions themselves are not deleted, only the ServerActions associated with them.

Parameters:

user - User requesting the action be cancelled.

action - Action to be cancelled.

deleteActionsById

public static void deleteActionsById(User user,
                                     java.util.List actionsIds)

Deletes the archived actions

Parameters:

user - User requesting the delete action

actionsIds - List of action ids to be deleted

addServerToAction

public static void addServerToAction(java.lang.Long sid,
                                     Action action)

Adds a server to an action

Parameters:

sid - The server id

action - The parent action

addServerToAction

public static void addServerToAction(Server server,
                                     Action action)

Adds a server to an action

Parameters:

server - The server

action - The parent action

createErrataAction

public static ErrataAction createErrataAction(Org org,
                                              Errata errata)

Creates an errata action with the specified Org

Parameters:

org - The org that needs the errata.

errata - The errata pertaining to this action

Returns:

The created action

createErrataAction

public static Action createErrataAction(User user,
                                        Errata errata)

Creates an errata action

Parameters:

user - The user scheduling errata

errata - The errata pertaining to this action

Returns:

The created action

createConfigUploadAction

public static Action createConfigUploadAction(User user,
                                              java.util.Set filenames,
                                              Server server,
                                              ConfigChannel channel,
                                              java.util.Date earliest)

Create a Config Upload action. This is a much different action from the other config actions (doesn't involve revisions).

Parameters:

user - The scheduler for this config action.

filenames - A set of config file name ids as Longs

server - The server for which to schedule this action.

channel - The config channel to which files will be uploaded.

earliest - The soonest time that this action could be executed.

Returns:

The created upload action

createConfigDiffAction

public static Action createConfigDiffAction(User user,
                                            java.util.Collection<java.lang.Long> revisions,
                                            java.util.Collection<java.lang.Long> serverIds)

Create a Config File Diff action.

Parameters:

user - The user scheduling a diff action.

revisions - A set of revision ids as Longs

serverIds - A set of server ids as Longs

Returns:

The created diff action

createConfigActionForServers

public static Action createConfigActionForServers(User user,
                                                  java.util.Collection<java.lang.Long> revisions,
                                                  java.util.Collection<Server> servers,
                                                  ActionType type,
                                                  java.util.Date earliest)

Create a Config Action.

Parameters:

user - The user scheduling the action.

revisions - A set of revision ids as Longs

servers - A set of server objects

type - The type of config action

earliest - The earliest time this action could execute.

Returns:

The created config action

addConfigurationRevisionsToAction

public static void addConfigurationRevisionsToAction(User user,
                                                     java.util.Collection<java.lang.Long> revisions,
                                                     ConfigAction configAction,
                                                     Server server)

Adds configuration revisions to a ConfigurationAction object

Parameters:

user - the user scheduling the action

revisions - a set of revision ids as Longs

configAction - the action to add revisions to

server - a server object

checkConfigActionOnServer

public static void checkConfigActionOnServer(ActionType type,
                                             Server server)

Checks that a server can be the target of a ConfigAction

Parameters:

type - type of ConfigAction

server - a server object

Throws:

MissingCapabilityException - if server does not have needed capabilities

createConfigAction

public static ConfigAction createConfigAction(User user,
                                              ActionType type,
                                              java.util.Date earliest)

Returns a new ConfigAction object

Parameters:

user - the user scheduling the action

type - type of ConfigAction

earliest - earliest action scheduling date

Returns:

a ConfigAction

createConfigAction

public static Action createConfigAction(User user,
                                        java.util.Collection<java.lang.Long> revisions,
                                        java.util.Collection<java.lang.Long> serverIds,
                                        ActionType type,
                                        java.util.Date earliest)

Create a Config Action.

Parameters:

user - The user scheduling the action.

revisions - A set of revision ids as Longs

serverIds - A set of server ids as Longs

type - The type of config action

earliest - The earliest time this action could execute.

Returns:

The created config action

createDeployImageAction

public static Action createDeployImageAction(User user,
                                             java.lang.String imageUrl,
                                             java.lang.Long vcpus,
                                             java.lang.Long memkb,
                                             java.lang.String bridge,
                                             ProxyConfig proxy)

Schedule deployment of an image to a vhost.

Parameters:

user - The user scheduling image deployment

imageUrl - The URL of the image to be deployed

vcpus - number of vcpus

memkb - memory in Kb

bridge - device

proxy - proxy configuration

Returns:

The created action

createBaseAction

public static Action createBaseAction(User user,
                                      Server server,
                                      ActionType type)

Parameters:

user - The user scheduling the action

server - The server the action is being scheduled for

type - The type of the action

Returns:

The Action we have created

storeAction

public static Action storeAction(Action actionIn)

Stores the action in the database through hibernate

Parameters:

actionIn - The action to be stored

Returns:

action

rescheduleAction

public static void rescheduleAction(Action action)

Reschedule the action so it can be attempted again.

Parameters:

action - Action to reschedule

rescheduleAction

public static void rescheduleAction(Action action,
                                    boolean onlyFailed)

Reschedule the action so it can be attempted again.

Parameters:

action - Action to reschedule

onlyFailed - reschedule only the ServerActions w/failed status

recentlyScheduledActions

public static DataResult recentlyScheduledActions(User user,
                                                  PageControl pc,
                                                  long age)

Retrieve the list of unarchived scheduled actions for the current user

Parameters:

user - The user in question

pc - The details of which results to return

age - how many days old a system can be in order to count as a "recently" scheduled action

Returns:

A list containing the pending actions for the user

allActions

public static DataResult allActions(User user,
                                    PageControl pc)

Retrieve the list of all actions for a particular user. This includes pending, completed, failed and archived actions.

Parameters:

user - The user in question

pc - The details of which results to return

Returns:

A list containing the all actions for the user

pendingActions

public static DataResult pendingActions(User user,
                                        PageControl pc)

Retrieve the list of pending actions for a particular user

Parameters:

user - The user in question

pc - The details of which results to return

Returns:

A list containing the pending actions for the user

pendingActionsInSet

public static DataResult pendingActionsInSet(User user,
                                             PageControl pc,
                                             java.lang.String setLabel)

Retrieve the list of pending actions for a particular user within the given set.

Parameters:

user - The user in question

pc - The details of which results to return

setLabel - Label of an RhnSet of actions IDs to limit the results to.

Returns:

A list containing the pending actions for the user.

pendingActionsToDeleteInSet

public static DataResult pendingActionsToDeleteInSet(User user,
                                                     PageControl pc,
                                                     java.lang.String setLabel,
                                                     java.lang.Long sid)

Retrieve the list of pending actions for a particular user within the given set.

Parameters:

user - The user in question

pc - The details of which results to return

setLabel - Label of an RhnSet of actions IDs to limit the results to.

sid - Server id

Returns:

A list containing the pending actions for the user.

failedActions

public static DataResult failedActions(User user,
                                       PageControl pc)

Retrieve the list of failed actions for a particular user

Parameters:

user - The user in question

pc - The details of which results to return

Returns:

A list containing the pending actions for the user

completedActions

public static DataResult completedActions(User user,
                                          PageControl pc)

Retrieve the list of completed actions for a particular user

Parameters:

user - The user in question

pc - The details of which results to return

Returns:

A list containing the pending actions for the user

archivedActions

public static DataResult archivedActions(User user,
                                         PageControl pc)

Retrieve the list of completed actions for a particular user

Parameters:

user - The user in question

pc - The details of which results to return

Returns:

A list containing the pending actions for the user

getPackageList

public static DataResult getPackageList(java.lang.Long aid,
                                        PageControl pc)

Returns the list of packages associated with a specific action.

Parameters:

aid - The action id for the action in question

pc - The details of which results to return

Returns:

Return a list containing the packages for the action.

getErrataList

public static DataResult getErrataList(java.lang.Long aid)

Returns the list of errata associated with a specific action.

Parameters:

aid - The action id for the action in question

Returns:

Return a list containing the errata for the action.

getConfigFileUploadList

public static DataResult getConfigFileUploadList(java.lang.Long aid)

Returns the list of details associated with a config file upload action.

Parameters:

aid - The action id for the action in question

Returns:

Return a list containing the errata for the action.

getConfigFileDeployList

public static DataResult getConfigFileDeployList(java.lang.Long aid)

Returns the list of details associated with a config file deploy action.

Parameters:

aid - The action id for the action in question

Returns:

Return a list containing the details for the action.

getConfigFileDiffList

public static DataResult getConfigFileDiffList(java.lang.Long aid)

Returns the list of details associated with a config file diff action.

Parameters:

aid - The action id for the action in question

Returns:

Return a list containing the details for the action.

completedSystems

public static DataResult completedSystems(User user,
                                          Action action,
                                          PageControl pc)

Retrieves the systems that have completed a given action

Parameters:

user - The user in question.

action - The Action.

pc - The PageControl.

Returns:

Returns list containing the completed systems.

inProgressSystems

public static DataResult inProgressSystems(User user,
                                           Action action,
                                           PageControl pc)

Retrieves the systems that are in the process of completing a given action

Parameters:

user - The user in question.

action - The Action.

pc - The PageControl.

Returns:

Returns list containing the completed systems.

failedSystems

public static DataResult failedSystems(User user,
                                       Action action,
                                       PageControl pc)

Retrieves the systems that failed completing a given action

Parameters:

user - The user in question.

action - The Action.

pc - The PageControl.

Returns:

Returns list containing the completed systems.

schedulePackageRefresh

public static PackageAction schedulePackageRefresh(User scheduler,
                                                   Server server)

Schedules a package list refresh action for the given server.

Parameters:

scheduler - User scheduling the action.

server - Server for which the action affects.

Returns:

The scheduled PackageAction

schedulePackageRefresh

public static PackageAction schedulePackageRefresh(User scheduler,
                                                   Server server,
                                                   java.util.Date earliest)

Schedules a package list refresh action for the given server.

Parameters:

scheduler - User scheduling the action.

server - Server for which the action affects.

earliest - The earliest time this action should be run.

Returns:

The scheduled PackageAction

Throws:

MissingEntitlementException - if the server is not entitled

schedulePackageRunTransaction

public static PackageAction schedulePackageRunTransaction(User scheduler,
                                                          Server server,
                                                          java.util.List pkgs,
                                                          java.util.Date earliest)

Schedules a package runtransaction action.

Parameters:

scheduler - User scheduling the action.

server - Server for which the action affects.

pkgs - List of PackageMetadata's to be run.

earliest - The earliest time this action should be run.

Returns:

The scheduled PackageAction

schedulePackageRemoval

public static PackageAction schedulePackageRemoval(User scheduler,
                                                   Server srvr,
                                                   RhnSet pkgs,
                                                   java.util.Date earliestAction)

Schedules one or more package removal actions for the given server.

Parameters:

scheduler - User scheduling the action.

srvr - Server for which the action affects.

pkgs - The set of packages to be removed.

earliestAction - Date of earliest action to be executed

Returns:

Currently scheduled PackageAction

schedulePackageRemoval

public static PackageAction schedulePackageRemoval(User scheduler,
                                                   Server srvr,
                                                   java.util.List<java.util.Map<java.lang.String,java.lang.Long>> pkgs,
                                                   java.util.Date earliestAction)

Schedules one or more package removal actions for the given server.

Parameters:

scheduler - User scheduling the action.

srvr - Server for which the action affects.

pkgs - The list of packages to be removed.

earliestAction - Date of earliest action to be executed

Returns:

Currently scheduled PackageAction

schedulePackageInstall

public static PackageAction schedulePackageInstall(User scheduler,
                                                   Server srvr,
                                                   java.util.List pkgs,
                                                   java.util.Date earliestAction)

Schedules one or more package installation actions for the given server.

Parameters:

scheduler - User scheduling the action.

srvr - Server for which the action affects.

pkgs - The set of packages to be removed.

earliestAction - Date of earliest action to be executed

Returns:

Currently scheduled PackageAction

schedulePackageVerify

public static PackageAction schedulePackageVerify(User scheduler,
                                                  Server srvr,
                                                  RhnSet pkgs,
                                                  java.util.Date earliest)

Schedules one or more package verification actions for the given server.

Parameters:

scheduler - User scheduling the action.

srvr - Server for which the action affects.

pkgs - The set of packages to be removed.

earliest - Earliest occurrence of the script.

Returns:

Currently scheduled PackageAction

scheduleScriptRun

public static ScriptRunAction scheduleScriptRun(User scheduler,
                                                java.util.List<java.lang.Long> sids,
                                                java.lang.String name,
                                                ScriptActionDetails script,
                                                java.util.Date earliest)

Schedules a script action for the given servers

Parameters:

scheduler - User scheduling the action.

sids - Servers for which the action affects.

script - The set of packages to be removed.

name - Name of Script action.

earliest - Earliest occurrence of the script.

Returns:

Currently scheduled ScriptRunAction

Throws:

MissingCapabilityException - if any server in the list is missing script.run; schedule fails

checkScriptingOnServers

public static void checkScriptingOnServers(java.util.List<java.lang.Long> sids)
                                    throws MissingCapabilityException

Checks that ScriptRunActions can be run on the servers with specified IDs.

Parameters:

sids - servers' ids

Throws:

MissingCapabilityException - if scripts cannot be run

MissingEntitlementException - if the server is not entitled

createScript

public static ScriptActionDetails createScript(java.lang.String username,
                                               java.lang.String groupname,
                                               java.lang.Long timeout,
                                               java.lang.String script)

Creates a ScriptActionDetails which contains an arbitrary script to be run by a ScriptRunAction.

Parameters:

username - Username of script

groupname - Group script runs as

script - Script contents

timeout - script timeout

Returns:

ScriptActionDetails containing script to be run by ScriptRunAction

scheduleForExecution

public static void scheduleForExecution(Action action,
                                        java.util.Set<java.lang.Long> serverIds)

Schedules an action for execution on one or more servers (adding rows to rhnServerAction)

Parameters:

action - the action

serverIds - server IDs

createAction

public static Action createAction(User user,
                                  ActionType type,
                                  java.lang.String name,
                                  java.util.Date earliestAction)

Creates, saves and returns a new Action

Parameters:

user - the user who created this action

type - the action type

name - the action name

earliestAction - the earliest execution date

Returns:

a saved Action

scheduleKickstartAction

public static KickstartAction scheduleKickstartAction(KickstartData ksdata,
                                                      User scheduler,
                                                      Server srvr,
                                                      java.util.Date earliestAction,
                                                      java.lang.String appendString,
                                                      java.lang.String kickstartHost)

Schedule a KickstartAction against a system

Parameters:

ksdata - KickstartData to associate with this Action

scheduler - User scheduling the action.

srvr - Server for which the action affects.

earliestAction - Date run the Action

appendString - extra options to add to the action.

kickstartHost - host that serves up the kickstart file.

Returns:

Currently scheduled KickstartAction

scheduleKickstartAction

public static KickstartAction scheduleKickstartAction(java.util.Set<FileList> fileList,
                                                      User scheduler,
                                                      Server srvr,
                                                      java.util.Date earliestAction,
                                                      java.lang.String appendString,
                                                      java.lang.String kickstartHost)

Schedule a KickstartAction against a system

Parameters:

fileList - file preservation lists to be included in the system records.

scheduler - User scheduling the action.

srvr - Server for which the action affects.

earliestAction - Date run the Action

appendString - extra options to add to the action.

kickstartHost - host that serves up the kickstart file.

Returns:

Currently scheduled KickstartAction

scheduleKickstartGuestAction

public static KickstartGuestAction scheduleKickstartGuestAction(ProvisionVirtualInstanceCommand pcmd,
                                                                java.lang.Long ksSessionId)

Schedule a KickstartGuestAction against a system

Parameters:

pcmd - most information needed to create this action

ksSessionId - Kickstart Session ID to associate with this action

Returns:

Currently scheduled KickstartAction

scheduleRebootAction

public static Action scheduleRebootAction(User scheduler,
                                          Server srvr,
                                          java.util.Date earliestAction)

Schedule a scheduleRebootAction against a system

Parameters:

scheduler - User scheduling the action.

srvr - Server for which the action affects.

earliestAction - Date run the Action

Returns:

Currently scheduled KickstartAction

scheduleHardwareRefreshAction

public static Action scheduleHardwareRefreshAction(User scheduler,
                                                   Server srvr,
                                                   java.util.Date earliestAction)

Schedule a scheduleHardwareRefreshAction against a system

Parameters:

scheduler - User scheduling the action.

srvr - Server for which the action affects.

earliestAction - Date run the Action

Returns:

Currently scheduled KickstartAction

Throws:

MissingCapabilityException - if scripts cannot be run

scheduleHardwareRefreshAction

public static Action scheduleHardwareRefreshAction(User scheduler,
                                                   java.util.Date earliestAction,
                                                   java.util.Set<java.lang.Long> serverIds)

Schedule a scheduleHardwareRefreshAction against a system or systems

Parameters:

scheduler - User scheduling the action.

earliestAction - Date run the Action

serverIds - server ids meant for the action

Returns:

Currently scheduled KickstartAction

Throws:

MissingCapabilityException - if scripts cannot be run

scheduleAllErrataUpdate

public static void scheduleAllErrataUpdate(User scheduler,
                                           Server srvr,
                                           java.util.Date earliest)

Schedules all Errata for the given system.

Parameters:

scheduler - Person scheduling the action.

srvr - Server whose errata is going to be scheduled.

earliest - Earliest possible time action will occur.

schedulePackageInstall

public static Action schedulePackageInstall(User scheduler,
                                            Server srvr,
                                            java.lang.Long nameId,
                                            java.lang.Long evrId,
                                            java.lang.Long archId)

Schedules an install of a package

Parameters:

scheduler - The user scheduling the action.

srvr - The server that this action is for.

nameId - nameId rhnPackage.name_id

evrId - evrId of package

archId - archId of package

Returns:

The action that has been scheduled.

schedulePackageAction

public static Action schedulePackageAction(User scheduler,
                                           java.util.List pkgs,
                                           ActionType type,
                                           java.util.Date earliestAction,
                                           Server... servers)

Schedules a package action of the given type for the given server with the packages given as a list.

Parameters:

scheduler - The user scheduling the action.

pkgs - A list of maps containing keys 'name_id', 'evr_id' and optional 'arch_id' with Long values.

type - The type of the package action. One of the static types found in ActionFactory

earliestAction - The earliest time that this action could happen.

servers - The server(s) that this action is for.

Returns:

The action that has been scheduled.

schedulePackageAction

public static Action schedulePackageAction(User scheduler,
                                           java.util.List pkgs,
                                           ActionType type,
                                           java.util.Date earliestAction,
                                           java.util.Set<java.lang.Long> serverIds)

Schedules a package action of the given type for the given server with the packages given as a list.

Parameters:

scheduler - The user scheduling the action.

pkgs - A list of maps containing keys 'name_id', 'evr_id' and optional 'arch_id' with Long values.

type - The type of the package action. One of the static types found in ActionFactory

earliestAction - The earliest time that this action could happen.

serverIds - The server ids that this action is for.

Returns:

The action that has been scheduled.

addPackageActionDetails

public static void addPackageActionDetails(Action action,
                                           java.util.List packages)

Adds package details to an Action

Parameters:

action - the action

packages - A list of maps containing keys 'name_id', 'evr_id' and optional 'arch_id' with Long values.

getActionName

public static java.lang.String getActionName(ActionType type)

Returns a name string from an Action type

Parameters:

type - the type

Returns:

a name

scheduleXccdfEval

public static ScapAction scheduleXccdfEval(User scheduler,
                                           Server srvr,
                                           java.lang.String path,
                                           java.lang.String parameters,
                                           java.util.Date earliestAction)

Schedules Xccdf evaluation.

Parameters:

scheduler - User scheduling the action.

srvr - Server for which the action affects.

path - Path for the Xccdf content.

parameters - Additional parameters for oscap tool.

earliestAction - Date of earliest action to be executed.

Returns:

scheduled Scap Action

scheduleXccdfEval

public static ScapAction scheduleXccdfEval(User scheduler,
                                           java.util.Set<java.lang.Long> serverIds,
                                           java.lang.String path,
                                           java.lang.String parameters,
                                           java.util.Date earliestAction)

Schedules Xccdf evaluation.

Parameters:

scheduler - User scheduling the action.

serverIds - Set of server identifiers for which the action affects.

path - Path for the Xccdf content.

parameters - Additional parameters for oscap tool.

earliestAction - Date of earliest action to be executed.

Returns:

scheduled Scap Action

Throws:

MissingCapabilityException - if scripts cannot be run

scheduleReboot

public static Action scheduleReboot(User scheduler,
                                    Server server,
                                    java.util.Date earliestAction)

Schedule machine reboot.

Parameters:

scheduler - Logged in user

server - Server, which is going to be rebooted

earliestAction - Earliest date. If null, then date is current.

Returns:

scheduled reboot action

scheduleCertificateUpdate

public static Action scheduleCertificateUpdate(User scheduler,
                                               Server server,
                                               java.util.Date earliestAction)

scheduleCertificateUpdate

Parameters:

scheduler - Logged in user

server - Server, to update the certificate for

earliestAction - Earliest date. If null, use current date

Returns:

scheduled certificate update action