Skip navigation links

weblogic.management.runtime
Interface ServerRuntimeMBean

All Superinterfaces:

DynamicMBean, HealthFeedback, MBeanRegistration, NotificationBroadcaster, RuntimeMBean, ServerStates, WebLogicMBean

public interface ServerRuntimeMBean

extends RuntimeMBean, HealthFeedback, ServerStates

Provides methods for retrieving runtime information about a server instance and for transitioning a server from one state to another.

suspend

void suspend()
             throws ServerLifecycleException

Suspend server. Deny new requests (except by privileged users). Allow pending requests to complete. This operation transitions the server into ADMIN state. Applications and resources are fully available to administrators in ADMIN state. But non-admin users are denied access to applications and resources

Throws:

ServerLifecycleException

See Also:

ServerRuntimeMBean.suspend(int, boolean)

suspend

void suspend(int timeout,
             boolean ignoreSessions)
             throws ServerLifecycleException

Transitions the server from RUNNING to ADMIN state gracefully.

Applications are in admin mode. Inflight work is completed. Applications and resources are fully available to administrators in ADMIN state. But non-admin users are denied access to applications and resources

Parameters:

timeout - Seconds to wait for server to transition gracefully. The server calls ServerRuntimeMBean.forceSuspend() after timeout.

ignoreSessions - drop inflight HTTP sessions during graceful suspend

Throws:

ServerLifecycleException - server failed to suspend gracefully. A ServerRuntimeMBean.forceSuspend() or a ServerRuntimeMBean.forceShutdown() operation can be invoked.

forceSuspend

void forceSuspend()
                  throws ServerLifecycleException

Transitions the server from RUNNING to ADMIN state forcefully cancelling inflight work.

Work that cannot be cancelled is dropped. Applications are brought into the admin mode. This is the supported way of force suspending the server and getting it into ADMIN state.

Throws:

ServerLifecycleException - server failed to force suspend. A ServerRuntimeMBean.forceShutdown() operation can be invoked.

resume

void resume()
            throws ServerLifecycleException

Resume suspended server. Allow new requests. This operation transitions the server into RUNNING state.

Throws:

ServerLifecycleException - if this operation fails to complete. The server transitions back to the previous state from which this operation was invoked e.g. if the server was in the ADMIN state before this operation, it will go back to the ADMIN state if resume fails.

shutdown

void shutdown()
              throws ServerLifecycleException

Gracefully shuts down the server after handling inflight work.

Throws:

ServerLifecycleException

See Also:

ServerRuntimeMBean.shutdown(int, boolean, boolean)

shutdown

void shutdown(int timeout,
              boolean ignoreSessions)
              throws ServerLifecycleException

Gracefully shuts down the server after handling inflight work.

This method is the same as calling: shutdown(timeout, ignoreSessions, false);

Parameters:

timeout -

ignoreSessions -

Throws:

ServerLifecycleException

See Also:

ServerRuntimeMBean.shutdown(int, boolean, boolean)

shutdown

void shutdown(int timeout,
              boolean ignoreSessions,
              boolean waitForAllSessions)
              throws ServerLifecycleException

Gracefully shuts down the server after handling inflight work; optionally ignores pending HTTP sessions while handling inflight work.

The following inflight work is allowed to complete before shutdown:

• Pending transaction's and TLOG checkpoint
• Pending HTTP sessions
• Pending JMS work
• Pending work in the execute queues
• RMI requests with transaction context

Further administrative calls are accepted while the server is completing inflight work. For example a forceShutdown command can be issued to quickly shutdown the server if graceful shutdown takes a long time.

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.

waitForAllSessions - true indicates waiting for all HTTP sessions during inflight work handling; false indicates waiting for non-persisted HTTP sessions only.

Throws:

ServerLifecycleException - Thrown if the server cannot gracefully shutdown. Use the forceShutdown command to shutdown the server.

forceShutdown

void forceShutdown()
                   throws ServerLifecycleException

Force shutdown the server. Causes the server to reject new requests and fail pending requests.

Throws:

ServerLifecycleException - Thrown when the server cannot force shutdown due to a fatal exception. Even after this exception is thrown indicating failure the server exits after ServerLifeCycleTimeoutVal seconds defined in the ServerMBean.

start

@Deprecated
void start()

Deprecated. Use ServerRuntimeMBean.suspend() and ServerRuntimeMBean.resume() operations instead of lock/unlock.

