weblogic.server

Class ResourceGroupLifeCycleRuntime

java.lang.Object

weblogic.management.runtime.RuntimeMBeanDelegate

weblogic.management.runtime.DomainRuntimeMBeanDelegate

weblogic.server.ResourceGroupLifeCycleRuntime

All Implemented Interfaces:

javax.management.DynamicMBean, javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, ResourceGroupLifeCycleRuntimeMBean, RuntimeMBean, WebLogicMBean

public class ResourceGroupLifeCycleRuntime
extends DomainRuntimeMBeanDelegate
implements ResourceGroupLifeCycleRuntimeMBean

Implementation of ResourceGroupLifeCycleRuntimeMBean.

Provides methods that transition resource groups from one state to another.

Excluded in public API Reference.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	ResourceGroupLifeCycleRuntime.PersistResourceGroupDesiredState
private class	ResourceGroupLifeCycleRuntime.ResourceGroupLifecycleRequest

Field Summary

Fields

Modifier and Type	Field and Description
private static boolean	DEBUG
private static java.util.Properties	DO_NOT_START_PROPS
private static weblogic.invocation.ComponentInvocationContext	DOMAIN_CIC
private DomainRuntimeServiceMBean	domainRuntimeServiceMBean
private static weblogic.security.acl.internal.AuthenticatedSubject	kernelId
private weblogic.invocation.ComponentInvocationContext	PARTITION_CIC
private java.lang.String	partitionName
private PartitionRuntimeStateManagerContract	partitionRuntimeStateManager
private static java.lang.String	PTN_DELIMITER
private ResourceGroupMBean	resourceGroupMBean
private ResourceGroupLifecycleOperations.RGState	state
static java.lang.String	STATE_PROPERTY_NAME
private static int	TASK_AFTERLIFE_TIME_MILLIS
private java.util.Set<ResourceGroupLifeCycleTaskRuntimeMBean>	tasks
private static boolean	USE_OLD_STATE_NAMES

Fields inherited from class weblogic.management.runtime.RuntimeMBeanDelegate

descriptor, name, parent, registered, type

Constructor Summary

Constructors

Constructor and Description
ResourceGroupLifeCycleRuntime(ResourceGroupMBean resourceGroupMBean, DomainRuntimeMBeanDelegate parentRuntime, java.beans.PropertyChangeListener listener)

Method Summary

