JTAMigratableTargetMBean (WebLogic Server 10.3 API Reference)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Oracle

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

weblogic.management.configuration
Interface JTAMigratableTargetMBean

All Superinterfaces:: ConfigurationMBean, MigratableTargetMBean, TargetMBean

public interface JTAMigratableTargetMBean
extends MigratableTargetMBean
extends MigratableTargetMBean

The target that is used internally to register the JTA recovery manager to the Migration Manager.

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. For more information, see "Developing Manageable Applications with JMX" on http://edocs.bea.com.

Since:: 7.0.0.0
See Also:: MigratableTargetMBean

Field Summary

Fields inherited from interface weblogic.management.configuration.MigratableTargetMBean
`DEFAULT_MIGRATABLETARGET_SUFFIX, EXACTLY_ONCE, FAILURE_RECOVERY, NONE`

Fields inherited from interface weblogic.management.configuration.ConfigurationMBean
`DEFAULT_EMPTY_BYTE_ARRAY`

Method Summary
`String`	`getMigrationPolicy()` Defines the type of migration policy to use for the services hosted by this migratable target.
`boolean`	`isStrictOwnershipCheck()` Whether continue to boot if cannot find the current owner of TRS to do failback.
`void`	`setMigrationPolicy(String migrationPolicyName)` Sets the value of the MigrationPolicy attribute.
`void`	`setStrictOwnershipCheck(boolean strict)`
`void`	`setUserPreferredServer(ServerMBean userPreferredServer)`

Methods inherited from interface weblogic.management.configuration.MigratableTargetMBean
addConstrainedCandidateServer, getAllCandidateServers, getCluster, getConstrainedCandidateServers, getNumberOfRestartAttempts, getPostScript, getPreScript, getRestartOnFailure, getSecondsBetweenRestarts, isNonLocalPostAllowed, isPostScriptFailureFatal, removeConstrainedCandidateServer, setAllCandidateServers, setCluster, setConstrainedCandidateServers, setNonLocalPostAllowed, setNumberOfRestartAttempts, setPostScript, setPostScriptFailureFatal, setPreScript, setRestartOnFailure, setSecondsBetweenRestarts

Methods inherited from interface weblogic.management.configuration.MigratableTargetMBean

addConstrainedCandidateServer, getAllCandidateServers, getCluster, getConstrainedCandidateServers, getNumberOfRestartAttempts, getPostScript, getPreScript, getRestartOnFailure, getSecondsBetweenRestarts, isNonLocalPostAllowed, isPostScriptFailureFatal, removeConstrainedCandidateServer, setAllCandidateServers, setCluster, setConstrainedCandidateServers, setNonLocalPostAllowed, setNumberOfRestartAttempts, setPostScript, setPostScriptFailureFatal, setPreScript, setRestartOnFailure, setSecondsBetweenRestarts

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
`freezeCurrentValue, getName, getNotes, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet`

Method Detail

setUserPreferredServer

void setUserPreferredServer(ServerMBean userPreferredServer)

Specified by:: setUserPreferredServer in interface MigratableTargetMBean

Parameters:: userPreferredServer - The new userPreferredServer value

getMigrationPolicy

String getMigrationPolicy()

Description copied from interface: MigratableTargetMBean

Defines the type of migration policy to use for the services hosted by this migratable target. Valid options are:

Manual Service Migration Only Indicates that no automatic migration of services hosted by this migratable target will occur.
Auto-Migrate Exactly-Once Services Indicates that if at least one Managed Server in the candidate server list is running, the services hosted by this migratable target will be active somewhere in the cluster if servers should fail or are administratively shut down (either gracefully or forcibly). For example, it is a recommended best practice to use this policy when a migratable target hosts a path service, so if its preferred server fails or is shut down, the path service will automatically migrate to another candidate server, and so will always be active in the cluster.
Note This value can lead to target grouping on a server member. For example, if you have five exactly-once migratable targets and only one Managed Server is started in the cluster, then all five targets will be activated on that server.
Auto-Migrate Failure-Recovery Services Indicates that the services hosted by this migratable target will only start if the migratable target's User Preferred Server (UPS) is started. If an administrator manually shuts down the UPS, either gracefully or forcibly, then a failure-recovery service will not migrate. However, if the UPS fails due to an internal error, then the service will be migrated to another candidate server. If such a candidate server is unavailable (due to either a manual shutdown or an internal failure), then the migration framework will first attempt to reactivate the service on its UPS server. If the UPS server is not available at that time, then the service will be migrated to another candidate server.

Specified by:: getMigrationPolicy in interface MigratableTargetMBean

Returns:: MigrationPolicy, the name of the auto migration policy chosen for this target
See Also:: MigratableTargetMBean.getMigrationPolicy()
Default Value:: MigratableTargetMBean.NONE
Valid Values:: MigratableTargetMBean.NONE, MigratableTargetMBean.FAILURE_RECOVERY

setMigrationPolicy

void setMigrationPolicy(String migrationPolicyName)

Description copied from interface: MigratableTargetMBean

Sets the value of the MigrationPolicy attribute.

Specified by:: setMigrationPolicy in interface MigratableTargetMBean

Parameters:: migrationPolicyName - the name of the auto migration policy chosen for this target
See Also:: JTAMigratableTargetMBean.getMigrationPolicy(), MigratableTargetMBean.setMigrationPolicy(java.lang.String)
Default Value:: MigratableTargetMBean.NONE
Valid Values:: MigratableTargetMBean.NONE, MigratableTargetMBean.FAILURE_RECOVERY

isStrictOwnershipCheck

boolean isStrictOwnershipCheck()

Whether continue to boot if cannot find the current owner of TRS to do failback. This attribute is only meaningful for servers in cluster.

If true: server will fail to boot under this situation.

If false: server will continue to boot without trying to do failback.

Returns:

true or false

Changes take effect after you redeploy the module or restart the server.

Default Value:

false

setStrictOwnershipCheck

void setStrictOwnershipCheck(boolean strict)

Parameters:: strict - whether need to enforce strict ownership check