org.apache.hadoop.hbase.rsgroup

Class RSGroupAdminServer

java.lang.Object

org.apache.hadoop.hbase.rsgroup.RSGroupAdminServer

All Implemented Interfaces:

RSGroupAdmin

@InterfaceAudience.Private
public class RSGroupAdminServer
extends Object
implements RSGroupAdmin

Service to support Region Server Grouping (HBase-6721).

Field Summary

Fields

Modifier and Type	Field and Description
static String	KEEP_ONE_SERVER_IN_DEFAULT_ERROR_MESSAGE
private static org.slf4j.Logger	LOG
private MasterServices	master
private RSGroupInfoManager	rsGroupInfoManager

Constructor Summary

Constructors

Constructor and Description
RSGroupAdminServer(MasterServices master, RSGroupInfoManager rsGroupInfoManager)

Method Summary

Modifier and Type	Method and Description
private void	addRegion(LinkedList<RegionInfo> regions, RegionInfo hri)
void	addRSGroup(String name) Creates a new RegionServer group with the given name.
boolean	balanceRSGroup(String groupName) Balance regions in the given RegionServer group.
private void	checkForDeadOrOnlineServers(Set<Address> servers) Check if the set of servers are belong to dead servers list or online servers list.
private void	checkOnlineServersOnly(Set<Address> servers)
private void	checkServersAndTables(Set<Address> servers, Set<TableName> tables, String targetGroupName) Check servers and tables.
private RSGroupInfo	getAndCheckRSGroupInfo(String name) Check passed name.
private List<RegionInfo>	getRegions(Address server)
private Map<TableName,Map<ServerName,List<RegionInfo>>>	getRSGroupAssignmentsByTable(String groupName)
RSGroupInfo	getRSGroupInfo(String groupName) Gets RSGroupInfo for given group name.
RSGroupInfo	getRSGroupInfoOfTable(TableName tableName) Gets RSGroupInfo for the given table's group.
RSGroupInfo	getRSGroupOfServer(Address hostPort) Retrieve the RSGroupInfo a server is affiliated to
List<RSGroupInfo>	listRSGroups() Lists current set of RegionServer groups.
private void	moveRegionsFromServers(Set<Address> servers, Set<TableName> tables, String targetGroupName) Moves every region from servers which are currently located on these servers, but should not be located there.
private void	moveRegionsToServers(Set<Address> servers, Set<TableName> tables, String targetGroupName) Moves every region of tables which should be kept on the servers, but currently they are located on other servers.
void	moveServers(Set<Address> servers, String targetGroupName) Move given set of servers to the specified target RegionServer group.
void	moveServersAndTables(Set<Address> servers, Set<TableName> tables, String targetGroup) Move given set of servers and tables to the specified target RegionServer group.
void	moveTables(Set<TableName> tables, String targetGroup) Move given set of tables to the specified target RegionServer group.
void	removeRSGroup(String name) Removes RegionServer group associated with the given name.
void	removeServers(Set<Address> servers) Remove decommissioned servers from rsgroup.
private Map<String,RegionState>	rsGroupGetRegionsInTransition(String groupName)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

private static final org.slf4j.Logger LOG

KEEP_ONE_SERVER_IN_DEFAULT_ERROR_MESSAGE

public static final String KEEP_ONE_SERVER_IN_DEFAULT_ERROR_MESSAGE

See Also:

Constant Field Values

master

private MasterServices master

rsGroupInfoManager

private final RSGroupInfoManager rsGroupInfoManager

Constructor Detail

RSGroupAdminServer

public RSGroupAdminServer(MasterServices master,
                          RSGroupInfoManager rsGroupInfoManager)
                   throws IOException

Throws:

IOException

Method Detail

getRSGroupInfo

public RSGroupInfo getRSGroupInfo(String groupName)
                           throws IOException

Description copied from interface: RSGroupAdmin

Gets RSGroupInfo for given group name.

Specified by:

getRSGroupInfo in interface RSGroupAdmin

Throws:

IOException

getRSGroupInfoOfTable

public RSGroupInfo getRSGroupInfoOfTable(TableName tableName)
                                  throws IOException

Description copied from interface: RSGroupAdmin

Gets RSGroupInfo for the given table's group.

Specified by:

getRSGroupInfoOfTable in interface RSGroupAdmin

Throws:

IOException

checkOnlineServersOnly

private void checkOnlineServersOnly(Set<Address> servers)
                             throws ConstraintException

Throws:

ConstraintException

getAndCheckRSGroupInfo

private RSGroupInfo getAndCheckRSGroupInfo(String name)
                                    throws IOException

Check passed name. Fail if nulls or if corresponding RSGroupInfo not found.

Returns:

The RSGroupInfo named name

Throws:

IOException

getRegions

private List<RegionInfo> getRegions(Address server)

Returns:

List of Regions associated with this server.

addRegion

private void addRegion(LinkedList<RegionInfo> regions,
                       RegionInfo hri)

