Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02

weblogic.management.runtime
Interface ServerLifeCycleRuntimeMBean

All Superinterfaces:
ServerStates

public interface ServerLifeCycleRuntimeMBean
extends ServerStates

Provides methods that transition servers from one state to another. This class is instantiated only on the Administration Server, but you can use it to transition the states of Managed Servers as well as Administration Servers.

You cannot use it to start an Administration Server, and if you want to use it to start Managed Servers, you must first set up a Node Manager on each Managed Server's host machine.

If you want to use the methods that transition a server into the ADMIN state, you must first set up an administration channel for that server.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime.

Access limited to the following security roles:
Operator

Method Summary
 ServerLifeCycleTaskRuntimeMBean forceShutdown()
          Immediately transitions a server to the SHUTDOWN state.
 ServerLifeCycleTaskRuntimeMBean forceSuspend()
          Transitions the server from RUNNING to ADMIN state forcefully cancelling inflight work.
 int getNodeManagerRestartCount()
          Number of times the server has been restarted using the NodeManager since creation.
 String getState()
          The current state of the server.
 ServerLifeCycleTaskRuntimeMBean[] getTasks()
          Get preexisting Server Lifecycle Tasks
 ServerLifeCycleTaskRuntimeMBean resume()
          Transitions the server from ADMIN to RUNNING state.
 ServerLifeCycleTaskRuntimeMBean shutdown()
          Gracefully transitions a server to the SHUTDOWN state.
 ServerLifeCycleTaskRuntimeMBean shutdown(int timeout, boolean ignoreSessions)
          Gracefully shutdown the server after handling inflight work.
 ServerLifeCycleTaskRuntimeMBean start()
          Uses the Node Manager to start a Managed Server.
 ServerLifeCycleTaskRuntimeMBean suspend()
          Gracefully suspends server to ADMIN state.
 ServerLifeCycleTaskRuntimeMBean suspend(int timeout, boolean ignoreSessions)
          Transitions the server from RUNNING to ADMIN state gracefully.
 

Method Detail

start

ServerLifeCycleTaskRuntimeMBean start()
                                      throws ServerLifecycleException

Uses the Node Manager to start a Managed Server.

Throws:
ServerLifecycleException - If start operation fails

resume

ServerLifeCycleTaskRuntimeMBean resume()
                                       throws ServerLifecycleException

Transitions the server from ADMIN to RUNNING state.

Throws:
ServerLifecycleException - If the resume operation fails

suspend

ServerLifeCycleTaskRuntimeMBean suspend()
                                        throws ServerLifecycleException

Gracefully suspends server to ADMIN state. New requests are rejected and inflight work is allowed to complete.

Returns:
Throws:
ServerLifecycleException - If the operation fails
See Also:
ServerLifeCycleRuntimeMBean.suspend(int, boolean)

suspend

ServerLifeCycleTaskRuntimeMBean 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.

Parameters:
timeout - Seconds to wait for server to transition gracefully. The server calls ServerLifeCycleRuntimeMBean.forceSuspend() after timeout.
ignoreSessions - drop inflight HTTP sessions during graceful suspend
Throws:
ServerLifecycleException - server failed to suspend gracefully. A ServerLifeCycleRuntimeMBean.forceSuspend() or a ServerLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

forceSuspend

ServerLifeCycleTaskRuntimeMBean 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 forcefully.

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

shutdown

ServerLifeCycleTaskRuntimeMBean shutdown()
                                         throws ServerLifecycleException

Gracefully transitions a server to the SHUTDOWN state. The server completes all current work before it shuts down.

Returns:
Throws:
ServerLifecycleException - If the server fails to gracefully shutdown. A ServerLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

shutdown

ServerLifeCycleTaskRuntimeMBean shutdown(int timeout,
                                         boolean ignoreSessions)
                                         throws ServerLifecycleException

Gracefully shutdown the server after handling inflight work. The following inflight work is handled :

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.
Returns:
Throws:
ServerLifecycleException - If the server fails to gracefully shutdown. A ServerLifeCycleRuntimeMBean.forceShutdown() operation can be invoked.

forceShutdown

ServerLifeCycleTaskRuntimeMBean forceShutdown()
                                              throws ServerLifecycleException

Immediately transitions a server to the SHUTDOWN state. The server immediately terminates all current work, moves through the SHUTTING_DOWN state, and ends in the SHUTDOWN state.

You can forcefully shut down a server from any state except UNKNOWN.

Returns:
Throws:
ServerLifecycleException - If force shutdown fails. The server process will exit after ServerMBean.ServerLifeCycleTimeoutVal() seconds.

getTasks

ServerLifeCycleTaskRuntimeMBean[] getTasks()
Get preexisting Server Lifecycle Tasks

Returns:
a list of all completed or pending server lifecycle tasks.

getState

String getState()

The current state of the server.

Server states are described in

Returns:
The state value

getNodeManagerRestartCount

int getNodeManagerRestartCount()
Number of times the server has been restarted using the NodeManager since creation. The first start does not count. The count is valid only if the NodeManager is used to start and restart the server everytime.

Returns:
Number of server restarts using the NodeManager

Documentation is available at
http://download.oracle.com/docs/cd/E12839_01/web.1111/wls.htm
Copyright 1996, 2009, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02