Modifier and Type	Method and Description
private ResourceGroupLifeCycleTaskRuntime	alreadyCompletedTask(ResourceGroupLifecycleOperations.RGOperation operation)
void	clearOldResourceGroupLifeCycleTaskRuntimes()
private ResourceGroupLifecycleOperations.RGState	computeState()
private ResourceGroupLifeCycleTaskRuntime	createTaskMbean(ResourceGroupLifecycleOperations.RGOperation operation, java.lang.String operationMsg, java.lang.String serverName)
private static void	debug(java.lang.String debugMessage)
ResourceGroupLifeCycleTaskRuntimeMBean	forceShutdown() Begins to force the shutdown of this resource group on all targeted servers, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	forceShutdown(java.lang.String[] targetNames) Begins to force the shutdown of this resource group on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	forceShutdown(TargetMBean[] targets) Begins to force the shutdown of this resource group on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	forceSuspend() Begins the forceful transition of this resource group from the RUNNING state to the ADMIN state on all targeted servers.
ResourceGroupLifeCycleTaskRuntimeMBean	forceSuspend(java.lang.String[] targetNames) Begins the forceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets.
ResourceGroupLifeCycleTaskRuntimeMBean	forceSuspend(TargetMBean[] targets) Begins the forceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets.
private static weblogic.invocation.ComponentInvocationContext	getDomainCIC()
ResourceGroupLifecycleOperations.RGState	getInternalState() The internal state enum value.
private weblogic.invocation.ComponentInvocationContext	getPartitionCIC()
java.lang.String	getState() The current overall state of the resource group.
java.lang.String	getState(ServerMBean serverMBean) The state of resource group on a specific server.
java.lang.String	getState(java.lang.String serverName) The current state of the resource group on a specific server.
private java.lang.String[]	getSvrsForSettingDesiredState(java.util.Set<java.lang.String> targets, boolean targetsSpecified)
ResourceGroupLifeCycleTaskRuntimeMBean[]	getTasks() The preexisting resource group lifecycle tasks
private ResourceGroupLifeCycleTaskRuntime	initiateRGLifecycleRequest(TargetMBean[] targets, ResourceGroupLifecycleOperations.RGOperation operation, java.lang.String msg, boolean targetsSpecified)
private ResourceGroupLifeCycleTaskRuntime	initiateRGLifecycleRequest(TargetMBean[] targets, ResourceGroupLifecycleOperations.RGOperation operation, java.lang.String msg, int timeout, boolean ignoreSessions, boolean targetsSpecified)
private ResourceGroupLifeCycleTaskRuntime	initiateRGLifecycleRequest(TargetMBean[] targets, ResourceGroupLifecycleOperations.RGOperation operation, java.lang.String msg, int timeout, boolean ignoreSessions, boolean waitForAllSessions, boolean targetsSpecified)
private boolean	isDomainRGSameState(java.lang.String resourceGroupName, ServerRuntimeMBean svrRuntime, java.lang.String state)
private boolean	isServerActionNeeded(java.lang.String server, java.lang.String resourceGroupName, ResourceGroupLifecycleOperations.RGState state)
private void	logRGAlreadyExpectedState(java.lang.String operationName)
ResourceGroupLifeCycleTaskRuntimeMBean	lookupTask(java.lang.String taskName) The preexisting partition lifecycle task.
void	markStarted()
private static java.util.Properties	prepDoNotStartProps()
void	purgeTasks() Clears the retained task collection.
ResourceGroupLifeCycleTaskRuntimeMBean	resume() Begins the transition of this resource group from the ADMIN state to the RUNNING state on all targeted servers.
ResourceGroupLifeCycleTaskRuntimeMBean	resume(java.lang.String[] targetNames) Begins the transition of this resource group from the ADMIN state to the RUNNING state on the specified targets.
ResourceGroupLifeCycleTaskRuntimeMBean	resume(TargetMBean[] targets) Begins the transition of this resource group from the ADMIN state to the RUNNING state on the specified targets.
void	setState(ResourceGroupLifecycleOperations.RGState newState)
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown() Begins to shut down the resource group gracefully on all targeted servers, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(int timeout, boolean ignoreSessions) Begins to shut down this resource group gracefully on all targeted servers, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(int timeout, boolean ignoreSessions, boolean waitForAllSessions) Begins to shut down this resource group gracefully on all targeted servers, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(int timeout, boolean ignoreSessions, boolean waitForAllSessions, java.lang.String[] targetNames) Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(int timeout, boolean ignoreSessions, boolean waitForAllSessions, TargetMBean[] targets) Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(int timeout, boolean ignoreSessions, java.lang.String[] targetNames) Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(int timeout, boolean ignoreSessions, TargetMBean[] targets) Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(java.lang.String[] targetNames) Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	shutdown(TargetMBean[] targets) Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.
ResourceGroupLifeCycleTaskRuntimeMBean	start() Begins to start this resource group on all targeted servers, changing its state to RUNNING.
ResourceGroupLifeCycleTaskRuntimeMBean	start(java.lang.String[] targetNames) Begins to start this resource group on the specified targets, changing its state to RUNNING.
ResourceGroupLifeCycleTaskRuntimeMBean	start(TargetMBean[] targets) Begins to start this resource group on the specified targets, changing its state to RUNNING.
ResourceGroupLifeCycleTaskRuntimeMBean	startInAdmin() Begins to start this resource group in the admin state on all targeted servers, changing its state to ADMIN.
ResourceGroupLifeCycleTaskRuntimeMBean	startInAdmin(java.lang.String[] targetNames) Begins to start this resource group in the admin state on the specified targets, changing its state to ADMIN.
ResourceGroupLifeCycleTaskRuntimeMBean	startInAdmin(TargetMBean[] targets) Begins to start this resource group in the admin state on the specified targets, changing its state to ADMIN.
ResourceGroupLifecycleOperations.RGState	state()
private ResourceGroupLifecycleOperations.RGState	stateForServer(java.lang.String server)
ResourceGroupLifeCycleTaskRuntimeMBean	suspend() Begins the graceful transition of this resource group from the RUNNING state to the ADMIN state on all targeted servers.
ResourceGroupLifeCycleTaskRuntimeMBean	suspend(int timeout, boolean ignoreSessions) Begins to transition the resource group from RUNNING to ADMIN state gracefully on all targeted servers.
ResourceGroupLifeCycleTaskRuntimeMBean	suspend(int timeout, boolean ignoreSessions, java.lang.String[] targetNames) Begins to transition this resource group from RUNNING to ADMIN state gracefully on the specified targets.
ResourceGroupLifeCycleTaskRuntimeMBean	suspend(int timeout, boolean ignoreSessions, TargetMBean[] targets) Begins to transition this resource group from RUNNING to ADMIN state gracefully on the specified targets.
ResourceGroupLifeCycleTaskRuntimeMBean	suspend(java.lang.String[] targetNames) Begins the graceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets.
ResourceGroupLifeCycleTaskRuntimeMBean	suspend(TargetMBean[] targets) Begins the graceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets.
private void	updateStoreForDesiredState(ResourceGroupLifecycleOperations.RGState state, java.lang.String... servers)
private static void	updateTaskMBeanOnCompletion(ResourceGroupLifeCycleTaskRuntime rlcTaskRuntime)