Unlocks a server and enables it to receive new requests.

Servers can be locked with the java weblogic.Admin LOCK command. In a locked state, a server instance accepts only administrative logins.

getState

String getState()

The current life cycle state of this server.

For example, a server can be in a RUNNING state in which it can receive and process requests or in an ADMIN state in which it can receive only administrative requests.

Returns:

The state value

getStateVal

int getStateVal()

Returns current state of the server as in integer. ServerStates has more information about the available server states

Returns:

The stateVal value

getActivationTime

long getActivationTime()

The time when the server was started.

Returns:

The activationTime value

getListenAddress

@Deprecated
String getListenAddress()

Deprecated. 9.0.0.0 Replaced by ServerRuntimeMBean.getURL(java.lang.String)

The address on which this server is listening for connections through the default network channel.

For example this might return the string: santiago/172.17.9.220.

You can configure other network channels for this server, and the other channels can use different listen addresses.

Returns:

The listenAddress value

See Also:

ServerRuntimeMBean.getServerChannel(String)

getServerChannel

InetSocketAddress getServerChannel(String protocol)

The address on which this server is listening for connections that use the specified protocol.

Note: The listen address is persisted in the domain's config.xml file, however when a server instance is started, a command-line option can override the persisted listen address. This getServerChannel method returns the listen address that is currently being used, not necessarily the address that is specified in config.xml.

The returned address will always be resolved.

Parameters:

protocol - the desired protocol

Returns:

The channel as an InetSocketAddress

getDefaultURL

String getDefaultURL()

The URL that clients use to connect to this server's default network channel.

The returned value indicates the default protocol, listen address and listen port:

protocol://listen-address:listen-port

Note: The default protocol, listen address and listen port are persisted in the domain's config.xml file, however when a server instance is started, command-line options can override these persisted values. This getDefaultURL method returns the URL values that are currently being used, not necessarily the values that are specified in config.xml.

The returned URL will be consistent with dynamic channel updates.

Returns:

The URL as a string

getAdministrationURL

String getAdministrationURL()

The URL that the server and its clients use for administrative connections.

If no administration channel is enabled, then this method returns the URL for connections through the default channel. If the default channel is de-activated, this method returns the URL for a secure channel. If no secure channel is enabled, the method returns null.

The returned URL will be consistent with dynamic channel updates.

Returns:

The URL as a string

getURL

String getURL(String protocol)

The URL that clients use when connecting to this server using the specified protocol.

Note: The listen address and listen port for a given protocol are persisted in the domain's config.xml file, however when a server instance is started, command-line options can override these persisted values. This getURL method returns the URL values that are currently being used, not necessarily the values that are specified in config.xml.

Parameters:

protocol - the desired protocol

Returns:

The URL as a string

getIPv4URL

String getIPv4URL(String protocol)

The URL that clients use when connecting to this server using the specified protocol.

Note: The listen address and listen port for a given protocol are persisted in the domain's config.xml file, however when a server instance is started, command-line options can override these persisted values. This getURL method returns the URL values that are currently being used, not necessarily the values that are specified in config.xml.

Parameters:

protocol - the desired protocol

Returns:

The URL as a string

Since:

10.3.1.0

getIPv6URL

String getIPv6URL(String protocol)

The URL that clients use when connecting to this server using the specified protocol.

Note: The listen address and listen port for a given protocol are persisted in the domain's config.xml file, however when a server instance is started, command-line options can override these persisted values. This getURL method returns the URL values that are currently being used, not necessarily the values that are specified in config.xml.

Parameters:

protocol - the desired protocol

Returns:

The URL as a string

Since:

10.3.1.0

getListenPort

@Deprecated
int getListenPort()

Deprecated. 9.0.0.0 Replaced by ServerRuntimeMBean.getURL(java.lang.String)

The port on which this server is listening for connections.

Returns:

The listenPort value

getSSLListenPort

@Deprecated
int getSSLListenPort()

Deprecated. 9.0.0.0 Replaced by ServerRuntimeMBean.getURL(java.lang.String)

The port on which this server is listening for SSL connections.

Returns:

The sSLListenPort value

getAdministrationPort

@Deprecated
int getAdministrationPort()

Deprecated. 9.0.0.0 Replaced by ServerRuntimeMBean.getAdministrationURL()

The port on which this server is listening for administrative requests.

