HAManager MBean

Partial ObjectName:
WebSphere:*,type=HAManager

ResourceInstanceIdentifier:

     The resource being modified for the MBean is of type Cell

     The instance is identified by the value of key cell in the MBean's Object Name >


MBean HAManager

Management interface for the HA Manager services.

Since:

5.1 XD


Attribute Summary

booleansupportsDynamicCGReload
           Internal use only.
booleanisInSingleServerMode
           Returns true if this process is running in single server mode.

Operation Summary

CoreGroupInfogetCoreGroupInfo()
           Returns information about the core group.
java.lang.String[]getCoordinators()
           Return a String array containing the current list of active coordinator processes for the core group.
GroupData[]queryGroupState(java.lang.String groupNameProps, java.lang.Integer maxGroupsPerCoordinator, java.lang.Boolean includeMemberData)
           Returns group information for each group that matches the query criteria.
GroupMemberData[]retrieveGroupMembers(com.ibm.wsspi.hamanager.GroupName groupName)
           Retrieve group member data for a specified group
ServerWithActiveGroups[]queryCountActiveGroupsOnServers(java.lang.String groupNameProps, java.lang.Integer maxGroupsPerCoordinator)
           Report the number of active members on various servers
voidenableMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)
           Enable the specified group member.
voiddisableMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)
           Disable the specified group member.
voidactivateMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)
           Activate the specified group member.
voiddeactivateMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)
           Deactivate the specified group member.
voidenableGroup(com.ibm.wsspi.hamanager.GroupName groupName)
           Enable all of the members of the specified group.
voiddisableGroup(com.ibm.wsspi.hamanager.GroupName groupName)
           Disable all of the members of the specified group.
com.ibm.wsspi.hamanager.GroupNamecreateGroupName(java.lang.String groupNameCSV)
           Creates a group name from a comma separated String of Name=Value pairs
voidmigrateActiveMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String currMemberNodeName, java.lang.String currMemberServerName, java.lang.String futureMemberNodeName, java.lang.String futureMemberServerName)
           Move the active state from one member of the group to another member of the group.
java.lang.String[]resolvePolicyForGroup(com.ibm.wsspi.hamanager.GroupName groupName)
           This returns the policy(s) matching the provided group name.
voidrunPolicy(com.ibm.wsspi.hamanager.GroupName groupName)
           This runs the policy associated with the specified group.
voidresetQuorumProviders()
           Request that quorum providers refresh all information and recalculate quorum based on latest data.
Ljava.lang.StringgetConnectedMembers()
           Get the list of core group members to which this member is connected to at the network layer.
voidupdateRuntimeConfig(java.io.Serializable config)
           Internal use only!
java.io.SerializablegetCoreGroupConfig(java.lang.String coreGroupName)
           Internal use only!

Attribute Detail

supportsDynamicCGReload

public boolean supportsDynamicCGReload

     Internal use only.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


isInSingleServerMode

public boolean isInSingleServerMode

     Returns true if this process is running in single server mode.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


Operation Detail

getCoreGroupInfo

public CoreGroupInfo getCoreGroupInfo()

     Returns information about the core group.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


getCoordinators

public java.lang.String[] getCoordinators()

     Return a String array containing the current list of active coordinator processes for the core group. Each String in the array will be in the form of Cell\Node\Server.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


queryGroupState

public GroupData[] queryGroupState(java.lang.String groupNameProps, java.lang.Integer maxGroupsPerCoordinator, java.lang.Boolean includeMemberData)

     Returns group information for each group that matches the query criteria.

Parameters:

     groupNameProps - A comma delimited String of name=value pairs. Used for matching a group names.
     maxGroupsPerCoordinator - At most this number of matching groups will be returned per coordinator. Use -1 for no maximum limit.
     includeMemberData - A boolean to indicate whether group data or both group and member data should be returned.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


retrieveGroupMembers

public GroupMemberData[] retrieveGroupMembers(com.ibm.wsspi.hamanager.GroupName groupName)

     Retrieve group member data for a specified group

Parameters:

     groupName - GroupName of the group for which member data is desired.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


queryCountActiveGroupsOnServers

public ServerWithActiveGroups[] queryCountActiveGroupsOnServers(java.lang.String groupNameProps, java.lang.Integer maxGroupsPerCoordinator)

     Report the number of active members on various servers

Parameters:

     groupNameProps - A comma delimited String of name=value pairs. Used for matching a group names.
     maxGroupsPerCoordinator - At most this number of matching groups will be returned per coordinator. Use -1 for no maximum limit.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


