org.apache.hadoop.hbase.rsgroup

Class RSGroupBasedLoadBalancer

java.lang.Object

org.apache.hadoop.hbase.rsgroup.RSGroupBasedLoadBalancer

All Implemented Interfaces:

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

@InterfaceAudience.Private
public class RSGroupBasedLoadBalancer
extends Object
implements RSGroupableBalancer, LoadBalancer

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

Modifier and Type	Field and Description
static String	HBASE_GROUP_LOADBALANCER_CLASS Config for pluggable load balancers

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

Constructor Summary

Constructors

Constructor and Description
RSGroupBasedLoadBalancer()
RSGroupBasedLoadBalancer(RSGroupInfoManager RSGroupInfoManager)

Method Summary

Methods

Modifier and Type	Method and Description
List<RegionPlan>	balanceCluster(Map<ServerName,List<HRegionInfo>> clusterState)
List<RegionPlan>	balanceCluster(TableName tableName, Map<ServerName,List<HRegionInfo>> clusterState)
org.apache.hadoop.conf.Configuration	getConf()
Set<HRegionInfo>	getMisplacedRegions(Map<HRegionInfo,ServerName> regions)
Map<HRegionInfo,ServerName>	immediateAssignment(List<HRegionInfo> regions, List<ServerName> servers)
void	initialize()
boolean	isOnline()
boolean	isStopped()
void	onConfigurationChange(org.apache.hadoop.conf.Configuration conf)
void	postMasterStartupInitialize()
ServerName	randomAssignment(HRegionInfo region, List<ServerName> servers)
void	regionOffline(HRegionInfo regionInfo)
void	regionOnline(HRegionInfo regionInfo, ServerName sn)
Map<ServerName,List<HRegionInfo>>	retainAssignment(Map<HRegionInfo,ServerName> regions, List<ServerName> servers)
Map<ServerName,List<HRegionInfo>>	roundRobinAssignment(List<HRegionInfo> regions, List<ServerName> servers)
void	setClusterStatus(ClusterStatus st)
void	setConf(org.apache.hadoop.conf.Configuration conf)
void	setMasterServices(MasterServices masterServices)
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

Field Detail

HBASE_GROUP_LOADBALANCER_CLASS

public static final String HBASE_GROUP_LOADBALANCER_CLASS

Config for pluggable load balancers

See Also:

Constant Field Values

Constructor Detail

RSGroupBasedLoadBalancer

@InterfaceAudience.Private
public RSGroupBasedLoadBalancer()

RSGroupBasedLoadBalancer

@InterfaceAudience.Private
public RSGroupBasedLoadBalancer(RSGroupInfoManager RSGroupInfoManager)

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

setClusterStatus

public void setClusterStatus(ClusterStatus st)

Specified by:

setClusterStatus in interface LoadBalancer

setMasterServices

public void setMasterServices(MasterServices masterServices)

Specified by:

setMasterServices in interface LoadBalancer

balanceCluster

public List<RegionPlan> balanceCluster(TableName tableName,
                              Map<ServerName,List<HRegionInfo>> clusterState)
                                throws HBaseIOException

Specified by:

balanceCluster in interface LoadBalancer

Throws:

HBaseIOException

balanceCluster

public List<RegionPlan> balanceCluster(Map<ServerName,List<HRegionInfo>> clusterState)
                                throws HBaseIOException

Specified by:

balanceCluster in interface LoadBalancer

Throws:

HBaseIOException

roundRobinAssignment

public Map<ServerName,List<HRegionInfo>> roundRobinAssignment(List<HRegionInfo> regions,
                                                     List<ServerName> servers)
                                                       throws HBaseIOException

Specified by:

roundRobinAssignment in interface LoadBalancer

Throws:

HBaseIOException

retainAssignment

public Map<ServerName,List<HRegionInfo>> retainAssignment(Map<HRegionInfo,ServerName> regions,
                                                 List<ServerName> servers)
                                                   throws HBaseIOException

Specified by:

retainAssignment in interface LoadBalancer

Throws:

HBaseIOException

immediateAssignment

public Map<HRegionInfo,ServerName> immediateAssignment(List<HRegionInfo> regions,
                                              List<ServerName> servers)
                                                throws HBaseIOException

Specified by:

immediateAssignment in interface LoadBalancer

Throws:

HBaseIOException

randomAssignment

public ServerName randomAssignment(HRegionInfo region,
                          List<ServerName> servers)
                            throws HBaseIOException

Specified by:

randomAssignment in interface LoadBalancer

Throws:

HBaseIOException

getMisplacedRegions

public Set<HRegionInfo> getMisplacedRegions(Map<HRegionInfo,ServerName> regions)
                                     throws IOException

Throws:

IOException

initialize

public void initialize()
                throws HBaseIOException

Specified by:

initialize in interface LoadBalancer

Throws:

HBaseIOException

isOnline

public boolean isOnline()

regionOnline

public void regionOnline(HRegionInfo regionInfo,
                ServerName sn)

Specified by:

regionOnline in interface LoadBalancer

regionOffline

public void regionOffline(HRegionInfo regionInfo)

Specified by:

regionOffline in interface LoadBalancer

onConfigurationChange

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

Specified by:

onConfigurationChange in interface ConfigurationObserver

Specified by:

onConfigurationChange in interface LoadBalancer

stop

public void stop(String why)

Specified by:

stop in interface Stoppable

isStopped

public boolean isStopped()

Specified by:

isStopped in interface Stoppable

postMasterStartupInitialize

public void postMasterStartupInitialize()

Specified by:

postMasterStartupInitialize in interface LoadBalancer

updateBalancerStatus

public void updateBalancerStatus(boolean status)

Specified by:

updateBalancerStatus in interface LoadBalancer