Returns:

The administrationPort value

getSSLListenAddress

@Deprecated
String getSSLListenAddress()

Deprecated. 9.0.0.0 Replaced by ServerRuntimeMBean.getURL(java.lang.String)

The address on which this server is listening for SSL connections. For example this might return the string: santiago/172.17.9.220

Returns:

The sSLListenAddress value

getOpenSocketsCurrentCount

int getOpenSocketsCurrentCount()

The current number of sockets registered for socket muxing on this server.

Returns:

The openSocketsCurrentCount value

getRestartsTotalCount

@Deprecated
int getRestartsTotalCount()

Deprecated. This attribute always returns a value of 0. Please use ServerLifeCycleRuntimeMBean.getNodeManagerRestartCount() if the NodeManager is used to start servers

The total number of restarts for this server since the cluster was last started.

Returns:

The restartsTotalCount value

getServerChannelRuntimes

ServerChannelRuntimeMBean[] getServerChannelRuntimes()

The network channels that are currently configured on the server.

Returns:

The channels value

getSocketsOpenedTotalCount

@Deprecated
long getSocketsOpenedTotalCount()

Deprecated. Use ServerRuntimeMBean.getOpenSocketsCurrentCount() instead. Both methods return the same value. This method is being deprecated in favor of the other method.

The total number of registrations for socket muxing on this sever.

Returns:

The socketsOpenedTotalCount value

getMiddlewareHome

String getMiddlewareHome()

The Oracle Middleware installation directory.

Returns:

The Oracle Middleware installation directory

Since:

10.3.3.0

getOracleHome

@Deprecated
String getOracleHome()

Deprecated. WLS can no longer find out what ORACLE_HOME is

The directory where Oracle products are installed. Deprecated since 10.3.3

Returns:

The Oracle products installation directory

Since:

10.3.1.0

getWeblogicHome

String getWeblogicHome()

The directory where the WebLogic Server instance (server) is installed, without the trailing "/server".

Returns:

The weblogic server directory

Since:

10.3.1.0

getWeblogicVersion

String getWeblogicVersion()

The version of this WebLogic Server instance (server).

Returns:

The weblogicVersion value

getJTARuntime

JTARuntimeMBean getJTARuntime()

The transaction RuntimeMBean for this server.

Returns:

The jTARuntime value

See Also:

JTARuntimeMBean

getJVMRuntime

JVMRuntimeMBean getJVMRuntime()

The JVMRuntimeMBean for this server.

Returns:

The jVMRuntime value

See Also:

JVMRuntimeMBean

getJMSRuntime

JMSRuntimeMBean getJMSRuntime()

The JMSRuntimeMBean for this server.

Returns:

The jMSRuntime value

getMessagingBridgeRuntime

@Deprecated
MessagingBridgeRuntimeMBean getMessagingBridgeRuntime()

Deprecated. 12.1.3.0 Replaced by ServerRuntimeMBean.getMessagingBridgeRuntimes()

The MessagingBridgeRuntimeMBean for this server

Returns:

the messagingBridgeRuntime value

getMessagingBridgeRuntimes

MessagingBridgeRuntimeMBean[] getMessagingBridgeRuntimes()

The MessagingBridgeRuntimeMBeans for this server

Returns:

an array of messagingBridgeRuntimes

Since:

12.1.3.0

lookupMessagingBridgeRuntime

MessagingBridgeRuntimeMBean lookupMessagingBridgeRuntime(String name)

Parameters:

name -

Since:

12.1.3.0

getJDBCServiceRuntime

JDBCServiceRuntimeMBean getJDBCServiceRuntime()

The JDBCServiceRuntimeMBean for this server.

Returns:

The jDBCServiceRuntime value

getWTCRuntime

WTCRuntimeMBean getWTCRuntime()

The WTCRuntimeMBean for this server.

Returns:

The WTCRuntime value

getJoltRuntime

JoltConnectionServiceRuntimeMBean getJoltRuntime()

The JoltConnectionServiceRuntimeMBean for this server.

Returns:

The JoltConnectionServiceRuntime value

getServerSecurityRuntime

ServerSecurityRuntimeMBean getServerSecurityRuntime()

Return the ServerSecurityRuntimeMBean for this server.

Returns:

The serverSecurityRuntime value

getClusterRuntime

ClusterRuntimeMBean getClusterRuntime()