Methods inherited from class weblogic.management.runtime.DomainRuntimeMBeanDelegate

getRegistrationManager

Methods inherited from class weblogic.management.runtime.RuntimeMBeanDelegate

_createHelper, _postSet, _postSet, _postSet, _postSet, _postSet, addChild, addNotificationListener, addPropertyChangeListener, createChildCopy, getAttribute, getAttributes, getMBeanInfo, getMetaData, getName, getNotificationInfo, getObjectName, getParent, getParentAttribute, getPropertyChangeListeners, getRestParent, getType, invoke, isCachingDisabled, isEditable, isRegistered, pluralize, postDeregister, postRegister, preDeregister, preRegister, register, removeChild, removeNotificationListener, removePropertyChangeListener, setAttribute, setAttributes, setMetaData, setName, setParent, setRestParent, setRuntimeMBeanHelper, setType, unregister

Methods inherited from class java.lang.Object

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

Methods inherited from interface weblogic.management.runtime.RuntimeMBean

addPropertyChangeListener, preDeregister, removePropertyChangeListener

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, setParent

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Field Detail

kernelId

private static final weblogic.security.acl.internal.AuthenticatedSubject kernelId

DO_NOT_START_PROPS

private static final java.util.Properties DO_NOT_START_PROPS

TASK_AFTERLIFE_TIME_MILLIS

private static final int TASK_AFTERLIFE_TIME_MILLIS

See Also:

Constant Field Values

USE_OLD_STATE_NAMES

private static final boolean USE_OLD_STATE_NAMES

DOMAIN_CIC

private static weblogic.invocation.ComponentInvocationContext DOMAIN_CIC

tasks

private final java.util.Set<ResourceGroupLifeCycleTaskRuntimeMBean> tasks

resourceGroupMBean

private final ResourceGroupMBean resourceGroupMBean

partitionName

private final java.lang.String partitionName

PARTITION_CIC

private weblogic.invocation.ComponentInvocationContext PARTITION_CIC

PTN_DELIMITER

private static final java.lang.String PTN_DELIMITER

See Also:

Constant Field Values

STATE_PROPERTY_NAME

public static final java.lang.String STATE_PROPERTY_NAME

See Also:

Constant Field Values

domainRuntimeServiceMBean

private final DomainRuntimeServiceMBean domainRuntimeServiceMBean

partitionRuntimeStateManager

private final PartitionRuntimeStateManagerContract partitionRuntimeStateManager

state

private ResourceGroupLifecycleOperations.RGState state

DEBUG

private static final boolean DEBUG

Constructor Detail