checkServersAndTables

private void checkServersAndTables(Set<Address> servers,
                                   Set<TableName> tables,
                                   String targetGroupName)
                            throws IOException

Check servers and tables.

Parameters:

servers - servers to move

tables - tables to move

targetGroupName - target group name

Throws:

IOException - if nulls or if servers and tables not belong to the same group

moveRegionsFromServers

private void moveRegionsFromServers(Set<Address> servers,
                                    Set<TableName> tables,
                                    String targetGroupName)
                             throws IOException

Moves every region from servers which are currently located on these servers, but should not be located there.

Parameters:

servers - the servers that will move to new group

tables - these tables will be kept on the servers, others will be moved

targetGroupName - the target group name

Throws:

IOException - if moving the server and tables fail

moveRegionsToServers

private void moveRegionsToServers(Set<Address> servers,
                                  Set<TableName> tables,
                                  String targetGroupName)
                           throws IOException

Moves every region of tables which should be kept on the servers, but currently they are located on other servers.

Parameters:

servers - the regions of these servers will be kept on the servers, others will be moved

tables - the tables that will move to new group

targetGroupName - the target group name

Throws:

IOException - if moving the region fails

moveServers

public void moveServers(Set<Address> servers,
                        String targetGroupName)
                 throws IOException

Description copied from interface: RSGroupAdmin

Move given set of servers to the specified target RegionServer group.

Specified by:

moveServers in interface RSGroupAdmin

Throws:

IOException

moveTables

public void moveTables(Set<TableName> tables,
                       String targetGroup)
                throws IOException

Description copied from interface: RSGroupAdmin

Move given set of tables to the specified target RegionServer group. This will unassign all of a table's region so it can be reassigned to the correct group.

Specified by:

moveTables in interface RSGroupAdmin

Throws:

IOException

addRSGroup

public void addRSGroup(String name)
                throws IOException

Description copied from interface: RSGroupAdmin

Creates a new RegionServer group with the given name.

Specified by:

addRSGroup in interface RSGroupAdmin

Throws:

IOException

removeRSGroup

public void removeRSGroup(String name)
                   throws IOException

Description copied from interface: RSGroupAdmin

Removes RegionServer group associated with the given name.

Specified by:

removeRSGroup in interface RSGroupAdmin

Throws:

IOException

balanceRSGroup

public boolean balanceRSGroup(String groupName)
                       throws IOException

Description copied from interface: RSGroupAdmin

Balance regions in the given RegionServer group.

Specified by:

balanceRSGroup in interface RSGroupAdmin

Returns:

boolean Whether balance ran or not

Throws:

IOException

listRSGroups

public List<RSGroupInfo> listRSGroups()
                               throws IOException

Description copied from interface: RSGroupAdmin

Lists current set of RegionServer groups.

Specified by:

listRSGroups in interface RSGroupAdmin

Throws:

IOException

getRSGroupOfServer

public RSGroupInfo getRSGroupOfServer(Address hostPort)
                               throws IOException

Description copied from interface: RSGroupAdmin

Retrieve the RSGroupInfo a server is affiliated to

Specified by:

getRSGroupOfServer in interface RSGroupAdmin

Parameters:

hostPort - HostPort to get RSGroupInfo for

Throws:

IOException

moveServersAndTables

public void moveServersAndTables(Set<Address> servers,
                                 Set<TableName> tables,
                                 String targetGroup)
                          throws IOException

Description copied from interface: RSGroupAdmin

Move given set of servers and tables to the specified target RegionServer group.

Specified by:

moveServersAndTables in interface RSGroupAdmin

Parameters:

servers - set of servers to move

tables - set of tables to move

targetGroup - the target group name

Throws:

IOException - if moving the server and tables fail

removeServers

public void removeServers(Set<Address> servers)
                   throws IOException

Description copied from interface: RSGroupAdmin

Remove decommissioned servers from rsgroup. 1. Sometimes we may find the server aborted due to some hardware failure and we must offline the server for repairing. Or we need to move some servers to join other clusters. So we need to remove these servers from the rsgroup. 2. Dead/recovering/live servers will be disallowed.

Specified by:

removeServers in interface RSGroupAdmin

Parameters:

servers - set of servers to remove

Throws:

IOException

rsGroupGetRegionsInTransition

private Map<String,RegionState> rsGroupGetRegionsInTransition(String groupName)
                                                       throws IOException

Throws:

IOException

getRSGroupAssignmentsByTable

private Map<TableName,Map<ServerName,List<RegionInfo>>> getRSGroupAssignmentsByTable(String groupName)
                                                                              throws IOException

Throws:

IOException

checkForDeadOrOnlineServers

private void checkForDeadOrOnlineServers(Set<Address> servers)
                                  throws ConstraintException

Check if the set of servers are belong to dead servers list or online servers list.

Parameters:

servers - servers to remove

Throws:

ConstraintException