Return an MBean which represents this server's view of its cluster, if any.

Returns:

The clusterRuntime value

getEntityCacheCurrentStateRuntime

EntityCacheCurrentStateRuntimeMBean getEntityCacheCurrentStateRuntime()

Return an MBean which represents Current Status of the XML Cache.

Returns:

The entityCacheCurrentStateRuntime value

getEntityCacheCumulativeRuntime

EntityCacheCumulativeRuntimeMBean getEntityCacheCumulativeRuntime()

Return an MBean which represents Cumulative Status of the XML Cache.

Returns:

The entityCacheCumulativeRuntime value

getEntityCacheHistoricalRuntime

EntityCacheCumulativeRuntimeMBean getEntityCacheHistoricalRuntime()

Return an MBean which represents Historical Status of the XML Cache.

Returns:

The entityCacheHistoricalRuntime value

getThreadPoolRuntime

ThreadPoolRuntimeMBean getThreadPoolRuntime()

Get the self-tuning thread pool's runtime information. This call will return null if the self-tuning implementation is not enabled.

Since:

9.0.0.0

getClassLoaderRuntime

ClassLoaderRuntimeMBean getClassLoaderRuntime()

Get statistics for system-level class loading.

Since:

12.2.1

getTimerRuntime

TimerRuntimeMBean getTimerRuntime()

Get the runtime information about the WebLogic timer implementation.

getDefaultExecuteQueueRuntime

ExecuteQueueRuntimeMBean getDefaultExecuteQueueRuntime()

Return an MBean which exposes this server's default execute queue.

Returns:

The executeQueueRuntime value

getExecuteQueueRuntimes

ExecuteQueueRuntimeMBean[] getExecuteQueueRuntimes()

Returns an array of MBeans which exposes this server's active execute queues.

Returns:

The executeQueueRuntimes value

getWorkManagerRuntimes

WorkManagerRuntimeMBean[] getWorkManagerRuntimes()

Returns an array of MBeans which exposes this server's active internal WorkManagers.

Returns:

The workManagerRuntimes value

Since:

9.0.0.0

getMaxThreadsConstraintRuntimes

MaxThreadsConstraintRuntimeMBean[] getMaxThreadsConstraintRuntimes()

Returns an array of RuntimeMBeans which exposes this server's globally defined MaxThreadsConstraints.

Since:

9.0.0.0

getMinThreadsConstraintRuntimes

MinThreadsConstraintRuntimeMBean[] getMinThreadsConstraintRuntimes()

Returns an array of RuntimeMBeans which exposes this server's globally defined MinThreadsConstraints.

Since:

9.0.0.0

getRequestClassRuntimes

RequestClassRuntimeMBean[] getRequestClassRuntimes()

Returns an array of RuntimeMBeans which exposes this server's globally defined Request Classes.

Since:

9.0.0.0

getAdminServerHost

String getAdminServerHost()

The address on which the Administration Server is listening for connections. For example, this might return the string: santiago

Returns:

The adminServerHost value

getAdminServerListenPort

int getAdminServerListenPort()

The port on which the Administration Server is listening for connections.

Returns:

The adminServerListenPort value

isAdminServerListenPortSecure

boolean isAdminServerListenPortSecure()

Indicates whether the port that the server uses for administrative traffic is configured to use a secure protocol.

Returns:

The adminServerListenPortSecure value

isListenPortEnabled

boolean isListenPortEnabled()

Indicates whether the default listen port is enabled on the server.

Returns:

The listenPortEnabled value

isSSLListenPortEnabled

boolean isSSLListenPortEnabled()

Indicates whether the default SSL listen port is enabled on the server

Returns:

The SLListenPortEnabled value

isAdministrationPortEnabled

boolean isAdministrationPortEnabled()

Indicates whether the administration port is enabled on the server

Returns:

The administrationPortEnabled value

getHealthState

HealthState getHealthState()

The health state of the server as reported by the server's self-health monitoring.

For example, the server can report if it is overloaded by too many requests, if it needs more memory resources, or if it will soon fail for other reasons.

Specified by:

getHealthState in interface HealthFeedback

Returns:

The healthState value

See Also:

HealthState

getHealthStateJMX

CompositeData getHealthStateJMX()
                                throws OpenDataException

The HealthState object returned as a CompositeData type.

Returns:

The HealthState represented as a CompositeData

Throws:

OpenDataException

See Also:

ServerRuntimeMBean.getHealthState(), HealthState

getOverallHealthState

HealthState getOverallHealthState()

Determine the overall health state of this server, taking into account the health of each of its subsystems.

Returns:

The healthState value with subsystems taken into account

See Also:

HealthState

getOverallHealthStateJMX

CompositeData getOverallHealthStateJMX()
                                       throws OpenDataException

The overall health state of this server returned as a CompositeData type.

Returns:

The HealthState represented as a CompositeData

Throws:

OpenDataException

See Also:

ServerRuntimeMBean.getOverallHealthState(), HealthState

isAdminServer

boolean isAdminServer()

Indicates whether the server is an Administration Server.

Returns:

The adminServer value

getCurrentDirectory

String getCurrentDirectory()

The absolute path of the directory from which the server was started.

This may be used in conjunction with other relative paths in ServerMBean to compute full paths.

Returns:

The currentDirectory value

See Also:

ServerMBean

getApplicationRuntimes

ApplicationRuntimeMBean[] getApplicationRuntimes()

Returns the list of currently running Applications

Returns:

the currently running applications.

lookupApplicationRuntime

ApplicationRuntimeMBean lookupApplicationRuntime(String name)

Returns the ApplicationRuntimeMBean asked for, by name.

Parameters:

name -

Returns:

The requested ApplicationRuntimeMBean, null if it does not exist.

getLibraryRuntimes

LibraryRuntimeMBean[] getLibraryRuntimes()

Returns all deployed Libraries

Returns:

Array of LibraryRuntimeMBeans.

lookupLibraryRuntime

LibraryRuntimeMBean lookupLibraryRuntime(String name)

Returns the LibraryRuntimeMBean asked for, by name.

Parameters:

name -

Returns:

The requested LibraryRuntimeMBean, null if it does not exist.

getLogBroadcasterRuntime

LogBroadcasterRuntimeMBean getLogBroadcasterRuntime()
                                                    throws ManagementException

The object which generates notifications on behalf of the logging subystem.

Throws:

ManagementException

getLogRuntime

@Deprecated
LogRuntimeMBean getLogRuntime()

Deprecated. 12.1.3.0

Return the MBean which provides access to the control interface for WLS server logging.

Since:

9.0.0.0

getServerLogRuntime

ServerLogRuntimeMBean getServerLogRuntime()

Return the MBean which provides access to the control interface for WLS server logging.

Since:

12.1.3.0

getWLDFRuntime

WLDFRuntimeMBean getWLDFRuntime()

Return the MBean which provides access to all Diagnostic runtime MBeans.

Since:

9.0.0.0

getMANReplicationRuntime

MANReplicationRuntimeMBean getMANReplicationRuntime()

Return an MBean which represents this server's view of its MANReplicationRuntime, if any.

Returns:

The MANReplicationRuntime value

getWANReplicationRuntime

WANReplicationRuntimeMBean getWANReplicationRuntime()

Return an MBean which represents this server's view of its WANReplicationRuntime, if any.

Returns:

The WANReplicationRuntime value

setCurrentMachine

void setCurrentMachine(String machineName)

Return the machine on which the server is running. This will be different from the configuration if the server gets migrated automatically.

Parameters:

machineName -

getCurrentMachine

String getCurrentMachine()

Return the machine on which the server is running. This will be different from the configuration if the server gets migrated automatically.

Returns:

Machine on which server is running.

restartSSLChannels

void restartSSLChannels()

Restart all SSL channels on which the server is listening. This could be necessary because of some change that the server is not aware of, for instance updates to the keystore.

getMailSessionRuntimes

MailSessionRuntimeMBean[] getMailSessionRuntimes()

Return the runtimeMBeans for JavaMail Mail Sessions

Since:

9.0.0.0

getPersistentStoreRuntimes

PersistentStoreRuntimeMBean[] getPersistentStoreRuntimes()

Returns the mbeans that provides runtime information for each PersistentStore.

Since:

9.0.0.0

lookupPersistentStoreRuntime

PersistentStoreRuntimeMBean lookupPersistentStoreRuntime(String name)

Returns the Runtime mbean for the persistent store with the specified short name.

Parameters:

name -

getConnectorServiceRuntime

ConnectorServiceRuntimeMBean getConnectorServiceRuntime()

The access point for server wide control and monitoring of the Connector Container.

