View Javadoc

1   /**
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *     http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   */
18  package org.apache.hadoop.hbase.master;
19  
20  
21  import static org.junit.Assert.assertEquals;
22  import static org.junit.Assert.assertFalse;
23  import static org.junit.Assert.assertTrue;
24  
25  import java.io.IOException;
26  import java.net.InetAddress;
27  import java.net.UnknownHostException;
28  import java.util.ArrayList;
29  import java.util.List;
30  
31  import org.apache.hadoop.conf.Configuration;
32  import org.apache.hadoop.hbase.Abortable;
33  import org.apache.hadoop.hbase.TableName;
34  import org.apache.hadoop.hbase.exceptions.DeserializationException;
35  import org.apache.hadoop.hbase.HBaseTestingUtility;
36  import org.apache.hadoop.hbase.HConstants;
37  import org.apache.hadoop.hbase.HRegionInfo;
38  import org.apache.hadoop.hbase.ServerLoad;
39  import org.apache.hadoop.hbase.Server;
40  import org.apache.hadoop.hbase.ServerName;
41  import org.apache.hadoop.hbase.ZooKeeperConnectionException;
42  import org.apache.hadoop.hbase.catalog.CatalogTracker;
43  import org.apache.hadoop.hbase.catalog.MetaMockingUtil;
44  import org.apache.hadoop.hbase.client.HConnection;
45  import org.apache.hadoop.hbase.client.HConnectionTestingUtility;
46  import org.apache.hadoop.hbase.client.Result;
47  import org.apache.hadoop.hbase.monitoring.MonitoredTask;
48  import org.apache.hadoop.hbase.regionserver.RegionOpeningState;
49  import org.apache.hadoop.hbase.util.FSUtils;
50  import org.apache.hadoop.hbase.util.Threads;
51  import org.apache.hadoop.hbase.zookeeper.MetaRegionTracker;
52  import org.apache.hadoop.hbase.zookeeper.ZKUtil;
53  import org.apache.hadoop.hbase.zookeeper.ZooKeeperWatcher;
54  import org.apache.hadoop.hbase.MediumTests;
55  import org.apache.zookeeper.KeeperException;
56  import org.apache.hadoop.hbase.protobuf.ProtobufUtil;
57  import org.apache.hadoop.hbase.protobuf.generated.HBaseProtos.NameStringPair;
58  import org.apache.hadoop.hbase.protobuf.generated.RegionServerStatusProtos.RegionServerReportRequest;
59  import org.apache.hadoop.hbase.protobuf.generated.RegionServerStatusProtos.RegionServerStartupRequest;
60  import org.apache.hadoop.hbase.protobuf.generated.RegionServerStatusProtos.RegionServerStartupResponse;
61  import com.google.protobuf.ServiceException;
62  import org.junit.After;
63  import org.junit.AfterClass;
64  import org.junit.BeforeClass;
65  import org.junit.Test;
66  import org.mockito.Mockito;
67  import org.junit.experimental.categories.Category;
68  import org.apache.commons.logging.Log;
69  import org.apache.commons.logging.LogFactory;
70  
71  /**
72   * Standup the master and fake it to test various aspects of master function.
73   * Does NOT spin up a mini hbase nor mini dfs cluster testing master (it does
74   * put up a zk cluster but this is usually pretty fast compared).  Also, should
75   * be possible to inject faults at points difficult to get at in cluster context.
76   * TODO: Speed up the zk connection by Master.  It pauses 5 seconds establishing
77   * session.
78   */
79  @Category(MediumTests.class)
80  public class TestMasterNoCluster {
81    private static final Log LOG = LogFactory.getLog(TestMasterNoCluster.class);
82    private static final HBaseTestingUtility TESTUTIL = new HBaseTestingUtility();
83  
84    @BeforeClass
85    public static void setUpBeforeClass() throws Exception {
86      Configuration c = TESTUTIL.getConfiguration();
87      // We use local filesystem.  Set it so it writes into the testdir.
88      FSUtils.setRootDir(c, TESTUTIL.getDataTestDir());
89      // Startup a mini zk cluster.
90      TESTUTIL.startMiniZKCluster();
91    }
92  
93    @AfterClass
94    public static void tearDownAfterClass() throws Exception {
95      TESTUTIL.shutdownMiniZKCluster();
96    }
97  
98    @After
99    public void tearDown()
100   throws KeeperException, ZooKeeperConnectionException, IOException {
101     // Make sure zk is clean before we run the next test.
102     ZooKeeperWatcher zkw = new ZooKeeperWatcher(TESTUTIL.getConfiguration(),
103         "@Before", new Abortable() {
104       @Override
105       public void abort(String why, Throwable e) {
106         throw new RuntimeException(why, e);
107       }
108 
109       @Override
110       public boolean isAborted() {
111         return false;
112       }
113     });
114     ZKUtil.deleteNodeRecursively(zkw, zkw.baseZNode);
115     zkw.close();
116   }
117 
118   /**
119    * Test starting master then stopping it before its fully up.
120    * @throws IOException
121    * @throws KeeperException
122    * @throws InterruptedException
123    */
124   @Test (timeout=30000)
125   public void testStopDuringStart()
126   throws IOException, KeeperException, InterruptedException {
127     HMaster master = new HMaster(TESTUTIL.getConfiguration());
128     master.start();
129     // Immediately have it stop.  We used hang in assigning meta.
130     master.stopMaster();
131     master.join();
132   }
133 
134   /**
135    * Test master failover.
136    * Start up three fake regionservers and a master.
137    * @throws IOException
138    * @throws KeeperException
139    * @throws InterruptedException
140    */
141   @Test (timeout=30000)
142   public void testFailover()
143   throws IOException, KeeperException, InterruptedException, ServiceException {
144     final long now = System.currentTimeMillis();
145     // Names for our three servers.  Make the port numbers match hostname.
146     // Will come in use down in the server when we need to figure how to respond.
147     final ServerName sn0 = new ServerName("0.example.org", 0, now);
148     final ServerName sn1 = new ServerName("1.example.org", 1, now);
149     final ServerName sn2 = new ServerName("2.example.org", 2, now);
150     final ServerName [] sns = new ServerName [] {sn0, sn1, sn2};
151     // Put up the mock servers
152     final Configuration conf = TESTUTIL.getConfiguration();
153     final MockRegionServer rs0 = new MockRegionServer(conf, sn0);
154     final MockRegionServer rs1 = new MockRegionServer(conf, sn1);
155     final MockRegionServer rs2 = new MockRegionServer(conf, sn2);
156     // Put some data into the servers.  Make it look like sn0 has the metaH
157     // Put data into sn2 so it looks like it has a few regions for a table named 't'.
158     MetaRegionTracker.setMetaLocation(rs0.getZooKeeper(), rs0.getServerName());
159     final TableName tableName = TableName.valueOf("t");
160     Result [] results = new Result [] {
161       MetaMockingUtil.getMetaTableRowResult(
162         new HRegionInfo(tableName, HConstants.EMPTY_START_ROW, HBaseTestingUtility.KEYS[1]),
163         rs2.getServerName()),
164       MetaMockingUtil.getMetaTableRowResult(
165         new HRegionInfo(tableName, HBaseTestingUtility.KEYS[1], HBaseTestingUtility.KEYS[2]),
166         rs2.getServerName()),
167       MetaMockingUtil.getMetaTableRowResult(new HRegionInfo(tableName, HBaseTestingUtility.KEYS[2],
168           HConstants.EMPTY_END_ROW),
169         rs2.getServerName())
170     };
171     rs1.setNextResults(HRegionInfo.FIRST_META_REGIONINFO.getRegionName(), results);
172 
173     // Create master.  Subclass to override a few methods so we can insert mocks
174     // and get notification on transitions.  We need to fake out any rpcs the
175     // master does opening/closing regions.  Also need to fake out the address
176     // of the 'remote' mocked up regionservers.
177     HMaster master = new HMaster(conf) {
178       InetAddress getRemoteInetAddress(final int port, final long serverStartCode)
179       throws UnknownHostException {
180         // Return different address dependent on port passed.
181         ServerName sn = sns[port];
182         return InetAddress.getByAddress(sn.getHostname(),
183           new byte [] {10, 0, 0, (byte)sn.getPort()});
184       }
185 
186       @Override
187       ServerManager createServerManager(Server master, MasterServices services)
188       throws IOException {
189         ServerManager sm = super.createServerManager(master, services);
190         // Spy on the created servermanager
191         ServerManager spy = Mockito.spy(sm);
192         // Fake a successful open.
193         Mockito.doReturn(RegionOpeningState.OPENED).when(spy).
194           sendRegionOpen((ServerName)Mockito.any(), (HRegionInfo)Mockito.any(),
195             Mockito.anyInt(), Mockito.anyListOf(ServerName.class));
196         return spy;
197       }
198 
199       @Override
200       CatalogTracker createCatalogTracker(ZooKeeperWatcher zk,
201           Configuration conf, Abortable abortable)
202       throws IOException {
203         // Insert a mock for the connection used by the CatalogTracker.  Any
204         // regionserver should do.  Use TESTUTIL.getConfiguration rather than
205         // the conf from the master; the conf will already have an HConnection
206         // associate so the below mocking of a connection will fail.
207         HConnection connection =
208           HConnectionTestingUtility.getMockedConnectionAndDecorate(TESTUTIL.getConfiguration(),
209             rs0, rs0, rs0.getServerName(), HRegionInfo.ROOT_REGIONINFO);
210         return new CatalogTracker(zk, conf, connection, abortable);
211       }
212 
213       @Override
214       void assignSystemTables(MonitoredTask status)
215           throws IOException, InterruptedException, KeeperException {
216       }
217     };
218     master.start();
219 
220     try {
221       // Wait till master is up ready for RPCs.
222       while (!master.isRpcServerOpen()) Threads.sleep(10);
223       // Fake master that there are regionservers out there.  Report in.
224       for (int i = 0; i < sns.length; i++) {
225         RegionServerReportRequest.Builder request = RegionServerReportRequest.newBuilder();;
226         ServerName sn = ServerName.parseVersionedServerName(sns[i].getVersionedBytes());
227         request.setServer(ProtobufUtil.toServerName(sn));
228         request.setLoad(ServerLoad.EMPTY_SERVERLOAD.obtainServerLoadPB());
229         master.regionServerReport(null, request.build());
230       }
231       // Master should now come up.
232       while (!master.isInitialized()) {Threads.sleep(10);}
233       assertTrue(master.isInitialized());
234     } finally {
235       rs0.stop("Test is done");
236       rs1.stop("Test is done");
237       rs2.stop("Test is done");
238       master.stopMaster();
239       master.join();
240     }
241   }
242 
243   /**
244    * Test starting master getting it up post initialized state using mocks.
245    * @throws IOException
246    * @throws KeeperException
247    * @throws InterruptedException
248    * @throws DeserializationException
249    * @throws ServiceException
250    */
251   @Test (timeout=60000)
252   public void testCatalogDeploys()
253       throws Exception {
254     final Configuration conf = TESTUTIL.getConfiguration();
255     conf.setInt(ServerManager.WAIT_ON_REGIONSERVERS_MINTOSTART, 1);
256     conf.setInt(ServerManager.WAIT_ON_REGIONSERVERS_MAXTOSTART, 1);
257 
258     final long now = System.currentTimeMillis();
259     // Name for our single mocked up regionserver.
260     final ServerName sn = new ServerName("0.example.org", 0, now);
261     // Here is our mocked up regionserver.  Create it now.  Need it setting up
262     // master next.
263     final MockRegionServer rs0 = new MockRegionServer(conf, sn);
264 
265     // Create master.  Subclass to override a few methods so we can insert mocks
266     // and get notification on transitions.  We need to fake out any rpcs the
267     // master does opening/closing regions.  Also need to fake out the address
268     // of the 'remote' mocked up regionservers.
269     HMaster master = new HMaster(conf) {
270       InetAddress getRemoteInetAddress(final int port, final long serverStartCode)
271       throws UnknownHostException {
272         // Interject an unchecked, nonsense InetAddress; i.e. no resolve.
273         return InetAddress.getByAddress(rs0.getServerName().getHostname(),
274           new byte [] {10, 0, 0, 0});
275       }
276 
277       @Override
278       ServerManager createServerManager(Server master, MasterServices services)
279       throws IOException {
280         ServerManager sm = super.createServerManager(master, services);
281         // Spy on the created servermanager
282         ServerManager spy = Mockito.spy(sm);
283         // Fake a successful open.
284         Mockito.doReturn(RegionOpeningState.OPENED).when(spy).
285           sendRegionOpen((ServerName)Mockito.any(), (HRegionInfo)Mockito.any(),
286             Mockito.anyInt(), Mockito.anyListOf(ServerName.class));
287         return spy;
288       }
289 
290       @Override
291       CatalogTracker createCatalogTracker(ZooKeeperWatcher zk,
292           Configuration conf, Abortable abortable)
293       throws IOException {
294         // Insert a mock for the connection used by the CatalogTracker.   Use
295         // TESTUTIL.getConfiguration rather than the conf from the master; the
296         // conf will already have an HConnection associate so the below mocking
297         // of a connection will fail.
298         HConnection connection =
299           HConnectionTestingUtility.getMockedConnectionAndDecorate(TESTUTIL.getConfiguration(),
300             rs0, rs0, rs0.getServerName(), HRegionInfo.FIRST_META_REGIONINFO);
301         return new CatalogTracker(zk, conf, connection, abortable);
302       }
303 
304       @Override
305       void assignSystemTables(MonitoredTask status)
306           throws IOException, InterruptedException, KeeperException {
307       }
308     };
309     master.start();
310     LOG.info("Master has started");
311 
312     try {
313       // Wait till master is up ready for RPCs.
314       while (!master.isRpcServerOpen()) Threads.sleep(10);
315       LOG.info("RpcServerOpen has started");
316 
317       // Fake master that there is a regionserver out there.  Report in.
318       RegionServerStartupRequest.Builder request = RegionServerStartupRequest.newBuilder();
319       request.setPort(rs0.getServerName().getPort());
320       request.setServerStartCode(rs0.getServerName().getStartcode());
321       request.setServerCurrentTime(now);
322       RegionServerStartupResponse result =
323         master.regionServerStartup(null, request.build());
324       String rshostname = new String();
325       for (NameStringPair e : result.getMapEntriesList()) {
326         if (e.getName().toString().equals(HConstants.KEY_FOR_HOSTNAME_SEEN_BY_MASTER)) {
327           rshostname = e.getValue();
328         }
329       }
330       // Assert hostname is as expected.
331       assertEquals(rs0.getServerName().getHostname(), rshostname);
332       // Now master knows there is at least one regionserver checked in and so
333       // it'll wait a while to see if more and when none, will assign meta
334       // to this single server.  Will do an rpc open but we've
335       // mocked it above in our master override to return 'success'.  As part of
336       // region open, master will have set an unassigned znode for the region up
337       // into zk for the regionserver to transition.  Lets do that now to
338       // complete fake of a successful open.
339       Mocking.fakeRegionServerRegionOpenInZK(master, rs0.getZooKeeper(),
340         rs0.getServerName(), HRegionInfo.FIRST_META_REGIONINFO);
341       LOG.info("fakeRegionServerRegionOpenInZK has started");
342 
343       // Need to set meta location as r0.  Usually the regionserver does this
344       // when its figured it just opened the meta region by setting the meta
345       // location up into zk.  Since we're mocking regionserver, need to do this
346       // ourselves.
347       MetaRegionTracker.setMetaLocation(rs0.getZooKeeper(), rs0.getServerName());
348       // Master should now come up.
349       while (!master.isInitialized()) {Threads.sleep(10);}
350       assertTrue(master.isInitialized());
351     } finally {
352       rs0.stop("Test is done");
353       master.stopMaster();
354       master.join();
355     }
356   }
357 
358   @Test
359   public void testNotPullingDeadRegionServerFromZK()
360       throws IOException, KeeperException, InterruptedException {
361     final Configuration conf = TESTUTIL.getConfiguration();
362     final ServerName newServer = new ServerName("test.sample", 1, 101);
363     final ServerName deadServer = new ServerName("test.sample", 1, 100);
364     final MockRegionServer rs0 = new MockRegionServer(conf, newServer);
365 
366     HMaster master = new HMaster(conf) {
367       @Override
368       void assignMeta(MonitoredTask status) {
369         return;
370       }
371 
372       @Override
373       void initializeZKBasedSystemTrackers() throws IOException,
374       InterruptedException, KeeperException {
375         super.initializeZKBasedSystemTrackers();
376         // Record a newer server in server manager at first
377         serverManager.recordNewServer(newServer, ServerLoad.EMPTY_SERVERLOAD);
378 
379         List<ServerName> onlineServers = new ArrayList<ServerName>();
380         onlineServers.add(deadServer);
381         onlineServers.add(newServer);
382         // Mock the region server tracker to pull the dead server from zk
383         regionServerTracker = Mockito.spy(regionServerTracker);
384         Mockito.doReturn(onlineServers).when(
385           regionServerTracker).getOnlineServers();
386       }
387 
388       @Override
389       CatalogTracker createCatalogTracker(ZooKeeperWatcher zk,
390           Configuration conf, Abortable abortable)
391       throws IOException {
392         // Insert a mock for the connection used by the CatalogTracker.  Any
393         // regionserver should do.  Use TESTUTIL.getConfiguration rather than
394         // the conf from the master; the conf will already have an HConnection
395         // associate so the below mocking of a connection will fail.
396         HConnection connection =
397           HConnectionTestingUtility.getMockedConnectionAndDecorate(TESTUTIL.getConfiguration(),
398             rs0, rs0, rs0.getServerName(), HRegionInfo.ROOT_REGIONINFO);
399         return new CatalogTracker(zk, conf, connection, abortable);
400       }
401 
402       @Override
403       void assignSystemTables(MonitoredTask status)
404           throws IOException, InterruptedException, KeeperException {
405       }
406     };
407     master.start();
408 
409     try {
410       // Wait till master is initialized.
411       while (!master.initialized) Threads.sleep(10);
412       LOG.info("Master is initialized");
413 
414       assertFalse("The dead server should not be pulled in",
415         master.serverManager.isServerOnline(deadServer));
416     } finally {
417       master.stopMaster();
418       master.join();
419     }
420   }
421 }