ResourceGroupLifeCycleRuntime

public ResourceGroupLifeCycleRuntime(ResourceGroupMBean resourceGroupMBean,
                                     DomainRuntimeMBeanDelegate parentRuntime,
                                     java.beans.PropertyChangeListener listener)
                              throws ManagementException

Throws:

ManagementException

Method Detail

prepDoNotStartProps

private static java.util.Properties prepDoNotStartProps()

getDomainCIC

private static weblogic.invocation.ComponentInvocationContext getDomainCIC()

getPartitionCIC

private weblogic.invocation.ComponentInvocationContext getPartitionCIC()

start

public ResourceGroupLifeCycleTaskRuntimeMBean start()
                                             throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to start this resource group on all targeted servers, changing its state to RUNNING.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

start in interface ResourceGroupLifeCycleRuntimeMBean

Throws:

ResourceGroupLifecycleException - if start operation fails

getState

public java.lang.String getState()

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

The current overall state of the resource group.

The value returned is the highest state for the resource group on all servers where it is targeted. As a result, the overall resource group state can change (for example, to RUNNING) as soon as the operation (such as start) has finished on one server, even while the operation is still in progress elsewhere.

If the resource group is not currently targeted to any running server then its reported state is the desired state indicated by the most recent resource group life cycle operation on the resource group.

Specified by:

getState in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

The state value

getState

public java.lang.String getState(ServerMBean serverMBean)
                          throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

The state of resource group on a specific server.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.getState(String serverName)

Specified by:

getState in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

Throws:

ResourceGroupLifecycleException

getState

public java.lang.String getState(java.lang.String serverName)
                          throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

The current state of the resource group on a specific server.

Specified by:

getState in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

serverName - name of the server to check

Returns:

the state of this resource group

Throws:

ResourceGroupLifecycleException

getInternalState

public ResourceGroupLifecycleOperations.RGState getInternalState()

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

The internal state enum value.

Specified by:

getInternalState in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

the enum value for the resource group's current state

computeState

private ResourceGroupLifecycleOperations.RGState computeState()

stateForServer

private ResourceGroupLifecycleOperations.RGState stateForServer(java.lang.String server)

getTasks

public ResourceGroupLifeCycleTaskRuntimeMBean[] getTasks()

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

The preexisting resource group lifecycle tasks

Specified by:

getTasks in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

an array of all completed or pending resource group lifecycle tasks.

lookupTask

public ResourceGroupLifeCycleTaskRuntimeMBean lookupTask(java.lang.String taskName)

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

The preexisting partition lifecycle task.

Specified by:

lookupTask in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

ResourceGroupLifeCycleTaskRuntimeMBean based on the name passed by the user

start

public ResourceGroupLifeCycleTaskRuntimeMBean start(TargetMBean[] targets)
                                             throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to start this resource group on the specified targets, changing its state to RUNNING.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.start(String[] targetNames)

Specified by:

start in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targets - the specific targets on which to start this resource group

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the start fails

start

public ResourceGroupLifeCycleTaskRuntimeMBean start(java.lang.String[] targetNames)
                                             throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to start this resource group on the specified targets, changing its state to RUNNING.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

start in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targetNames - the specific servers on which to start this resource group

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the start fails

startInAdmin

public ResourceGroupLifeCycleTaskRuntimeMBean startInAdmin(TargetMBean[] targets)
                                                    throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to start this resource group in the admin state on the specified targets, changing its state to ADMIN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.startInAdmin(String[] targetNames)

Specified by:

startInAdmin in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targets - the specific targets on which to start this resource group in "admin" state

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the start fails

startInAdmin

public ResourceGroupLifeCycleTaskRuntimeMBean startInAdmin(java.lang.String[] targetNames)
                                                    throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to start this resource group in the admin state on the specified targets, changing its state to ADMIN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

startInAdmin in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targetNames - the specific servers on which to start this resource group in "admin" state

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the start fails

startInAdmin

public ResourceGroupLifeCycleTaskRuntimeMBean startInAdmin()
                                                    throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to start this resource group in the admin state on all targeted servers, changing its state to ADMIN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

