org.apache.hadoop.hbase.rsgroup

Class RSGroupBasedLoadBalancer

java.lang.Object

org.apache.hadoop.hbase.rsgroup.RSGroupBasedLoadBalancer

All Implemented Interfaces:

org.apache.hadoop.conf.Configurable, org.apache.hadoop.hbase.conf.ConfigurationObserver, org.apache.hadoop.hbase.master.LoadBalancer, RSGroupableBalancer, org.apache.hadoop.hbase.Stoppable

@InterfaceAudience.Private
public class RSGroupBasedLoadBalancer
extends Object
implements RSGroupableBalancer

GroupBasedLoadBalancer, used when Region Server Grouping is configured (HBase-6721) It does region balance based on a table's group membership. Most assignment methods contain two exclusive code paths: Online - when the group table is online and Offline - when it is unavailable. During Offline, assignments are assigned based on cached information in zookeeper. If unavailable (ie bootstrap) then regions are assigned randomly. Once the GROUP table has been assigned, the balancer switches to Online and will then start providing appropriate assignments for user tables.

Field Summary

Fields inherited from interface org.apache.hadoop.hbase.rsgroup.RSGroupableBalancer

HBASE_RSGROUP_LOADBALANCER_CLASS

Fields inherited from interface org.apache.hadoop.hbase.master.LoadBalancer

BOGUS_SERVER_NAME, SYSTEM_TABLES_ON_MASTER, TABLES_ON_MASTER

Constructor Summary

Constructors

Constructor and Description
RSGroupBasedLoadBalancer() Used by reflection in LoadBalancerFactory.

Method Summary

Modifier and Type	Method and Description
List<org.apache.hadoop.hbase.master.RegionPlan>	balanceCluster(Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>> clusterState)
List<org.apache.hadoop.hbase.master.RegionPlan>	balanceCluster(org.apache.hadoop.hbase.TableName tableName, Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>> clusterState)
org.apache.hadoop.conf.Configuration	getConf()
void	initialize()
boolean	isOnline()
boolean	isStopped()
void	onConfigurationChange(org.apache.hadoop.conf.Configuration conf)
void	postMasterStartupInitialize()
org.apache.hadoop.hbase.ServerName	randomAssignment(org.apache.hadoop.hbase.client.RegionInfo region, List<org.apache.hadoop.hbase.ServerName> servers)
void	regionOffline(org.apache.hadoop.hbase.client.RegionInfo regionInfo)
void	regionOnline(org.apache.hadoop.hbase.client.RegionInfo regionInfo, org.apache.hadoop.hbase.ServerName sn)
Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>>	retainAssignment(Map<org.apache.hadoop.hbase.client.RegionInfo,org.apache.hadoop.hbase.ServerName> regions, List<org.apache.hadoop.hbase.ServerName> servers)
Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>>	roundRobinAssignment(List<org.apache.hadoop.hbase.client.RegionInfo> regions, List<org.apache.hadoop.hbase.ServerName> servers)
void	setClusterLoad(Map<org.apache.hadoop.hbase.TableName,Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>>> clusterLoad)
void	setClusterMetrics(org.apache.hadoop.hbase.ClusterMetrics sm)
void	setConf(org.apache.hadoop.conf.Configuration conf)
void	setMasterServices(org.apache.hadoop.hbase.master.MasterServices masterServices)
void	setRsGroupInfoManager(RSGroupInfoManager rsGroupInfoManager)
void	stop(String why)
void	updateBalancerStatus(boolean status)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.hadoop.hbase.master.LoadBalancer

isMasterCanHostUserRegions, isSystemTablesOnlyOnMaster, isTablesOnMaster

Constructor Detail

RSGroupBasedLoadBalancer

@InterfaceAudience.Private
public RSGroupBasedLoadBalancer()

Used by reflection in LoadBalancerFactory.

Method Detail

getConf

public org.apache.hadoop.conf.Configuration getConf()

Specified by:

getConf in interface org.apache.hadoop.conf.Configurable

setConf

public void setConf(org.apache.hadoop.conf.Configuration conf)

Specified by:

setConf in interface org.apache.hadoop.conf.Configurable

setClusterMetrics

public void setClusterMetrics(org.apache.hadoop.hbase.ClusterMetrics sm)

Specified by:

setClusterMetrics in interface org.apache.hadoop.hbase.master.LoadBalancer

setMasterServices

public void setMasterServices(org.apache.hadoop.hbase.master.MasterServices masterServices)

