Index: hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java (revision 9f362ac918cac99dc365edd897e1c6e130a8dd4d) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java (revision ) @@ -75,6 +75,8 @@ import org.apache.hadoop.hbase.client.ConnectionUtils; import org.apache.hadoop.hbase.client.HConnection; import org.apache.hadoop.hbase.client.HConnectionManager; +import org.apache.hadoop.hbase.consensus.ConsensusProviderFactory; +import org.apache.hadoop.hbase.consensus.ConsensusProvider; import org.apache.hadoop.hbase.coprocessor.CoprocessorHost; import org.apache.hadoop.hbase.exceptions.RegionMovedException; import org.apache.hadoop.hbase.exceptions.RegionOpeningException; @@ -105,6 +107,7 @@ import org.apache.hadoop.hbase.protobuf.generated.RegionServerStatusProtos.RegionServerStatusService; import org.apache.hadoop.hbase.protobuf.generated.RegionServerStatusProtos.ReportRSFatalErrorRequest; import org.apache.hadoop.hbase.regionserver.compactions.CompactionProgress; +import org.apache.hadoop.hbase.regionserver.consensus.CloseRegionConsensus; import org.apache.hadoop.hbase.regionserver.handler.CloseMetaHandler; import org.apache.hadoop.hbase.regionserver.handler.CloseRegionHandler; import org.apache.hadoop.hbase.regionserver.wal.HLog; @@ -390,6 +393,8 @@ protected final RSRpcServices rpcServices; + protected ConsensusProvider consensus; + /** * Starts a HRegionServer at the default location * @@ -480,6 +485,9 @@ catalogTracker = createCatalogTracker(); catalogTracker.start(); + + consensus = ConsensusProviderFactory.getConsensusProvider(conf); + consensus.start(this); } rpcServices.start(); @@ -2117,6 +2125,10 @@ return zooKeeper; } + public ConsensusProvider getConsensus() { + return consensus; + } + @Override public ServerName getServerName() { return serverName; @@ -2276,7 +2288,9 @@ */ private void closeRegionIgnoreErrors(HRegionInfo region, final boolean abort) { try { - if (!closeRegion(region.getEncodedName(), abort, false, -1, null)) { + CloseRegionConsensus.CloseRegionDetails details = + consensus.getCloseRegionConsensus().getDetailsForNonCoordinatedClosing(); + if (!closeRegion(region.getEncodedName(), abort, details, null)) { LOG.warn("Failed to close " + region.getRegionNameAsString() + " - ignoring and continuing"); } @@ -2301,17 +2315,13 @@ * * @param encodedName Region to close * @param abort True if we are aborting - * @param zk True if we are to update zk about the region close; if the close - * was orchestrated by master, then update zk. If the close is being run by - * the regionserver because its going down, don't update zk. - * @param versionOfClosingNode the version of znode to compare when RS transitions the znode from - * CLOSING state. + * @param crd details about closing region consensus-coordinated task * @return True if closed a region. * @throws NotServingRegionException if the region is not online * @throws RegionAlreadyInTransitionException if the region is already closing */ protected boolean closeRegion(String encodedName, final boolean abort, - final boolean zk, final int versionOfClosingNode, final ServerName sn) + CloseRegionConsensus.CloseRegionDetails crd, final ServerName sn) throws NotServingRegionException, RegionAlreadyInTransitionException { //Check for permissions to close. HRegion actualRegion = this.getFromOnlineRegions(encodedName); @@ -2335,7 +2345,7 @@ // We're going to try to do a standard close then. LOG.warn("The opening for region " + encodedName + " was done before we could cancel it." + " Doing a standard close now"); - return closeRegion(encodedName, abort, zk, versionOfClosingNode, sn); + return closeRegion(encodedName, abort, crd, sn); } // Let's get the region from the online region list again actualRegion = this.getFromOnlineRegions(encodedName); @@ -2369,9 +2379,11 @@ CloseRegionHandler crh; final HRegionInfo hri = actualRegion.getRegionInfo(); if (hri.isMetaRegion()) { - crh = new CloseMetaHandler(this, this, hri, abort, zk, versionOfClosingNode); + crh = new CloseMetaHandler(this, this, hri, abort, + consensus.getCloseRegionConsensus(), crd); } else { - crh = new CloseRegionHandler(this, this, hri, abort, zk, versionOfClosingNode, sn); + crh = new CloseRegionHandler(this, this, hri, abort, + consensus.getCloseRegionConsensus(), crd, sn); } this.service.submit(crh); return true; Index: hbase-common/src/main/java/org/apache/hadoop/hbase/HConstants.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-common/src/main/java/org/apache/hadoop/hbase/HConstants.java (revision 9f362ac918cac99dc365edd897e1c6e130a8dd4d) +++ hbase-common/src/main/java/org/apache/hadoop/hbase/HConstants.java (revision ) @@ -974,4 +974,7 @@ private HConstants() { // Can't be instantiated with this ctor. } + + /** Config for pluggable consensus providers */ + public static final String HBASE_CONSENSUS_PROVIDER_CLASS = "hbase.consensus.provider.class"; } Index: hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/consensus/CloseRegionConsensus.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/consensus/CloseRegionConsensus.java (revision ) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/consensus/CloseRegionConsensus.java (revision ) @@ -0,0 +1,76 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.hadoop.hbase.regionserver.consensus; + +import org.apache.hadoop.classification.InterfaceAudience; +import org.apache.hadoop.hbase.HRegionInfo; +import org.apache.hadoop.hbase.ServerName; +import org.apache.hadoop.hbase.protobuf.generated.AdminProtos; +import org.apache.hadoop.hbase.regionserver.HRegion; + +/** + * Consensus operations for close region handlers. + */ +@InterfaceAudience.Private +public interface CloseRegionConsensus { + + /** + * Called before actual region closing to check that we can do close operation + * on this region. + * @param regionInfo region being closed + * @param crd details about closing operation + * @return true if caller shall proceed and close, false if need to abort closing. + */ + boolean checkClosingState(HRegionInfo regionInfo, CloseRegionDetails crd); + + /** + * Called after region is closed to notify all interesting parties / "register" + * region as finally closed. + * @param region region being closed + * @param crd details about closing operation + */ + void setClosedState(HRegion region, CloseRegionDetails crd); + + /** + * Construct CloseRegionDetails instance from CloseRegionRequest. + * @return instance of CloseRegionDetails + */ + CloseRegionDetails parseFromProtoRequest(AdminProtos.CloseRegionRequest request); + + /** + * Get details object with params for case when we're closing on + * regionserver side internally (not because of RPC call from master). + */ + CloseRegionDetails getDetailsForNonCoordinatedClosing(); + + /** + * Interface for region closing tasks. Used to carry implementation details in + * encapsulated way through Handlers to the consensus API. + */ + static interface CloseRegionDetails { + /** + * Sets server name on which closing operation is running. + */ + void setServerName(ServerName serverName); + + /** + * @return server name on which closing op is running. + */ + ServerName getServerName(); + } +} Index: hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RSRpcServices.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RSRpcServices.java (revision 9f362ac918cac99dc365edd897e1c6e130a8dd4d) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RSRpcServices.java (revision ) @@ -139,6 +139,7 @@ import org.apache.hadoop.hbase.protobuf.generated.RPCProtos.RequestHeader; import org.apache.hadoop.hbase.regionserver.HRegion.Operation; import org.apache.hadoop.hbase.regionserver.Leases.LeaseStillHeldException; +import org.apache.hadoop.hbase.regionserver.consensus.CloseRegionConsensus; import org.apache.hadoop.hbase.regionserver.handler.OpenMetaHandler; import org.apache.hadoop.hbase.regionserver.handler.OpenRegionHandler; import org.apache.hadoop.hbase.regionserver.wal.HLog; @@ -859,11 +860,6 @@ @QosPriority(priority=HConstants.HIGH_QOS) public CloseRegionResponse closeRegion(final RpcController controller, final CloseRegionRequest request) throws ServiceException { - int versionOfClosingNode = -1; - if (request.hasVersionOfClosingNode()) { - versionOfClosingNode = request.getVersionOfClosingNode(); - } - boolean zk = request.getTransitionInZK(); final ServerName sn = (request.hasDestinationServer() ? ProtobufUtil.toServerName(request.getDestinationServer()) : null); @@ -887,10 +883,11 @@ } requestCount.increment(); - LOG.info("Close " + encodedRegionName + ", via zk=" + (zk ? "yes" : "no") - + ", znode version=" + versionOfClosingNode + ", on " + sn); + LOG.info("Close " + encodedRegionName + ", on " + sn); + CloseRegionConsensus.CloseRegionDetails crd = + regionServer.getConsensus().getCloseRegionConsensus().parseFromProtoRequest(request); - boolean closed = regionServer.closeRegion(encodedRegionName, false, zk, versionOfClosingNode, sn); + boolean closed = regionServer.closeRegion(encodedRegionName, false, crd, sn); CloseRegionResponse.Builder builder = CloseRegionResponse.newBuilder().setClosed(closed); return builder.build(); } catch (IOException ie) { Index: hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ConsensusProviderFactory.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ConsensusProviderFactory.java (revision ) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ConsensusProviderFactory.java (revision ) @@ -0,0 +1,43 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.hadoop.hbase.consensus; + +import org.apache.hadoop.classification.InterfaceAudience; +import org.apache.hadoop.conf.Configuration; +import org.apache.hadoop.hbase.HConstants; +import org.apache.hadoop.util.ReflectionUtils; + +/** + * Creates instance of {@link org.apache.hadoop.hbase.consensus.ConsensusProvider} + * based on conf. + */ +@InterfaceAudience.Private +public class ConsensusProviderFactory { + + /** + * Creates consensus provider from the given conf. + * @param conf Configuration + * @return A {@link org.apache.hadoop.hbase.consensus.ConsensusProvider} + */ + public static ConsensusProvider getConsensusProvider(Configuration conf) { + Class consensusKlass = + conf.getClass(HConstants.HBASE_CONSENSUS_PROVIDER_CLASS, ZkConsensusProvider.class, + ConsensusProvider.class); + return ReflectionUtils.newInstance(consensusKlass, conf); + } +} Index: hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/CloseRegionHandler.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/CloseRegionHandler.java (revision 9f362ac918cac99dc365edd897e1c6e130a8dd4d) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/CloseRegionHandler.java (revision ) @@ -18,8 +18,6 @@ */ package org.apache.hadoop.hbase.regionserver.handler; -import java.io.IOException; - import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.apache.hadoop.classification.InterfaceAudience; @@ -30,9 +28,11 @@ import org.apache.hadoop.hbase.executor.EventType; import org.apache.hadoop.hbase.regionserver.HRegion; import org.apache.hadoop.hbase.regionserver.RegionServerServices; -import org.apache.hadoop.hbase.zookeeper.ZKAssign; +import org.apache.hadoop.hbase.regionserver.consensus.CloseRegionConsensus; import org.apache.zookeeper.KeeperException; +import java.io.IOException; + /** * Handles closing of a region on a region server. */ @@ -45,73 +45,64 @@ // have a running queue of user regions to close? private static final Log LOG = LogFactory.getLog(CloseRegionHandler.class); - private final int FAILED = -1; - int expectedVersion = FAILED; - private final RegionServerServices rsServices; - private final HRegionInfo regionInfo; // If true, the hosting server is aborting. Region close process is different // when we are aborting. private final boolean abort; - - // Update zk on closing transitions. Usually true. Its false if cluster - // is going down. In this case, its the rs that initiates the region - // close -- not the master process so state up in zk will unlikely be - // CLOSING. - private final boolean zk; private ServerName destination; + private CloseRegionConsensus closeRegionConsensus; + private CloseRegionConsensus.CloseRegionDetails closeRegionDetails; - // This is executed after receiving an CLOSE RPC from the master. - public CloseRegionHandler(final Server server, - final RegionServerServices rsServices, HRegionInfo regionInfo) { - this(server, rsServices, regionInfo, false, true, -1, EventType.M_RS_CLOSE_REGION, null); - } - /** * This method used internally by the RegionServer to close out regions. * @param server * @param rsServices * @param regionInfo * @param abort If the regionserver is aborting. - * @param zk If the close should be noted out in zookeeper. + * @param closeRegionConsensus consensus for closing regions + * @param crd object carrying details about region close task. */ public CloseRegionHandler(final Server server, final RegionServerServices rsServices, - final HRegionInfo regionInfo, final boolean abort, final boolean zk, - final int versionOfClosingNode) { - this(server, rsServices, regionInfo, abort, zk, versionOfClosingNode, + final HRegionInfo regionInfo, final boolean abort, + CloseRegionConsensus closeRegionConsensus, + CloseRegionConsensus.CloseRegionDetails crd) { + this(server, rsServices, regionInfo, abort, closeRegionConsensus, crd, EventType.M_RS_CLOSE_REGION, null); } public CloseRegionHandler(final Server server, final RegionServerServices rsServices, - final HRegionInfo regionInfo, final boolean abort, final boolean zk, - final int versionOfClosingNode, ServerName destination) { - this(server, rsServices, regionInfo, abort, zk, versionOfClosingNode, + final HRegionInfo regionInfo, final boolean abort, + CloseRegionConsensus closeRegionConsensus, + CloseRegionConsensus.CloseRegionDetails crd, + ServerName destination) { + this(server, rsServices, regionInfo, abort, closeRegionConsensus, crd, EventType.M_RS_CLOSE_REGION, destination); } public CloseRegionHandler(final Server server, final RegionServerServices rsServices, HRegionInfo regionInfo, - boolean abort, final boolean zk, final int versionOfClosingNode, - EventType eventType) { - this(server, rsServices, regionInfo, abort, zk, versionOfClosingNode, eventType, null); + boolean abort, CloseRegionConsensus closeRegionConsensus, + CloseRegionConsensus.CloseRegionDetails crd, EventType eventType) { + this(server, rsServices, regionInfo, abort, closeRegionConsensus, crd, eventType, null); } protected CloseRegionHandler(final Server server, final RegionServerServices rsServices, HRegionInfo regionInfo, - boolean abort, final boolean zk, final int versionOfClosingNode, + boolean abort, CloseRegionConsensus closeRegionConsensus, + CloseRegionConsensus.CloseRegionDetails crd, EventType eventType, ServerName destination) { super(server, eventType); this.server = server; this.rsServices = rsServices; this.regionInfo = regionInfo; this.abort = abort; - this.zk = zk; - this.expectedVersion = versionOfClosingNode; this.destination = destination; + this.closeRegionConsensus = closeRegionConsensus; + this.closeRegionDetails = crd; } public HRegionInfo getRegionInfo() { @@ -128,18 +119,14 @@ HRegion region = this.rsServices.getFromOnlineRegions(encodedRegionName); if (region == null) { LOG.warn("Received CLOSE for region " + name + " but currently not serving - ignoring"); - if (zk){ - LOG.error("The znode is not modified as we are not serving " + name); - } // TODO: do better than a simple warning return; } // Close the region try { - if (zk && !ZKAssign.checkClosingState(server.getZooKeeper(), regionInfo, expectedVersion)){ - // bad znode state - return; // We're node deleting the znode, but it's not ours... + if (closeRegionConsensus.checkClosingState(regionInfo, closeRegionDetails)) { + return; } // TODO: If we need to keep updating CLOSING stamp to prevent against @@ -152,10 +139,6 @@ regionInfo.getRegionNameAsString()); return; } - } catch (KeeperException ke) { - server.abort("Unrecoverable exception while checking state with zk " + - regionInfo.getRegionNameAsString() + ", still finishing close", ke); - throw new RuntimeException(ke); } catch (IOException ioe) { // An IOException here indicates that we couldn't successfully flush the // memstore before closing. So, we need to abort the server and allow @@ -166,50 +149,13 @@ } this.rsServices.removeFromOnlineRegions(region, destination); + closeRegionConsensus.setClosedState(region, closeRegionDetails); - if (this.zk) { - if (setClosedState(this.expectedVersion, region)) { - LOG.debug("Set closed state in zk for " + name + " on " + this.server.getServerName()); - } else { - LOG.debug("Set closed state in zk UNSUCCESSFUL for " + name + " on " + - this.server.getServerName()); - } - } - // Done! Region is closed on this RS LOG.debug("Closed " + region.getRegionNameAsString()); } finally { this.rsServices.getRegionsInTransitionInRS(). remove(this.regionInfo.getEncodedNameAsBytes()); } - } - - /** - * Transition ZK node to CLOSED - * @param expectedVersion - * @return If the state is set successfully - */ - private boolean setClosedState(final int expectedVersion, final HRegion region) { - try { - if (ZKAssign.transitionNodeClosed(server.getZooKeeper(), regionInfo, - server.getServerName(), expectedVersion) == FAILED) { - LOG.warn("Completed the CLOSE of a region but when transitioning from " + - " CLOSING to CLOSED got a version mismatch, someone else clashed " + - "so now unassigning"); - region.close(); - return false; - } - } catch (NullPointerException e) { - // I've seen NPE when table was deleted while close was running in unit tests. - LOG.warn("NPE during close -- catching and continuing...", e); - return false; - } catch (KeeperException e) { - LOG.error("Failed transitioning node from CLOSING to CLOSED", e); - return false; - } catch (IOException e) { - LOG.error("Failed to close region after failing to transition", e); - return false; - } - return true; } } Index: hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ConsensusProvider.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ConsensusProvider.java (revision ) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ConsensusProvider.java (revision ) @@ -0,0 +1,51 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.hadoop.hbase.consensus; + +import org.apache.hadoop.classification.InterfaceAudience; +import org.apache.hadoop.hbase.Server; +import org.apache.hadoop.hbase.regionserver.consensus.CloseRegionConsensus; + +/** + * Interface for consensus providers used by HBase + * for coordination. + * + * Property hbase.consensus.provider.class in hbase-site.xml controls + * which provider to use. + */ +@InterfaceAudience.Private +public interface ConsensusProvider { + + /** + * Starts consensus within specified server instance. + * @param server master or region server to run consensus within. + */ + void start(Server server); + + void stop(); + + /** + * @return instance of Server consensus runs within + */ + Server getServer(); + + /** + * @return instance of consensus operations for closing regions. + */ + CloseRegionConsensus getCloseRegionConsensus(); +} Index: hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/CloseMetaHandler.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/CloseMetaHandler.java (revision 9f362ac918cac99dc365edd897e1c6e130a8dd4d) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/handler/CloseMetaHandler.java (revision ) @@ -23,24 +23,21 @@ import org.apache.hadoop.hbase.Server; import org.apache.hadoop.hbase.executor.EventType; import org.apache.hadoop.hbase.regionserver.RegionServerServices; +import org.apache.hadoop.hbase.regionserver.consensus.CloseRegionConsensus; /** * Handles closing of the root region on a region server. */ @InterfaceAudience.Private public class CloseMetaHandler extends CloseRegionHandler { - // Called when master tells us shutdown a region via close rpc - public CloseMetaHandler(final Server server, - final RegionServerServices rsServices, final HRegionInfo regionInfo) { - this(server, rsServices, regionInfo, false, true, -1); - } // Called when regionserver determines its to go down; not master orchestrated public CloseMetaHandler(final Server server, final RegionServerServices rsServices, final HRegionInfo regionInfo, - final boolean abort, final boolean zk, final int versionOfClosingNode) { - super(server, rsServices, regionInfo, abort, zk, versionOfClosingNode, - EventType.M_RS_CLOSE_META); + final boolean abort, CloseRegionConsensus closeRegionConsensus, + CloseRegionConsensus.CloseRegionDetails crd) { + super(server, rsServices, regionInfo, abort, closeRegionConsensus, + crd, EventType.M_RS_CLOSE_META); } } Index: hbase-common/src/main/resources/hbase-default.xml IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-common/src/main/resources/hbase-default.xml (revision 9f362ac918cac99dc365edd897e1c6e130a8dd4d) +++ hbase-common/src/main/resources/hbase-default.xml (revision ) @@ -1160,4 +1160,9 @@ procedure. After implementing your own MasterProcedureManager, just put it in HBase's classpath and add the fully qualified class name here. + + hbase.consensus.provider.class + org.apache.hadoop.hbase.consensus.ZkConsensusProvider + Fully qualified name of class implementing consensus. + Index: hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ZkConsensusProvider.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ZkConsensusProvider.java (revision ) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/consensus/ZkConsensusProvider.java (revision ) @@ -0,0 +1,58 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.hadoop.hbase.consensus; + +import org.apache.hadoop.classification.InterfaceAudience; +import org.apache.hadoop.hbase.Server; +import org.apache.hadoop.hbase.regionserver.consensus.CloseRegionConsensus; +import org.apache.hadoop.hbase.regionserver.consensus.ZkCloseRegionConsensus; +import org.apache.hadoop.hbase.zookeeper.ZooKeeperWatcher; + +/** + * ZooKeeper-based implementation of {@link ConsensusProvider}. + */ +@InterfaceAudience.Private +public class ZkConsensusProvider implements ConsensusProvider { + private Server server; + private ZooKeeperWatcher watcher; + + CloseRegionConsensus closeRegionConsensus; + + @Override + public void start(Server server) { + this.server = server; + this.watcher = server.getZooKeeper(); + + closeRegionConsensus = new ZkCloseRegionConsensus(this, watcher); + } + + @Override + public void stop() { + + } + + @Override + public Server getServer() { + return server; + } + + @Override + public CloseRegionConsensus getCloseRegionConsensus() { + return closeRegionConsensus; + } +} Index: hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/consensus/ZkCloseRegionConsensus.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/consensus/ZkCloseRegionConsensus.java (revision ) +++ hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/consensus/ZkCloseRegionConsensus.java (revision ) @@ -0,0 +1,212 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.hadoop.hbase.regionserver.consensus; + +import org.apache.commons.logging.Log; +import org.apache.commons.logging.LogFactory; +import org.apache.hadoop.classification.InterfaceAudience; +import org.apache.hadoop.hbase.HRegionInfo; +import org.apache.hadoop.hbase.ServerName; +import org.apache.hadoop.hbase.consensus.ConsensusProvider; +import org.apache.hadoop.hbase.protobuf.generated.AdminProtos; +import org.apache.hadoop.hbase.regionserver.HRegion; +import org.apache.hadoop.hbase.zookeeper.ZKAssign; +import org.apache.hadoop.hbase.zookeeper.ZooKeeperWatcher; +import org.apache.zookeeper.KeeperException; + +import java.io.IOException; + +/** + * ZK-based implementation of {@link CloseRegionConsensus}. + */ +@InterfaceAudience.Private +public class ZkCloseRegionConsensus implements CloseRegionConsensus { + private static final Log LOG = LogFactory.getLog(ZkCloseRegionConsensus.class); + + private final static int FAILED_VERSION = -1; + + private ConsensusProvider consensus; + private final ZooKeeperWatcher watcher; + + public ZkCloseRegionConsensus(ConsensusProvider consensus, ZooKeeperWatcher watcher) { + this.consensus = consensus; + this.watcher = watcher; + } + + /** + * In ZK-based version we're checking for bad znode state, e.g. if we're + * trying to delete the znode, and it's not ours (version doesn't match). + */ + @Override + public boolean checkClosingState(HRegionInfo regionInfo, CloseRegionDetails crd) { + ZkCloseRegionDetails zkCrd = (ZkCloseRegionDetails) crd; + + try { + return zkCrd.isZk() && !ZKAssign.checkClosingState(watcher, + regionInfo, ((ZkCloseRegionDetails) crd).getExpectedVersion()); + } catch (KeeperException e) { + LOG.error(e.getMessage()); + } + return false; + } + + /** + * In ZK-based version we do some znodes transitioning. + */ + @Override + public void setClosedState(HRegion region, CloseRegionDetails crd) { + ZkCloseRegionDetails zkCrd = (ZkCloseRegionDetails) crd; + String name = region.getRegionInfo().getRegionNameAsString(); + ServerName serverName = zkCrd.getServerName(); + + if (zkCrd.isZk()) { + if (setClosedState(region, zkCrd)) { + LOG.debug("Set closed state in zk for " + name + " on " + serverName); + } else { + LOG.debug("Set closed state in zk UNSUCCESSFUL for " + name + " on " + + serverName); + } + } + } + + /** + * Parse ZK-related fields from request. + */ + @Override + public CloseRegionDetails parseFromProtoRequest(AdminProtos.CloseRegionRequest request) { + ZkCloseRegionConsensus.ZkCloseRegionDetails zkCrd = + new ZkCloseRegionConsensus.ZkCloseRegionDetails(); + zkCrd.setZk(request.getTransitionInZK()); + int versionOfClosingNode = -1; + if (request.hasVersionOfClosingNode()) { + versionOfClosingNode = request.getVersionOfClosingNode(); + } + zkCrd.setExpectedVersion(versionOfClosingNode); + zkCrd.setServerName(consensus.getServer().getServerName()); + + return zkCrd; + } + + /** + * No ZK tracking will be performed for that case. + * This method should be used when we want to construct CloseRegionDetails, + * but don't want any coordination on that (when it's initiated by regionserver), + * so no znode state transitions will be performed. + */ + @Override + public CloseRegionDetails getDetailsForNonCoordinatedClosing() { + ZkCloseRegionConsensus.ZkCloseRegionDetails zkCrd = + new ZkCloseRegionConsensus.ZkCloseRegionDetails(); + zkCrd.setZk(false); + zkCrd.setExpectedVersion(FAILED_VERSION); + zkCrd.setServerName(consensus.getServer().getServerName()); + + return zkCrd; + } + + /** + * Transition ZK node to CLOSED + * @param region HRegion instance being closed + * @param zkCrd details about region closing operation. + * @return If the state is set successfully + */ + private boolean setClosedState(final HRegion region, ZkCloseRegionDetails zkCrd) { + final int expectedVersion = zkCrd.getExpectedVersion(); + + try { + if (ZKAssign.transitionNodeClosed(watcher, region.getRegionInfo(), + zkCrd.getServerName(), expectedVersion) == FAILED_VERSION) { + LOG.warn("Completed the CLOSE of a region but when transitioning from " + + " CLOSING to CLOSED got a version mismatch, someone else clashed " + + "so now unassigning"); + region.close(); + return false; + } + } catch (NullPointerException e) { + // I've seen NPE when table was deleted while close was running in unit tests. + LOG.warn("NPE during close -- catching and continuing...", e); + return false; + } catch (KeeperException e) { + LOG.error("Failed transitioning node from CLOSING to CLOSED", e); + return false; + } catch (IOException e) { + LOG.error("Failed to close region after failing to transition", e); + return false; + } + return true; + } + + /** + * ZK-based implementation. Has details about whether the state transition should be + * reflected in ZK, as well as expected version of znode. + */ + public static class ZkCloseRegionDetails implements CloseRegionConsensus.CloseRegionDetails { + + /** + * True if we are to update zk about the region close; if the close + * was orchestrated by master, then update zk. If the close is being run by + * the regionserver because its going down, don't update zk. + * */ + private boolean zk; + + /** + * The version of znode to compare when RS transitions the znode from + * CLOSING state. + */ + private int expectedVersion = FAILED_VERSION; + + /** + * Server name the handler is running on. + */ + private ServerName serverName; + + public ZkCloseRegionDetails() { + } + + public ZkCloseRegionDetails(boolean zk, int expectedVersion) { + this.zk = zk; + this.expectedVersion = expectedVersion; + } + + public boolean isZk() { + return zk; + } + + public void setZk(boolean zk) { + this.zk = zk; + } + + public int getExpectedVersion() { + return expectedVersion; + } + + public void setExpectedVersion(int expectedVersion) { + this.expectedVersion = expectedVersion; + } + + @Override + public ServerName getServerName() { + return serverName; + } + + @Override + public void setServerName(ServerName serverName) { + this.serverName = serverName; + } + } +} Index: hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/handler/TestCloseRegionHandler.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/handler/TestCloseRegionHandler.java (revision 9f362ac918cac99dc365edd897e1c6e130a8dd4d) +++ hbase-server/src/test/java/org/apache/hadoop/hbase/regionserver/handler/TestCloseRegionHandler.java (revision ) @@ -33,10 +33,12 @@ import org.apache.hadoop.hbase.RegionTransition; import org.apache.hadoop.hbase.Server; import org.apache.hadoop.hbase.TableName; +import org.apache.hadoop.hbase.consensus.ZkConsensusProvider; import org.apache.hadoop.hbase.exceptions.DeserializationException; import org.apache.hadoop.hbase.executor.EventType; import org.apache.hadoop.hbase.regionserver.HRegion; import org.apache.hadoop.hbase.regionserver.RegionServerServices; +import org.apache.hadoop.hbase.regionserver.consensus.ZkCloseRegionConsensus; import org.apache.hadoop.hbase.util.Bytes; import org.apache.hadoop.hbase.util.MockServer; import org.apache.hadoop.hbase.zookeeper.ZKAssign; @@ -110,8 +112,18 @@ rss.addToOnlineRegions(spy); // Assert the Server is NOT stopped before we call close region. assertFalse(server.isStopped()); - CloseRegionHandler handler = - new CloseRegionHandler(server, rss, hri, false, false, -1); + + ZkConsensusProvider consensus = new ZkConsensusProvider(); + consensus.start(server); + + ZkCloseRegionConsensus.ZkCloseRegionDetails zkCrd = + new ZkCloseRegionConsensus.ZkCloseRegionDetails(); + zkCrd.setZk(false); + zkCrd.setExpectedVersion(-1); + zkCrd.setServerName(server.getServerName()); + + CloseRegionHandler handler = new CloseRegionHandler(server, rss, hri, false, + consensus.getCloseRegionConsensus(), zkCrd); boolean throwable = false; try { handler.process(); @@ -153,9 +165,18 @@ // The CloseRegionHandler will validate the expected version // Given it is set to invalid versionOfClosingNode+1, // CloseRegionHandler should be M_ZK_REGION_CLOSING - CloseRegionHandler handler = - new CloseRegionHandler(server, rss, hri, false, true, - versionOfClosingNode+1); + + ZkConsensusProvider consensus = new ZkConsensusProvider(); + consensus.start(server); + + ZkCloseRegionConsensus.ZkCloseRegionDetails zkCrd = + new ZkCloseRegionConsensus.ZkCloseRegionDetails(); + zkCrd.setZk(true); + zkCrd.setExpectedVersion(versionOfClosingNode+1); + zkCrd.setServerName(server.getServerName()); + + CloseRegionHandler handler = new CloseRegionHandler(server, rss, hri, false, + consensus.getCloseRegionConsensus(), zkCrd); handler.process(); // Handler should remain in M_ZK_REGION_CLOSING @@ -190,9 +211,18 @@ // The CloseRegionHandler will validate the expected version // Given it is set to correct versionOfClosingNode, // CloseRegionHandlerit should be RS_ZK_REGION_CLOSED - CloseRegionHandler handler = - new CloseRegionHandler(server, rss, hri, false, true, - versionOfClosingNode); + + ZkConsensusProvider consensus = new ZkConsensusProvider(); + consensus.start(server); + + ZkCloseRegionConsensus.ZkCloseRegionDetails zkCrd = + new ZkCloseRegionConsensus.ZkCloseRegionDetails(); + zkCrd.setZk(true); + zkCrd.setExpectedVersion(versionOfClosingNode); + zkCrd.setServerName(server.getServerName()); + + CloseRegionHandler handler = new CloseRegionHandler(server, rss, hri, false, + consensus.getCloseRegionConsensus(), zkCrd); handler.process(); // Handler should have transitioned it to RS_ZK_REGION_CLOSED RegionTransition rt = RegionTransition.parseFrom(