startInAdmin in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the start fails

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(int timeout,
                                                       boolean ignoreSessions,
                                                       boolean waitForAllSessions)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on all targeted servers, changing its state to SHUTDOWN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Number of seconds to wait before aborting inflight work and force shutting down the server.

ignoreSessions - Set to true to ignore pending HTTP sessions during inflight work handling.

waitForAllSessions - Set to true to wait for all HTTP sessions duirng inflight work handling; false to wait for non-persisted HTTP sessions only.

Returns:

task object for monitoring the operation's progress

Throws:

ResourceGroupLifecycleException - If the resource group fails to gracefully shutdown. A ResourceGroupLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(int timeout,
                                                       boolean ignoreSessions,
                                                       boolean waitForAllSessions,
                                                       TargetMBean[] targets)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.shutdown(int timeout, boolean ignoreSessions, boolean waitForAllSessions, TargetMBean[] targets)

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Number of seconds to wait before aborting inflight work and force shutting down the server.

ignoreSessions - Set to true to ignore pending HTTP sessions during inflight work handling.

waitForAllSessions - Set to true to wait for all HTTP sessions duirng inflight work handling; false to wait for non-persisted HTTP sessions only.

targets - the specific targets on which to shut down this resource group

Returns:

task object for monitoring the operation's progress

Throws:

ResourceGroupLifecycleException - If the resource group fails to gracefully shutdown. A ResourceGroupLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(int timeout,
                                                       boolean ignoreSessions,
                                                       boolean waitForAllSessions,
                                                       java.lang.String[] targetNames)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Number of seconds to wait before aborting inflight work and force shutting down the server.

ignoreSessions - Set to true to ignore pending HTTP sessions during inflight work handling.

waitForAllSessions - Set to true to wait for all HTTP sessions duirng inflight work handling; false to wait for non-persisted HTTP sessions only.

targetNames - the specific servers on which to shut down this resource group

Returns:

task object for monitoring the operation's progress

Throws:

ResourceGroupLifecycleException - If the resource group fails to gracefully shutdown. A ResourceGroupLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(int timeout,
                                                       boolean ignoreSessions,
                                                       TargetMBean[] targets)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN. (equivalent to shutdown(timeout, ignoreSessions, false, targets)).

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.shutdown(int timeout, boolean ignoreSessions, String[] targetNames)

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Number of seconds to wait before aborting inflight work and shutting down the server.

ignoreSessions - true indicates ignore pending HTTP sessions during inflight work handling.

targets - the specific targets on which to shut down this resource group

Throws:

ResourceGroupLifecycleException - Thrown if the resource group cannot gracefully shutdown. Use the forceShutdown command to shutdown the resource group.

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(int timeout,
                                                       boolean ignoreSessions,
                                                       java.lang.String[] targetNames)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN. (equivalent to shutdown(timeout, ignoreSessions, false, targets)).

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Number of seconds to wait before aborting inflight work and shutting down the server.

ignoreSessions - true indicates ignore pending HTTP sessions during inflight work handling.

targetNames - the specific servers on which to shut down this resource group

Throws:

ResourceGroupLifecycleException - Thrown if the resource group cannot gracefully shutdown. Use the forceShutdown command to shutdown the resource group.

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(int timeout,
                                                       boolean ignoreSessions)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on all targeted servers, changing its state to SHUTDOWN. (equivalent to shutdown(timeout, ignoreSessions, false)).

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Number of seconds to wait before aborting inflight work and shutting down the server.

ignoreSessions - true indicates ignore pending HTTP sessions during inflight work handling.

Throws:

ResourceGroupLifecycleException - Thrown if the resource group cannot gracefully shutdown. Use the forceShutdown command to shutdown the resource group.

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(TargetMBean[] targets)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN. (equivalent to shutdown(targets, 0, false)).

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.shutdown(String[] targetNames)

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targets - the specific targets on which to start this resource group

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the shutdown fails

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown(java.lang.String[] targetNames)
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down this resource group gracefully on the specified targets, changing its state to SHUTDOWN. (equivalent to shutdown(targets, 0, false)).

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targetNames - the specific servers on which to shut down this resource group

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the shutdown fails

