Package weblogic.management.configuration

Interface JTAMigratableTargetMBean

All Superinterfaces:

ConfigurationMBean, DescriptorBean, javax.management.DynamicMBean, javax.management.MBeanRegistration, MigratableTargetMBean, javax.management.NotificationBroadcaster, SettableBean, SingletonServiceBaseMBean, TargetMBean, WebLogicMBean

public interface JTAMigratableTargetMBean
extends MigratableTargetMBean

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

See Also:

MigratableTargetMBean

Field Summary

Fields inherited from interface weblogic.management.configuration.ConfigurationMBean

DEFAULT_EMPTY_BYTE_ARRAY

Fields inherited from interface weblogic.management.configuration.MigratableTargetMBean

DEFAULT_MIGRATABLETARGET_SUFFIX, EXACTLY_ONCE, FAILURE_RECOVERY, NONE, SHUTDOWN_RECOVERY

Method Summary

Modifier and Type	Method	Description
java.lang.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(java.lang.String migrationPolicyName)	Sets the value of the MigrationPolicy attribute.
void	setStrictOwnershipCheck(boolean strict)
void	setUserPreferredServer(ServerMBean userPreferredServer)

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean

freezeCurrentValue, getId, getInheritedProperties, getName, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet

Methods inherited from interface weblogic.descriptor.DescriptorBean

addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener

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 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 javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Methods inherited from interface weblogic.management.configuration.SingletonServiceBaseMBean

getAdditionalMigrationAttempts, getHostingServer, getMillisToSleepBetweenAttempts, getUserPreferredServer, setAdditionalMigrationAttempts, setMillisToSleepBetweenAttempts

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent

Method Detail

setUserPreferredServer

void setUserPreferredServer(ServerMBean userPreferredServer)

Specified by:

setUserPreferredServer in interface MigratableTargetMBean

Specified by:

setUserPreferredServer in interface SingletonServiceBaseMBean

Parameters:

userPreferredServer - The new userPreferredServer value

getMigrationPolicy

java.lang.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.

  Notes
  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.
  This policy does not apply for JTA service migration.

• 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.
• Auto-Migrate Shutdown-Recovery Services Indicates that the services hosted by this migratable target will migrate to one of the candidate servers, if server is administratively shut down (either gracefully or forcibly). Once recovery is done, service is migrated back to failed 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, MigratableTargetMBean.SHUTDOWN_RECOVERY

setMigrationPolicy

void setMigrationPolicy(java.lang.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:

getMigrationPolicy(), MigratableTargetMBean.setMigrationPolicy(java.lang.String)

Default Value:

MigratableTargetMBean.NONE

Valid Values:

MigratableTargetMBean.NONE, MigratableTargetMBean.FAILURE_RECOVERY, MigratableTargetMBean.SHUTDOWN_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

Default Value:

false

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setStrictOwnershipCheck

void setStrictOwnershipCheck(boolean strict)

Parameters:

strict - whether need to enforce strict ownership check