weblogic.management.runtime

Interface AppRuntimeStateRuntimeMBean

All Superinterfaces:

DynamicMBean, MBeanRegistration, NotificationBroadcaster, RuntimeMBean, WebLogicMBean

public interface AppRuntimeStateRuntimeMBean
extends RuntimeMBean

Provides access to runtime state for deployed applications.

Access limited to the following security roles:

Deployer, Operator, Monitor

Field Summary

Fields

Modifier and Type	Field and Description
static String	STATE_ACTIVE Running and available.
static String	STATE_ADMIN Running, but only accessible through the administration port.
static String	STATE_FAILED Configured but not deployed.
static String	STATE_NEW Configured but not deployed.
static String	STATE_PREPARED Ready for activation.
static String	STATE_RETIRED Configured but not deployed.
static String	STATE_UPDATE_PENDING Running and being updated.

Method Summary

Modifier and Type	Method and Description
String[]	getApplicationIds()
String	getCurrentState(String appid, String target) Aggregate state for the application.
String	getCurrentState(String appid, String moduleid, String target) Aggregate state for the module.
String	getCurrentState(String appid, String moduleid, String subModuleId, String target) Aggregate state for a submodule.
String	getIntendedState(String appid) The state the application should be in.
String	getIntendedState(String appid, String target) The state the application should be in on a specific target.
String[]	getModuleIds(String appid) Names of the modules contained in the application.
String[]	getModuleTargets(String appid, String moduleid) Logical targets where the module is deployed.
String[]	getModuleTargets(String appid, String moduleid, String subModuleId) Logical targets where the submodule is deployed.
String	getModuleType(String appid, String moduleid) Indicates the type of module: EAR, WAR, etc.
long	getRetireTimeMillis(String appid) The time when the application will be retired.
int	getRetireTimeoutSeconds(String appid) The amount of time the application is given to retire.
String[]	getSubmoduleIds(String appid, String moduleid) Submodules associated with this module.
boolean	isActiveVersion(String appid) Indicates if the application is the active version, the one that new sessions will use.
boolean	isAdminMode(String appid, String target) Indicates if the application should only be available through the administration port.

Methods inherited from interface weblogic.management.runtime.RuntimeMBean

addPropertyChangeListener, 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, preDeregister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Field Detail

STATE_NEW

static final String STATE_NEW

Configured but not deployed.

See Also:

Constant Field Values

STATE_FAILED

static final String STATE_FAILED

Configured but not deployed. This is the state of an application after it fails during dynamic deployment activate or during static deployment startup. This state can only be set as a current state, but not as an intended state.

See Also:

Constant Field Values

STATE_RETIRED

static final String STATE_RETIRED

Configured but not deployed. This is the state of an application version after it is retired. The administrator is responsible for explicitly removing the retired application version from the configuration. This state can only be set as a current state, but not as an intended state.

See Also:

Constant Field Values

STATE_PREPARED

static final String STATE_PREPARED

Ready for activation.

See Also:

Constant Field Values

STATE_ADMIN

static final String STATE_ADMIN

Running, but only accessible through the administration port.

See Also:

Constant Field Values

STATE_ACTIVE

static final String STATE_ACTIVE

Running and available.

See Also:

Constant Field Values

STATE_UPDATE_PENDING

static final String STATE_UPDATE_PENDING

Running and being updated.

See Also:

Constant Field Values

Method Detail

getApplicationIds

String[] getApplicationIds()

Returns:

List of known applications

isAdminMode

boolean isAdminMode(String appid,
                    String target)

Indicates if the application should only be available through the administration port. This is the desired state of the application.

Parameters:

appid - is the application id

target -

Returns:

true if application deployed to named target is in admin mode. Returns false otherwise, or if application is not deployed to target.

isActiveVersion

boolean isActiveVersion(String appid)

Indicates if the application is the active version, the one that new sessions will use.

Parameters:

appid - is the application id

Returns:

true if application deployed to named target is the active version.

getRetireTimeMillis

long getRetireTimeMillis(String appid)

The time when the application will be retired.

Parameters:

appid -

getRetireTimeoutSeconds

int getRetireTimeoutSeconds(String appid)

The amount of time the application is given to retire.

Parameters:

appid -

getIntendedState

String getIntendedState(String appid)

The state the application should be in.

Parameters:

appid -

getIntendedState

String getIntendedState(String appid,
                        String target)

The state the application should be in on a specific target.

Parameters:

appid -

target -

getCurrentState

String getCurrentState(String appid,
                       String target)

Aggregate state for the application. This is defined as the most advanced state of the application's modules on the named target.

Parameters:

appid -

target - logical target where the app is deployed

Returns:

Aggregate state for the application, or null if app not configured on target

getModuleIds

String[] getModuleIds(String appid)

Names of the modules contained in the application. This does not include submodules.

Parameters:

appid -

Returns:

list of modules or null if app doesn't exist

Access limited to the following security roles:

Deployer

getSubmoduleIds

String[] getSubmoduleIds(String appid,
                         String moduleid)

Submodules associated with this module.

Parameters:

appid -

moduleid -

Returns:

type of module

See Also:

WebLogicModuleType

getModuleType

String getModuleType(String appid,
                     String moduleid)

Indicates the type of module: EAR, WAR, etc.

Parameters:

appid -

moduleid -

Returns:

type of module

See Also:

WebLogicModuleType

getCurrentState

String getCurrentState(String appid,
                       String moduleid,
                       String target)

Aggregate state for the module. This is defined as the most advanced state of the module on all servers associated with the named target.

Parameters:

appid -

moduleid -

target - logical target where module is deployed

Returns:

Aggregate state for the application, or null if app not configured on target

getModuleTargets

String[] getModuleTargets(String appid,
                          String moduleid)

Logical targets where the module is deployed.

Parameters:

appid -

moduleid -

getCurrentState

String getCurrentState(String appid,
                       String moduleid,
                       String subModuleId,
                       String target)

Aggregate state for a submodule. This is defined as the most advanced state of the submodule on all servers associated with the named target.

Parameters:

appid -

moduleid -

subModuleId -

target - logical target where module is deployed

Returns:

Aggregate state for the application, or null if app not configured on target

getModuleTargets

String[] getModuleTargets(String appid,
                          String moduleid,
                          String subModuleId)

Logical targets where the submodule is deployed.

Parameters:

appid -

moduleid -

subModuleId -