Returns:

the Connector Service MBean for this server instance.

getWebServerRuntimes

WebServerRuntimeMBean[] getWebServerRuntimes()

Returns all the initialized webservers

isRestartRequired

boolean isRestartRequired()

Indicates whether the server must be restarted in order to activate configuration changes.

Returns:

true if the server needs to be restarted, false otherwise.

Since:

9.0.0.0

getServerClasspath

String getServerClasspath()

Get the classpath for this server including domain/lib contents that are automatically picked up and appended to the classpath.

Since:

9.0.0.0

getPathServiceRuntime

@Deprecated
PathServiceRuntimeMBean getPathServiceRuntime()

Deprecated. replaced by ServerRuntimeMBean.getPathServiceRuntimes()

Domain scoped PathServiceRuntimeMBean for this server.

Returns:

The Domain scoped PathServiceRuntime value

getSAFRuntime

SAFRuntimeMBean getSAFRuntime()

The SAFRuntimeMBean for this server.

Returns:

The sAFRuntime value

getSNMPAgentRuntime

SNMPAgentRuntimeMBean getSNMPAgentRuntime()

Return the MBean which provides access to the monitoring statistics for WLS SNMP Agent.

Since:

10.0.0.0

getSingleSignOnServicesRuntime

SingleSignOnServicesRuntimeMBean getSingleSignOnServicesRuntime()

Get the runtime interface to publish single sign-on services information.

getMANAsyncReplicationRuntime

MANAsyncReplicationRuntimeMBean getMANAsyncReplicationRuntime()

Return an MBean which represents this server's view of its MANAsyncReplicationRuntime, if any.

Returns:

The MANAsyncReplicationRuntime value

Since:

10.3.0.0

getAsyncReplicationRuntime

AsyncReplicationRuntimeMBean getAsyncReplicationRuntime()

Return an MBean which represents this server's view of its AsyncReplicationRuntime, if any.

Returns:

The AsyncReplicationRuntime value

Since:

10.3.0.0

getWseeWsrmRuntime

WseeWsrmRuntimeMBean getWseeWsrmRuntime()

Get statistics for web services reliable messaging across the entire server if any web service is deployed that employs reliable messaging. This MBean is null otherwise.

Since:

10.3.1.2

getWseeClusterFrontEndRuntime

WseeClusterFrontEndRuntimeMBean getWseeClusterFrontEndRuntime()

This is non-null only when this server is running as a host to a front-end proxy (HttpClusterServlet) instance.

Since:

10.3.1.2

getConcurrentManagedObjectsRuntime

ConcurrentManagedObjectsRuntimeMBean getConcurrentManagedObjectsRuntime()

The ConcurrentManagedObjectsRuntimeMBean for this server.

Returns:

The concurrentManagedObjectsRuntime value

See Also:

ConcurrentManagedObjectsRuntimeMBean

startPartition

void startPartition(String partitionName)
                    throws PartitionLifeCycleException

starts the partition.

Parameters:

partitionName - The resource group name

Throws:

PartitionLifeCycleException - partition failed to start.

startPartitionInAdmin

void startPartitionInAdmin(String partitionName)
                           throws PartitionLifeCycleException

starts the Partition in ADMIN state. Applications and resources are fully available to administrators in ADMIN state. But non-admin users are denied access to applications and resources

Parameters:

partitionName -

Throws:

PartitionLifeCycleException - partition failed to start in admin mode.

startResourceGroup

void startResourceGroup(String resourceGroupName)
                        throws ResourceGroupLifecycleException

starts the resource group.

Parameters:

resourceGroupName - The resource group name

Throws:

ResourceGroupLifecycleException - partition failed to start.

startResourceGroupInAdmin

void startResourceGroupInAdmin(String resourceGroupName)
                               throws ResourceGroupLifecycleException

starts the resource group in ADMIN state. Applications and resources are fully available to administrators in ADMIN state. But non-admin users are denied access to applications and resources

Parameters:

resourceGroupName -

Throws:

ResourceGroupLifecycleException - resource group failed to start in admin mode.

suspendResourceGroup

void suspendResourceGroup(String resourceGroupName,
                          int timeout,
                          boolean ignoreSessions)
                          throws ResourceGroupLifecycleException

Suspend resource group. Deny new requests (except by privileged users). Allow pending requests to complete. This operation transitions the partition into ADMIN state. Applications and resources are fully available to administrators in ADMIN state. But non-admin users are denied access to applications and resources

