001/*
002 * Licensed to the Apache Software Foundation (ASF) under one
003 * or more contributor license agreements.  See the NOTICE file
004 * distributed with this work for additional information
005 * regarding copyright ownership.  The ASF licenses this file
006 * to you under the Apache License, Version 2.0 (the
007 * "License"); you may not use this file except in compliance
008 * with the License.  You may obtain a copy of the License at
009 *
010 *     http://www.apache.org/licenses/LICENSE-2.0
011 *
012 * Unless required by applicable law or agreed to in writing, software
013 * distributed under the License is distributed on an "AS IS" BASIS,
014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 * See the License for the specific language governing permissions and
016 * limitations under the License.
017 */
018package org.apache.hadoop.hbase.master.balancer;
019
020import static org.apache.hadoop.hbase.master.balancer.CandidateGeneratorTestUtil.isTableIsolated;
021import static org.apache.hadoop.hbase.master.balancer.CandidateGeneratorTestUtil.runBalancerToExhaustion;
022
023import java.util.ArrayList;
024import java.util.HashMap;
025import java.util.List;
026import java.util.Map;
027import java.util.Random;
028import java.util.Set;
029import org.apache.hadoop.conf.Configuration;
030import org.apache.hadoop.hbase.HBaseClassTestRule;
031import org.apache.hadoop.hbase.ServerName;
032import org.apache.hadoop.hbase.TableName;
033import org.apache.hadoop.hbase.client.RegionInfo;
034import org.apache.hadoop.hbase.client.RegionInfoBuilder;
035import org.apache.hadoop.hbase.master.balancer.BalancerTestBase.MockMapping;
036import org.apache.hadoop.hbase.testclassification.MasterTests;
037import org.apache.hadoop.hbase.testclassification.MediumTests;
038import org.apache.hadoop.net.DNSToSwitchMapping;
039import org.junit.BeforeClass;
040import org.junit.ClassRule;
041import org.junit.Test;
042import org.junit.experimental.categories.Category;
043import org.slf4j.Logger;
044import org.slf4j.LoggerFactory;
045
046@Category({ MediumTests.class, MasterTests.class })
047public class TestLargeClusterBalancingTableIsolationAndReplicaDistribution {
048
049  @ClassRule
050  public static final HBaseClassTestRule CLASS_RULE = HBaseClassTestRule
051    .forClass(TestLargeClusterBalancingTableIsolationAndReplicaDistribution.class);
052
053  private static final Logger LOG =
054    LoggerFactory.getLogger(TestLargeClusterBalancingTableIsolationAndReplicaDistribution.class);
055  private static final TableName SYSTEM_TABLE_NAME = TableName.valueOf("hbase:system");
056  private static final TableName NON_ISOLATED_TABLE_NAME = TableName.valueOf("userTable");
057
058  private static final int NUM_SERVERS = 500;
059  private static final int NUM_REGIONS = 2_500;
060  private static final int NUM_REPLICAS = 3;
061
062  private static final ServerName[] servers = new ServerName[NUM_SERVERS];
063  private static final Map<ServerName, List<RegionInfo>> serverToRegions = new HashMap<>();
064
065  @BeforeClass
066  public static void setup() {
067    // Initialize servers
068    for (int i = 0; i < NUM_SERVERS; i++) {
069      servers[i] = ServerName.valueOf("server" + i, i, System.currentTimeMillis());
070      serverToRegions.put(servers[i], new ArrayList<>());
071    }
072
073    // Create primary regions and their replicas
074    for (int i = 0; i < NUM_REGIONS; i++) {
075      TableName tableName;
076      if (i < 1) {
077        tableName = TableName.META_TABLE_NAME;
078      } else if (i < 10) {
079        tableName = SYSTEM_TABLE_NAME;
080      } else {
081        tableName = NON_ISOLATED_TABLE_NAME;
082      }
083
084      // Define startKey and endKey for the region
085      byte[] startKey = new byte[1];
086      startKey[0] = (byte) i;
087      byte[] endKey = new byte[1];
088      endKey[0] = (byte) (i + 1);
089
090      Random random = new Random();
091      // Create 3 replicas for each primary region
092      for (int replicaId = 0; replicaId < NUM_REPLICAS; replicaId++) {
093        RegionInfo regionInfo = RegionInfoBuilder.newBuilder(tableName).setStartKey(startKey)
094          .setEndKey(endKey).setReplicaId(replicaId).build();
095        // Assign region to random server
096        int randomServer = random.nextInt(servers.length);
097        serverToRegions.get(servers[randomServer]).add(regionInfo);
098      }
099    }
100  }
101
102  @Test
103  public void testTableIsolationAndReplicaDistribution() {
104    Configuration conf = new Configuration(false);
105    conf.setClass("hbase.util.ip.to.rack.determiner", MockMapping.class, DNSToSwitchMapping.class);
106    conf.setBoolean(BalancerConditionals.ISOLATE_META_TABLE_KEY, true);
107    conf.setBoolean(BalancerConditionals.ISOLATE_SYSTEM_TABLES_KEY, true);
108    DistributeReplicasTestConditional.enableConditionalReplicaDistributionForTest(conf);
109
110    runBalancerToExhaustion(conf, serverToRegions,
111      Set.of(this::isMetaTableIsolated, this::isSystemTableIsolated,
112        CandidateGeneratorTestUtil::areAllReplicasDistributed),
113      10.0f, 60_000, CandidateGeneratorTestUtil.ExhaustionType.COST_GOAL_ACHIEVED);
114    LOG.info("Meta table regions are successfully isolated, "
115      + "and region replicas are appropriately distributed.");
116  }
117
118  /**
119   * Validates whether all meta table regions are isolated.
120   */
121  private boolean isMetaTableIsolated(BalancerClusterState cluster) {
122    return isTableIsolated(cluster, TableName.META_TABLE_NAME, "Meta");
123  }
124
125  /**
126   * Validates whether all meta table regions are isolated.
127   */
128  private boolean isSystemTableIsolated(BalancerClusterState cluster) {
129    return isTableIsolated(cluster, SYSTEM_TABLE_NAME, "System");
130  }
131}