You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hbase.apache.org by gi...@apache.org on 2017/12/24 15:19:21 UTC
[13/23] hbase-site git commit: Published site at .
http://git-wip-us.apache.org/repos/asf/hbase-site/blob/c33bd58a/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupBasedLoadBalancer.html
----------------------------------------------------------------------
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupBasedLoadBalancer.html b/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupBasedLoadBalancer.html
index 9a7fe9f..164ea88 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupBasedLoadBalancer.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupBasedLoadBalancer.html
@@ -51,289 +51,289 @@
<span class="sourceLineNo">043</span>import org.apache.hadoop.hbase.master.RegionPlan;<a name="line.43"></a>
<span class="sourceLineNo">044</span>import org.apache.hadoop.hbase.master.balancer.StochasticLoadBalancer;<a name="line.44"></a>
<span class="sourceLineNo">045</span>import org.apache.hadoop.hbase.net.Address;<a name="line.45"></a>
-<span class="sourceLineNo">046</span>import org.apache.hadoop.hbase.shaded.com.google.common.annotations.VisibleForTesting;<a name="line.46"></a>
-<span class="sourceLineNo">047</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.ArrayListMultimap;<a name="line.47"></a>
-<span class="sourceLineNo">048</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.LinkedListMultimap;<a name="line.48"></a>
-<span class="sourceLineNo">049</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.ListMultimap;<a name="line.49"></a>
-<span class="sourceLineNo">050</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.Lists;<a name="line.50"></a>
-<span class="sourceLineNo">051</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.Maps;<a name="line.51"></a>
-<span class="sourceLineNo">052</span>import org.apache.hadoop.util.ReflectionUtils;<a name="line.52"></a>
-<span class="sourceLineNo">053</span>import org.apache.yetus.audience.InterfaceAudience;<a name="line.53"></a>
-<span class="sourceLineNo">054</span>import org.slf4j.Logger;<a name="line.54"></a>
-<span class="sourceLineNo">055</span>import org.slf4j.LoggerFactory;<a name="line.55"></a>
-<span class="sourceLineNo">056</span><a name="line.56"></a>
-<span class="sourceLineNo">057</span>/**<a name="line.57"></a>
-<span class="sourceLineNo">058</span> * GroupBasedLoadBalancer, used when Region Server Grouping is configured (HBase-6721)<a name="line.58"></a>
-<span class="sourceLineNo">059</span> * It does region balance based on a table's group membership.<a name="line.59"></a>
-<span class="sourceLineNo">060</span> *<a name="line.60"></a>
-<span class="sourceLineNo">061</span> * Most assignment methods contain two exclusive code paths: Online - when the group<a name="line.61"></a>
-<span class="sourceLineNo">062</span> * table is online and Offline - when it is unavailable.<a name="line.62"></a>
-<span class="sourceLineNo">063</span> *<a name="line.63"></a>
-<span class="sourceLineNo">064</span> * During Offline, assignments are assigned based on cached information in zookeeper.<a name="line.64"></a>
-<span class="sourceLineNo">065</span> * If unavailable (ie bootstrap) then regions are assigned randomly.<a name="line.65"></a>
-<span class="sourceLineNo">066</span> *<a name="line.66"></a>
-<span class="sourceLineNo">067</span> * Once the GROUP table has been assigned, the balancer switches to Online and will then<a name="line.67"></a>
-<span class="sourceLineNo">068</span> * start providing appropriate assignments for user tables.<a name="line.68"></a>
-<span class="sourceLineNo">069</span> *<a name="line.69"></a>
-<span class="sourceLineNo">070</span> */<a name="line.70"></a>
-<span class="sourceLineNo">071</span>@InterfaceAudience.Private<a name="line.71"></a>
-<span class="sourceLineNo">072</span>public class RSGroupBasedLoadBalancer implements RSGroupableBalancer {<a name="line.72"></a>
-<span class="sourceLineNo">073</span> private static final Logger LOG = LoggerFactory.getLogger(RSGroupBasedLoadBalancer.class);<a name="line.73"></a>
-<span class="sourceLineNo">074</span><a name="line.74"></a>
-<span class="sourceLineNo">075</span> private Configuration config;<a name="line.75"></a>
-<span class="sourceLineNo">076</span> private ClusterStatus clusterStatus;<a name="line.76"></a>
-<span class="sourceLineNo">077</span> private MasterServices masterServices;<a name="line.77"></a>
-<span class="sourceLineNo">078</span> private volatile RSGroupInfoManager rsGroupInfoManager;<a name="line.78"></a>
-<span class="sourceLineNo">079</span> private LoadBalancer internalBalancer;<a name="line.79"></a>
-<span class="sourceLineNo">080</span><a name="line.80"></a>
-<span class="sourceLineNo">081</span> /**<a name="line.81"></a>
-<span class="sourceLineNo">082</span> * Used by reflection in {@link org.apache.hadoop.hbase.master.balancer.LoadBalancerFactory}.<a name="line.82"></a>
-<span class="sourceLineNo">083</span> */<a name="line.83"></a>
-<span class="sourceLineNo">084</span> @InterfaceAudience.Private<a name="line.84"></a>
-<span class="sourceLineNo">085</span> public RSGroupBasedLoadBalancer() {}<a name="line.85"></a>
-<span class="sourceLineNo">086</span><a name="line.86"></a>
-<span class="sourceLineNo">087</span> @Override<a name="line.87"></a>
-<span class="sourceLineNo">088</span> public Configuration getConf() {<a name="line.88"></a>
-<span class="sourceLineNo">089</span> return config;<a name="line.89"></a>
-<span class="sourceLineNo">090</span> }<a name="line.90"></a>
-<span class="sourceLineNo">091</span><a name="line.91"></a>
-<span class="sourceLineNo">092</span> @Override<a name="line.92"></a>
-<span class="sourceLineNo">093</span> public void setConf(Configuration conf) {<a name="line.93"></a>
-<span class="sourceLineNo">094</span> this.config = conf;<a name="line.94"></a>
-<span class="sourceLineNo">095</span> }<a name="line.95"></a>
-<span class="sourceLineNo">096</span><a name="line.96"></a>
-<span class="sourceLineNo">097</span> @Override<a name="line.97"></a>
-<span class="sourceLineNo">098</span> public void setClusterStatus(ClusterStatus st) {<a name="line.98"></a>
-<span class="sourceLineNo">099</span> this.clusterStatus = st;<a name="line.99"></a>
-<span class="sourceLineNo">100</span> }<a name="line.100"></a>
-<span class="sourceLineNo">101</span><a name="line.101"></a>
-<span class="sourceLineNo">102</span> @Override<a name="line.102"></a>
-<span class="sourceLineNo">103</span> public void setMasterServices(MasterServices masterServices) {<a name="line.103"></a>
-<span class="sourceLineNo">104</span> this.masterServices = masterServices;<a name="line.104"></a>
-<span class="sourceLineNo">105</span> }<a name="line.105"></a>
-<span class="sourceLineNo">106</span><a name="line.106"></a>
-<span class="sourceLineNo">107</span> @Override<a name="line.107"></a>
-<span class="sourceLineNo">108</span> public List<RegionPlan> balanceCluster(TableName tableName, Map<ServerName, List<RegionInfo>><a name="line.108"></a>
-<span class="sourceLineNo">109</span> clusterState) throws HBaseIOException {<a name="line.109"></a>
-<span class="sourceLineNo">110</span> return balanceCluster(clusterState);<a name="line.110"></a>
-<span class="sourceLineNo">111</span> }<a name="line.111"></a>
-<span class="sourceLineNo">112</span><a name="line.112"></a>
-<span class="sourceLineNo">113</span> @Override<a name="line.113"></a>
-<span class="sourceLineNo">114</span> public List<RegionPlan> balanceCluster(Map<ServerName, List<RegionInfo>> clusterState)<a name="line.114"></a>
-<span class="sourceLineNo">115</span> throws HBaseIOException {<a name="line.115"></a>
-<span class="sourceLineNo">116</span> if (!isOnline()) {<a name="line.116"></a>
-<span class="sourceLineNo">117</span> throw new ConstraintException(RSGroupInfoManager.RSGROUP_TABLE_NAME +<a name="line.117"></a>
-<span class="sourceLineNo">118</span> " is not online, unable to perform balance");<a name="line.118"></a>
-<span class="sourceLineNo">119</span> }<a name="line.119"></a>
-<span class="sourceLineNo">120</span><a name="line.120"></a>
-<span class="sourceLineNo">121</span> Map<ServerName,List<RegionInfo>> correctedState = correctAssignments(clusterState);<a name="line.121"></a>
-<span class="sourceLineNo">122</span> List<RegionPlan> regionPlans = new ArrayList<>();<a name="line.122"></a>
-<span class="sourceLineNo">123</span><a name="line.123"></a>
-<span class="sourceLineNo">124</span> List<RegionInfo> misplacedRegions = correctedState.get(LoadBalancer.BOGUS_SERVER_NAME);<a name="line.124"></a>
-<span class="sourceLineNo">125</span> for (RegionInfo regionInfo : misplacedRegions) {<a name="line.125"></a>
-<span class="sourceLineNo">126</span> ServerName serverName = findServerForRegion(clusterState, regionInfo);<a name="line.126"></a>
-<span class="sourceLineNo">127</span> regionPlans.add(new RegionPlan(regionInfo, serverName, null));<a name="line.127"></a>
-<span class="sourceLineNo">128</span> }<a name="line.128"></a>
-<span class="sourceLineNo">129</span> try {<a name="line.129"></a>
-<span class="sourceLineNo">130</span> List<RSGroupInfo> rsgi = rsGroupInfoManager.listRSGroups();<a name="line.130"></a>
-<span class="sourceLineNo">131</span> for (RSGroupInfo info: rsgi) {<a name="line.131"></a>
-<span class="sourceLineNo">132</span> Map<ServerName, List<RegionInfo>> groupClusterState = new HashMap<>();<a name="line.132"></a>
-<span class="sourceLineNo">133</span> Map<TableName, Map<ServerName, List<RegionInfo>>> groupClusterLoad = new HashMap<>();<a name="line.133"></a>
-<span class="sourceLineNo">134</span> for (Address sName : info.getServers()) {<a name="line.134"></a>
-<span class="sourceLineNo">135</span> for(ServerName curr: clusterState.keySet()) {<a name="line.135"></a>
-<span class="sourceLineNo">136</span> if(curr.getAddress().equals(sName)) {<a name="line.136"></a>
-<span class="sourceLineNo">137</span> groupClusterState.put(curr, correctedState.get(curr));<a name="line.137"></a>
-<span class="sourceLineNo">138</span> }<a name="line.138"></a>
-<span class="sourceLineNo">139</span> }<a name="line.139"></a>
-<span class="sourceLineNo">140</span> }<a name="line.140"></a>
-<span class="sourceLineNo">141</span> groupClusterLoad.put(HConstants.ENSEMBLE_TABLE_NAME, groupClusterState);<a name="line.141"></a>
-<span class="sourceLineNo">142</span> this.internalBalancer.setClusterLoad(groupClusterLoad);<a name="line.142"></a>
-<span class="sourceLineNo">143</span> List<RegionPlan> groupPlans = this.internalBalancer<a name="line.143"></a>
-<span class="sourceLineNo">144</span> .balanceCluster(groupClusterState);<a name="line.144"></a>
-<span class="sourceLineNo">145</span> if (groupPlans != null) {<a name="line.145"></a>
-<span class="sourceLineNo">146</span> regionPlans.addAll(groupPlans);<a name="line.146"></a>
-<span class="sourceLineNo">147</span> }<a name="line.147"></a>
-<span class="sourceLineNo">148</span> }<a name="line.148"></a>
-<span class="sourceLineNo">149</span> } catch (IOException exp) {<a name="line.149"></a>
-<span class="sourceLineNo">150</span> LOG.warn("Exception while balancing cluster.", exp);<a name="line.150"></a>
-<span class="sourceLineNo">151</span> regionPlans.clear();<a name="line.151"></a>
-<span class="sourceLineNo">152</span> }<a name="line.152"></a>
-<span class="sourceLineNo">153</span> return regionPlans;<a name="line.153"></a>
-<span class="sourceLineNo">154</span> }<a name="line.154"></a>
-<span class="sourceLineNo">155</span><a name="line.155"></a>
-<span class="sourceLineNo">156</span> @Override<a name="line.156"></a>
-<span class="sourceLineNo">157</span> public Map<ServerName, List<RegionInfo>> roundRobinAssignment(<a name="line.157"></a>
-<span class="sourceLineNo">158</span> List<RegionInfo> regions, List<ServerName> servers) throws HBaseIOException {<a name="line.158"></a>
-<span class="sourceLineNo">159</span> Map<ServerName, List<RegionInfo>> assignments = Maps.newHashMap();<a name="line.159"></a>
-<span class="sourceLineNo">160</span> ListMultimap<String,RegionInfo> regionMap = ArrayListMultimap.create();<a name="line.160"></a>
-<span class="sourceLineNo">161</span> ListMultimap<String,ServerName> serverMap = ArrayListMultimap.create();<a name="line.161"></a>
-<span class="sourceLineNo">162</span> generateGroupMaps(regions, servers, regionMap, serverMap);<a name="line.162"></a>
-<span class="sourceLineNo">163</span> for(String groupKey : regionMap.keySet()) {<a name="line.163"></a>
-<span class="sourceLineNo">164</span> if (regionMap.get(groupKey).size() > 0) {<a name="line.164"></a>
-<span class="sourceLineNo">165</span> Map<ServerName, List<RegionInfo>> result =<a name="line.165"></a>
-<span class="sourceLineNo">166</span> this.internalBalancer.roundRobinAssignment(<a name="line.166"></a>
-<span class="sourceLineNo">167</span> regionMap.get(groupKey),<a name="line.167"></a>
-<span class="sourceLineNo">168</span> serverMap.get(groupKey));<a name="line.168"></a>
-<span class="sourceLineNo">169</span> if(result != null) {<a name="line.169"></a>
-<span class="sourceLineNo">170</span> if(result.containsKey(LoadBalancer.BOGUS_SERVER_NAME) &&<a name="line.170"></a>
-<span class="sourceLineNo">171</span> assignments.containsKey(LoadBalancer.BOGUS_SERVER_NAME)){<a name="line.171"></a>
-<span class="sourceLineNo">172</span> assignments.get(LoadBalancer.BOGUS_SERVER_NAME).addAll(<a name="line.172"></a>
-<span class="sourceLineNo">173</span> result.get(LoadBalancer.BOGUS_SERVER_NAME));<a name="line.173"></a>
-<span class="sourceLineNo">174</span> } else {<a name="line.174"></a>
-<span class="sourceLineNo">175</span> assignments.putAll(result);<a name="line.175"></a>
-<span class="sourceLineNo">176</span> }<a name="line.176"></a>
-<span class="sourceLineNo">177</span> }<a name="line.177"></a>
-<span class="sourceLineNo">178</span> }<a name="line.178"></a>
-<span class="sourceLineNo">179</span> }<a name="line.179"></a>
-<span class="sourceLineNo">180</span> return assignments;<a name="line.180"></a>
-<span class="sourceLineNo">181</span> }<a name="line.181"></a>
-<span class="sourceLineNo">182</span><a name="line.182"></a>
-<span class="sourceLineNo">183</span> @Override<a name="line.183"></a>
-<span class="sourceLineNo">184</span> public Map<ServerName, List<RegionInfo>> retainAssignment(<a name="line.184"></a>
-<span class="sourceLineNo">185</span> Map<RegionInfo, ServerName> regions, List<ServerName> servers) throws HBaseIOException {<a name="line.185"></a>
-<span class="sourceLineNo">186</span> try {<a name="line.186"></a>
-<span class="sourceLineNo">187</span> Map<ServerName, List<RegionInfo>> assignments = new TreeMap<>();<a name="line.187"></a>
-<span class="sourceLineNo">188</span> ListMultimap<String, RegionInfo> groupToRegion = ArrayListMultimap.create();<a name="line.188"></a>
-<span class="sourceLineNo">189</span> Set<RegionInfo> misplacedRegions = getMisplacedRegions(regions);<a name="line.189"></a>
-<span class="sourceLineNo">190</span> for (RegionInfo region : regions.keySet()) {<a name="line.190"></a>
-<span class="sourceLineNo">191</span> if (!misplacedRegions.contains(region)) {<a name="line.191"></a>
-<span class="sourceLineNo">192</span> String groupName = rsGroupInfoManager.getRSGroupOfTable(region.getTable());<a name="line.192"></a>
-<span class="sourceLineNo">193</span> groupToRegion.put(groupName, region);<a name="line.193"></a>
-<span class="sourceLineNo">194</span> }<a name="line.194"></a>
-<span class="sourceLineNo">195</span> }<a name="line.195"></a>
-<span class="sourceLineNo">196</span> // Now the "groupToRegion" map has only the regions which have correct<a name="line.196"></a>
-<span class="sourceLineNo">197</span> // assignments.<a name="line.197"></a>
-<span class="sourceLineNo">198</span> for (String key : groupToRegion.keySet()) {<a name="line.198"></a>
-<span class="sourceLineNo">199</span> Map<RegionInfo, ServerName> currentAssignmentMap = new TreeMap<RegionInfo, ServerName>();<a name="line.199"></a>
-<span class="sourceLineNo">200</span> List<RegionInfo> regionList = groupToRegion.get(key);<a name="line.200"></a>
-<span class="sourceLineNo">201</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(key);<a name="line.201"></a>
-<span class="sourceLineNo">202</span> List<ServerName> candidateList = filterOfflineServers(info, servers);<a name="line.202"></a>
-<span class="sourceLineNo">203</span> for (RegionInfo region : regionList) {<a name="line.203"></a>
-<span class="sourceLineNo">204</span> currentAssignmentMap.put(region, regions.get(region));<a name="line.204"></a>
-<span class="sourceLineNo">205</span> }<a name="line.205"></a>
-<span class="sourceLineNo">206</span> if(candidateList.size() > 0) {<a name="line.206"></a>
-<span class="sourceLineNo">207</span> assignments.putAll(this.internalBalancer.retainAssignment(<a name="line.207"></a>
-<span class="sourceLineNo">208</span> currentAssignmentMap, candidateList));<a name="line.208"></a>
-<span class="sourceLineNo">209</span> }<a name="line.209"></a>
-<span class="sourceLineNo">210</span> }<a name="line.210"></a>
-<span class="sourceLineNo">211</span><a name="line.211"></a>
-<span class="sourceLineNo">212</span> for (RegionInfo region : misplacedRegions) {<a name="line.212"></a>
-<span class="sourceLineNo">213</span> String groupName = rsGroupInfoManager.getRSGroupOfTable(region.getTable());<a name="line.213"></a>
-<span class="sourceLineNo">214</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(groupName);<a name="line.214"></a>
-<span class="sourceLineNo">215</span> List<ServerName> candidateList = filterOfflineServers(info, servers);<a name="line.215"></a>
-<span class="sourceLineNo">216</span> ServerName server = this.internalBalancer.randomAssignment(region,<a name="line.216"></a>
-<span class="sourceLineNo">217</span> candidateList);<a name="line.217"></a>
-<span class="sourceLineNo">218</span> if (server != null) {<a name="line.218"></a>
-<span class="sourceLineNo">219</span> if (!assignments.containsKey(server)) {<a name="line.219"></a>
-<span class="sourceLineNo">220</span> assignments.put(server, new ArrayList<>());<a name="line.220"></a>
-<span class="sourceLineNo">221</span> }<a name="line.221"></a>
-<span class="sourceLineNo">222</span> assignments.get(server).add(region);<a name="line.222"></a>
-<span class="sourceLineNo">223</span> } else {<a name="line.223"></a>
-<span class="sourceLineNo">224</span> //if not server is available assign to bogus so it ends up in RIT<a name="line.224"></a>
-<span class="sourceLineNo">225</span> if(!assignments.containsKey(LoadBalancer.BOGUS_SERVER_NAME)) {<a name="line.225"></a>
-<span class="sourceLineNo">226</span> assignments.put(LoadBalancer.BOGUS_SERVER_NAME, new ArrayList<>());<a name="line.226"></a>
-<span class="sourceLineNo">227</span> }<a name="line.227"></a>
-<span class="sourceLineNo">228</span> assignments.get(LoadBalancer.BOGUS_SERVER_NAME).add(region);<a name="line.228"></a>
-<span class="sourceLineNo">229</span> }<a name="line.229"></a>
-<span class="sourceLineNo">230</span> }<a name="line.230"></a>
-<span class="sourceLineNo">231</span> return assignments;<a name="line.231"></a>
-<span class="sourceLineNo">232</span> } catch (IOException e) {<a name="line.232"></a>
-<span class="sourceLineNo">233</span> throw new HBaseIOException("Failed to do online retain assignment", e);<a name="line.233"></a>
-<span class="sourceLineNo">234</span> }<a name="line.234"></a>
-<span class="sourceLineNo">235</span> }<a name="line.235"></a>
-<span class="sourceLineNo">236</span><a name="line.236"></a>
-<span class="sourceLineNo">237</span> @Override<a name="line.237"></a>
-<span class="sourceLineNo">238</span> public ServerName randomAssignment(RegionInfo region,<a name="line.238"></a>
-<span class="sourceLineNo">239</span> List<ServerName> servers) throws HBaseIOException {<a name="line.239"></a>
-<span class="sourceLineNo">240</span> ListMultimap<String,RegionInfo> regionMap = LinkedListMultimap.create();<a name="line.240"></a>
-<span class="sourceLineNo">241</span> ListMultimap<String,ServerName> serverMap = LinkedListMultimap.create();<a name="line.241"></a>
-<span class="sourceLineNo">242</span> generateGroupMaps(Lists.newArrayList(region), servers, regionMap, serverMap);<a name="line.242"></a>
-<span class="sourceLineNo">243</span> List<ServerName> filteredServers = serverMap.get(regionMap.keySet().iterator().next());<a name="line.243"></a>
-<span class="sourceLineNo">244</span> return this.internalBalancer.randomAssignment(region, filteredServers);<a name="line.244"></a>
-<span class="sourceLineNo">245</span> }<a name="line.245"></a>
-<span class="sourceLineNo">246</span><a name="line.246"></a>
-<span class="sourceLineNo">247</span> private void generateGroupMaps(<a name="line.247"></a>
-<span class="sourceLineNo">248</span> List<RegionInfo> regions,<a name="line.248"></a>
-<span class="sourceLineNo">249</span> List<ServerName> servers,<a name="line.249"></a>
-<span class="sourceLineNo">250</span> ListMultimap<String, RegionInfo> regionMap,<a name="line.250"></a>
-<span class="sourceLineNo">251</span> ListMultimap<String, ServerName> serverMap) throws HBaseIOException {<a name="line.251"></a>
-<span class="sourceLineNo">252</span> try {<a name="line.252"></a>
-<span class="sourceLineNo">253</span> for (RegionInfo region : regions) {<a name="line.253"></a>
-<span class="sourceLineNo">254</span> String groupName = rsGroupInfoManager.getRSGroupOfTable(region.getTable());<a name="line.254"></a>
-<span class="sourceLineNo">255</span> if (groupName == null) {<a name="line.255"></a>
-<span class="sourceLineNo">256</span> LOG.warn("Group for table "+region.getTable()+" is null");<a name="line.256"></a>
-<span class="sourceLineNo">257</span> }<a name="line.257"></a>
-<span class="sourceLineNo">258</span> regionMap.put(groupName, region);<a name="line.258"></a>
-<span class="sourceLineNo">259</span> }<a name="line.259"></a>
-<span class="sourceLineNo">260</span> for (String groupKey : regionMap.keySet()) {<a name="line.260"></a>
-<span class="sourceLineNo">261</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(groupKey);<a name="line.261"></a>
-<span class="sourceLineNo">262</span> serverMap.putAll(groupKey, filterOfflineServers(info, servers));<a name="line.262"></a>
-<span class="sourceLineNo">263</span> if(serverMap.get(groupKey).size() < 1) {<a name="line.263"></a>
-<span class="sourceLineNo">264</span> serverMap.put(groupKey, LoadBalancer.BOGUS_SERVER_NAME);<a name="line.264"></a>
-<span class="sourceLineNo">265</span> }<a name="line.265"></a>
-<span class="sourceLineNo">266</span> }<a name="line.266"></a>
-<span class="sourceLineNo">267</span> } catch(IOException e) {<a name="line.267"></a>
-<span class="sourceLineNo">268</span> throw new HBaseIOException("Failed to generate group maps", e);<a name="line.268"></a>
-<span class="sourceLineNo">269</span> }<a name="line.269"></a>
-<span class="sourceLineNo">270</span> }<a name="line.270"></a>
-<span class="sourceLineNo">271</span><a name="line.271"></a>
-<span class="sourceLineNo">272</span> private List<ServerName> filterOfflineServers(RSGroupInfo RSGroupInfo,<a name="line.272"></a>
-<span class="sourceLineNo">273</span> List<ServerName> onlineServers) {<a name="line.273"></a>
-<span class="sourceLineNo">274</span> if (RSGroupInfo != null) {<a name="line.274"></a>
-<span class="sourceLineNo">275</span> return filterServers(RSGroupInfo.getServers(), onlineServers);<a name="line.275"></a>
-<span class="sourceLineNo">276</span> } else {<a name="line.276"></a>
-<span class="sourceLineNo">277</span> LOG.warn("RSGroup Information found to be null. Some regions might be unassigned.");<a name="line.277"></a>
-<span class="sourceLineNo">278</span> return Collections.EMPTY_LIST;<a name="line.278"></a>
-<span class="sourceLineNo">279</span> }<a name="line.279"></a>
-<span class="sourceLineNo">280</span> }<a name="line.280"></a>
-<span class="sourceLineNo">281</span><a name="line.281"></a>
-<span class="sourceLineNo">282</span> /**<a name="line.282"></a>
-<span class="sourceLineNo">283</span> * Filter servers based on the online servers.<a name="line.283"></a>
-<span class="sourceLineNo">284</span> *<a name="line.284"></a>
-<span class="sourceLineNo">285</span> * @param servers<a name="line.285"></a>
-<span class="sourceLineNo">286</span> * the servers<a name="line.286"></a>
-<span class="sourceLineNo">287</span> * @param onlineServers<a name="line.287"></a>
-<span class="sourceLineNo">288</span> * List of servers which are online.<a name="line.288"></a>
-<span class="sourceLineNo">289</span> * @return the list<a name="line.289"></a>
-<span class="sourceLineNo">290</span> */<a name="line.290"></a>
-<span class="sourceLineNo">291</span> private List<ServerName> filterServers(Collection<Address> servers,<a name="line.291"></a>
-<span class="sourceLineNo">292</span> Collection<ServerName> onlineServers) {<a name="line.292"></a>
-<span class="sourceLineNo">293</span> ArrayList<ServerName> finalList = new ArrayList<ServerName>();<a name="line.293"></a>
-<span class="sourceLineNo">294</span> for (Address server : servers) {<a name="line.294"></a>
-<span class="sourceLineNo">295</span> for(ServerName curr: onlineServers) {<a name="line.295"></a>
-<span class="sourceLineNo">296</span> if(curr.getAddress().equals(server)) {<a name="line.296"></a>
-<span class="sourceLineNo">297</span> finalList.add(curr);<a name="line.297"></a>
-<span class="sourceLineNo">298</span> }<a name="line.298"></a>
-<span class="sourceLineNo">299</span> }<a name="line.299"></a>
-<span class="sourceLineNo">300</span> }<a name="line.300"></a>
-<span class="sourceLineNo">301</span> return finalList;<a name="line.301"></a>
-<span class="sourceLineNo">302</span> }<a name="line.302"></a>
-<span class="sourceLineNo">303</span><a name="line.303"></a>
-<span class="sourceLineNo">304</span> private Set<RegionInfo> getMisplacedRegions(<a name="line.304"></a>
-<span class="sourceLineNo">305</span> Map<RegionInfo, ServerName> regions) throws IOException {<a name="line.305"></a>
-<span class="sourceLineNo">306</span> Set<RegionInfo> misplacedRegions = new HashSet<>();<a name="line.306"></a>
-<span class="sourceLineNo">307</span> for(Map.Entry<RegionInfo, ServerName> region : regions.entrySet()) {<a name="line.307"></a>
-<span class="sourceLineNo">308</span> RegionInfo regionInfo = region.getKey();<a name="line.308"></a>
-<span class="sourceLineNo">309</span> ServerName assignedServer = region.getValue();<a name="line.309"></a>
-<span class="sourceLineNo">310</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(rsGroupInfoManager.<a name="line.310"></a>
-<span class="sourceLineNo">311</span> getRSGroupOfTable(regionInfo.getTable()));<a name="line.311"></a>
-<span class="sourceLineNo">312</span> if (assignedServer != null &&<a name="line.312"></a>
-<span class="sourceLineNo">313</span> (info == null || !info.containsServer(assignedServer.getAddress()))) {<a name="line.313"></a>
-<span class="sourceLineNo">314</span> RSGroupInfo otherInfo = null;<a name="line.314"></a>
-<span class="sourceLineNo">315</span> otherInfo = rsGroupInfoManager.getRSGroupOfServer(assignedServer.getAddress());<a name="line.315"></a>
-<span class="sourceLineNo">316</span> LOG.debug("Found misplaced region: " + regionInfo.getRegionNameAsString() +<a name="line.316"></a>
-<span class="sourceLineNo">317</span> " on server: " + assignedServer +<a name="line.317"></a>
-<span class="sourceLineNo">318</span> " found in group: " + otherInfo +<a name="line.318"></a>
-<span class="sourceLineNo">319</span> " outside of group: " + (info == null ? "UNKNOWN" : info.getName()));<a name="line.319"></a>
-<span class="sourceLineNo">320</span> misplacedRegions.add(regionInfo);<a name="line.320"></a>
-<span class="sourceLineNo">321</span> }<a name="line.321"></a>
-<span class="sourceLineNo">322</span> }<a name="line.322"></a>
-<span class="sourceLineNo">323</span> return misplacedRegions;<a name="line.323"></a>
-<span class="sourceLineNo">324</span> }<a name="line.324"></a>
-<span class="sourceLineNo">325</span><a name="line.325"></a>
-<span class="sourceLineNo">326</span> private ServerName findServerForRegion(<a name="line.326"></a>
-<span class="sourceLineNo">327</span> Map<ServerName, List<RegionInfo>> existingAssignments, RegionInfo region)<a name="line.327"></a>
-<span class="sourceLineNo">328</span> {<a name="line.328"></a>
+<span class="sourceLineNo">046</span>import org.apache.hadoop.util.ReflectionUtils;<a name="line.46"></a>
+<span class="sourceLineNo">047</span>import org.apache.yetus.audience.InterfaceAudience;<a name="line.47"></a>
+<span class="sourceLineNo">048</span>import org.slf4j.Logger;<a name="line.48"></a>
+<span class="sourceLineNo">049</span>import org.slf4j.LoggerFactory;<a name="line.49"></a>
+<span class="sourceLineNo">050</span><a name="line.50"></a>
+<span class="sourceLineNo">051</span>import org.apache.hadoop.hbase.shaded.com.google.common.annotations.VisibleForTesting;<a name="line.51"></a>
+<span class="sourceLineNo">052</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.ArrayListMultimap;<a name="line.52"></a>
+<span class="sourceLineNo">053</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.LinkedListMultimap;<a name="line.53"></a>
+<span class="sourceLineNo">054</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.ListMultimap;<a name="line.54"></a>
+<span class="sourceLineNo">055</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.Lists;<a name="line.55"></a>
+<span class="sourceLineNo">056</span>import org.apache.hadoop.hbase.shaded.com.google.common.collect.Maps;<a name="line.56"></a>
+<span class="sourceLineNo">057</span><a name="line.57"></a>
+<span class="sourceLineNo">058</span>/**<a name="line.58"></a>
+<span class="sourceLineNo">059</span> * GroupBasedLoadBalancer, used when Region Server Grouping is configured (HBase-6721)<a name="line.59"></a>
+<span class="sourceLineNo">060</span> * It does region balance based on a table's group membership.<a name="line.60"></a>
+<span class="sourceLineNo">061</span> *<a name="line.61"></a>
+<span class="sourceLineNo">062</span> * Most assignment methods contain two exclusive code paths: Online - when the group<a name="line.62"></a>
+<span class="sourceLineNo">063</span> * table is online and Offline - when it is unavailable.<a name="line.63"></a>
+<span class="sourceLineNo">064</span> *<a name="line.64"></a>
+<span class="sourceLineNo">065</span> * During Offline, assignments are assigned based on cached information in zookeeper.<a name="line.65"></a>
+<span class="sourceLineNo">066</span> * If unavailable (ie bootstrap) then regions are assigned randomly.<a name="line.66"></a>
+<span class="sourceLineNo">067</span> *<a name="line.67"></a>
+<span class="sourceLineNo">068</span> * Once the GROUP table has been assigned, the balancer switches to Online and will then<a name="line.68"></a>
+<span class="sourceLineNo">069</span> * start providing appropriate assignments for user tables.<a name="line.69"></a>
+<span class="sourceLineNo">070</span> *<a name="line.70"></a>
+<span class="sourceLineNo">071</span> */<a name="line.71"></a>
+<span class="sourceLineNo">072</span>@InterfaceAudience.Private<a name="line.72"></a>
+<span class="sourceLineNo">073</span>public class RSGroupBasedLoadBalancer implements RSGroupableBalancer {<a name="line.73"></a>
+<span class="sourceLineNo">074</span> private static final Logger LOG = LoggerFactory.getLogger(RSGroupBasedLoadBalancer.class);<a name="line.74"></a>
+<span class="sourceLineNo">075</span><a name="line.75"></a>
+<span class="sourceLineNo">076</span> private Configuration config;<a name="line.76"></a>
+<span class="sourceLineNo">077</span> private ClusterStatus clusterStatus;<a name="line.77"></a>
+<span class="sourceLineNo">078</span> private MasterServices masterServices;<a name="line.78"></a>
+<span class="sourceLineNo">079</span> private volatile RSGroupInfoManager rsGroupInfoManager;<a name="line.79"></a>
+<span class="sourceLineNo">080</span> private LoadBalancer internalBalancer;<a name="line.80"></a>
+<span class="sourceLineNo">081</span><a name="line.81"></a>
+<span class="sourceLineNo">082</span> /**<a name="line.82"></a>
+<span class="sourceLineNo">083</span> * Used by reflection in {@link org.apache.hadoop.hbase.master.balancer.LoadBalancerFactory}.<a name="line.83"></a>
+<span class="sourceLineNo">084</span> */<a name="line.84"></a>
+<span class="sourceLineNo">085</span> @InterfaceAudience.Private<a name="line.85"></a>
+<span class="sourceLineNo">086</span> public RSGroupBasedLoadBalancer() {}<a name="line.86"></a>
+<span class="sourceLineNo">087</span><a name="line.87"></a>
+<span class="sourceLineNo">088</span> @Override<a name="line.88"></a>
+<span class="sourceLineNo">089</span> public Configuration getConf() {<a name="line.89"></a>
+<span class="sourceLineNo">090</span> return config;<a name="line.90"></a>
+<span class="sourceLineNo">091</span> }<a name="line.91"></a>
+<span class="sourceLineNo">092</span><a name="line.92"></a>
+<span class="sourceLineNo">093</span> @Override<a name="line.93"></a>
+<span class="sourceLineNo">094</span> public void setConf(Configuration conf) {<a name="line.94"></a>
+<span class="sourceLineNo">095</span> this.config = conf;<a name="line.95"></a>
+<span class="sourceLineNo">096</span> }<a name="line.96"></a>
+<span class="sourceLineNo">097</span><a name="line.97"></a>
+<span class="sourceLineNo">098</span> @Override<a name="line.98"></a>
+<span class="sourceLineNo">099</span> public void setClusterStatus(ClusterStatus st) {<a name="line.99"></a>
+<span class="sourceLineNo">100</span> this.clusterStatus = st;<a name="line.100"></a>
+<span class="sourceLineNo">101</span> }<a name="line.101"></a>
+<span class="sourceLineNo">102</span><a name="line.102"></a>
+<span class="sourceLineNo">103</span> @Override<a name="line.103"></a>
+<span class="sourceLineNo">104</span> public void setMasterServices(MasterServices masterServices) {<a name="line.104"></a>
+<span class="sourceLineNo">105</span> this.masterServices = masterServices;<a name="line.105"></a>
+<span class="sourceLineNo">106</span> }<a name="line.106"></a>
+<span class="sourceLineNo">107</span><a name="line.107"></a>
+<span class="sourceLineNo">108</span> @Override<a name="line.108"></a>
+<span class="sourceLineNo">109</span> public List<RegionPlan> balanceCluster(TableName tableName, Map<ServerName, List<RegionInfo>><a name="line.109"></a>
+<span class="sourceLineNo">110</span> clusterState) throws HBaseIOException {<a name="line.110"></a>
+<span class="sourceLineNo">111</span> return balanceCluster(clusterState);<a name="line.111"></a>
+<span class="sourceLineNo">112</span> }<a name="line.112"></a>
+<span class="sourceLineNo">113</span><a name="line.113"></a>
+<span class="sourceLineNo">114</span> @Override<a name="line.114"></a>
+<span class="sourceLineNo">115</span> public List<RegionPlan> balanceCluster(Map<ServerName, List<RegionInfo>> clusterState)<a name="line.115"></a>
+<span class="sourceLineNo">116</span> throws HBaseIOException {<a name="line.116"></a>
+<span class="sourceLineNo">117</span> if (!isOnline()) {<a name="line.117"></a>
+<span class="sourceLineNo">118</span> throw new ConstraintException(RSGroupInfoManager.RSGROUP_TABLE_NAME +<a name="line.118"></a>
+<span class="sourceLineNo">119</span> " is not online, unable to perform balance");<a name="line.119"></a>
+<span class="sourceLineNo">120</span> }<a name="line.120"></a>
+<span class="sourceLineNo">121</span><a name="line.121"></a>
+<span class="sourceLineNo">122</span> Map<ServerName,List<RegionInfo>> correctedState = correctAssignments(clusterState);<a name="line.122"></a>
+<span class="sourceLineNo">123</span> List<RegionPlan> regionPlans = new ArrayList<>();<a name="line.123"></a>
+<span class="sourceLineNo">124</span><a name="line.124"></a>
+<span class="sourceLineNo">125</span> List<RegionInfo> misplacedRegions = correctedState.get(LoadBalancer.BOGUS_SERVER_NAME);<a name="line.125"></a>
+<span class="sourceLineNo">126</span> for (RegionInfo regionInfo : misplacedRegions) {<a name="line.126"></a>
+<span class="sourceLineNo">127</span> ServerName serverName = findServerForRegion(clusterState, regionInfo);<a name="line.127"></a>
+<span class="sourceLineNo">128</span> regionPlans.add(new RegionPlan(regionInfo, serverName, null));<a name="line.128"></a>
+<span class="sourceLineNo">129</span> }<a name="line.129"></a>
+<span class="sourceLineNo">130</span> try {<a name="line.130"></a>
+<span class="sourceLineNo">131</span> List<RSGroupInfo> rsgi = rsGroupInfoManager.listRSGroups();<a name="line.131"></a>
+<span class="sourceLineNo">132</span> for (RSGroupInfo info: rsgi) {<a name="line.132"></a>
+<span class="sourceLineNo">133</span> Map<ServerName, List<RegionInfo>> groupClusterState = new HashMap<>();<a name="line.133"></a>
+<span class="sourceLineNo">134</span> Map<TableName, Map<ServerName, List<RegionInfo>>> groupClusterLoad = new HashMap<>();<a name="line.134"></a>
+<span class="sourceLineNo">135</span> for (Address sName : info.getServers()) {<a name="line.135"></a>
+<span class="sourceLineNo">136</span> for(ServerName curr: clusterState.keySet()) {<a name="line.136"></a>
+<span class="sourceLineNo">137</span> if(curr.getAddress().equals(sName)) {<a name="line.137"></a>
+<span class="sourceLineNo">138</span> groupClusterState.put(curr, correctedState.get(curr));<a name="line.138"></a>
+<span class="sourceLineNo">139</span> }<a name="line.139"></a>
+<span class="sourceLineNo">140</span> }<a name="line.140"></a>
+<span class="sourceLineNo">141</span> }<a name="line.141"></a>
+<span class="sourceLineNo">142</span> groupClusterLoad.put(HConstants.ENSEMBLE_TABLE_NAME, groupClusterState);<a name="line.142"></a>
+<span class="sourceLineNo">143</span> this.internalBalancer.setClusterLoad(groupClusterLoad);<a name="line.143"></a>
+<span class="sourceLineNo">144</span> List<RegionPlan> groupPlans = this.internalBalancer<a name="line.144"></a>
+<span class="sourceLineNo">145</span> .balanceCluster(groupClusterState);<a name="line.145"></a>
+<span class="sourceLineNo">146</span> if (groupPlans != null) {<a name="line.146"></a>
+<span class="sourceLineNo">147</span> regionPlans.addAll(groupPlans);<a name="line.147"></a>
+<span class="sourceLineNo">148</span> }<a name="line.148"></a>
+<span class="sourceLineNo">149</span> }<a name="line.149"></a>
+<span class="sourceLineNo">150</span> } catch (IOException exp) {<a name="line.150"></a>
+<span class="sourceLineNo">151</span> LOG.warn("Exception while balancing cluster.", exp);<a name="line.151"></a>
+<span class="sourceLineNo">152</span> regionPlans.clear();<a name="line.152"></a>
+<span class="sourceLineNo">153</span> }<a name="line.153"></a>
+<span class="sourceLineNo">154</span> return regionPlans;<a name="line.154"></a>
+<span class="sourceLineNo">155</span> }<a name="line.155"></a>
+<span class="sourceLineNo">156</span><a name="line.156"></a>
+<span class="sourceLineNo">157</span> @Override<a name="line.157"></a>
+<span class="sourceLineNo">158</span> public Map<ServerName, List<RegionInfo>> roundRobinAssignment(<a name="line.158"></a>
+<span class="sourceLineNo">159</span> List<RegionInfo> regions, List<ServerName> servers) throws HBaseIOException {<a name="line.159"></a>
+<span class="sourceLineNo">160</span> Map<ServerName, List<RegionInfo>> assignments = Maps.newHashMap();<a name="line.160"></a>
+<span class="sourceLineNo">161</span> ListMultimap<String,RegionInfo> regionMap = ArrayListMultimap.create();<a name="line.161"></a>
+<span class="sourceLineNo">162</span> ListMultimap<String,ServerName> serverMap = ArrayListMultimap.create();<a name="line.162"></a>
+<span class="sourceLineNo">163</span> generateGroupMaps(regions, servers, regionMap, serverMap);<a name="line.163"></a>
+<span class="sourceLineNo">164</span> for(String groupKey : regionMap.keySet()) {<a name="line.164"></a>
+<span class="sourceLineNo">165</span> if (regionMap.get(groupKey).size() > 0) {<a name="line.165"></a>
+<span class="sourceLineNo">166</span> Map<ServerName, List<RegionInfo>> result =<a name="line.166"></a>
+<span class="sourceLineNo">167</span> this.internalBalancer.roundRobinAssignment(<a name="line.167"></a>
+<span class="sourceLineNo">168</span> regionMap.get(groupKey),<a name="line.168"></a>
+<span class="sourceLineNo">169</span> serverMap.get(groupKey));<a name="line.169"></a>
+<span class="sourceLineNo">170</span> if(result != null) {<a name="line.170"></a>
+<span class="sourceLineNo">171</span> if(result.containsKey(LoadBalancer.BOGUS_SERVER_NAME) &&<a name="line.171"></a>
+<span class="sourceLineNo">172</span> assignments.containsKey(LoadBalancer.BOGUS_SERVER_NAME)){<a name="line.172"></a>
+<span class="sourceLineNo">173</span> assignments.get(LoadBalancer.BOGUS_SERVER_NAME).addAll(<a name="line.173"></a>
+<span class="sourceLineNo">174</span> result.get(LoadBalancer.BOGUS_SERVER_NAME));<a name="line.174"></a>
+<span class="sourceLineNo">175</span> } else {<a name="line.175"></a>
+<span class="sourceLineNo">176</span> assignments.putAll(result);<a name="line.176"></a>
+<span class="sourceLineNo">177</span> }<a name="line.177"></a>
+<span class="sourceLineNo">178</span> }<a name="line.178"></a>
+<span class="sourceLineNo">179</span> }<a name="line.179"></a>
+<span class="sourceLineNo">180</span> }<a name="line.180"></a>
+<span class="sourceLineNo">181</span> return assignments;<a name="line.181"></a>
+<span class="sourceLineNo">182</span> }<a name="line.182"></a>
+<span class="sourceLineNo">183</span><a name="line.183"></a>
+<span class="sourceLineNo">184</span> @Override<a name="line.184"></a>
+<span class="sourceLineNo">185</span> public Map<ServerName, List<RegionInfo>> retainAssignment(<a name="line.185"></a>
+<span class="sourceLineNo">186</span> Map<RegionInfo, ServerName> regions, List<ServerName> servers) throws HBaseIOException {<a name="line.186"></a>
+<span class="sourceLineNo">187</span> try {<a name="line.187"></a>
+<span class="sourceLineNo">188</span> Map<ServerName, List<RegionInfo>> assignments = new TreeMap<>();<a name="line.188"></a>
+<span class="sourceLineNo">189</span> ListMultimap<String, RegionInfo> groupToRegion = ArrayListMultimap.create();<a name="line.189"></a>
+<span class="sourceLineNo">190</span> Set<RegionInfo> misplacedRegions = getMisplacedRegions(regions);<a name="line.190"></a>
+<span class="sourceLineNo">191</span> for (RegionInfo region : regions.keySet()) {<a name="line.191"></a>
+<span class="sourceLineNo">192</span> if (!misplacedRegions.contains(region)) {<a name="line.192"></a>
+<span class="sourceLineNo">193</span> String groupName = rsGroupInfoManager.getRSGroupOfTable(region.getTable());<a name="line.193"></a>
+<span class="sourceLineNo">194</span> groupToRegion.put(groupName, region);<a name="line.194"></a>
+<span class="sourceLineNo">195</span> }<a name="line.195"></a>
+<span class="sourceLineNo">196</span> }<a name="line.196"></a>
+<span class="sourceLineNo">197</span> // Now the "groupToRegion" map has only the regions which have correct<a name="line.197"></a>
+<span class="sourceLineNo">198</span> // assignments.<a name="line.198"></a>
+<span class="sourceLineNo">199</span> for (String key : groupToRegion.keySet()) {<a name="line.199"></a>
+<span class="sourceLineNo">200</span> Map<RegionInfo, ServerName> currentAssignmentMap = new TreeMap<RegionInfo, ServerName>();<a name="line.200"></a>
+<span class="sourceLineNo">201</span> List<RegionInfo> regionList = groupToRegion.get(key);<a name="line.201"></a>
+<span class="sourceLineNo">202</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(key);<a name="line.202"></a>
+<span class="sourceLineNo">203</span> List<ServerName> candidateList = filterOfflineServers(info, servers);<a name="line.203"></a>
+<span class="sourceLineNo">204</span> for (RegionInfo region : regionList) {<a name="line.204"></a>
+<span class="sourceLineNo">205</span> currentAssignmentMap.put(region, regions.get(region));<a name="line.205"></a>
+<span class="sourceLineNo">206</span> }<a name="line.206"></a>
+<span class="sourceLineNo">207</span> if(candidateList.size() > 0) {<a name="line.207"></a>
+<span class="sourceLineNo">208</span> assignments.putAll(this.internalBalancer.retainAssignment(<a name="line.208"></a>
+<span class="sourceLineNo">209</span> currentAssignmentMap, candidateList));<a name="line.209"></a>
+<span class="sourceLineNo">210</span> }<a name="line.210"></a>
+<span class="sourceLineNo">211</span> }<a name="line.211"></a>
+<span class="sourceLineNo">212</span><a name="line.212"></a>
+<span class="sourceLineNo">213</span> for (RegionInfo region : misplacedRegions) {<a name="line.213"></a>
+<span class="sourceLineNo">214</span> String groupName = rsGroupInfoManager.getRSGroupOfTable(region.getTable());<a name="line.214"></a>
+<span class="sourceLineNo">215</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(groupName);<a name="line.215"></a>
+<span class="sourceLineNo">216</span> List<ServerName> candidateList = filterOfflineServers(info, servers);<a name="line.216"></a>
+<span class="sourceLineNo">217</span> ServerName server = this.internalBalancer.randomAssignment(region,<a name="line.217"></a>
+<span class="sourceLineNo">218</span> candidateList);<a name="line.218"></a>
+<span class="sourceLineNo">219</span> if (server != null) {<a name="line.219"></a>
+<span class="sourceLineNo">220</span> if (!assignments.containsKey(server)) {<a name="line.220"></a>
+<span class="sourceLineNo">221</span> assignments.put(server, new ArrayList<>());<a name="line.221"></a>
+<span class="sourceLineNo">222</span> }<a name="line.222"></a>
+<span class="sourceLineNo">223</span> assignments.get(server).add(region);<a name="line.223"></a>
+<span class="sourceLineNo">224</span> } else {<a name="line.224"></a>
+<span class="sourceLineNo">225</span> //if not server is available assign to bogus so it ends up in RIT<a name="line.225"></a>
+<span class="sourceLineNo">226</span> if(!assignments.containsKey(LoadBalancer.BOGUS_SERVER_NAME)) {<a name="line.226"></a>
+<span class="sourceLineNo">227</span> assignments.put(LoadBalancer.BOGUS_SERVER_NAME, new ArrayList<>());<a name="line.227"></a>
+<span class="sourceLineNo">228</span> }<a name="line.228"></a>
+<span class="sourceLineNo">229</span> assignments.get(LoadBalancer.BOGUS_SERVER_NAME).add(region);<a name="line.229"></a>
+<span class="sourceLineNo">230</span> }<a name="line.230"></a>
+<span class="sourceLineNo">231</span> }<a name="line.231"></a>
+<span class="sourceLineNo">232</span> return assignments;<a name="line.232"></a>
+<span class="sourceLineNo">233</span> } catch (IOException e) {<a name="line.233"></a>
+<span class="sourceLineNo">234</span> throw new HBaseIOException("Failed to do online retain assignment", e);<a name="line.234"></a>
+<span class="sourceLineNo">235</span> }<a name="line.235"></a>
+<span class="sourceLineNo">236</span> }<a name="line.236"></a>
+<span class="sourceLineNo">237</span><a name="line.237"></a>
+<span class="sourceLineNo">238</span> @Override<a name="line.238"></a>
+<span class="sourceLineNo">239</span> public ServerName randomAssignment(RegionInfo region,<a name="line.239"></a>
+<span class="sourceLineNo">240</span> List<ServerName> servers) throws HBaseIOException {<a name="line.240"></a>
+<span class="sourceLineNo">241</span> ListMultimap<String,RegionInfo> regionMap = LinkedListMultimap.create();<a name="line.241"></a>
+<span class="sourceLineNo">242</span> ListMultimap<String,ServerName> serverMap = LinkedListMultimap.create();<a name="line.242"></a>
+<span class="sourceLineNo">243</span> generateGroupMaps(Lists.newArrayList(region), servers, regionMap, serverMap);<a name="line.243"></a>
+<span class="sourceLineNo">244</span> List<ServerName> filteredServers = serverMap.get(regionMap.keySet().iterator().next());<a name="line.244"></a>
+<span class="sourceLineNo">245</span> return this.internalBalancer.randomAssignment(region, filteredServers);<a name="line.245"></a>
+<span class="sourceLineNo">246</span> }<a name="line.246"></a>
+<span class="sourceLineNo">247</span><a name="line.247"></a>
+<span class="sourceLineNo">248</span> private void generateGroupMaps(<a name="line.248"></a>
+<span class="sourceLineNo">249</span> List<RegionInfo> regions,<a name="line.249"></a>
+<span class="sourceLineNo">250</span> List<ServerName> servers,<a name="line.250"></a>
+<span class="sourceLineNo">251</span> ListMultimap<String, RegionInfo> regionMap,<a name="line.251"></a>
+<span class="sourceLineNo">252</span> ListMultimap<String, ServerName> serverMap) throws HBaseIOException {<a name="line.252"></a>
+<span class="sourceLineNo">253</span> try {<a name="line.253"></a>
+<span class="sourceLineNo">254</span> for (RegionInfo region : regions) {<a name="line.254"></a>
+<span class="sourceLineNo">255</span> String groupName = rsGroupInfoManager.getRSGroupOfTable(region.getTable());<a name="line.255"></a>
+<span class="sourceLineNo">256</span> if (groupName == null) {<a name="line.256"></a>
+<span class="sourceLineNo">257</span> LOG.warn("Group for table "+region.getTable()+" is null");<a name="line.257"></a>
+<span class="sourceLineNo">258</span> }<a name="line.258"></a>
+<span class="sourceLineNo">259</span> regionMap.put(groupName, region);<a name="line.259"></a>
+<span class="sourceLineNo">260</span> }<a name="line.260"></a>
+<span class="sourceLineNo">261</span> for (String groupKey : regionMap.keySet()) {<a name="line.261"></a>
+<span class="sourceLineNo">262</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(groupKey);<a name="line.262"></a>
+<span class="sourceLineNo">263</span> serverMap.putAll(groupKey, filterOfflineServers(info, servers));<a name="line.263"></a>
+<span class="sourceLineNo">264</span> if(serverMap.get(groupKey).size() < 1) {<a name="line.264"></a>
+<span class="sourceLineNo">265</span> serverMap.put(groupKey, LoadBalancer.BOGUS_SERVER_NAME);<a name="line.265"></a>
+<span class="sourceLineNo">266</span> }<a name="line.266"></a>
+<span class="sourceLineNo">267</span> }<a name="line.267"></a>
+<span class="sourceLineNo">268</span> } catch(IOException e) {<a name="line.268"></a>
+<span class="sourceLineNo">269</span> throw new HBaseIOException("Failed to generate group maps", e);<a name="line.269"></a>
+<span class="sourceLineNo">270</span> }<a name="line.270"></a>
+<span class="sourceLineNo">271</span> }<a name="line.271"></a>
+<span class="sourceLineNo">272</span><a name="line.272"></a>
+<span class="sourceLineNo">273</span> private List<ServerName> filterOfflineServers(RSGroupInfo RSGroupInfo,<a name="line.273"></a>
+<span class="sourceLineNo">274</span> List<ServerName> onlineServers) {<a name="line.274"></a>
+<span class="sourceLineNo">275</span> if (RSGroupInfo != null) {<a name="line.275"></a>
+<span class="sourceLineNo">276</span> return filterServers(RSGroupInfo.getServers(), onlineServers);<a name="line.276"></a>
+<span class="sourceLineNo">277</span> } else {<a name="line.277"></a>
+<span class="sourceLineNo">278</span> LOG.warn("RSGroup Information found to be null. Some regions might be unassigned.");<a name="line.278"></a>
+<span class="sourceLineNo">279</span> return Collections.EMPTY_LIST;<a name="line.279"></a>
+<span class="sourceLineNo">280</span> }<a name="line.280"></a>
+<span class="sourceLineNo">281</span> }<a name="line.281"></a>
+<span class="sourceLineNo">282</span><a name="line.282"></a>
+<span class="sourceLineNo">283</span> /**<a name="line.283"></a>
+<span class="sourceLineNo">284</span> * Filter servers based on the online servers.<a name="line.284"></a>
+<span class="sourceLineNo">285</span> *<a name="line.285"></a>
+<span class="sourceLineNo">286</span> * @param servers<a name="line.286"></a>
+<span class="sourceLineNo">287</span> * the servers<a name="line.287"></a>
+<span class="sourceLineNo">288</span> * @param onlineServers<a name="line.288"></a>
+<span class="sourceLineNo">289</span> * List of servers which are online.<a name="line.289"></a>
+<span class="sourceLineNo">290</span> * @return the list<a name="line.290"></a>
+<span class="sourceLineNo">291</span> */<a name="line.291"></a>
+<span class="sourceLineNo">292</span> private List<ServerName> filterServers(Collection<Address> servers,<a name="line.292"></a>
+<span class="sourceLineNo">293</span> Collection<ServerName> onlineServers) {<a name="line.293"></a>
+<span class="sourceLineNo">294</span> ArrayList<ServerName> finalList = new ArrayList<ServerName>();<a name="line.294"></a>
+<span class="sourceLineNo">295</span> for (Address server : servers) {<a name="line.295"></a>
+<span class="sourceLineNo">296</span> for(ServerName curr: onlineServers) {<a name="line.296"></a>
+<span class="sourceLineNo">297</span> if(curr.getAddress().equals(server)) {<a name="line.297"></a>
+<span class="sourceLineNo">298</span> finalList.add(curr);<a name="line.298"></a>
+<span class="sourceLineNo">299</span> }<a name="line.299"></a>
+<span class="sourceLineNo">300</span> }<a name="line.300"></a>
+<span class="sourceLineNo">301</span> }<a name="line.301"></a>
+<span class="sourceLineNo">302</span> return finalList;<a name="line.302"></a>
+<span class="sourceLineNo">303</span> }<a name="line.303"></a>
+<span class="sourceLineNo">304</span><a name="line.304"></a>
+<span class="sourceLineNo">305</span> private Set<RegionInfo> getMisplacedRegions(<a name="line.305"></a>
+<span class="sourceLineNo">306</span> Map<RegionInfo, ServerName> regions) throws IOException {<a name="line.306"></a>
+<span class="sourceLineNo">307</span> Set<RegionInfo> misplacedRegions = new HashSet<>();<a name="line.307"></a>
+<span class="sourceLineNo">308</span> for(Map.Entry<RegionInfo, ServerName> region : regions.entrySet()) {<a name="line.308"></a>
+<span class="sourceLineNo">309</span> RegionInfo regionInfo = region.getKey();<a name="line.309"></a>
+<span class="sourceLineNo">310</span> ServerName assignedServer = region.getValue();<a name="line.310"></a>
+<span class="sourceLineNo">311</span> RSGroupInfo info = rsGroupInfoManager.getRSGroup(rsGroupInfoManager.<a name="line.311"></a>
+<span class="sourceLineNo">312</span> getRSGroupOfTable(regionInfo.getTable()));<a name="line.312"></a>
+<span class="sourceLineNo">313</span> if (assignedServer != null &&<a name="line.313"></a>
+<span class="sourceLineNo">314</span> (info == null || !info.containsServer(assignedServer.getAddress()))) {<a name="line.314"></a>
+<span class="sourceLineNo">315</span> RSGroupInfo otherInfo = null;<a name="line.315"></a>
+<span class="sourceLineNo">316</span> otherInfo = rsGroupInfoManager.getRSGroupOfServer(assignedServer.getAddress());<a name="line.316"></a>
+<span class="sourceLineNo">317</span> LOG.debug("Found misplaced region: " + regionInfo.getRegionNameAsString() +<a name="line.317"></a>
+<span class="sourceLineNo">318</span> " on server: " + assignedServer +<a name="line.318"></a>
+<span class="sourceLineNo">319</span> " found in group: " + otherInfo +<a name="line.319"></a>
+<span class="sourceLineNo">320</span> " outside of group: " + (info == null ? "UNKNOWN" : info.getName()));<a name="line.320"></a>
+<span class="sourceLineNo">321</span> misplacedRegions.add(regionInfo);<a name="line.321"></a>
+<span class="sourceLineNo">322</span> }<a name="line.322"></a>
+<span class="sourceLineNo">323</span> }<a name="line.323"></a>
+<span class="sourceLineNo">324</span> return misplacedRegions;<a name="line.324"></a>
+<span class="sourceLineNo">325</span> }<a name="line.325"></a>
+<span class="sourceLineNo">326</span><a name="line.326"></a>
+<span class="sourceLineNo">327</span> private ServerName findServerForRegion(<a name="line.327"></a>
+<span class="sourceLineNo">328</span> Map<ServerName, List<RegionInfo>> existingAssignments, RegionInfo region) {<a name="line.328"></a>
<span class="sourceLineNo">329</span> for (Map.Entry<ServerName, List<RegionInfo>> entry : existingAssignments.entrySet()) {<a name="line.329"></a>
<span class="sourceLineNo">330</span> if (entry.getValue().contains(region)) {<a name="line.330"></a>
<span class="sourceLineNo">331</span> return entry.getKey();<a name="line.331"></a>
@@ -400,41 +400,44 @@
<span class="sourceLineNo">392</span> }<a name="line.392"></a>
<span class="sourceLineNo">393</span><a name="line.393"></a>
<span class="sourceLineNo">394</span> public boolean isOnline() {<a name="line.394"></a>
-<span class="sourceLineNo">395</span> if (this.rsGroupInfoManager == null) return false;<a name="line.395"></a>
-<span class="sourceLineNo">396</span> return this.rsGroupInfoManager.isOnline();<a name="line.396"></a>
-<span class="sourceLineNo">397</span> }<a name="line.397"></a>
+<span class="sourceLineNo">395</span> if (this.rsGroupInfoManager == null) {<a name="line.395"></a>
+<span class="sourceLineNo">396</span> return false;<a name="line.396"></a>
+<span class="sourceLineNo">397</span> }<a name="line.397"></a>
<span class="sourceLineNo">398</span><a name="line.398"></a>
-<span class="sourceLineNo">399</span> @Override<a name="line.399"></a>
-<span class="sourceLineNo">400</span> public void setClusterLoad(Map<TableName, Map<ServerName, List<RegionInfo>>> clusterLoad) {<a name="line.400"></a>
-<span class="sourceLineNo">401</span> }<a name="line.401"></a>
-<span class="sourceLineNo">402</span><a name="line.402"></a>
-<span class="sourceLineNo">403</span> @Override<a name="line.403"></a>
-<span class="sourceLineNo">404</span> public void regionOnline(RegionInfo regionInfo, ServerName sn) {<a name="line.404"></a>
-<span class="sourceLineNo">405</span> }<a name="line.405"></a>
-<span class="sourceLineNo">406</span><a name="line.406"></a>
-<span class="sourceLineNo">407</span> @Override<a name="line.407"></a>
-<span class="sourceLineNo">408</span> public void regionOffline(RegionInfo regionInfo) {<a name="line.408"></a>
-<span class="sourceLineNo">409</span> }<a name="line.409"></a>
-<span class="sourceLineNo">410</span><a name="line.410"></a>
-<span class="sourceLineNo">411</span> @Override<a name="line.411"></a>
-<span class="sourceLineNo">412</span> public void onConfigurationChange(Configuration conf) {<a name="line.412"></a>
-<span class="sourceLineNo">413</span> //DO nothing for now<a name="line.413"></a>
-<span class="sourceLineNo">414</span> }<a name="line.414"></a>
-<span class="sourceLineNo">415</span><a name="line.415"></a>
-<span class="sourceLineNo">416</span> @Override<a name="line.416"></a>
-<span class="sourceLineNo">417</span> public void stop(String why) {<a name="line.417"></a>
-<span class="sourceLineNo">418</span> }<a name="line.418"></a>
-<span class="sourceLineNo">419</span><a name="line.419"></a>
-<span class="sourceLineNo">420</span> @Override<a name="line.420"></a>
-<span class="sourceLineNo">421</span> public boolean isStopped() {<a name="line.421"></a>
-<span class="sourceLineNo">422</span> return false;<a name="line.422"></a>
-<span class="sourceLineNo">423</span> }<a name="line.423"></a>
-<span class="sourceLineNo">424</span><a name="line.424"></a>
-<span class="sourceLineNo">425</span> @VisibleForTesting<a name="line.425"></a>
-<span class="sourceLineNo">426</span> public void setRsGroupInfoManager(RSGroupInfoManager rsGroupInfoManager) {<a name="line.426"></a>
-<span class="sourceLineNo">427</span> this.rsGroupInfoManager = rsGroupInfoManager;<a name="line.427"></a>
-<span class="sourceLineNo">428</span> }<a name="line.428"></a>
-<span class="sourceLineNo">429</span>}<a name="line.429"></a>
+<span class="sourceLineNo">399</span> return this.rsGroupInfoManager.isOnline();<a name="line.399"></a>
+<span class="sourceLineNo">400</span> }<a name="line.400"></a>
+<span class="sourceLineNo">401</span><a name="line.401"></a>
+<span class="sourceLineNo">402</span> @Override<a name="line.402"></a>
+<span class="sourceLineNo">403</span> public void setClusterLoad(Map<TableName, Map<ServerName, List<RegionInfo>>> clusterLoad) {<a name="line.403"></a>
+<span class="sourceLineNo">404</span> }<a name="line.404"></a>
+<span class="sourceLineNo">405</span><a name="line.405"></a>
+<span class="sourceLineNo">406</span> @Override<a name="line.406"></a>
+<span class="sourceLineNo">407</span> public void regionOnline(RegionInfo regionInfo, ServerName sn) {<a name="line.407"></a>
+<span class="sourceLineNo">408</span> }<a name="line.408"></a>
+<span class="sourceLineNo">409</span><a name="line.409"></a>
+<span class="sourceLineNo">410</span> @Override<a name="line.410"></a>
+<span class="sourceLineNo">411</span> public void regionOffline(RegionInfo regionInfo) {<a name="line.411"></a>
+<span class="sourceLineNo">412</span> }<a name="line.412"></a>
+<span class="sourceLineNo">413</span><a name="line.413"></a>
+<span class="sourceLineNo">414</span> @Override<a name="line.414"></a>
+<span class="sourceLineNo">415</span> public void onConfigurationChange(Configuration conf) {<a name="line.415"></a>
+<span class="sourceLineNo">416</span> //DO nothing for now<a name="line.416"></a>
+<span class="sourceLineNo">417</span> }<a name="line.417"></a>
+<span class="sourceLineNo">418</span><a name="line.418"></a>
+<span class="sourceLineNo">419</span> @Override<a name="line.419"></a>
+<span class="sourceLineNo">420</span> public void stop(String why) {<a name="line.420"></a>
+<span class="sourceLineNo">421</span> }<a name="line.421"></a>
+<span class="sourceLineNo">422</span><a name="line.422"></a>
+<span class="sourceLineNo">423</span> @Override<a name="line.423"></a>
+<span class="sourceLineNo">424</span> public boolean isStopped() {<a name="line.424"></a>
+<span class="sourceLineNo">425</span> return false;<a name="line.425"></a>
+<span class="sourceLineNo">426</span> }<a name="line.426"></a>
+<span class="sourceLineNo">427</span><a name="line.427"></a>
+<span class="sourceLineNo">428</span> @VisibleForTesting<a name="line.428"></a>
+<span class="sourceLineNo">429</span> public void setRsGroupInfoManager(RSGroupInfoManager rsGroupInfoManager) {<a name="line.429"></a>
+<span class="sourceLineNo">430</span> this.rsGroupInfoManager = rsGroupInfoManager;<a name="line.430"></a>
+<span class="sourceLineNo">431</span> }<a name="line.431"></a>
+<span class="sourceLineNo">432</span>}<a name="line.432"></a>
http://git-wip-us.apache.org/repos/asf/hbase-site/blob/c33bd58a/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManager.html
----------------------------------------------------------------------
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManager.html b/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManager.html
index 8f39ade..959e2b5 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManager.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/rsgroup/RSGroupInfoManager.html
@@ -26,112 +26,111 @@
<span class="sourceLineNo">018</span><a name="line.18"></a>
<span class="sourceLineNo">019</span>package org.apache.hadoop.hbase.rsgroup;<a name="line.19"></a>
<span class="sourceLineNo">020</span><a name="line.20"></a>
-<span class="sourceLineNo">021</span><a name="line.21"></a>
-<span class="sourceLineNo">022</span>import java.io.IOException;<a name="line.22"></a>
-<span class="sourceLineNo">023</span>import java.util.List;<a name="line.23"></a>
-<span class="sourceLineNo">024</span>import java.util.Set;<a name="line.24"></a>
-<span class="sourceLineNo">025</span><a name="line.25"></a>
-<span class="sourceLineNo">026</span>import org.apache.hadoop.hbase.NamespaceDescriptor;<a name="line.26"></a>
-<span class="sourceLineNo">027</span>import org.apache.hadoop.hbase.TableName;<a name="line.27"></a>
+<span class="sourceLineNo">021</span>import java.io.IOException;<a name="line.21"></a>
+<span class="sourceLineNo">022</span>import java.util.List;<a name="line.22"></a>
+<span class="sourceLineNo">023</span>import java.util.Set;<a name="line.23"></a>
+<span class="sourceLineNo">024</span><a name="line.24"></a>
+<span class="sourceLineNo">025</span>import org.apache.hadoop.hbase.NamespaceDescriptor;<a name="line.25"></a>
+<span class="sourceLineNo">026</span>import org.apache.hadoop.hbase.TableName;<a name="line.26"></a>
+<span class="sourceLineNo">027</span>import org.apache.hadoop.hbase.net.Address;<a name="line.27"></a>
<span class="sourceLineNo">028</span>import org.apache.hadoop.hbase.util.Bytes;<a name="line.28"></a>
<span class="sourceLineNo">029</span>import org.apache.yetus.audience.InterfaceAudience;<a name="line.29"></a>
-<span class="sourceLineNo">030</span>import org.apache.hadoop.hbase.net.Address;<a name="line.30"></a>
-<span class="sourceLineNo">031</span><a name="line.31"></a>
-<span class="sourceLineNo">032</span>/**<a name="line.32"></a>
-<span class="sourceLineNo">033</span> * Interface used to manage RSGroupInfo storage. An implementation<a name="line.33"></a>
-<span class="sourceLineNo">034</span> * has the option to support offline mode.<a name="line.34"></a>
-<span class="sourceLineNo">035</span> * See {@link RSGroupBasedLoadBalancer}<a name="line.35"></a>
-<span class="sourceLineNo">036</span> */<a name="line.36"></a>
-<span class="sourceLineNo">037</span>@InterfaceAudience.Private<a name="line.37"></a>
-<span class="sourceLineNo">038</span>public interface RSGroupInfoManager {<a name="line.38"></a>
-<span class="sourceLineNo">039</span><a name="line.39"></a>
-<span class="sourceLineNo">040</span> String REASSIGN_WAIT_INTERVAL_KEY = "hbase.rsgroup.reassign.wait";<a name="line.40"></a>
-<span class="sourceLineNo">041</span> long DEFAULT_REASSIGN_WAIT_INTERVAL = 30 * 1000L;<a name="line.41"></a>
-<span class="sourceLineNo">042</span><a name="line.42"></a>
-<span class="sourceLineNo">043</span> //Assigned before user tables<a name="line.43"></a>
-<span class="sourceLineNo">044</span> TableName RSGROUP_TABLE_NAME =<a name="line.44"></a>
-<span class="sourceLineNo">045</span> TableName.valueOf(NamespaceDescriptor.SYSTEM_NAMESPACE_NAME_STR, "rsgroup");<a name="line.45"></a>
-<span class="sourceLineNo">046</span> String rsGroupZNode = "rsgroup";<a name="line.46"></a>
-<span class="sourceLineNo">047</span> byte[] META_FAMILY_BYTES = Bytes.toBytes("m");<a name="line.47"></a>
-<span class="sourceLineNo">048</span> byte[] META_QUALIFIER_BYTES = Bytes.toBytes("i");<a name="line.48"></a>
-<span class="sourceLineNo">049</span> byte[] ROW_KEY = {0};<a name="line.49"></a>
-<span class="sourceLineNo">050</span><a name="line.50"></a>
-<span class="sourceLineNo">051</span> /**<a name="line.51"></a>
-<span class="sourceLineNo">052</span> * Add given RSGroupInfo to existing list of group infos.<a name="line.52"></a>
-<span class="sourceLineNo">053</span> */<a name="line.53"></a>
-<span class="sourceLineNo">054</span> void addRSGroup(RSGroupInfo rsGroupInfo) throws IOException;<a name="line.54"></a>
-<span class="sourceLineNo">055</span><a name="line.55"></a>
-<span class="sourceLineNo">056</span> /**<a name="line.56"></a>
-<span class="sourceLineNo">057</span> * Remove a region server group.<a name="line.57"></a>
-<span class="sourceLineNo">058</span> */<a name="line.58"></a>
-<span class="sourceLineNo">059</span> void removeRSGroup(String groupName) throws IOException;<a name="line.59"></a>
-<span class="sourceLineNo">060</span><a name="line.60"></a>
-<span class="sourceLineNo">061</span> /**<a name="line.61"></a>
-<span class="sourceLineNo">062</span> * Move servers to a new group.<a name="line.62"></a>
-<span class="sourceLineNo">063</span> * @param servers list of servers, must be part of the same group<a name="line.63"></a>
-<span class="sourceLineNo">064</span> * @param srcGroup groupName being moved from<a name="line.64"></a>
-<span class="sourceLineNo">065</span> * @param dstGroup groupName being moved to<a name="line.65"></a>
-<span class="sourceLineNo">066</span> * @return Set of servers moved (May be a subset of {@code servers}).<a name="line.66"></a>
-<span class="sourceLineNo">067</span> */<a name="line.67"></a>
-<span class="sourceLineNo">068</span> Set<Address> moveServers(Set<Address> servers, String srcGroup, String dstGroup)<a name="line.68"></a>
-<span class="sourceLineNo">069</span> throws IOException;<a name="line.69"></a>
-<span class="sourceLineNo">070</span><a name="line.70"></a>
-<span class="sourceLineNo">071</span> /**<a name="line.71"></a>
-<span class="sourceLineNo">072</span> * Gets the group info of server.<a name="line.72"></a>
-<span class="sourceLineNo">073</span> */<a name="line.73"></a>
-<span class="sourceLineNo">074</span> RSGroupInfo getRSGroupOfServer(Address serverHostPort) throws IOException;<a name="line.74"></a>
-<span class="sourceLineNo">075</span><a name="line.75"></a>
-<span class="sourceLineNo">076</span> /**<a name="line.76"></a>
-<span class="sourceLineNo">077</span> * Gets {@code RSGroupInfo} for the given group name.<a name="line.77"></a>
-<span class="sourceLineNo">078</span> */<a name="line.78"></a>
-<span class="sourceLineNo">079</span> RSGroupInfo getRSGroup(String groupName) throws IOException;<a name="line.79"></a>
-<span class="sourceLineNo">080</span><a name="line.80"></a>
-<span class="sourceLineNo">081</span> /**<a name="line.81"></a>
-<span class="sourceLineNo">082</span> * Get the group membership of a table<a name="line.82"></a>
-<span class="sourceLineNo">083</span> */<a name="line.83"></a>
-<span class="sourceLineNo">084</span> String getRSGroupOfTable(TableName tableName) throws IOException;<a name="line.84"></a>
-<span class="sourceLineNo">085</span><a name="line.85"></a>
-<span class="sourceLineNo">086</span> /**<a name="line.86"></a>
-<span class="sourceLineNo">087</span> * Set the group membership of a set of tables<a name="line.87"></a>
-<span class="sourceLineNo">088</span> *<a name="line.88"></a>
-<span class="sourceLineNo">089</span> * @param tableNames set of tables to move<a name="line.89"></a>
-<span class="sourceLineNo">090</span> * @param groupName name of group of tables to move to<a name="line.90"></a>
-<span class="sourceLineNo">091</span> */<a name="line.91"></a>
-<span class="sourceLineNo">092</span> void moveTables(Set<TableName> tableNames, String groupName) throws IOException;<a name="line.92"></a>
-<span class="sourceLineNo">093</span><a name="line.93"></a>
-<span class="sourceLineNo">094</span> /**<a name="line.94"></a>
-<span class="sourceLineNo">095</span> * List the existing {@code RSGroupInfo}s.<a name="line.95"></a>
-<span class="sourceLineNo">096</span> */<a name="line.96"></a>
-<span class="sourceLineNo">097</span> List<RSGroupInfo> listRSGroups() throws IOException;<a name="line.97"></a>
-<span class="sourceLineNo">098</span><a name="line.98"></a>
-<span class="sourceLineNo">099</span> /**<a name="line.99"></a>
-<span class="sourceLineNo">100</span> * Refresh/reload the group information from the persistent store<a name="line.100"></a>
-<span class="sourceLineNo">101</span> */<a name="line.101"></a>
-<span class="sourceLineNo">102</span> void refresh() throws IOException;<a name="line.102"></a>
-<span class="sourceLineNo">103</span><a name="line.103"></a>
-<span class="sourceLineNo">104</span> /**<a name="line.104"></a>
-<span class="sourceLineNo">105</span> * Whether the manager is able to fully return group metadata<a name="line.105"></a>
-<span class="sourceLineNo">106</span> *<a name="line.106"></a>
-<span class="sourceLineNo">107</span> * @return whether the manager is in online mode<a name="line.107"></a>
-<span class="sourceLineNo">108</span> */<a name="line.108"></a>
-<span class="sourceLineNo">109</span> boolean isOnline();<a name="line.109"></a>
-<span class="sourceLineNo">110</span><a name="line.110"></a>
-<span class="sourceLineNo">111</span> /**<a name="line.111"></a>
-<span class="sourceLineNo">112</span> * Move servers and tables to a new group.<a name="line.112"></a>
-<span class="sourceLineNo">113</span> * @param servers list of servers, must be part of the same group<a name="line.113"></a>
-<span class="sourceLineNo">114</span> * @param tables set of tables to move<a name="line.114"></a>
-<span class="sourceLineNo">115</span> * @param srcGroup groupName being moved from<a name="line.115"></a>
-<span class="sourceLineNo">116</span> * @param dstGroup groupName being moved to<a name="line.116"></a>
-<span class="sourceLineNo">117</span> */<a name="line.117"></a>
-<span class="sourceLineNo">118</span> void moveServersAndTables(Set<Address> servers, Set<TableName> tables,<a name="line.118"></a>
-<span class="sourceLineNo">119</span> String srcGroup, String dstGroup) throws IOException;<a name="line.119"></a>
-<span class="sourceLineNo">120</span><a name="line.120"></a>
-<span class="sourceLineNo">121</span> /**<a name="line.121"></a>
-<span class="sourceLineNo">122</span> * Remove decommissioned servers from rsgroup<a name="line.122"></a>
-<span class="sourceLineNo">123</span> * @param servers set of servers to remove<a name="line.123"></a>
-<span class="sourceLineNo">124</span> */<a name="line.124"></a>
-<span class="sourceLineNo">125</span> void removeServers(Set<Address> servers) throws IOException;<a name="line.125"></a>
-<span class="sourceLineNo">126</span>}<a name="line.126"></a>
+<span class="sourceLineNo">030</span><a name="line.30"></a>
+<span class="sourceLineNo">031</span>/**<a name="line.31"></a>
+<span class="sourceLineNo">032</span> * Interface used to manage RSGroupInfo storage. An implementation<a name="line.32"></a>
+<span class="sourceLineNo">033</span> * has the option to support offline mode.<a name="line.33"></a>
+<span class="sourceLineNo">034</span> * See {@link RSGroupBasedLoadBalancer}<a name="line.34"></a>
+<span class="sourceLineNo">035</span> */<a name="line.35"></a>
+<span class="sourceLineNo">036</span>@InterfaceAudience.Private<a name="line.36"></a>
+<span class="sourceLineNo">037</span>public interface RSGroupInfoManager {<a name="line.37"></a>
+<span class="sourceLineNo">038</span><a name="line.38"></a>
+<span class="sourceLineNo">039</span> String REASSIGN_WAIT_INTERVAL_KEY = "hbase.rsgroup.reassign.wait";<a name="line.39"></a>
+<span class="sourceLineNo">040</span> long DEFAULT_REASSIGN_WAIT_INTERVAL = 30 * 1000L;<a name="line.40"></a>
+<span class="sourceLineNo">041</span><a name="line.41"></a>
+<span class="sourceLineNo">042</span> //Assigned before user tables<a name="line.42"></a>
+<span class="sourceLineNo">043</span> TableName RSGROUP_TABLE_NAME =<a name="line.43"></a>
+<span class="sourceLineNo">044</span> TableName.valueOf(NamespaceDescriptor.SYSTEM_NAMESPACE_NAME_STR, "rsgroup");<a name="line.44"></a>
+<span class="sourceLineNo">045</span> String rsGroupZNode = "rsgroup";<a name="line.45"></a>
+<span class="sourceLineNo">046</span> byte[] META_FAMILY_BYTES = Bytes.toBytes("m");<a name="line.46"></a>
+<span class="sourceLineNo">047</span> byte[] META_QUALIFIER_BYTES = Bytes.toBytes("i");<a name="line.47"></a>
+<span class="sourceLineNo">048</span> byte[] ROW_KEY = {0};<a name="line.48"></a>
+<span class="sourceLineNo">049</span><a name="line.49"></a>
+<span class="sourceLineNo">050</span> /**<a name="line.50"></a>
+<span class="sourceLineNo">051</span> * Add given RSGroupInfo to existing list of group infos.<a name="line.51"></a>
+<span class="sourceLineNo">052</span> */<a name="line.52"></a>
+<span class="sourceLineNo">053</span> void addRSGroup(RSGroupInfo rsGroupInfo) throws IOException;<a name="line.53"></a>
+<span class="sourceLineNo">054</span><a name="line.54"></a>
+<span class="sourceLineNo">055</span> /**<a name="line.55"></a>
+<span class="sourceLineNo">056</span> * Remove a region server group.<a name="line.56"></a>
+<span class="sourceLineNo">057</span> */<a name="line.57"></a>
+<span class="sourceLineNo">058</span> void removeRSGroup(String groupName) throws IOException;<a name="line.58"></a>
+<span class="sourceLineNo">059</span><a name="line.59"></a>
+<span class="sourceLineNo">060</span> /**<a name="line.60"></a>
+<span class="sourceLineNo">061</span> * Move servers to a new group.<a name="line.61"></a>
+<span class="sourceLineNo">062</span> * @param servers list of servers, must be part of the same group<a name="line.62"></a>
+<span class="sourceLineNo">063</span> * @param srcGroup groupName being moved from<a name="line.63"></a>
+<span class="sourceLineNo">064</span> * @param dstGroup groupName being moved to<a name="line.64"></a>
+<span class="sourceLineNo">065</span> * @return Set of servers moved (May be a subset of {@code servers}).<a name="line.65"></a>
+<span class="sourceLineNo">066</span> */<a name="line.66"></a>
+<span class="sourceLineNo">067</span> Set<Address> moveServers(Set<Address> servers, String srcGroup, String dstGroup)<a name="line.67"></a>
+<span class="sourceLineNo">068</span> throws IOException;<a name="line.68"></a>
+<span class="sourceLineNo">069</span><a name="line.69"></a>
+<span class="sourceLineNo">070</span> /**<a name="line.70"></a>
+<span class="sourceLineNo">071</span> * Gets the group info of server.<a name="line.71"></a>
+<span class="sourceLineNo">072</span> */<a name="line.72"></a>
+<span class="sourceLineNo">073</span> RSGroupInfo getRSGroupOfServer(Address serverHostPort) throws IOException;<a name="line.73"></a>
+<span class="sourceLineNo">074</span><a name="line.74"></a>
+<span class="sourceLineNo">075</span> /**<a name="line.75"></a>
+<span class="sourceLineNo">076</span> * Gets {@code RSGroupInfo} for the given group name.<a name="line.76"></a>
+<span class="sourceLineNo">077</span> */<a name="line.77"></a>
+<span class="sourceLineNo">078</span> RSGroupInfo getRSGroup(String groupName) throws IOException;<a name="line.78"></a>
+<span class="sourceLineNo">079</span><a name="line.79"></a>
+<span class="sourceLineNo">080</span> /**<a name="line.80"></a>
+<span class="sourceLineNo">081</span> * Get the group membership of a table<a name="line.81"></a>
+<span class="sourceLineNo">082</span> */<a name="line.82"></a>
+<span class="sourceLineNo">083</span> String getRSGroupOfTable(TableName tableName) throws IOException;<a name="line.83"></a>
+<span class="sourceLineNo">084</span><a name="line.84"></a>
+<span class="sourceLineNo">085</span> /**<a name="line.85"></a>
+<span class="sourceLineNo">086</span> * Set the group membership of a set of tables<a name="line.86"></a>
+<span class="sourceLineNo">087</span> *<a name="line.87"></a>
+<span class="sourceLineNo">088</span> * @param tableNames set of tables to move<a name="line.88"></a>
+<span class="sourceLineNo">089</span> * @param groupName name of group of tables to move to<a name="line.89"></a>
+<span class="sourceLineNo">090</span> */<a name="line.90"></a>
+<span class="sourceLineNo">091</span> void moveTables(Set<TableName> tableNames, String groupName) throws IOException;<a name="line.91"></a>
+<span class="sourceLineNo">092</span><a name="line.92"></a>
+<span class="sourceLineNo">093</span> /**<a name="line.93"></a>
+<span class="sourceLineNo">094</span> * List the existing {@code RSGroupInfo}s.<a name="line.94"></a>
+<span class="sourceLineNo">095</span> */<a name="line.95"></a>
+<span class="sourceLineNo">096</span> List<RSGroupInfo> listRSGroups() throws IOException;<a name="line.96"></a>
+<span class="sourceLineNo">097</span><a name="line.97"></a>
+<span class="sourceLineNo">098</span> /**<a name="line.98"></a>
+<span class="sourceLineNo">099</span> * Refresh/reload the group information from the persistent store<a name="line.99"></a>
+<span class="sourceLineNo">100</span> */<a name="line.100"></a>
+<span class="sourceLineNo">101</span> void refresh() throws IOException;<a name="line.101"></a>
+<span class="sourceLineNo">102</span><a name="line.102"></a>
+<span class="sourceLineNo">103</span> /**<a name="line.103"></a>
+<span class="sourceLineNo">104</span> * Whether the manager is able to fully return group metadata<a name="line.104"></a>
+<span class="sourceLineNo">105</span> *<a name="line.105"></a>
+<span class="sourceLineNo">106</span> * @return whether the manager is in online mode<a name="line.106"></a>
+<span class="sourceLineNo">107</span> */<a name="line.107"></a>
+<span class="sourceLineNo">108</span> boolean isOnline();<a name="line.108"></a>
+<span class="sourceLineNo">109</span><a name="line.109"></a>
+<span class="sourceLineNo">110</span> /**<a name="line.110"></a>
+<span class="sourceLineNo">111</span> * Move servers and tables to a new group.<a name="line.111"></a>
+<span class="sourceLineNo">112</span> * @param servers list of servers, must be part of the same group<a name="line.112"></a>
+<span class="sourceLineNo">113</span> * @param tables set of tables to move<a name="line.113"></a>
+<span class="sourceLineNo">114</span> * @param srcGroup groupName being moved from<a name="line.114"></a>
+<span class="sourceLineNo">115</span> * @param dstGroup groupName being moved to<a name="line.115"></a>
+<span class="sourceLineNo">116</span> */<a name="line.116"></a>
+<span class="sourceLineNo">117</span> void moveServersAndTables(Set<Address> servers, Set<TableName> tables,<a name="line.117"></a>
+<span class="sourceLineNo">118</span> String srcGroup, String dstGroup) throws IOException;<a name="line.118"></a>
+<span class="sourceLineNo">119</span><a name="line.119"></a>
+<span class="sourceLineNo">120</span> /**<a name="line.120"></a>
+<span class="sourceLineNo">121</span> * Remove decommissioned servers from rsgroup<a name="line.121"></a>
+<span class="sourceLineNo">122</span> * @param servers set of servers to remove<a name="line.122"></a>
+<span class="sourceLineNo">123</span> */<a name="line.123"></a>
+<span class="sourceLineNo">124</span> void removeServers(Set<Address> servers) throws IOException;<a name="line.124"></a>
+<span class="sourceLineNo">125</span>}<a name="line.125"></a>