Parameters:

resourceGroupName -

timeout -

ignoreSessions -

Throws:

ResourceGroupLifecycleException

suspendResourceGroup

void suspendResourceGroup(String resourceGroupName)
                          throws ResourceGroupLifecycleException

Suspend resource group. Deny new requests (except by privileged users). Allow pending requests to complete. This operation transitions the partition into ADMIN state. Applications and resources are fully available to administrators in ADMIN state. But non-admin users are denied access to applications and resources

Parameters:

resourceGroupName -

Throws:

ResourceGroupLifecycleException

See Also:

ServerRuntimeMBean.suspendResourceGroup(String, int, boolean)

forceSuspendResourceGroup

void forceSuspendResourceGroup(String resourceGroupName)
                               throws ResourceGroupLifecycleException

Transitions the resource group from RUNNING to ADMIN state forcefully cancelling inflight work.

Work that cannot be cancelled is dropped. Applications are brought into the admin mode. This is the supported way of force suspending the resource group and getting it into ADMIN state.

Parameters:

resourceGroupName -

Throws:

ResourceGroupLifecycleException - partition failed to force suspend. A ServerRuntimeMBean.forceShutdown() operation can be invoked.

resumeResourceGroup

void resumeResourceGroup(String resourceGroupName)
                         throws ResourceGroupLifecycleException

Resume suspended resource group. Allow new requests. This operation transitions the resource group into RUNNING state.

Parameters:

resourceGroupName -

Throws:

ResourceGroupLifecycleException - if this operation fails to complete. The resource group transitions back to the previous state from which this operation was invoked e.g. if the resource group was in the ADMIN state before this operation, it will go back to the ADMIN state if resume fails.

forceShutdownResourceGroup

void forceShutdownResourceGroup(String resourceGroupName)
                                throws ResourceGroupLifecycleException

Force shutdown the resource group. Causes the resource group to reject new requests and fail pending requests.

Parameters:

resourceGroupName -

Throws:

ResourceGroupLifecycleException - Thrown when the resource group cannot force shutdown due to a fatal exception. Even after this exception is thrown indicating failure the partition exits after PartitionLifeCycleTimeoutVal seconds defined in the PartitionMBean.

shutdownResourceGroup

void shutdownResourceGroup(String resourceGroupName,
                           int timeout,
                           boolean ignoreSessions,
                           boolean waitForAllSessions)
                           throws ResourceGroupLifecycleException

Gracefully shuts down the resource group after handling inflight work; optionally ignores pending HTTP sessions while handling inflight work.

The following inflight work is allowed to complete before shutdown:

• Pending transaction's and TLOG checkpoint

• Pending HTTP sessions

• Pending JMS work

• Pending work in the execute queues

• RMI requests with transaction context

Further administrative calls are accepted while the server is completing inflight work. For example a forceShutdown command can be issued to quickly shutdown the partition if graceful shutdown takes a long time.

Parameters:

resourceGroupName -

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

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

waitForAllSessions - true indicates waiting for all HTTP sessions during inflight work handling; false indicates waiting for non-persisted HTTP sessions only.

Throws:

PartitionLifeCycleException - Thrown if the partition cannot gracefully shutdown. Use the forceShutdown command to shutdown the server.

ResourceGroupLifecycleException

shutdownResourceGroup

void shutdownResourceGroup(String resourceGroupName,
                           int timeout,
                           boolean ignoreSessions)
                           throws ResourceGroupLifecycleException

Gracefully shuts down the resource group after handling inflight work.

This method is same to call: shutdown(timeout, ignoreSessions, false);

Parameters:

resourceGroupName -

timeout -

ignoreSessions -

Throws:

ResourceGroupLifecycleException

See Also:

ServerRuntimeMBean.shutdownResourceGroup(String, int, boolean, boolean)

shutdownResourceGroup

void shutdownResourceGroup(String resourceGroupName)
                           throws ResourceGroupLifecycleException

Gracefully shuts down the resource group after handling inflight work.

Parameters:

resourceGroupName -

Throws:

ResourceGroupLifecycleException

See Also:

ServerRuntimeMBean.shutdownResourceGroup(String, int, boolean, boolean)

getName

String getName()

The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.

Specified by:

getName in interface WebLogicMBean

Skip navigation links