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.quotas;
019
020import static org.apache.hadoop.hbase.quotas.ThrottleQuotaTestUtil.triggerUserCacheRefresh;
021import static org.apache.hadoop.hbase.quotas.ThrottleQuotaTestUtil.waitMinuteQuota;
022
023import java.io.IOException;
024import java.util.UUID;
025import java.util.concurrent.TimeUnit;
026import org.apache.hadoop.hbase.HBaseClassTestRule;
027import org.apache.hadoop.hbase.HBaseTestingUtil;
028import org.apache.hadoop.hbase.HConstants;
029import org.apache.hadoop.hbase.TableName;
030import org.apache.hadoop.hbase.client.Admin;
031import org.apache.hadoop.hbase.client.Table;
032import org.apache.hadoop.hbase.security.User;
033import org.apache.hadoop.hbase.testclassification.MediumTests;
034import org.apache.hadoop.hbase.testclassification.RegionServerTests;
035import org.apache.hadoop.hbase.util.Bytes;
036import org.apache.hadoop.hbase.util.EnvironmentEdgeManager;
037import org.junit.After;
038import org.junit.BeforeClass;
039import org.junit.ClassRule;
040import org.junit.Test;
041import org.junit.experimental.categories.Category;
042
043@Category({ RegionServerTests.class, MediumTests.class })
044public class TestDefaultQuota {
045  @ClassRule
046  public static final HBaseClassTestRule CLASS_RULE =
047    HBaseClassTestRule.forClass(TestDefaultQuota.class);
048  private static final HBaseTestingUtil TEST_UTIL = new HBaseTestingUtil();
049  private static final TableName TABLE_NAME = TableName.valueOf(UUID.randomUUID().toString());
050  private static final int REFRESH_TIME = 5000;
051  private static final byte[] FAMILY = Bytes.toBytes("cf");
052  private static final byte[] QUALIFIER = Bytes.toBytes("q");
053
054  @After
055  public void tearDown() throws Exception {
056    ThrottleQuotaTestUtil.clearQuotaCache(TEST_UTIL);
057    EnvironmentEdgeManager.reset();
058    TEST_UTIL.deleteTable(TABLE_NAME);
059    TEST_UTIL.shutdownMiniCluster();
060  }
061
062  @BeforeClass
063  public static void setUpBeforeClass() throws Exception {
064    // quotas enabled, using block bytes scanned
065    TEST_UTIL.getConfiguration().setBoolean(QuotaUtil.QUOTA_CONF_KEY, true);
066    TEST_UTIL.getConfiguration().setInt(QuotaCache.REFRESH_CONF_KEY, REFRESH_TIME);
067    TEST_UTIL.getConfiguration().setInt(QuotaUtil.QUOTA_DEFAULT_USER_MACHINE_READ_NUM, 1);
068
069    // don't cache blocks to make IO predictable
070    TEST_UTIL.getConfiguration().setFloat(HConstants.HFILE_BLOCK_CACHE_SIZE_KEY, 0.0f);
071
072    TEST_UTIL.startMiniCluster(1);
073    TEST_UTIL.waitTableAvailable(QuotaTableUtil.QUOTA_TABLE_NAME);
074    TEST_UTIL.createTable(TABLE_NAME, FAMILY);
075    TEST_UTIL.waitTableAvailable(TABLE_NAME);
076    QuotaCache.TEST_FORCE_REFRESH = true;
077
078    try (Admin admin = TEST_UTIL.getAdmin()) {
079      ThrottleQuotaTestUtil.doPuts(1_000, FAMILY, QUALIFIER,
080        admin.getConnection().getTable(TABLE_NAME));
081    }
082    TEST_UTIL.flush(TABLE_NAME);
083  }
084
085  @Test
086  public void testDefaultUserReadNum() throws Exception {
087    // Should have a strict throttle by default
088    TEST_UTIL.waitFor(60_000, () -> runGetsTest(100) < 100);
089
090    // Add big quota and should be effectively unlimited
091    configureLenientThrottle();
092    refreshQuotas();
093    // Should run without error
094    TEST_UTIL.waitFor(60_000, () -> runGetsTest(100) == 100);
095
096    // Remove all the limits, and should revert to strict default
097    unsetQuota();
098    TEST_UTIL.waitFor(60_000, () -> runGetsTest(100) < 100);
099  }
100
101  private void configureLenientThrottle() throws IOException {
102    try (Admin admin = TEST_UTIL.getAdmin()) {
103      admin.setQuota(QuotaSettingsFactory.throttleUser(getUserName(), ThrottleType.READ_NUMBER,
104        100_000, TimeUnit.SECONDS));
105    }
106  }
107
108  private static String getUserName() throws IOException {
109    return User.getCurrent().getShortName();
110  }
111
112  private void refreshQuotas() throws Exception {
113    triggerUserCacheRefresh(TEST_UTIL, false, TABLE_NAME);
114    waitMinuteQuota();
115  }
116
117  private void unsetQuota() throws Exception {
118    try (Admin admin = TEST_UTIL.getAdmin()) {
119      admin.setQuota(QuotaSettingsFactory.unthrottleUser(getUserName()));
120    }
121    refreshQuotas();
122  }
123
124  private long runGetsTest(int attempts) throws Exception {
125    refreshQuotas();
126    try (Table table = getTable()) {
127      return ThrottleQuotaTestUtil.doGets(attempts, FAMILY, QUALIFIER, table);
128    }
129  }
130
131  private Table getTable() throws IOException {
132    TEST_UTIL.getConfiguration().setInt("hbase.client.pause", 100);
133    TEST_UTIL.getConfiguration().setInt(HConstants.HBASE_CLIENT_RETRIES_NUMBER, 1);
134    return TEST_UTIL.getConnection().getTableBuilder(TABLE_NAME, null).setOperationTimeout(250)
135      .build();
136  }
137
138}