shutdown

public ResourceGroupLifeCycleTaskRuntimeMBean shutdown()
                                                throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to shut down the resource group gracefully on all targeted servers, changing its state to SHUTDOWN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

shutdown in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

task usable by caller to monitor progress

Throws:

ResourceGroupLifecycleException - if the shutdown fails

forceShutdown

public ResourceGroupLifeCycleTaskRuntimeMBean forceShutdown(TargetMBean[] targets)
                                                     throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to force the shutdown of this resource group on the specified targets, changing its state to SHUTDOWN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.forceShutdown(String[] targetNames)

Specified by:

forceShutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targets - the specific targets on which to force a shutdown on this resource group

Returns:

task object for monitoring the shutdown

Throws:

ResourceGroupLifecycleException - if the resource group fails to shut down

forceShutdown

public ResourceGroupLifeCycleTaskRuntimeMBean forceShutdown(java.lang.String[] targetNames)
                                                     throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to force the shutdown of this resource group on the specified targets, changing its state to SHUTDOWN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

forceShutdown in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targetNames - the specific servers on which to force a shutdown on this resource group

Returns:

task object for monitoring the shutdown

Throws:

ResourceGroupLifecycleException - if the resource group fails to shut down

forceShutdown

public ResourceGroupLifeCycleTaskRuntimeMBean forceShutdown()
                                                     throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to force the shutdown of this resource group on all targeted servers, changing its state to SHUTDOWN.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

forceShutdown in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

task object for monitoring the shutdown

Throws:

ResourceGroupLifecycleException - if the resource group fails to shut down

suspend

public ResourceGroupLifeCycleTaskRuntimeMBean suspend(int timeout,
                                                      boolean ignoreSessions,
                                                      TargetMBean[] targets)
                                               throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to transition this resource group from RUNNING to ADMIN state gracefully on the specified targets.

Applications are in admin mode. Inflight work is completed.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.suspend(timeout, boolean ignoreSessions, String[] targetNames)

Specified by:

suspend in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Seconds to wait for the resource group to transition gracefully. The resource group automatically calls ResourceGroupLifeCycleRuntimeMBean.forceSuspend() after timeout.

ignoreSessions - drop inflight HTTP sessions during graceful suspend

targets - the specific targets on which to start this resource group

Throws:

ResourceGroupLifecycleException - resource group failed to suspend gracefully. A ResourceGroupLifeCycleRuntimeMBean.forceSuspend() or a ResourceGroupLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

suspend

public ResourceGroupLifeCycleTaskRuntimeMBean suspend(int timeout,
                                                      boolean ignoreSessions,
                                                      java.lang.String[] targetNames)
                                               throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to transition this resource group from RUNNING to ADMIN state gracefully on the specified targets.

Applications are in admin mode. Inflight work is completed.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

suspend in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Seconds to wait for the resource group to transition gracefully. The resource group automatically calls ResourceGroupLifeCycleRuntimeMBean.forceSuspend() after timeout.

ignoreSessions - drop inflight HTTP sessions during graceful suspend

targetNames - the specific servers on which to suspend this resource group

Throws:

ResourceGroupLifecycleException - resource group failed to suspend gracefully. A ResourceGroupLifeCycleRuntimeMBean.forceSuspend() or a ResourceGroupLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

suspend

public ResourceGroupLifeCycleTaskRuntimeMBean suspend(int timeout,
                                                      boolean ignoreSessions)
                                               throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins to transition the resource group from RUNNING to ADMIN state gracefully on all targeted servers.

Applications are in admin mode. Inflight work is completed.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

suspend in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

timeout - Seconds to wait for the resource group to transition gracefully. The resource group automatically calls ResourceGroupLifeCycleRuntimeMBean.forceSuspend() after timeout.

ignoreSessions - drop inflight HTTP sessions during graceful suspend

Throws:

ResourceGroupLifecycleException - resource group failed to suspend gracefully. A ResourceGroupLifeCycleRuntimeMBean.forceSuspend() or a ResourceGroupLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