enableMember

public void enableMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)

     Enable the specified group member. The member must currently be in the DISABLED state. If successful the member will transition to the IDLE state.

Parameters:

     groupName - The name of the group containing the desired member.
     nodeName - The name of the node hosting the server with the desired member
     serverName - The name of the server hosting the member.

Security Roles:

     administrator
     operator


disableMember

public void disableMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)

     Disable the specified group member. Disabling an active member will result in it being deactivated. If successful the member will transition to the DISABLED state.

Parameters:

     groupName - The name of the group containing the desired member.
     nodeName - The name of the node hosting the server with the desired member
     serverName - The name of the server hosting the member.

Security Roles:

     administrator
     operator


activateMember

public void activateMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)

     Activate the specified group member. The group containing the member must be managed by a No Operation policy, and the member must currently be in the IDLE state. If successful the member will transition to the ACTIVE state.

Parameters:

     groupName - The name of the group containing the desired member.
     nodeName - The name of the node hosting the server with the desired member
     serverName - The name of the server hosting the member.

Security Roles:

     administrator
     operator


deactivateMember

public void deactivateMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String nodeName, java.lang.String serverName)

     Deactivate the specified group member. The group containing the member must be managed by a No Operation policy, and the member must currently be in the ACTIVE state. If successful the member will transition to the IDLE state.

Parameters:

     groupName - The name of the group containing the desired member.
     nodeName - The name of the node hosting the server with the desired member
     serverName - The name of the server hosting the member.

Security Roles:

     administrator
     operator


enableGroup

public void enableGroup(com.ibm.wsspi.hamanager.GroupName groupName)

     Enable all of the members of the specified group. The members must currently be in the DISABLED state. If successful the members will transition to the IDLE state.

Parameters:

     groupName - The name of the group to enable.

Security Roles:

     administrator
     operator


disableGroup

public void disableGroup(com.ibm.wsspi.hamanager.GroupName groupName)

     Disable all of the members of the specified group. If successful the members will transition to the DISABLED state.

Parameters:

     groupName - The name of the group to enable.

Security Roles:

     administrator
     operator


createGroupName

public com.ibm.wsspi.hamanager.GroupName createGroupName(java.lang.String groupNameCSV)

     Creates a group name from a comma separated String of Name=Value pairs

Parameters:

     groupNameCSV - A comma delimited String of name=value pairs (e.g. a=x,b=y,d=z)

Security Roles:

     administrator
     operator


migrateActiveMember

public void migrateActiveMember(com.ibm.wsspi.hamanager.GroupName groupName, java.lang.String currMemberNodeName, java.lang.String currMemberServerName, java.lang.String futureMemberNodeName, java.lang.String futureMemberServerName)

     Move the active state from one member of the group to another member of the group. The group containing the members must be managed by a One Of N or M Of N policy, and the policy must not have any preferred servers configured.

Parameters:

     groupName - The name of the group containing the members.
     currMemberNodeName - The name of the node hosting the current active member.
     currMemberServerName - The name of the server hosting the current active member.
     futureMemberNodeName - The name of the node hosting the desired future active member
     futureMemberServerName - The name of the server hosting the desired future active member

Security Roles:

     administrator
     operator


resolvePolicyForGroup

public java.lang.String[] resolvePolicyForGroup(com.ibm.wsspi.hamanager.GroupName groupName)

     This returns the policy(s) matching the provided group name.

Parameters:

     groupName - The name of the group for which you wish to determine the associated policy.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


runPolicy

public void runPolicy(com.ibm.wsspi.hamanager.GroupName groupName)

     This runs the policy associated with the specified group.

Parameters:

     groupName - The name of the group which the associated policy should be applied to.

Security Roles:

     administrator
     operator


resetQuorumProviders

public void resetQuorumProviders()

     Request that quorum providers refresh all information and recalculate quorum based on latest data.

Security Roles:

     administrator
     operator


getConnectedMembers

public Ljava.lang.String getConnectedMembers()

     Get the list of core group members to which this member is connected to at the network layer.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


updateRuntimeConfig

public void updateRuntimeConfig(java.io.Serializable config)

     Internal use only!

Parameters:

     config - New state data.

Security Roles:

     administrator
     operator


getCoreGroupConfig

public java.io.Serializable getCoreGroupConfig(java.lang.String coreGroupName)

     Internal use only!

Parameters:

     coreGroupName - Core group name/

Security Roles:

     administrator
     operator


Copyright IBM Corporation 2002, 2012