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.
Security roles | The following roles have read, write, and invoke permission for all non-encrypted attributes and operations in this MBean:
|
||
Fully Qualified Interface Name | If you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:weblogic.management.runtime.ServerLifeCycleRuntimeMBean
|
||
Factory Methods | No factory methods. Instances of this MBean are created automatically. | ||
Access Points |
You can access this MBean from the following MBean attributes:
|
||
Access Points Inherited from RuntimeMBean |
Because this MBean extends or implements RuntimeMBean, you can also access this MBean by retrieving RuntimeMBeans. The following attributes contain RuntimeMBeans and its subtypes:
|
This section describes attributes that provide access to other MBeans.
|
Get preexisting Server Lifecycle Tasks
Factory Methods | No explicit creator method. The child shares the lifecycle of its parent. |
Lookup Operation | lookupTask(String name)
Returns a |
Privileges | Read only |
Type | ServerLifeCycleTaskRuntimeMBean[] |
Relationship type: | Containment. |
This section describes the following attributes:
Private property that disables caching in proxies.
Privileges | Read only |
Type | boolean |
Returns the MBean info for this MBean.
Deprecated.
Privileges | Read only |
Type | javax.management.MBeanInfo |
The Oracle Middleware installation directory.
Available Since | Release 10.3.3.0 |
Privileges | Read only |
Type | java.lang.String |
The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.
Privileges | Read only |
Type | java.lang.String |
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.
Privileges | Read only |
Type | int |
Returns the ObjectName under which this MBean is registered in the MBean server.
Deprecated.
Privileges | Read only |
Type | weblogic.management.WebLogicObjectName |
Return the immediate parent for this MBean
Privileges | Read/Write |
Type |
Returns false if the MBean represented by this object has been unregistered.
Deprecated.
Privileges | Read only |
Type | boolean |
The current state of the server.
Privileges | Read only |
Type | java.lang.String |
Returns the type of the MBean.
Privileges | Read only |
Type | java.lang.String |
The directory where the WebLogic Server instance (server) is installed, without the trailing "/server".
Available Since | Release 10.3.3.0 |
Privileges | Read only |
Type | java.lang.String |
This section describes the following operations:
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
.
Operation Name | "forceShutdown" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
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.
Operation Name | "forceSuspend" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
The IPv4 URL that clients use when connecting to this server using the specified protocol.
Operation Name | "getIPv4URL" |
Parameters | Object [] { protocol }
where:
|
Signature | String [] {
"java.lang.String" } |
Returns | String
|
The IPv6 URL that clients use when connecting to this server using the specified protocol.
Operation Name | "getIPv6URL" |
Parameters | Object [] { protocol }
where:
|
Signature | String [] {
"java.lang.String" } |
Returns | String
|
Transitions the server from ADMIN
to
RUNNING
state.
Operation Name | "resume" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Gracefully transitions a server to the SHUTDOWN
state. The server completes all current work before it shuts
down.
Operation Name | "shutdown" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Gracefully shutdown the server after handling inflight work. The following inflight work is handled :
Pending transaction's and TLOG checkpoint
Pending HTTP sessions
Pending JMS work
Pending work in the Work Managers
RMI requests with tx context or administrator calls
Operation Name | "shutdown" |
Parameters | Object [] { timeout, ignoreSessions, waitForAllSessions }
where:
|
Signature | String [] {
"java.lang.Integer",
"java.lang.Boolean",
"java.lang.Boolean" } |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Gracefully transitions a server to the SHUTDOWN
state. The server completes all current work before it shuts
down.
This method is the same as calling:
shutdown(timeout, ignoreSessions, false);
Operation Name | "shutdown" |
Parameters | Object [] { timeout, ignoreSessions }
where:
|
Signature | String [] {
"java.lang.Integer",
"java.lang.Boolean" } |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Uses the Node Manager to start a Managed Server.
Operation Name | "start" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Uses the Node Manager to start a Managed Server on the given machine
Operation Name | "start" |
Parameters | Object [] { disableMsiMode: }
where:
|
Signature | String [] {
"java.lang.Boolean" } |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Uses the Node Manager to start a Managed Server and place it in
the ADMIN
state.
The server transitions through the following states:
SHUTDOWN
>SUSPENDING
>STANDBY
.
Operation Name | "startInAdmin" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Uses the Node Manager to start a Managed Server and place it in
the STANDBY
state.
The server transitions through the following states:
SHUTDOWN
>SUSPENDING
>STANDBY
.
Operation Name | "startInStandby" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Gracefully suspends server to ADMIN
state. New
requests are rejected and inflight work is allowed to complete.
For more information, see:
Operation Name | "suspend" |
Parameters | null |
Signature | null |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|
Transitions the server from RUNNING
to
ADMIN
state gracefully.
Applications are in admin mode. Inflight work is completed.
Operation Name | "suspend" |
Parameters | Object [] { timeout, ignoreSessions }
where:
|
Signature | String [] {
"java.lang.Integer",
"java.lang.Boolean" } |
Returns | ServerLifeCycleTaskRuntimeMBean |
Exceptions |
|