suspend

public ResourceGroupLifeCycleTaskRuntimeMBean suspend(TargetMBean[] targets)
                                               throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the graceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets. (equivalent to suspend(0, false, targets)) New requests are rejected and inflight work is allowed to complete.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.suspend(String[] targetNames)

Specified by:

suspend in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targets - the specific targets on which to start this resource group

Throws:

ResourceGroupLifecycleException - If the operation fails

See Also:

ResourceGroupLifeCycleRuntimeMBean.suspend(int, boolean)

suspend

public ResourceGroupLifeCycleTaskRuntimeMBean suspend(java.lang.String[] targetNames)
                                               throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the graceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets. (equivalent to suspend(0, false, targets)) New requests are rejected and inflight work is allowed to complete.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

suspend in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targetNames - the specific servers on which to suspend this resource group

Throws:

ResourceGroupLifecycleException - If the operation fails

See Also:

ResourceGroupLifeCycleRuntimeMBean.suspend(int, boolean)

suspend

public ResourceGroupLifeCycleTaskRuntimeMBean suspend()
                                               throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the graceful transition of this resource group from the RUNNING state to the ADMIN state on all targeted servers. (equivalent to suspend(0, false)) New requests are rejected and inflight work is allowed to complete.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

suspend in interface ResourceGroupLifeCycleRuntimeMBean

Throws:

ResourceGroupLifecycleException - If the operation fails

See Also:

ResourceGroupLifeCycleRuntimeMBean.suspend(int, boolean)

forceSuspend

public ResourceGroupLifeCycleTaskRuntimeMBean forceSuspend(TargetMBean[] targets)
                                                    throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the forceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.forceSuspend(String[] targetNames)

Specified by:

forceSuspend in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targets - the specific targets on which to start this resource group

Returns:

ResourceGroupLifeCycleTaskRuntimeMBean task object for monitoring the operation

Throws:

ResourceGroupLifecycleException - the resource group could not suspend.

forceSuspend

public ResourceGroupLifeCycleTaskRuntimeMBean forceSuspend(java.lang.String[] targetNames)
                                                    throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the forceful transition of this resource group from the RUNNING state to the ADMIN state on the specified targets.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

forceSuspend in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targetNames - the specific servers on which to force a suspend of this resource group

Returns:

ResourceGroupLifeCycleTaskRuntimeMBean task object for monitoring the operation

Throws:

ResourceGroupLifecycleException - the resource group could not suspend.

forceSuspend

public ResourceGroupLifeCycleTaskRuntimeMBean forceSuspend()
                                                    throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the forceful transition of this resource group from the RUNNING state to the ADMIN state on all targeted servers.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

forceSuspend in interface ResourceGroupLifeCycleRuntimeMBean

Returns:

ResourceGroupLifeCycleTaskRuntimeMBean task object for monitoring the operation

Throws:

ResourceGroupLifecycleException - the resource group could not suspend.

resume

public ResourceGroupLifeCycleTaskRuntimeMBean resume(TargetMBean[] targets)
                                              throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the transition of this resource group from the ADMIN state to the RUNNING state on the specified targets.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Please use ResourceGroupLifeCycleTaskRuntimeMBean.resume(String[] targetNames)

Specified by:

resume in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targets - the specific targets on which to start this resource group

Throws:

ResourceGroupLifecycleException - If the resume operation fails

resume

public ResourceGroupLifeCycleTaskRuntimeMBean resume(java.lang.String[] targetNames)
                                              throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the transition of this resource group from the ADMIN state to the RUNNING state on the specified targets.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

resume in interface ResourceGroupLifeCycleRuntimeMBean

Parameters:

targetNames - the specific servers on which to resume this resource group

Throws:

ResourceGroupLifecycleException - If the resume operation fails

resume

public ResourceGroupLifeCycleTaskRuntimeMBean resume()
                                              throws ResourceGroupLifecycleException

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Begins the transition of this resource group from the ADMIN state to the RUNNING state on all targeted servers.