Specified by:

setMasterServices in interface org.apache.hadoop.hbase.master.LoadBalancer

balanceCluster

public List<org.apache.hadoop.hbase.master.RegionPlan> balanceCluster(org.apache.hadoop.hbase.TableName tableName,
                                                                      Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>> clusterState)
                                                               throws org.apache.hadoop.hbase.HBaseIOException

Specified by:

balanceCluster in interface org.apache.hadoop.hbase.master.LoadBalancer

Throws:

org.apache.hadoop.hbase.HBaseIOException

balanceCluster

public List<org.apache.hadoop.hbase.master.RegionPlan> balanceCluster(Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>> clusterState)
                                                               throws org.apache.hadoop.hbase.HBaseIOException

Specified by:

balanceCluster in interface org.apache.hadoop.hbase.master.LoadBalancer

Throws:

org.apache.hadoop.hbase.HBaseIOException

roundRobinAssignment

public Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>> roundRobinAssignment(List<org.apache.hadoop.hbase.client.RegionInfo> regions,
                                                                                                                    List<org.apache.hadoop.hbase.ServerName> servers)
                                                                                                             throws org.apache.hadoop.hbase.HBaseIOException

Specified by:

roundRobinAssignment in interface org.apache.hadoop.hbase.master.LoadBalancer

Throws:

org.apache.hadoop.hbase.HBaseIOException

retainAssignment

public Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>> retainAssignment(Map<org.apache.hadoop.hbase.client.RegionInfo,org.apache.hadoop.hbase.ServerName> regions,
                                                                                                                List<org.apache.hadoop.hbase.ServerName> servers)
                                                                                                         throws org.apache.hadoop.hbase.HBaseIOException

Specified by:

retainAssignment in interface org.apache.hadoop.hbase.master.LoadBalancer

Throws:

org.apache.hadoop.hbase.HBaseIOException

randomAssignment

public org.apache.hadoop.hbase.ServerName randomAssignment(org.apache.hadoop.hbase.client.RegionInfo region,
                                                           List<org.apache.hadoop.hbase.ServerName> servers)
                                                    throws org.apache.hadoop.hbase.HBaseIOException

Specified by:

randomAssignment in interface org.apache.hadoop.hbase.master.LoadBalancer

Throws:

org.apache.hadoop.hbase.HBaseIOException

initialize

public void initialize()
                throws org.apache.hadoop.hbase.HBaseIOException

Specified by:

initialize in interface org.apache.hadoop.hbase.master.LoadBalancer

Throws:

org.apache.hadoop.hbase.HBaseIOException

isOnline

public boolean isOnline()

setClusterLoad

public void setClusterLoad(Map<org.apache.hadoop.hbase.TableName,Map<org.apache.hadoop.hbase.ServerName,List<org.apache.hadoop.hbase.client.RegionInfo>>> clusterLoad)

Specified by:

setClusterLoad in interface org.apache.hadoop.hbase.master.LoadBalancer

regionOnline

public void regionOnline(org.apache.hadoop.hbase.client.RegionInfo regionInfo,
                         org.apache.hadoop.hbase.ServerName sn)

Specified by:

regionOnline in interface org.apache.hadoop.hbase.master.LoadBalancer

regionOffline

public void regionOffline(org.apache.hadoop.hbase.client.RegionInfo regionInfo)

Specified by:

regionOffline in interface org.apache.hadoop.hbase.master.LoadBalancer

onConfigurationChange

public void onConfigurationChange(org.apache.hadoop.conf.Configuration conf)

Specified by:

onConfigurationChange in interface org.apache.hadoop.hbase.conf.ConfigurationObserver

Specified by:

onConfigurationChange in interface org.apache.hadoop.hbase.master.LoadBalancer

stop

public void stop(String why)

Specified by:

stop in interface org.apache.hadoop.hbase.Stoppable

isStopped

public boolean isStopped()

Specified by:

isStopped in interface org.apache.hadoop.hbase.Stoppable

setRsGroupInfoManager

public void setRsGroupInfoManager(RSGroupInfoManager rsGroupInfoManager)

postMasterStartupInitialize

public void postMasterStartupInitialize()

Specified by:

postMasterStartupInitialize in interface org.apache.hadoop.hbase.master.LoadBalancer

updateBalancerStatus

public void updateBalancerStatus(boolean status)

Specified by:

updateBalancerStatus in interface org.apache.hadoop.hbase.master.LoadBalancer