Use the returned ResourceGroupLifeCycleTaskRuntimeMBean value to check for completion.

Specified by:

resume in interface ResourceGroupLifeCycleRuntimeMBean

Throws:

ResourceGroupLifecycleException - If the resume operation fails

purgeTasks

public void purgeTasks()

Description copied from interface: ResourceGroupLifeCycleRuntimeMBean

Clears the retained task collection.

Specified by:

purgeTasks in interface ResourceGroupLifeCycleRuntimeMBean

state

public ResourceGroupLifecycleOperations.RGState state()

setState

public void setState(ResourceGroupLifecycleOperations.RGState newState)

markStarted

public void markStarted()

createTaskMbean

private ResourceGroupLifeCycleTaskRuntime createTaskMbean(ResourceGroupLifecycleOperations.RGOperation operation,
                                                          java.lang.String operationMsg,
                                                          java.lang.String serverName)
                                                   throws ManagementException

Throws:

ManagementException

initiateRGLifecycleRequest

private ResourceGroupLifeCycleTaskRuntime initiateRGLifecycleRequest(TargetMBean[] targets,
                                                                     ResourceGroupLifecycleOperations.RGOperation operation,
                                                                     java.lang.String msg,
                                                                     boolean targetsSpecified)
                                                              throws ResourceGroupLifecycleException

Throws:

ResourceGroupLifecycleException

initiateRGLifecycleRequest

private ResourceGroupLifeCycleTaskRuntime initiateRGLifecycleRequest(TargetMBean[] targets,
                                                                     ResourceGroupLifecycleOperations.RGOperation operation,
                                                                     java.lang.String msg,
                                                                     int timeout,
                                                                     boolean ignoreSessions,
                                                                     boolean targetsSpecified)
                                                              throws ResourceGroupLifecycleException

Throws:

ResourceGroupLifecycleException

initiateRGLifecycleRequest

private ResourceGroupLifeCycleTaskRuntime initiateRGLifecycleRequest(TargetMBean[] targets,
                                                                     ResourceGroupLifecycleOperations.RGOperation operation,
                                                                     java.lang.String msg,
                                                                     int timeout,
                                                                     boolean ignoreSessions,
                                                                     boolean waitForAllSessions,
                                                                     boolean targetsSpecified)
                                                              throws ResourceGroupLifecycleException

Throws:

ResourceGroupLifecycleException

logRGAlreadyExpectedState

private void logRGAlreadyExpectedState(java.lang.String operationName)

alreadyCompletedTask

private ResourceGroupLifeCycleTaskRuntime alreadyCompletedTask(ResourceGroupLifecycleOperations.RGOperation operation)
                                                        throws ManagementException,
                                                               ResourceGroupLifecycleException

Throws:

ManagementException

ResourceGroupLifecycleException

updateTaskMBeanOnCompletion

private static void updateTaskMBeanOnCompletion(ResourceGroupLifeCycleTaskRuntime rlcTaskRuntime)

clearOldResourceGroupLifeCycleTaskRuntimes

public void clearOldResourceGroupLifeCycleTaskRuntimes()

isServerActionNeeded

private boolean isServerActionNeeded(java.lang.String server,
                                     java.lang.String resourceGroupName,
                                     ResourceGroupLifecycleOperations.RGState state)
                              throws ResourceGroupLifecycleException

Throws:

ResourceGroupLifecycleException

isDomainRGSameState

private boolean isDomainRGSameState(java.lang.String resourceGroupName,
                                    ServerRuntimeMBean svrRuntime,
                                    java.lang.String state)
                             throws ResourceGroupLifecycleException

Throws:

ResourceGroupLifecycleException

updateStoreForDesiredState

private void updateStoreForDesiredState(ResourceGroupLifecycleOperations.RGState state,
                                        java.lang.String... servers)
                                 throws ResourceGroupLifecycleException

Throws:

ResourceGroupLifecycleException

getSvrsForSettingDesiredState

private java.lang.String[] getSvrsForSettingDesiredState(java.util.Set<java.lang.String> targets,
                                                         boolean targetsSpecified)

debug

private static void debug(java.lang.String debugMessage)