Repository: hbase-site
Updated Branches:
  refs/heads/asf-site d5aa6a181 -> 709b8fccb


http://git-wip-us.apache.org/repos/asf/hbase-site/blob/709b8fcc/devapidocs/src-html/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.html
----------------------------------------------------------------------
diff --git 
a/devapidocs/src-html/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.html
 
b/devapidocs/src-html/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.html
index 40e88c1..740d74a 100644
--- 
a/devapidocs/src-html/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.html
+++ 
b/devapidocs/src-html/org/apache/hadoop/hbase/master/snapshot/SnapshotManager.html
@@ -688,7 +688,7 @@
 <span class="sourceLineNo">680</span>   */<a name="line.680"></a>
 <span class="sourceLineNo">681</span>  private long cloneSnapshot(final 
SnapshotDescription reqSnapshot, final TableName tableName,<a 
name="line.681"></a>
 <span class="sourceLineNo">682</span>      final SnapshotDescription snapshot, 
final HTableDescriptor snapshotTableDesc,<a name="line.682"></a>
-<span class="sourceLineNo">683</span>      final NonceKey nonceKey, final 
boolean restoreAcl) throws IOException {<a name="line.683"></a>
+<span class="sourceLineNo">683</span>      final NonceKey nonceKey) throws 
IOException {<a name="line.683"></a>
 <span class="sourceLineNo">684</span>    MasterCoprocessorHost cpHost = 
master.getMasterCoprocessorHost();<a name="line.684"></a>
 <span class="sourceLineNo">685</span>    HTableDescriptor htd = new 
HTableDescriptor(tableName, snapshotTableDesc);<a name="line.685"></a>
 <span class="sourceLineNo">686</span>    if (cpHost != null) {<a 
name="line.686"></a>
@@ -696,7 +696,7 @@
 <span class="sourceLineNo">688</span>    }<a name="line.688"></a>
 <span class="sourceLineNo">689</span>    long procId;<a name="line.689"></a>
 <span class="sourceLineNo">690</span>    try {<a name="line.690"></a>
-<span class="sourceLineNo">691</span>      procId = cloneSnapshot(snapshot, 
htd, nonceKey, restoreAcl);<a name="line.691"></a>
+<span class="sourceLineNo">691</span>      procId = cloneSnapshot(snapshot, 
htd, nonceKey);<a name="line.691"></a>
 <span class="sourceLineNo">692</span>    } catch (IOException e) {<a 
name="line.692"></a>
 <span class="sourceLineNo">693</span>      LOG.error("Exception occurred while 
cloning the snapshot " + snapshot.getName()<a name="line.693"></a>
 <span class="sourceLineNo">694</span>        + " as table " + 
tableName.getNameAsString(), e);<a name="line.694"></a>
@@ -720,7 +720,7 @@
 <span class="sourceLineNo">712</span>   * @return procId the ID of the clone 
snapshot procedure<a name="line.712"></a>
 <span class="sourceLineNo">713</span>   */<a name="line.713"></a>
 <span class="sourceLineNo">714</span>  synchronized long cloneSnapshot(final 
SnapshotDescription snapshot,<a name="line.714"></a>
-<span class="sourceLineNo">715</span>      final HTableDescriptor 
hTableDescriptor, final NonceKey nonceKey, final boolean restoreAcl)<a 
name="line.715"></a>
+<span class="sourceLineNo">715</span>      final HTableDescriptor 
hTableDescriptor, final NonceKey nonceKey)<a name="line.715"></a>
 <span class="sourceLineNo">716</span>      throws HBaseSnapshotException {<a 
name="line.716"></a>
 <span class="sourceLineNo">717</span>    TableName tableName = 
hTableDescriptor.getTableName();<a name="line.717"></a>
 <span class="sourceLineNo">718</span><a name="line.718"></a>
@@ -736,8 +736,8 @@
 <span class="sourceLineNo">728</span><a name="line.728"></a>
 <span class="sourceLineNo">729</span>    try {<a name="line.729"></a>
 <span class="sourceLineNo">730</span>      long procId = 
master.getMasterProcedureExecutor().submitProcedure(<a name="line.730"></a>
-<span class="sourceLineNo">731</span>        new 
CloneSnapshotProcedure(master.getMasterProcedureExecutor().getEnvironment(),<a 
name="line.731"></a>
-<span class="sourceLineNo">732</span>            hTableDescriptor, snapshot, 
restoreAcl),<a name="line.732"></a>
+<span class="sourceLineNo">731</span>        new CloneSnapshotProcedure(<a 
name="line.731"></a>
+<span class="sourceLineNo">732</span>          
master.getMasterProcedureExecutor().getEnvironment(), hTableDescriptor, 
snapshot),<a name="line.732"></a>
 <span class="sourceLineNo">733</span>        nonceKey);<a name="line.733"></a>
 <span class="sourceLineNo">734</span>      
this.restoreTableToProcIdMap.put(tableName, procId);<a name="line.734"></a>
 <span class="sourceLineNo">735</span>      return procId;<a 
name="line.735"></a>
@@ -755,8 +755,8 @@
 <span class="sourceLineNo">747</span>   * @param nonceKey unique identifier to 
prevent duplicated RPC<a name="line.747"></a>
 <span class="sourceLineNo">748</span>   * @throws IOException<a 
name="line.748"></a>
 <span class="sourceLineNo">749</span>   */<a name="line.749"></a>
-<span class="sourceLineNo">750</span>  public long 
restoreOrCloneSnapshot(final SnapshotDescription reqSnapshot, final NonceKey 
nonceKey,<a name="line.750"></a>
-<span class="sourceLineNo">751</span>      final boolean restoreAcl) throws 
IOException {<a name="line.751"></a>
+<span class="sourceLineNo">750</span>  public long 
restoreOrCloneSnapshot(final SnapshotDescription reqSnapshot, final NonceKey 
nonceKey)<a name="line.750"></a>
+<span class="sourceLineNo">751</span>      throws IOException {<a 
name="line.751"></a>
 <span class="sourceLineNo">752</span>    FileSystem fs = 
master.getMasterFileSystem().getFileSystem();<a name="line.752"></a>
 <span class="sourceLineNo">753</span>    Path snapshotDir = 
SnapshotDescriptionUtils.getCompletedSnapshotDir(reqSnapshot, rootDir);<a 
name="line.753"></a>
 <span class="sourceLineNo">754</span><a name="line.754"></a>
@@ -787,394 +787,393 @@
 <span class="sourceLineNo">779</span>    if 
(MetaTableAccessor.tableExists(master.getConnection(), tableName)) {<a 
name="line.779"></a>
 <span class="sourceLineNo">780</span>      procId = 
restoreSnapshot(reqSnapshot, tableName, snapshot, snapshotTableDesc, 
nonceKey);<a name="line.780"></a>
 <span class="sourceLineNo">781</span>    } else {<a name="line.781"></a>
-<span class="sourceLineNo">782</span>      procId =<a name="line.782"></a>
-<span class="sourceLineNo">783</span>          cloneSnapshot(reqSnapshot, 
tableName, snapshot, snapshotTableDesc, nonceKey, restoreAcl);<a 
name="line.783"></a>
-<span class="sourceLineNo">784</span>    }<a name="line.784"></a>
-<span class="sourceLineNo">785</span>    return procId;<a name="line.785"></a>
-<span class="sourceLineNo">786</span>  }<a name="line.786"></a>
-<span class="sourceLineNo">787</span><a name="line.787"></a>
-<span class="sourceLineNo">788</span>  /**<a name="line.788"></a>
-<span class="sourceLineNo">789</span>   * Restore the specified snapshot.<a 
name="line.789"></a>
-<span class="sourceLineNo">790</span>   * The restore will fail if the 
destination table has a snapshot or restore in progress.<a name="line.790"></a>
-<span class="sourceLineNo">791</span>   *<a name="line.791"></a>
-<span class="sourceLineNo">792</span>   * @param reqSnapshot Snapshot 
Descriptor from request<a name="line.792"></a>
-<span class="sourceLineNo">793</span>   * @param tableName table to restore<a 
name="line.793"></a>
-<span class="sourceLineNo">794</span>   * @param snapshot Snapshot 
Descriptor<a name="line.794"></a>
-<span class="sourceLineNo">795</span>   * @param snapshotTableDesc Table 
Descriptor<a name="line.795"></a>
-<span class="sourceLineNo">796</span>   * @param nonceKey unique identifier to 
prevent duplicated RPC<a name="line.796"></a>
-<span class="sourceLineNo">797</span>   * @return procId the ID of the restore 
snapshot procedure<a name="line.797"></a>
-<span class="sourceLineNo">798</span>   * @throws IOException<a 
name="line.798"></a>
-<span class="sourceLineNo">799</span>   */<a name="line.799"></a>
-<span class="sourceLineNo">800</span>  private long restoreSnapshot(final 
SnapshotDescription reqSnapshot, final TableName tableName,<a 
name="line.800"></a>
-<span class="sourceLineNo">801</span>      final SnapshotDescription snapshot, 
final HTableDescriptor snapshotTableDesc,<a name="line.801"></a>
-<span class="sourceLineNo">802</span>      final NonceKey nonceKey) throws 
IOException {<a name="line.802"></a>
-<span class="sourceLineNo">803</span>    MasterCoprocessorHost cpHost = 
master.getMasterCoprocessorHost();<a name="line.803"></a>
-<span class="sourceLineNo">804</span><a name="line.804"></a>
-<span class="sourceLineNo">805</span>    if 
(master.getTableStateManager().isTableState(<a name="line.805"></a>
-<span class="sourceLineNo">806</span>      
TableName.valueOf(snapshot.getTable()), TableState.State.ENABLED)) {<a 
name="line.806"></a>
-<span class="sourceLineNo">807</span>      throw new 
UnsupportedOperationException("Table '" +<a name="line.807"></a>
-<span class="sourceLineNo">808</span>        
TableName.valueOf(snapshot.getTable()) + "' must be disabled in order to " +<a 
name="line.808"></a>
-<span class="sourceLineNo">809</span>        "perform a restore 
operation.");<a name="line.809"></a>
-<span class="sourceLineNo">810</span>    }<a name="line.810"></a>
-<span class="sourceLineNo">811</span><a name="line.811"></a>
-<span class="sourceLineNo">812</span>    // call Coprocessor pre hook<a 
name="line.812"></a>
-<span class="sourceLineNo">813</span>    if (cpHost != null) {<a 
name="line.813"></a>
-<span class="sourceLineNo">814</span>      
cpHost.preRestoreSnapshot(reqSnapshot, snapshotTableDesc);<a 
name="line.814"></a>
-<span class="sourceLineNo">815</span>    }<a name="line.815"></a>
-<span class="sourceLineNo">816</span><a name="line.816"></a>
-<span class="sourceLineNo">817</span>    long procId;<a name="line.817"></a>
-<span class="sourceLineNo">818</span>    try {<a name="line.818"></a>
-<span class="sourceLineNo">819</span>      procId = restoreSnapshot(snapshot, 
snapshotTableDesc, nonceKey);<a name="line.819"></a>
-<span class="sourceLineNo">820</span>    } catch (IOException e) {<a 
name="line.820"></a>
-<span class="sourceLineNo">821</span>      LOG.error("Exception occurred while 
restoring the snapshot " + snapshot.getName()<a name="line.821"></a>
-<span class="sourceLineNo">822</span>        + " as table " + 
tableName.getNameAsString(), e);<a name="line.822"></a>
-<span class="sourceLineNo">823</span>      throw e;<a name="line.823"></a>
-<span class="sourceLineNo">824</span>    }<a name="line.824"></a>
-<span class="sourceLineNo">825</span>    LOG.info("Restore snapshot=" + 
snapshot.getName() + " as table=" + tableName);<a name="line.825"></a>
-<span class="sourceLineNo">826</span><a name="line.826"></a>
-<span class="sourceLineNo">827</span>    if (cpHost != null) {<a 
name="line.827"></a>
-<span class="sourceLineNo">828</span>      
cpHost.postRestoreSnapshot(reqSnapshot, snapshotTableDesc);<a 
name="line.828"></a>
-<span class="sourceLineNo">829</span>    }<a name="line.829"></a>
-<span class="sourceLineNo">830</span><a name="line.830"></a>
-<span class="sourceLineNo">831</span>    return procId;<a name="line.831"></a>
-<span class="sourceLineNo">832</span>  }<a name="line.832"></a>
-<span class="sourceLineNo">833</span><a name="line.833"></a>
-<span class="sourceLineNo">834</span>  /**<a name="line.834"></a>
-<span class="sourceLineNo">835</span>   * Restore the specified snapshot.<a 
name="line.835"></a>
-<span class="sourceLineNo">836</span>   * The restore will fail if the 
destination table has a snapshot or restore in progress.<a name="line.836"></a>
-<span class="sourceLineNo">837</span>   *<a name="line.837"></a>
-<span class="sourceLineNo">838</span>   * @param snapshot Snapshot 
Descriptor<a name="line.838"></a>
-<span class="sourceLineNo">839</span>   * @param hTableDescriptor Table 
Descriptor<a name="line.839"></a>
-<span class="sourceLineNo">840</span>   * @param nonceKey unique identifier to 
prevent duplicated RPC<a name="line.840"></a>
-<span class="sourceLineNo">841</span>   * @return procId the ID of the restore 
snapshot procedure<a name="line.841"></a>
-<span class="sourceLineNo">842</span>   */<a name="line.842"></a>
-<span class="sourceLineNo">843</span>  private synchronized long 
restoreSnapshot(final SnapshotDescription snapshot,<a name="line.843"></a>
-<span class="sourceLineNo">844</span>      final HTableDescriptor 
hTableDescriptor, final NonceKey nonceKey)<a name="line.844"></a>
-<span class="sourceLineNo">845</span>      throws HBaseSnapshotException {<a 
name="line.845"></a>
-<span class="sourceLineNo">846</span>    final TableName tableName = 
hTableDescriptor.getTableName();<a name="line.846"></a>
-<span class="sourceLineNo">847</span><a name="line.847"></a>
-<span class="sourceLineNo">848</span>    // make sure we aren't running a 
snapshot on the same table<a name="line.848"></a>
-<span class="sourceLineNo">849</span>    if (isTakingSnapshot(tableName)) {<a 
name="line.849"></a>
-<span class="sourceLineNo">850</span>      throw new 
RestoreSnapshotException("Snapshot in progress on the restore table=" + 
tableName);<a name="line.850"></a>
-<span class="sourceLineNo">851</span>    }<a name="line.851"></a>
-<span class="sourceLineNo">852</span><a name="line.852"></a>
-<span class="sourceLineNo">853</span>    // make sure we aren't running a 
restore on the same table<a name="line.853"></a>
-<span class="sourceLineNo">854</span>    if (isRestoringTable(tableName)) {<a 
name="line.854"></a>
-<span class="sourceLineNo">855</span>      throw new 
RestoreSnapshotException("Restore already in progress on the table=" + 
tableName);<a name="line.855"></a>
-<span class="sourceLineNo">856</span>    }<a name="line.856"></a>
-<span class="sourceLineNo">857</span><a name="line.857"></a>
-<span class="sourceLineNo">858</span>    try {<a name="line.858"></a>
-<span class="sourceLineNo">859</span>      long procId = 
master.getMasterProcedureExecutor().submitProcedure(<a name="line.859"></a>
-<span class="sourceLineNo">860</span>        new RestoreSnapshotProcedure(<a 
name="line.860"></a>
-<span class="sourceLineNo">861</span>          
master.getMasterProcedureExecutor().getEnvironment(), hTableDescriptor, 
snapshot),<a name="line.861"></a>
-<span class="sourceLineNo">862</span>        nonceKey);<a name="line.862"></a>
-<span class="sourceLineNo">863</span>      
this.restoreTableToProcIdMap.put(tableName, procId);<a name="line.863"></a>
-<span class="sourceLineNo">864</span>      return procId;<a 
name="line.864"></a>
-<span class="sourceLineNo">865</span>    } catch (Exception e) {<a 
name="line.865"></a>
-<span class="sourceLineNo">866</span>      String msg = "Couldn't restore the 
snapshot=" + ClientSnapshotDescriptionUtils.toString(<a name="line.866"></a>
-<span class="sourceLineNo">867</span>          snapshot)  +<a 
name="line.867"></a>
-<span class="sourceLineNo">868</span>          " on table=" + tableName;<a 
name="line.868"></a>
-<span class="sourceLineNo">869</span>      LOG.error(msg, e);<a 
name="line.869"></a>
-<span class="sourceLineNo">870</span>      throw new 
RestoreSnapshotException(msg, e);<a name="line.870"></a>
-<span class="sourceLineNo">871</span>    }<a name="line.871"></a>
-<span class="sourceLineNo">872</span>  }<a name="line.872"></a>
-<span class="sourceLineNo">873</span><a name="line.873"></a>
-<span class="sourceLineNo">874</span>  /**<a name="line.874"></a>
-<span class="sourceLineNo">875</span>   * Verify if the restore of the 
specified table is in progress.<a name="line.875"></a>
-<span class="sourceLineNo">876</span>   *<a name="line.876"></a>
-<span class="sourceLineNo">877</span>   * @param tableName table under 
restore<a name="line.877"></a>
-<span class="sourceLineNo">878</span>   * @return &lt;tt&gt;true&lt;/tt&gt; if 
there is a restore in progress of the specified table.<a name="line.878"></a>
-<span class="sourceLineNo">879</span>   */<a name="line.879"></a>
-<span class="sourceLineNo">880</span>  private synchronized boolean 
isRestoringTable(final TableName tableName) {<a name="line.880"></a>
-<span class="sourceLineNo">881</span>    Long procId = 
this.restoreTableToProcIdMap.get(tableName);<a name="line.881"></a>
-<span class="sourceLineNo">882</span>    if (procId == null) {<a 
name="line.882"></a>
-<span class="sourceLineNo">883</span>      return false;<a name="line.883"></a>
-<span class="sourceLineNo">884</span>    }<a name="line.884"></a>
-<span class="sourceLineNo">885</span>    
ProcedureExecutor&lt;MasterProcedureEnv&gt; procExec = 
master.getMasterProcedureExecutor();<a name="line.885"></a>
-<span class="sourceLineNo">886</span>    if (procExec.isRunning() &amp;&amp; 
!procExec.isFinished(procId)) {<a name="line.886"></a>
-<span class="sourceLineNo">887</span>      return true;<a name="line.887"></a>
-<span class="sourceLineNo">888</span>    } else {<a name="line.888"></a>
-<span class="sourceLineNo">889</span>      
this.restoreTableToProcIdMap.remove(tableName);<a name="line.889"></a>
-<span class="sourceLineNo">890</span>      return false;<a name="line.890"></a>
-<span class="sourceLineNo">891</span>    }<a name="line.891"></a>
-<span class="sourceLineNo">892</span><a name="line.892"></a>
-<span class="sourceLineNo">893</span>  }<a name="line.893"></a>
-<span class="sourceLineNo">894</span><a name="line.894"></a>
-<span class="sourceLineNo">895</span>  /**<a name="line.895"></a>
-<span class="sourceLineNo">896</span>   * Return the handler if it is 
currently live and has the same snapshot target name.<a name="line.896"></a>
-<span class="sourceLineNo">897</span>   * The handler is removed from the 
sentinels map if completed.<a name="line.897"></a>
-<span class="sourceLineNo">898</span>   * @param sentinels live handlers<a 
name="line.898"></a>
-<span class="sourceLineNo">899</span>   * @param snapshot snapshot 
description<a name="line.899"></a>
-<span class="sourceLineNo">900</span>   * @return null if doesn't match, else 
a live handler.<a name="line.900"></a>
-<span class="sourceLineNo">901</span>   */<a name="line.901"></a>
-<span class="sourceLineNo">902</span>  private synchronized SnapshotSentinel 
removeSentinelIfFinished(<a name="line.902"></a>
-<span class="sourceLineNo">903</span>      final Map&lt;TableName, 
SnapshotSentinel&gt; sentinels,<a name="line.903"></a>
-<span class="sourceLineNo">904</span>      final SnapshotDescription snapshot) 
{<a name="line.904"></a>
-<span class="sourceLineNo">905</span>    if (!snapshot.hasTable()) {<a 
name="line.905"></a>
-<span class="sourceLineNo">906</span>      return null;<a name="line.906"></a>
-<span class="sourceLineNo">907</span>    }<a name="line.907"></a>
-<span class="sourceLineNo">908</span><a name="line.908"></a>
-<span class="sourceLineNo">909</span>    TableName snapshotTable = 
TableName.valueOf(snapshot.getTable());<a name="line.909"></a>
-<span class="sourceLineNo">910</span>    SnapshotSentinel h = 
sentinels.get(snapshotTable);<a name="line.910"></a>
-<span class="sourceLineNo">911</span>    if (h == null) {<a 
name="line.911"></a>
-<span class="sourceLineNo">912</span>      return null;<a name="line.912"></a>
-<span class="sourceLineNo">913</span>    }<a name="line.913"></a>
-<span class="sourceLineNo">914</span><a name="line.914"></a>
-<span class="sourceLineNo">915</span>    if 
(!h.getSnapshot().getName().equals(snapshot.getName())) {<a name="line.915"></a>
-<span class="sourceLineNo">916</span>      // specified snapshot is to the one 
currently running<a name="line.916"></a>
-<span class="sourceLineNo">917</span>      return null;<a name="line.917"></a>
-<span class="sourceLineNo">918</span>    }<a name="line.918"></a>
-<span class="sourceLineNo">919</span><a name="line.919"></a>
-<span class="sourceLineNo">920</span>    // Remove from the "in-progress" list 
once completed<a name="line.920"></a>
-<span class="sourceLineNo">921</span>    if (h.isFinished()) {<a 
name="line.921"></a>
-<span class="sourceLineNo">922</span>      sentinels.remove(snapshotTable);<a 
name="line.922"></a>
-<span class="sourceLineNo">923</span>    }<a name="line.923"></a>
-<span class="sourceLineNo">924</span><a name="line.924"></a>
-<span class="sourceLineNo">925</span>    return h;<a name="line.925"></a>
-<span class="sourceLineNo">926</span>  }<a name="line.926"></a>
-<span class="sourceLineNo">927</span><a name="line.927"></a>
-<span class="sourceLineNo">928</span>  /**<a name="line.928"></a>
-<span class="sourceLineNo">929</span>   * Removes "abandoned" snapshot/restore 
requests.<a name="line.929"></a>
-<span class="sourceLineNo">930</span>   * As part of the HBaseAdmin 
snapshot/restore API the operation status is checked until completed,<a 
name="line.930"></a>
-<span class="sourceLineNo">931</span>   * and the in-progress maps are cleaned 
up when the status of a completed task is requested.<a name="line.931"></a>
-<span class="sourceLineNo">932</span>   * To avoid having sentinels staying 
around for long time if something client side is failed,<a name="line.932"></a>
-<span class="sourceLineNo">933</span>   * each operation tries to clean up the 
in-progress maps sentinels finished from a long time.<a name="line.933"></a>
-<span class="sourceLineNo">934</span>   */<a name="line.934"></a>
-<span class="sourceLineNo">935</span>  private void cleanupSentinels() {<a 
name="line.935"></a>
-<span class="sourceLineNo">936</span>    
cleanupSentinels(this.snapshotHandlers);<a name="line.936"></a>
-<span class="sourceLineNo">937</span>    cleanupCompletedRestoreInMap();<a 
name="line.937"></a>
-<span class="sourceLineNo">938</span>  }<a name="line.938"></a>
-<span class="sourceLineNo">939</span><a name="line.939"></a>
-<span class="sourceLineNo">940</span>  /**<a name="line.940"></a>
-<span class="sourceLineNo">941</span>   * Remove the sentinels that are marked 
as finished and the completion time<a name="line.941"></a>
-<span class="sourceLineNo">942</span>   * has exceeded the removal timeout.<a 
name="line.942"></a>
-<span class="sourceLineNo">943</span>   * @param sentinels map of sentinels to 
clean<a name="line.943"></a>
-<span class="sourceLineNo">944</span>   */<a name="line.944"></a>
-<span class="sourceLineNo">945</span>  private synchronized void 
cleanupSentinels(final Map&lt;TableName, SnapshotSentinel&gt; sentinels) {<a 
name="line.945"></a>
-<span class="sourceLineNo">946</span>    long currentTime = 
EnvironmentEdgeManager.currentTime();<a name="line.946"></a>
-<span class="sourceLineNo">947</span>    Iterator&lt;Map.Entry&lt;TableName, 
SnapshotSentinel&gt;&gt; it =<a name="line.947"></a>
-<span class="sourceLineNo">948</span>        
sentinels.entrySet().iterator();<a name="line.948"></a>
-<span class="sourceLineNo">949</span>    while (it.hasNext()) {<a 
name="line.949"></a>
-<span class="sourceLineNo">950</span>      Map.Entry&lt;TableName, 
SnapshotSentinel&gt; entry = it.next();<a name="line.950"></a>
-<span class="sourceLineNo">951</span>      SnapshotSentinel sentinel = 
entry.getValue();<a name="line.951"></a>
-<span class="sourceLineNo">952</span>      if (sentinel.isFinished() 
&amp;&amp;<a name="line.952"></a>
-<span class="sourceLineNo">953</span>          (currentTime - 
sentinel.getCompletionTimestamp()) &gt; SNAPSHOT_SENTINELS_CLEANUP_TIMEOUT)<a 
name="line.953"></a>
-<span class="sourceLineNo">954</span>      {<a name="line.954"></a>
-<span class="sourceLineNo">955</span>        it.remove();<a 
name="line.955"></a>
-<span class="sourceLineNo">956</span>      }<a name="line.956"></a>
-<span class="sourceLineNo">957</span>    }<a name="line.957"></a>
-<span class="sourceLineNo">958</span>  }<a name="line.958"></a>
-<span class="sourceLineNo">959</span><a name="line.959"></a>
-<span class="sourceLineNo">960</span>  /**<a name="line.960"></a>
-<span class="sourceLineNo">961</span>   * Remove the procedures that are 
marked as finished<a name="line.961"></a>
-<span class="sourceLineNo">962</span>   */<a name="line.962"></a>
-<span class="sourceLineNo">963</span>  private synchronized void 
cleanupCompletedRestoreInMap() {<a name="line.963"></a>
-<span class="sourceLineNo">964</span>    
ProcedureExecutor&lt;MasterProcedureEnv&gt; procExec = 
master.getMasterProcedureExecutor();<a name="line.964"></a>
-<span class="sourceLineNo">965</span>    Iterator&lt;Map.Entry&lt;TableName, 
Long&gt;&gt; it = restoreTableToProcIdMap.entrySet().iterator();<a 
name="line.965"></a>
-<span class="sourceLineNo">966</span>    while (it.hasNext()) {<a 
name="line.966"></a>
-<span class="sourceLineNo">967</span>      Map.Entry&lt;TableName, Long&gt; 
entry = it.next();<a name="line.967"></a>
-<span class="sourceLineNo">968</span>      Long procId = entry.getValue();<a 
name="line.968"></a>
-<span class="sourceLineNo">969</span>      if (procExec.isRunning() &amp;&amp; 
procExec.isFinished(procId)) {<a name="line.969"></a>
-<span class="sourceLineNo">970</span>        it.remove();<a 
name="line.970"></a>
-<span class="sourceLineNo">971</span>      }<a name="line.971"></a>
-<span class="sourceLineNo">972</span>    }<a name="line.972"></a>
-<span class="sourceLineNo">973</span>  }<a name="line.973"></a>
-<span class="sourceLineNo">974</span><a name="line.974"></a>
-<span class="sourceLineNo">975</span>  //<a name="line.975"></a>
-<span class="sourceLineNo">976</span>  // Implementing Stoppable interface<a 
name="line.976"></a>
-<span class="sourceLineNo">977</span>  //<a name="line.977"></a>
-<span class="sourceLineNo">978</span><a name="line.978"></a>
-<span class="sourceLineNo">979</span>  @Override<a name="line.979"></a>
-<span class="sourceLineNo">980</span>  public void stop(String why) {<a 
name="line.980"></a>
-<span class="sourceLineNo">981</span>    // short circuit<a 
name="line.981"></a>
-<span class="sourceLineNo">982</span>    if (this.stopped) return;<a 
name="line.982"></a>
-<span class="sourceLineNo">983</span>    // make sure we get stop<a 
name="line.983"></a>
-<span class="sourceLineNo">984</span>    this.stopped = true;<a 
name="line.984"></a>
-<span class="sourceLineNo">985</span>    // pass the stop onto take snapshot 
handlers<a name="line.985"></a>
-<span class="sourceLineNo">986</span>    for (SnapshotSentinel 
snapshotHandler: this.snapshotHandlers.values()) {<a name="line.986"></a>
-<span class="sourceLineNo">987</span>      snapshotHandler.cancel(why);<a 
name="line.987"></a>
-<span class="sourceLineNo">988</span>    }<a name="line.988"></a>
-<span class="sourceLineNo">989</span><a name="line.989"></a>
-<span class="sourceLineNo">990</span>    try {<a name="line.990"></a>
-<span class="sourceLineNo">991</span>      if (coordinator != null) {<a 
name="line.991"></a>
-<span class="sourceLineNo">992</span>        coordinator.close();<a 
name="line.992"></a>
-<span class="sourceLineNo">993</span>      }<a name="line.993"></a>
-<span class="sourceLineNo">994</span>    } catch (IOException e) {<a 
name="line.994"></a>
-<span class="sourceLineNo">995</span>      LOG.error("stop 
ProcedureCoordinator error", e);<a name="line.995"></a>
-<span class="sourceLineNo">996</span>    }<a name="line.996"></a>
-<span class="sourceLineNo">997</span>  }<a name="line.997"></a>
-<span class="sourceLineNo">998</span><a name="line.998"></a>
-<span class="sourceLineNo">999</span>  @Override<a name="line.999"></a>
-<span class="sourceLineNo">1000</span>  public boolean isStopped() {<a 
name="line.1000"></a>
-<span class="sourceLineNo">1001</span>    return this.stopped;<a 
name="line.1001"></a>
-<span class="sourceLineNo">1002</span>  }<a name="line.1002"></a>
-<span class="sourceLineNo">1003</span><a name="line.1003"></a>
-<span class="sourceLineNo">1004</span>  /**<a name="line.1004"></a>
-<span class="sourceLineNo">1005</span>   * Throws an exception if snapshot 
operations (take a snapshot, restore, clone) are not supported.<a 
name="line.1005"></a>
-<span class="sourceLineNo">1006</span>   * Called at the beginning of 
snapshot() and restoreSnapshot() methods.<a name="line.1006"></a>
-<span class="sourceLineNo">1007</span>   * @throws 
UnsupportedOperationException if snapshot are not supported<a 
name="line.1007"></a>
-<span class="sourceLineNo">1008</span>   */<a name="line.1008"></a>
-<span class="sourceLineNo">1009</span>  public void checkSnapshotSupport() 
throws UnsupportedOperationException {<a name="line.1009"></a>
-<span class="sourceLineNo">1010</span>    if (!this.isSnapshotSupported) {<a 
name="line.1010"></a>
-<span class="sourceLineNo">1011</span>      throw new 
UnsupportedOperationException(<a name="line.1011"></a>
-<span class="sourceLineNo">1012</span>        "To use snapshots, You must add 
to the hbase-site.xml of the HBase Master: '" +<a name="line.1012"></a>
-<span class="sourceLineNo">1013</span>          HBASE_SNAPSHOT_ENABLED + "' 
property with value 'true'.");<a name="line.1013"></a>
-<span class="sourceLineNo">1014</span>    }<a name="line.1014"></a>
-<span class="sourceLineNo">1015</span>  }<a name="line.1015"></a>
-<span class="sourceLineNo">1016</span><a name="line.1016"></a>
-<span class="sourceLineNo">1017</span>  /**<a name="line.1017"></a>
-<span class="sourceLineNo">1018</span>   * Called at startup, to verify if 
snapshot operation is supported, and to avoid<a name="line.1018"></a>
-<span class="sourceLineNo">1019</span>   * starting the master if there're 
snapshots present but the cleaners needed are missing.<a name="line.1019"></a>
-<span class="sourceLineNo">1020</span>   * Otherwise we can end up with 
snapshot data loss.<a name="line.1020"></a>
-<span class="sourceLineNo">1021</span>   * @param conf The {@link 
Configuration} object to use<a name="line.1021"></a>
-<span class="sourceLineNo">1022</span>   * @param mfs The MasterFileSystem to 
use<a name="line.1022"></a>
-<span class="sourceLineNo">1023</span>   * @throws IOException in case of 
file-system operation failure<a name="line.1023"></a>
-<span class="sourceLineNo">1024</span>   * @throws 
UnsupportedOperationException in case cleaners are missing and<a 
name="line.1024"></a>
-<span class="sourceLineNo">1025</span>   *         there're snapshot in the 
system<a name="line.1025"></a>
-<span class="sourceLineNo">1026</span>   */<a name="line.1026"></a>
-<span class="sourceLineNo">1027</span>  private void 
checkSnapshotSupport(final Configuration conf, final MasterFileSystem mfs)<a 
name="line.1027"></a>
-<span class="sourceLineNo">1028</span>      throws IOException, 
UnsupportedOperationException {<a name="line.1028"></a>
-<span class="sourceLineNo">1029</span>    // Verify if snapshot is disabled by 
the user<a name="line.1029"></a>
-<span class="sourceLineNo">1030</span>    String enabled = 
conf.get(HBASE_SNAPSHOT_ENABLED);<a name="line.1030"></a>
-<span class="sourceLineNo">1031</span>    boolean snapshotEnabled = 
conf.getBoolean(HBASE_SNAPSHOT_ENABLED, false);<a name="line.1031"></a>
-<span class="sourceLineNo">1032</span>    boolean userDisabled = (enabled != 
null &amp;&amp; enabled.trim().length() &gt; 0 &amp;&amp; !snapshotEnabled);<a 
name="line.1032"></a>
-<span class="sourceLineNo">1033</span><a name="line.1033"></a>
-<span class="sourceLineNo">1034</span>    // Extract cleaners from conf<a 
name="line.1034"></a>
-<span class="sourceLineNo">1035</span>    Set&lt;String&gt; hfileCleaners = 
new HashSet&lt;&gt;();<a name="line.1035"></a>
-<span class="sourceLineNo">1036</span>    String[] cleaners = 
conf.getStrings(HFileCleaner.MASTER_HFILE_CLEANER_PLUGINS);<a 
name="line.1036"></a>
-<span class="sourceLineNo">1037</span>    if (cleaners != null) 
Collections.addAll(hfileCleaners, cleaners);<a name="line.1037"></a>
-<span class="sourceLineNo">1038</span><a name="line.1038"></a>
-<span class="sourceLineNo">1039</span>    Set&lt;String&gt; logCleaners = new 
HashSet&lt;&gt;();<a name="line.1039"></a>
-<span class="sourceLineNo">1040</span>    cleaners = 
conf.getStrings(HConstants.HBASE_MASTER_LOGCLEANER_PLUGINS);<a 
name="line.1040"></a>
-<span class="sourceLineNo">1041</span>    if (cleaners != null) 
Collections.addAll(logCleaners, cleaners);<a name="line.1041"></a>
-<span class="sourceLineNo">1042</span><a name="line.1042"></a>
-<span class="sourceLineNo">1043</span>    // check if an older version of 
snapshot directory was present<a name="line.1043"></a>
-<span class="sourceLineNo">1044</span>    Path oldSnapshotDir = new 
Path(mfs.getRootDir(), HConstants.OLD_SNAPSHOT_DIR_NAME);<a 
name="line.1044"></a>
-<span class="sourceLineNo">1045</span>    FileSystem fs = 
mfs.getFileSystem();<a name="line.1045"></a>
-<span class="sourceLineNo">1046</span>    List&lt;SnapshotDescription&gt; ss = 
getCompletedSnapshots(new Path(rootDir, oldSnapshotDir));<a 
name="line.1046"></a>
-<span class="sourceLineNo">1047</span>    if (ss != null &amp;&amp; 
!ss.isEmpty()) {<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span>      LOG.error("Snapshots from an 
earlier release were found under: " + oldSnapshotDir);<a name="line.1048"></a>
-<span class="sourceLineNo">1049</span>      LOG.error("Please rename the 
directory as " + HConstants.SNAPSHOT_DIR_NAME);<a name="line.1049"></a>
-<span class="sourceLineNo">1050</span>    }<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span><a name="line.1051"></a>
-<span class="sourceLineNo">1052</span>    // If the user has enabled the 
snapshot, we force the cleaners to be present<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span>    // otherwise we still need to check 
if cleaners are enabled or not and verify<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span>    // that there're no snapshot in the 
.snapshot folder.<a name="line.1054"></a>
-<span class="sourceLineNo">1055</span>    if (snapshotEnabled) {<a 
name="line.1055"></a>
-<span class="sourceLineNo">1056</span>      // Inject snapshot cleaners, if 
snapshot.enable is true<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span>      
hfileCleaners.add(SnapshotHFileCleaner.class.getName());<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span>      
hfileCleaners.add(HFileLinkCleaner.class.getName());<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span><a name="line.1059"></a>
-<span class="sourceLineNo">1060</span>      // Set cleaners conf<a 
name="line.1060"></a>
-<span class="sourceLineNo">1061</span>      
conf.setStrings(HFileCleaner.MASTER_HFILE_CLEANER_PLUGINS,<a 
name="line.1061"></a>
-<span class="sourceLineNo">1062</span>        hfileCleaners.toArray(new 
String[hfileCleaners.size()]));<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span>      
conf.setStrings(HConstants.HBASE_MASTER_LOGCLEANER_PLUGINS,<a 
name="line.1063"></a>
-<span class="sourceLineNo">1064</span>        logCleaners.toArray(new 
String[logCleaners.size()]));<a name="line.1064"></a>
-<span class="sourceLineNo">1065</span>    } else {<a name="line.1065"></a>
-<span class="sourceLineNo">1066</span>      // Verify if cleaners are 
present<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span>      snapshotEnabled =<a 
name="line.1067"></a>
-<span class="sourceLineNo">1068</span>        
hfileCleaners.contains(SnapshotHFileCleaner.class.getName()) &amp;&amp;<a 
name="line.1068"></a>
-<span class="sourceLineNo">1069</span>        
hfileCleaners.contains(HFileLinkCleaner.class.getName());<a 
name="line.1069"></a>
-<span class="sourceLineNo">1070</span><a name="line.1070"></a>
-<span class="sourceLineNo">1071</span>      // Warn if the cleaners are 
enabled but the snapshot.enabled property is false/not set.<a 
name="line.1071"></a>
-<span class="sourceLineNo">1072</span>      if (snapshotEnabled) {<a 
name="line.1072"></a>
-<span class="sourceLineNo">1073</span>        LOG.warn("Snapshot log and hfile 
cleaners are present in the configuration, " +<a name="line.1073"></a>
-<span class="sourceLineNo">1074</span>          "but the '" + 
HBASE_SNAPSHOT_ENABLED + "' property " +<a name="line.1074"></a>
-<span class="sourceLineNo">1075</span>          (userDisabled ? "is set to 
'false'." : "is not set."));<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span>      }<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span>    }<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span><a name="line.1078"></a>
-<span class="sourceLineNo">1079</span>    // Mark snapshot feature as enabled 
if cleaners are present and user has not disabled it.<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span>    this.isSnapshotSupported = 
snapshotEnabled &amp;&amp; !userDisabled;<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span><a name="line.1081"></a>
-<span class="sourceLineNo">1082</span>    // If cleaners are not enabled, 
verify that there're no snapshot in the .snapshot folder<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span>    // otherwise we end up with snapshot 
data loss.<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span>    if (!snapshotEnabled) {<a 
name="line.1084"></a>
-<span class="sourceLineNo">1085</span>      LOG.info("Snapshot feature is not 
enabled, missing log and hfile cleaners.");<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span>      Path snapshotDir = 
SnapshotDescriptionUtils.getSnapshotsDir(mfs.getRootDir());<a 
name="line.1086"></a>
-<span class="sourceLineNo">1087</span>      if (fs.exists(snapshotDir)) {<a 
name="line.1087"></a>
-<span class="sourceLineNo">1088</span>        FileStatus[] snapshots = 
FSUtils.listStatus(fs, snapshotDir,<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span>          new 
SnapshotDescriptionUtils.CompletedSnaphotDirectoriesFilter(fs));<a 
name="line.1089"></a>
-<span class="sourceLineNo">1090</span>        if (snapshots != null) {<a 
name="line.1090"></a>
-<span class="sourceLineNo">1091</span>          LOG.error("Snapshots are 
present, but cleaners are not enabled.");<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span>          checkSnapshotSupport();<a 
name="line.1092"></a>
-<span class="sourceLineNo">1093</span>        }<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span>      }<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span>    }<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span>  }<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span><a name="line.1097"></a>
-<span class="sourceLineNo">1098</span>  @Override<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span>  public void initialize(MasterServices 
master, MetricsMaster metricsMaster) throws KeeperException,<a 
name="line.1099"></a>
-<span class="sourceLineNo">1100</span>      IOException, 
UnsupportedOperationException {<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span>    this.master = master;<a 
name="line.1101"></a>
-<span class="sourceLineNo">1102</span><a name="line.1102"></a>
-<span class="sourceLineNo">1103</span>    this.rootDir = 
master.getMasterFileSystem().getRootDir();<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span>    
checkSnapshotSupport(master.getConfiguration(), 
master.getMasterFileSystem());<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span><a name="line.1105"></a>
-<span class="sourceLineNo">1106</span>    // get the configuration for the 
coordinator<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span>    Configuration conf = 
master.getConfiguration();<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span>    long wakeFrequency = 
conf.getInt(SNAPSHOT_WAKE_MILLIS_KEY, SNAPSHOT_WAKE_MILLIS_DEFAULT);<a 
name="line.1108"></a>
-<span class="sourceLineNo">1109</span>    long timeoutMillis = 
Math.max(conf.getLong(SnapshotDescriptionUtils.SNAPSHOT_TIMEOUT_MILLIS_KEY,<a 
name="line.1109"></a>
-<span class="sourceLineNo">1110</span>                    
SnapshotDescriptionUtils.SNAPSHOT_TIMEOUT_MILLIS_DEFAULT),<a 
name="line.1110"></a>
-<span class="sourceLineNo">1111</span>            
conf.getLong(SnapshotDescriptionUtils.MASTER_SNAPSHOT_TIMEOUT_MILLIS,<a 
name="line.1111"></a>
-<span class="sourceLineNo">1112</span>                    
SnapshotDescriptionUtils.DEFAULT_MAX_WAIT_TIME));<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span>    int opThreads = 
conf.getInt(SNAPSHOT_POOL_THREADS_KEY, SNAPSHOT_POOL_THREADS_DEFAULT);<a 
name="line.1113"></a>
-<span class="sourceLineNo">1114</span><a name="line.1114"></a>
-<span class="sourceLineNo">1115</span>    // setup the default procedure 
coordinator<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span>    String name = 
master.getServerName().toString();<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span>    ThreadPoolExecutor tpool = 
ProcedureCoordinator.defaultPool(name, opThreads);<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span>    ProcedureCoordinatorRpcs comms = new 
ZKProcedureCoordinator(<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span>        master.getZooKeeper(), 
SnapshotManager.ONLINE_SNAPSHOT_CONTROLLER_DESCRIPTION, name);<a 
name="line.1119"></a>
-<span class="sourceLineNo">1120</span><a name="line.1120"></a>
-<span class="sourceLineNo">1121</span>    this.coordinator = new 
ProcedureCoordinator(comms, tpool, timeoutMillis, wakeFrequency);<a 
name="line.1121"></a>
-<span class="sourceLineNo">1122</span>    this.executorService = 
master.getExecutorService();<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span>    resetTempDir();<a 
name="line.1123"></a>
-<span class="sourceLineNo">1124</span>  }<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span><a name="line.1125"></a>
-<span class="sourceLineNo">1126</span>  @Override<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span>  public String getProcedureSignature() 
{<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span>    return 
ONLINE_SNAPSHOT_CONTROLLER_DESCRIPTION;<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span>  }<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span><a name="line.1130"></a>
-<span class="sourceLineNo">1131</span>  @Override<a name="line.1131"></a>
-<span class="sourceLineNo">1132</span>  public void 
execProcedure(ProcedureDescription desc) throws IOException {<a 
name="line.1132"></a>
-<span class="sourceLineNo">1133</span>    
takeSnapshot(toSnapshotDescription(desc));<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span>  }<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span><a name="line.1135"></a>
-<span class="sourceLineNo">1136</span>  @Override<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span>  public boolean 
isProcedureDone(ProcedureDescription desc) throws IOException {<a 
name="line.1137"></a>
-<span class="sourceLineNo">1138</span>    return 
isSnapshotDone(toSnapshotDescription(desc));<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span>  }<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span>  private SnapshotDescription 
toSnapshotDescription(ProcedureDescription desc)<a name="line.1141"></a>
-<span class="sourceLineNo">1142</span>      throws IOException {<a 
name="line.1142"></a>
-<span class="sourceLineNo">1143</span>    SnapshotDescription.Builder builder 
= SnapshotDescription.newBuilder();<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span>    if (!desc.hasInstance()) {<a 
name="line.1144"></a>
-<span class="sourceLineNo">1145</span>      throw new IOException("Snapshot 
name is not defined: " + desc.toString());<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span>    }<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span>    String snapshotName = 
desc.getInstance();<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span>    List&lt;NameStringPair&gt; props = 
desc.getConfigurationList();<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span>    String table = null;<a 
name="line.1149"></a>
-<span class="sourceLineNo">1150</span>    for (NameStringPair prop : props) 
{<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span>      if 
("table".equalsIgnoreCase(prop.getName())) {<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span>        table = prop.getValue();<a 
name="line.1152"></a>
-<span class="sourceLineNo">1153</span>      }<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span>    }<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span>    if (table == null) {<a 
name="line.1155"></a>
-<span class="sourceLineNo">1156</span>      throw new IOException("Snapshot 
table is not defined: " + desc.toString());<a name="line.1156"></a>
-<span class="sourceLineNo">1157</span>    }<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span>    TableName tableName = 
TableName.valueOf(table);<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span>    
builder.setTable(tableName.getNameAsString());<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span>    builder.setName(snapshotName);<a 
name="line.1160"></a>
-<span class="sourceLineNo">1161</span>    
builder.setType(SnapshotDescription.Type.FLUSH);<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span>    return builder.build();<a 
name="line.1162"></a>
-<span class="sourceLineNo">1163</span>  }<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span><a name="line.1164"></a>
-<span class="sourceLineNo">1165</span>  public KeyLocker&lt;String&gt; 
getLocks() {<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span>    return locks;<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span>  }<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span><a name="line.1168"></a>
-<span class="sourceLineNo">1169</span>}<a name="line.1169"></a>
+<span class="sourceLineNo">782</span>      procId = cloneSnapshot(reqSnapshot, 
tableName, snapshot, snapshotTableDesc, nonceKey);<a name="line.782"></a>
+<span class="sourceLineNo">783</span>    }<a name="line.783"></a>
+<span class="sourceLineNo">784</span>    return procId;<a name="line.784"></a>
+<span class="sourceLineNo">785</span>  }<a name="line.785"></a>
+<span class="sourceLineNo">786</span><a name="line.786"></a>
+<span class="sourceLineNo">787</span>  /**<a name="line.787"></a>
+<span class="sourceLineNo">788</span>   * Restore the specified snapshot.<a 
name="line.788"></a>
+<span class="sourceLineNo">789</span>   * The restore will fail if the 
destination table has a snapshot or restore in progress.<a name="line.789"></a>
+<span class="sourceLineNo">790</span>   *<a name="line.790"></a>
+<span class="sourceLineNo">791</span>   * @param reqSnapshot Snapshot 
Descriptor from request<a name="line.791"></a>
+<span class="sourceLineNo">792</span>   * @param tableName table to restore<a 
name="line.792"></a>
+<span class="sourceLineNo">793</span>   * @param snapshot Snapshot 
Descriptor<a name="line.793"></a>
+<span class="sourceLineNo">794</span>   * @param snapshotTableDesc Table 
Descriptor<a name="line.794"></a>
+<span class="sourceLineNo">795</span>   * @param nonceKey unique identifier to 
prevent duplicated RPC<a name="line.795"></a>
+<span class="sourceLineNo">796</span>   * @return procId the ID of the restore 
snapshot procedure<a name="line.796"></a>
+<span class="sourceLineNo">797</span>   * @throws IOException<a 
name="line.797"></a>
+<span class="sourceLineNo">798</span>   */<a name="line.798"></a>
+<span class="sourceLineNo">799</span>  private long restoreSnapshot(final 
SnapshotDescription reqSnapshot, final TableName tableName,<a 
name="line.799"></a>
+<span class="sourceLineNo">800</span>      final SnapshotDescription snapshot, 
final HTableDescriptor snapshotTableDesc,<a name="line.800"></a>
+<span class="sourceLineNo">801</span>      final NonceKey nonceKey) throws 
IOException {<a name="line.801"></a>
+<span class="sourceLineNo">802</span>    MasterCoprocessorHost cpHost = 
master.getMasterCoprocessorHost();<a name="line.802"></a>
+<span class="sourceLineNo">803</span><a name="line.803"></a>
+<span class="sourceLineNo">804</span>    if 
(master.getTableStateManager().isTableState(<a name="line.804"></a>
+<span class="sourceLineNo">805</span>      
TableName.valueOf(snapshot.getTable()), TableState.State.ENABLED)) {<a 
name="line.805"></a>
+<span class="sourceLineNo">806</span>      throw new 
UnsupportedOperationException("Table '" +<a name="line.806"></a>
+<span class="sourceLineNo">807</span>        
TableName.valueOf(snapshot.getTable()) + "' must be disabled in order to " +<a 
name="line.807"></a>
+<span class="sourceLineNo">808</span>        "perform a restore 
operation.");<a name="line.808"></a>
+<span class="sourceLineNo">809</span>    }<a name="line.809"></a>
+<span class="sourceLineNo">810</span><a name="line.810"></a>
+<span class="sourceLineNo">811</span>    // call Coprocessor pre hook<a 
name="line.811"></a>
+<span class="sourceLineNo">812</span>    if (cpHost != null) {<a 
name="line.812"></a>
+<span class="sourceLineNo">813</span>      
cpHost.preRestoreSnapshot(reqSnapshot, snapshotTableDesc);<a 
name="line.813"></a>
+<span class="sourceLineNo">814</span>    }<a name="line.814"></a>
+<span class="sourceLineNo">815</span><a name="line.815"></a>
+<span class="sourceLineNo">816</span>    long procId;<a name="line.816"></a>
+<span class="sourceLineNo">817</span>    try {<a name="line.817"></a>
+<span class="sourceLineNo">818</span>      procId = restoreSnapshot(snapshot, 
snapshotTableDesc, nonceKey);<a name="line.818"></a>
+<span class="sourceLineNo">819</span>    } catch (IOException e) {<a 
name="line.819"></a>
+<span class="sourceLineNo">820</span>      LOG.error("Exception occurred while 
restoring the snapshot " + snapshot.getName()<a name="line.820"></a>
+<span class="sourceLineNo">821</span>        + " as table " + 
tableName.getNameAsString(), e);<a name="line.821"></a>
+<span class="sourceLineNo">822</span>      throw e;<a name="line.822"></a>
+<span class="sourceLineNo">823</span>    }<a name="line.823"></a>
+<span class="sourceLineNo">824</span>    LOG.info("Restore snapshot=" + 
snapshot.getName() + " as table=" + tableName);<a name="line.824"></a>
+<span class="sourceLineNo">825</span><a name="line.825"></a>
+<span class="sourceLineNo">826</span>    if (cpHost != null) {<a 
name="line.826"></a>
+<span class="sourceLineNo">827</span>      
cpHost.postRestoreSnapshot(reqSnapshot, snapshotTableDesc);<a 
name="line.827"></a>
+<span class="sourceLineNo">828</span>    }<a name="line.828"></a>
+<span class="sourceLineNo">829</span><a name="line.829"></a>
+<span class="sourceLineNo">830</span>    return procId;<a name="line.830"></a>
+<span class="sourceLineNo">831</span>  }<a name="line.831"></a>
+<span class="sourceLineNo">832</span><a name="line.832"></a>
+<span class="sourceLineNo">833</span>  /**<a name="line.833"></a>
+<span class="sourceLineNo">834</span>   * Restore the specified snapshot.<a 
name="line.834"></a>
+<span class="sourceLineNo">835</span>   * The restore will fail if the 
destination table has a snapshot or restore in progress.<a name="line.835"></a>
+<span class="sourceLineNo">836</span>   *<a name="line.836"></a>
+<span class="sourceLineNo">837</span>   * @param snapshot Snapshot 
Descriptor<a name="line.837"></a>
+<span class="sourceLineNo">838</span>   * @param hTableDescriptor Table 
Descriptor<a name="line.838"></a>
+<span class="sourceLineNo">839</span>   * @param nonceKey unique identifier to 
prevent duplicated RPC<a name="line.839"></a>
+<span class="sourceLineNo">840</span>   * @return procId the ID of the restore 
snapshot procedure<a name="line.840"></a>
+<span class="sourceLineNo">841</span>   */<a name="line.841"></a>
+<span class="sourceLineNo">842</span>  private synchronized long 
restoreSnapshot(final SnapshotDescription snapshot,<a name="line.842"></a>
+<span class="sourceLineNo">843</span>      final HTableDescriptor 
hTableDescriptor, final NonceKey nonceKey)<a name="line.843"></a>
+<span class="sourceLineNo">844</span>      throws HBaseSnapshotException {<a 
name="line.844"></a>
+<span class="sourceLineNo">845</span>    final TableName tableName = 
hTableDescriptor.getTableName();<a name="line.845"></a>
+<span class="sourceLineNo">846</span><a name="line.846"></a>
+<span class="sourceLineNo">847</span>    // make sure we aren't running a 
snapshot on the same table<a name="line.847"></a>
+<span class="sourceLineNo">848</span>    if (isTakingSnapshot(tableName)) {<a 
name="line.848"></a>
+<span class="sourceLineNo">849</span>      throw new 
RestoreSnapshotException("Snapshot in progress on the restore table=" + 
tableName);<a name="line.849"></a>
+<span class="sourceLineNo">850</span>    }<a name="line.850"></a>
+<span class="sourceLineNo">851</span><a name="line.851"></a>
+<span class="sourceLineNo">852</span>    // make sure we aren't running a 
restore on the same table<a name="line.852"></a>
+<span class="sourceLineNo">853</span>    if (isRestoringTable(tableName)) {<a 
name="line.853"></a>
+<span class="sourceLineNo">854</span>      throw new 
RestoreSnapshotException("Restore already in progress on the table=" + 
tableName);<a name="line.854"></a>
+<span class="sourceLineNo">855</span>    }<a name="line.855"></a>
+<span class="sourceLineNo">856</span><a name="line.856"></a>
+<span class="sourceLineNo">857</span>    try {<a name="line.857"></a>
+<span class="sourceLineNo">858</span>      long procId = 
master.getMasterProcedureExecutor().submitProcedure(<a name="line.858"></a>
+<span class="sourceLineNo">859</span>        new RestoreSnapshotProcedure(<a 
name="line.859"></a>
+<span class="sourceLineNo">860</span>          
master.getMasterProcedureExecutor().getEnvironment(), hTableDescriptor, 
snapshot),<a name="line.860"></a>
+<span class="sourceLineNo">861</span>        nonceKey);<a name="line.861"></a>
+<span class="sourceLineNo">862</span>      
this.restoreTableToProcIdMap.put(tableName, procId);<a name="line.862"></a>
+<span class="sourceLineNo">863</span>      return procId;<a 
name="line.863"></a>
+<span class="sourceLineNo">864</span>    } catch (Exception e) {<a 
name="line.864"></a>
+<span class="sourceLineNo">865</span>      String msg = "Couldn't restore the 
snapshot=" + ClientSnapshotDescriptionUtils.toString(<a name="line.865"></a>
+<span class="sourceLineNo">866</span>          snapshot)  +<a 
name="line.866"></a>
+<span class="sourceLineNo">867</span>          " on table=" + tableName;<a 
name="line.867"></a>
+<span class="sourceLineNo">868</span>      LOG.error(msg, e);<a 
name="line.868"></a>
+<span class="sourceLineNo">869</span>      throw new 
RestoreSnapshotException(msg, e);<a name="line.869"></a>
+<span class="sourceLineNo">870</span>    }<a name="line.870"></a>
+<span class="sourceLineNo">871</span>  }<a name="line.871"></a>
+<span class="sourceLineNo">872</span><a name="line.872"></a>
+<span class="sourceLineNo">873</span>  /**<a name="line.873"></a>
+<span class="sourceLineNo">874</span>   * Verify if the restore of the 
specified table is in progress.<a name="line.874"></a>
+<span class="sourceLineNo">875</span>   *<a name="line.875"></a>
+<span class="sourceLineNo">876</span>   * @param tableName table under 
restore<a name="line.876"></a>
+<span class="sourceLineNo">877</span>   * @return &lt;tt&gt;true&lt;/tt&gt; if 
there is a restore in progress of the specified table.<a name="line.877"></a>
+<span class="sourceLineNo">878</span>   */<a name="line.878"></a>
+<span class="sourceLineNo">879</span>  private synchronized boolean 
isRestoringTable(final TableName tableName) {<a name="line.879"></a>
+<span class="sourceLineNo">880</span>    Long procId = 
this.restoreTableToProcIdMap.get(tableName);<a name="line.880"></a>
+<span class="sourceLineNo">881</span>    if (procId == null) {<a 
name="line.881"></a>
+<span class="sourceLineNo">882</span>      return false;<a name="line.882"></a>
+<span class="sourceLineNo">883</span>    }<a name="line.883"></a>
+<span class="sourceLineNo">884</span>    
ProcedureExecutor&lt;MasterProcedureEnv&gt; procExec = 
master.getMasterProcedureExecutor();<a name="line.884"></a>
+<span class="sourceLineNo">885</span>    if (procExec.isRunning() &amp;&amp; 
!procExec.isFinished(procId)) {<a name="line.885"></a>
+<span class="sourceLineNo">886</span>      return true;<a name="line.886"></a>
+<span class="sourceLineNo">887</span>    } else {<a name="line.887"></a>
+<span class="sourceLineNo">888</span>      
this.restoreTableToProcIdMap.remove(tableName);<a name="line.888"></a>
+<span class="sourceLineNo">889</span>      return false;<a name="line.889"></a>
+<span class="sourceLineNo">890</span>    }<a name="line.890"></a>
+<span class="sourceLineNo">891</span><a name="line.891"></a>
+<span class="sourceLineNo">892</span>  }<a name="line.892"></a>
+<span class="sourceLineNo">893</span><a name="line.893"></a>
+<span class="sourceLineNo">894</span>  /**<a name="line.894"></a>
+<span class="sourceLineNo">895</span>   * Return the handler if it is 
currently live and has the same snapshot target name.<a name="line.895"></a>
+<span class="sourceLineNo">896</span>   * The handler is removed from the 
sentinels map if completed.<a name="line.896"></a>
+<span class="sourceLineNo">897</span>   * @param sentinels live handlers<a 
name="line.897"></a>
+<span class="sourceLineNo">898</span>   * @param snapshot snapshot 
description<a name="line.898"></a>
+<span class="sourceLineNo">899</span>   * @return null if doesn't match, else 
a live handler.<a name="line.899"></a>
+<span class="sourceLineNo">900</span>   */<a name="line.900"></a>
+<span class="sourceLineNo">901</span>  private synchronized SnapshotSentinel 
removeSentinelIfFinished(<a name="line.901"></a>
+<span class="sourceLineNo">902</span>      final Map&lt;TableName, 
SnapshotSentinel&gt; sentinels,<a name="line.902"></a>
+<span class="sourceLineNo">903</span>      final SnapshotDescription snapshot) 
{<a name="line.903"></a>
+<span class="sourceLineNo">904</span>    if (!snapshot.hasTable()) {<a 
name="line.904"></a>
+<span class="sourceLineNo">905</span>      return null;<a name="line.905"></a>
+<span class="sourceLineNo">906</span>    }<a name="line.906"></a>
+<span class="sourceLineNo">907</span><a name="line.907"></a>
+<span class="sourceLineNo">908</span>    TableName snapshotTable = 
TableName.valueOf(snapshot.getTable());<a name="line.908"></a>
+<span class="sourceLineNo">909</span>    SnapshotSentinel h = 
sentinels.get(snapshotTable);<a name="line.909"></a>
+<span class="sourceLineNo">910</span>    if (h == null) {<a 
name="line.910"></a>
+<span class="sourceLineNo">911</span>      return null;<a name="line.911"></a>
+<span class="sourceLineNo">912</span>    }<a name="line.912"></a>
+<span class="sourceLineNo">913</span><a name="line.913"></a>
+<span class="sourceLineNo">914</span>    if 
(!h.getSnapshot().getName().equals(snapshot.getName())) {<a name="line.914"></a>
+<span class="sourceLineNo">915</span>      // specified snapshot is to the one 
currently running<a name="line.915"></a>
+<span class="sourceLineNo">916</span>      return null;<a name="line.916"></a>
+<span class="sourceLineNo">917</span>    }<a name="line.917"></a>
+<span class="sourceLineNo">918</span><a name="line.918"></a>
+<span class="sourceLineNo">919</span>    // Remove from the "in-progress" list 
once completed<a name="line.919"></a>
+<span class="sourceLineNo">920</span>    if (h.isFinished()) {<a 
name="line.920"></a>
+<span class="sourceLineNo">921</span>      sentinels.remove(snapshotTable);<a 
name="line.921"></a>
+<span class="sourceLineNo">922</span>    }<a name="line.922"></a>
+<span class="sourceLineNo">923</span><a name="line.923"></a>
+<span class="sourceLineNo">924</span>    return h;<a name="line.924"></a>
+<span class="sourceLineNo">925</span>  }<a name="line.925"></a>
+<span class="sourceLineNo">926</span><a name="line.926"></a>
+<span class="sourceLineNo">927</span>  /**<a name="line.927"></a>
+<span class="sourceLineNo">928</span>   * Removes "abandoned" snapshot/restore 
requests.<a name="line.928"></a>
+<span class="sourceLineNo">929</span>   * As part of the HBaseAdmin 
snapshot/restore API the operation status is checked until completed,<a 
name="line.929"></a>
+<span class="sourceLineNo">930</span>   * and the in-progress maps are cleaned 
up when the status of a completed task is requested.<a name="line.930"></a>
+<span class="sourceLineNo">931</span>   * To avoid having sentinels staying 
around for long time if something client side is failed,<a name="line.931"></a>
+<span class="sourceLineNo">932</span>   * each operation tries to clean up the 
in-progress maps sentinels finished from a long time.<a name="line.932"></a>
+<span class="sourceLineNo">933</span>   */<a name="line.933"></a>
+<span class="sourceLineNo">934</span>  private void cleanupSentinels() {<a 
name="line.934"></a>
+<span class="sourceLineNo">935</span>    
cleanupSentinels(this.snapshotHandlers);<a name="line.935"></a>
+<span class="sourceLineNo">936</span>    cleanupCompletedRestoreInMap();<a 
name="line.936"></a>
+<span class="sourceLineNo">937</span>  }<a name="line.937"></a>
+<span class="sourceLineNo">938</span><a name="line.938"></a>
+<span class="sourceLineNo">939</span>  /**<a name="line.939"></a>
+<span class="sourceLineNo">940</span>   * Remove the sentinels that are marked 
as finished and the completion time<a name="line.940"></a>
+<span class="sourceLineNo">941</span>   * has exceeded the removal timeout.<a 
name="line.941"></a>
+<span class="sourceLineNo">942</span>   * @param sentinels map of sentinels to 
clean<a name="line.942"></a>
+<span class="sourceLineNo">943</span>   */<a name="line.943"></a>
+<span class="sourceLineNo">944</span>  private synchronized void 
cleanupSentinels(final Map&lt;TableName, SnapshotSentinel&gt; sentinels) {<a 
name="line.944"></a>
+<span class="sourceLineNo">945</span>    long currentTime = 
EnvironmentEdgeManager.currentTime();<a name="line.945"></a>
+<span class="sourceLineNo">946</span>    Iterator&lt;Map.Entry&lt;TableName, 
SnapshotSentinel&gt;&gt; it =<a name="line.946"></a>
+<span class="sourceLineNo">947</span>        
sentinels.entrySet().iterator();<a name="line.947"></a>
+<span class="sourceLineNo">948</span>    while (it.hasNext()) {<a 
name="line.948"></a>
+<span class="sourceLineNo">949</span>      Map.Entry&lt;TableName, 
SnapshotSentinel&gt; entry = it.next();<a name="line.949"></a>
+<span class="sourceLineNo">950</span>      SnapshotSentinel sentinel = 
entry.getValue();<a name="line.950"></a>
+<span class="sourceLineNo">951</span>      if (sentinel.isFinished() 
&amp;&amp;<a name="line.951"></a>
+<span class="sourceLineNo">952</span>          (currentTime - 
sentinel.getCompletionTimestamp()) &gt; SNAPSHOT_SENTINELS_CLEANUP_TIMEOUT)<a 
name="line.952"></a>
+<span class="sourceLineNo">953</span>      {<a name="line.953"></a>
+<span class="sourceLineNo">954</span>        it.remove();<a 
name="line.954"></a>
+<span class="sourceLineNo">955</span>      }<a name="line.955"></a>
+<span class="sourceLineNo">956</span>    }<a name="line.956"></a>
+<span class="sourceLineNo">957</span>  }<a name="line.957"></a>
+<span class="sourceLineNo">958</span><a name="line.958"></a>
+<span class="sourceLineNo">959</span>  /**<a name="line.959"></a>
+<span class="sourceLineNo">960</span>   * Remove the procedures that are 
marked as finished<a name="line.960"></a>
+<span class="sourceLineNo">961</span>   */<a name="line.961"></a>
+<span class="sourceLineNo">962</span>  private synchronized void 
cleanupCompletedRestoreInMap() {<a name="line.962"></a>
+<span class="sourceLineNo">963</span>    
ProcedureExecutor&lt;MasterProcedureEnv&gt; procExec = 
master.getMasterProcedureExecutor();<a name="line.963"></a>
+<span class="sourceLineNo">964</span>    Iterator&lt;Map.Entry&lt;TableName, 
Long&gt;&gt; it = restoreTableToProcIdMap.entrySet().iterator();<a 
name="line.964"></a>
+<span class="sourceLineNo">965</span>    while (it.hasNext()) {<a 
name="line.965"></a>
+<span class="sourceLineNo">966</span>      Map.Entry&lt;TableName, Long&gt; 
entry = it.next();<a name="line.966"></a>
+<span class="sourceLineNo">967</span>      Long procId = entry.getValue();<a 
name="line.967"></a>
+<span class="sourceLineNo">968</span>      if (procExec.isRunning() &amp;&amp; 
procExec.isFinished(procId)) {<a name="line.968"></a>
+<span class="sourceLineNo">969</span>        it.remove();<a 
name="line.969"></a>
+<span class="sourceLineNo">970</span>      }<a name="line.970"></a>
+<span class="sourceLineNo">971</span>    }<a name="line.971"></a>
+<span class="sourceLineNo">972</span>  }<a name="line.972"></a>
+<span class="sourceLineNo">973</span><a name="line.973"></a>
+<span class="sourceLineNo">974</span>  //<a name="line.974"></a>
+<span class="sourceLineNo">975</span>  // Implementing Stoppable interface<a 
name="line.975"></a>
+<span class="sourceLineNo">976</span>  //<a name="line.976"></a>
+<span class="sourceLineNo">977</span><a name="line.977"></a>
+<span class="sourceLineNo">978</span>  @Override<a name="line.978"></a>
+<span class="sourceLineNo">979</span>  public void stop(String why) {<a 
name="line.979"></a>
+<span class="sourceLineNo">980</span>    // short circuit<a 
name="line.980"></a>
+<span class="sourceLineNo">981</span>    if (this.stopped) return;<a 
name="line.981"></a>
+<span class="sourceLineNo">982</span>    // make sure we get stop<a 
name="line.982"></a>
+<span class="sourceLineNo">983</span>    this.stopped = true;<a 
name="line.983"></a>
+<span class="sourceLineNo">984</span>    // pass the stop onto take snapshot 
handlers<a name="line.984"></a>
+<span class="sourceLineNo">985</span>    for (SnapshotSentinel 
snapshotHandler: this.snapshotHandlers.values()) {<a name="line.985"></a>
+<span class="sourceLineNo">986</span>      snapshotHandler.cancel(why);<a 
name="line.986"></a>
+<span class="sourceLineNo">987</span>    }<a name="line.987"></a>
+<span class="sourceLineNo">988</span><a name="line.988"></a>
+<span class="sourceLineNo">989</span>    try {<a name="line.989"></a>
+<span class="sourceLineNo">990</span>      if (coordinator != null) {<a 
name="line.990"></a>
+<span class="sourceLineNo">991</span>        coordinator.close();<a 
name="line.991"></a>
+<span class="sourceLineNo">992</span>      }<a name="line.992"></a>
+<span class="sourceLineNo">993</span>    } catch (IOException e) {<a 
name="line.993"></a>
+<span class="sourceLineNo">994</span>      LOG.error("stop 
ProcedureCoordinator error", e);<a name="line.994"></a>
+<span class="sourceLineNo">995</span>    }<a name="line.995"></a>
+<span class="sourceLineNo">996</span>  }<a name="line.996"></a>
+<span class="sourceLineNo">997</span><a name="line.997"></a>
+<span class="sourceLineNo">998</span>  @Override<a name="line.998"></a>
+<span class="sourceLineNo">999</span>  public boolean isStopped() {<a 
name="line.999"></a>
+<span class="sourceLineNo">1000</span>    return this.stopped;<a 
name="line.1000"></a>
+<span class="sourceLineNo">1001</span>  }<a name="line.1001"></a>
+<span class="sourceLineNo">1002</span><a name="line.1002"></a>
+<span class="sourceLineNo">1003</span>  /**<a name="line.1003"></a>
+<span class="sourceLineNo">1004</span>   * Throws an exception if snapshot 
operations (take a snapshot, restore, clone) are not supported.<a 
name="line.1004"></a>
+<span class="sourceLineNo">1005</span>   * Called at the beginning of 
snapshot() and restoreSnapshot() methods.<a name="line.1005"></a>
+<span class="sourceLineNo">1006</span>   * @throws 
UnsupportedOperationException if snapshot are not supported<a 
name="line.1006"></a>
+<span class="sourceLineNo">1007</span>   */<a name="line.1007"></a>
+<span class="sourceLineNo">1008</span>  public void checkSnapshotSupport() 
throws UnsupportedOperationException {<a name="line.1008"></a>
+<span class="sourceLineNo">1009</span>    if (!this.isSnapshotSupported) {<a 
name="line.1009"></a>
+<span class="sourceLineNo">1010</span>      throw new 
UnsupportedOperationException(<a name="line.1010"></a>
+<span class="sourceLineNo">1011</span>        "To use snapshots, You must add 
to the hbase-site.xml of the HBase Master: '" +<a name="line.1011"></a>
+<span class="sourceLineNo">1012</span>          HBASE_SNAPSHOT_ENABLED + "' 
property with value 'true'.");<a name="line.1012"></a>
+<span class="sourceLineNo">1013</span>    }<a name="line.1013"></a>
+<span class="sourceLineNo">1014</span>  }<a name="line.1014"></a>
+<span class="sourceLineNo">1015</span><a name="line.1015"></a>
+<span class="sourceLineNo">1016</span>  /**<a name="line.1016"></a>
+<span class="sourceLineNo">1017</span>   * Called at startup, to verify if 
snapshot operation is supported, and to avoid<a name="line.1017"></a>
+<span class="sourceLineNo">1018</span>   * starting the master if there're 
snapshots present but the cleaners needed are missing.<a name="line.1018"></a>
+<span class="sourceLineNo">1019</span>   * Otherwise we can end up with 
snapshot data loss.<a name="line.1019"></a>
+<span class="sourceLineNo">1020</span>   * @param conf The {@link 
Configuration} object to use<a name="line.1020"></a>
+<span class="sourceLineNo">1021</span>   * @param mfs The MasterFileSystem to 
use<a name="line.1021"></a>
+<span class="sourceLineNo">1022</span>   * @throws IOException in case of 
file-system operation failure<a name="line.1022"></a>
+<span class="sourceLineNo">1023</span>   * @throws 
UnsupportedOperationException in case cleaners are missing and<a 
name="line.1023"></a>
+<span class="sourceLineNo">1024</span>   *         there're snapshot in the 
system<a name="line.1024"></a>
+<span class="sourceLineNo">1025</span>   */<a name="line.1025"></a>
+<span class="sourceLineNo">1026</span>  private void 
checkSnapshotSupport(final Configuration conf, final MasterFileSystem mfs)<a 
name="line.1026"></a>
+<span class="sourceLineNo">1027</span>      throws IOException, 
UnsupportedOperationException {<a name="line.1027"></a>
+<span class="sourceLineNo">1028</span>    // Verify if snapshot is disabled by 
the user<a name="line.1028"></a>
+<span class="sourceLineNo">1029</span>    String enabled = 
conf.get(HBASE_SNAPSHOT_ENABLED);<a name="line.1029"></a>
+<span class="sourceLineNo">1030</span>    boolean snapshotEnabled = 
conf.getBoolean(HBASE_SNAPSHOT_ENABLED, false);<a name="line.1030"></a>
+<span class="sourceLineNo">1031</span>    boolean userDisabled = (enabled != 
null &amp;&amp; enabled.trim().length() &gt; 0 &amp;&amp; !snapshotEnabled);<a 
name="line.1031"></a>
+<span class="sourceLineNo">1032</span><a name="line.1032"></a>
+<span class="sourceLineNo">1033</span>    // Extract cleaners from conf<a 
name="line.1033"></a>
+<span class="sourceLineNo">1034</span>    Set&lt;String&gt; hfileCleaners = 
new HashSet&lt;&gt;();<a name="line.1034"></a>
+<span class="sourceLineNo">1035</span>    String[] cleaners = 
conf.getStrings(HFileCleaner.MASTER_HFILE_CLEANER_PLUGINS);<a 
name="line.1035"></a>
+<span class="sourceLineNo">1036</span>    if (cleaners != null) 
Collections.addAll(hfileCleaners, cleaners);<a name="line.1036"></a>
+<span class="sourceLineNo">1037</span><a name="line.1037"></a>
+<span class="sourceLineNo">1038</span>    Set&lt;String&gt; logCleaners = new 
HashSet&lt;&gt;();<a name="line.1038"></a>
+<span class="sourceLineNo">1039</span>    cleaners = 
conf.getStrings(HConstants.HBASE_MASTER_LOGCLEANER_PLUGINS);<a 
name="line.1039"></a>
+<span class="sourceLineNo">1040</span>    if (cleaners != null) 
Collections.addAll(logCleaners, cleaners);<a name="line.1040"></a>
+<span class="sourceLineNo">1041</span><a name="line.1041"></a>
+<span class="sourceLineNo">1042</span>    // check if an older version of 
snapshot directory was present<a name="line.1042"></a>
+<span class="sourceLineNo">1043</span>    Path oldSnapshotDir = new 
Path(mfs.getRootDir(), HConstants.OLD_SNAPSHOT_DIR_NAME);<a 
name="line.1043"></a>
+<span class="sourceLineNo">1044</span>    FileSystem fs = 
mfs.getFileSystem();<a name="line.1044"></a>
+<span class="sourceLineNo">1045</span>    List&lt;SnapshotDescription&gt; ss = 
getCompletedSnapshots(new Path(rootDir, oldSnapshotDir));<a 
name="line.1045"></a>
+<span class="sourceLineNo">1046</span>    if (ss != null &amp;&amp; 
!ss.isEmpty()) {<a name="line.1046"></a>
+<span class="sourceLineNo">1047</span>      LOG.error("Snapshots from an 
earlier release were found under: " + oldSnapshotDir);<a name="line.1047"></a>
+<span class="sourceLineNo">1048</span>      LOG.error("Please rename the 
directory as " + HConstants.SNAPSHOT_DIR_NAME);<a name="line.1048"></a>
+<span class="sourceLineNo">1049</span>    }<a name="line.1049"></a>
+<span class="sourceLineNo">1050</span><a name="line.1050"></a>
+<span class="sourceLineNo">1051</span>    // If the user has enabled the 
snapshot, we force the cleaners to be present<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span>    // otherwise we still need to check 
if cleaners are enabled or not and verify<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span>    // that there're no snapshot in the 
.snapshot folder.<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span>    if (snapshotEnabled) {<a 
name="line.1054"></a>
+<span class="sourceLineNo">1055</span>      // Inject snapshot cleaners, if 
snapshot.enable is true<a name="line.1055"></a>
+<span class="sourceLineNo">1056</span>      
hfileCleaners.add(SnapshotHFileCleaner.class.getName());<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span>      
hfileCleaners.add(HFileLinkCleaner.class.getName());<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span><a name="line.1058"></a>
+<span class="sourceLineNo">1059</span>      // Set cleaners conf<a 
name="line.1059"></a>
+<span class="sourceLineNo">1060</span>      
conf.setStrings(HFileCleaner.MASTER_HFILE_CLEANER_PLUGINS,<a 
name="line.1060"></a>
+<span class="sourceLineNo">1061</span>        hfileCleaners.toArray(new 
String[hfileCleaners.size()]));<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span>      
conf.setStrings(HConstants.HBASE_MASTER_LOGCLEANER_PLUGINS,<a 
name="line.1062"></a>
+<span class="sourceLineNo">1063</span>        logCleaners.toArray(new 
String[logCleaners.size()]));<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span>    } else {<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span>      // Verify if cleaners are 
present<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span>      snapshotEnabled =<a 
name="line.1066"></a>
+<span class="sourceLineNo">1067</span>        
hfileCleaners.contains(SnapshotHFileCleaner.class.getName()) &amp;&amp;<a 
name="line.1067"></a>
+<span class="sourceLineNo">1068</span>        
hfileCleaners.contains(HFileLinkCleaner.class.getName());<a 
name="line.1068"></a>
+<span class="sourceLineNo">1069</span><a name="line.1069"></a>
+<span class="sourceLineNo">1070</span>      // Warn if the cleaners are 
enabled but the snapshot.enabled property is false/not set.<a 
name="line.1070"></a>
+<span class="sourceLineNo">1071</span>      if (snapshotEnabled) {<a 
name="line.1071"></a>
+<span class="sourceLineNo">1072</span>        LOG.warn("Snapshot log and hfile 
cleaners are present in the configuration, " +<a name="line.1072"></a>
+<span class="sourceLineNo">1073</span>          "but the '" + 
HBASE_SNAPSHOT_ENABLED + "' property " +<a name="line.1073"></a>
+<span class="sourceLineNo">1074</span>          (userDisabled ? "is set to 
'false'." : "is not set."));<a name="line.1074"></a>
+<span class="sourceLineNo">1075</span>      }<a name="line.1075"></a>
+<span class="sourceLineNo">1076</span>    }<a name="line.1076"></a>
+<span class="sourceLineNo">1077</span><a name="line.1077"></a>
+<span class="sourceLineNo">1078</span>    // Mark snapshot feature as enabled 
if cleaners are present and user has not disabled it.<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span>    this.isSnapshotSupported = 
snapshotEnabled &amp;&amp; !userDisabled;<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span><a name="line.1080"></a>
+<span class="sourceLineNo">1081</span>    // If cleaners are not enabled, 
verify that there're no snapshot in the .snapshot folder<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span>    // otherwise we end up with snapshot 
data loss.<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span>    if (!snapshotEnabled) {<a 
name="line.1083"></a>
+<span class="sourceLineNo">1084</span>      LOG.info("Snapshot feature is not 
enabled, missing log and hfile cleaners.");<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span>      Path snapshotDir = 
SnapshotDescriptionUtils.getSnapshotsDir(mfs.getRootDir());<a 
name="line.1085"></a>
+<span class="sourceLineNo">1086</span>      if (fs.exists(snapshotDir)) {<a 
name="line.1086"></a>
+<span class="sourceLineNo">1087</span>        FileStatus[] snapshots = 
FSUtils.listStatus(fs, snapshotDir,<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span>          new 
SnapshotDescriptionUtils.CompletedSnaphotDirectoriesFilter(fs));<a 
name="line.1088"></a>
+<span class="sourceLineNo">1089</span>        if (snapshots != null) {<a 
name="line.1089"></a>
+<span class="sourceLineNo">1090</span>          LOG.error("Snapshots are 
present, but cleaners are not enabled.");<a name="line.1090"></a>
+<span class="sourceLineNo">1091</span>          checkSnapshotSupport();<a 
name="line.1091"></a>
+<span class="sourceLineNo">1092</span>        }<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span>      }<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span>    }<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span>  }<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span><a name="line.1096"></a>
+<span class="sourceLineNo">1097</span>  @Override<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span>  public void initialize(MasterServices 
master, MetricsMaster metricsMaster) throws KeeperException,<a 
name="line.1098"></a>
+<span class="sourceLineNo">1099</span>      IOException, 
UnsupportedOperationException {<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span>    this.master = master;<a 
name="line.1100"></a>
+<span class="sourceLineNo">1101</span><a name="line.1101"></a>
+<span class="sourceLineNo">1102</span>    this.rootDir = 
master.getMasterFileSystem().getRootDir();<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span>    
checkSnapshotSupport(master.getConfiguration(), 
master.getMasterFileSystem());<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span><a name="line.1104"></a>
+<span class="sourceLineNo">1105</span>    // get the configuration for the 
coordinator<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span>    Configuration conf = 
master.getConfiguration();<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span>    long wakeFrequency = 
conf.getInt(SNAPSHOT_WAKE_MILLIS_KEY, SNAPSHOT_WAKE_MILLIS_DEFAULT);<a 
name="line.1107"></a>
+<span class="sourceLineNo">1108</span>    long timeoutMillis = 
Math.max(conf.getLong(SnapshotDescriptionUtils.SNAPSHOT_TIMEOUT_MILLIS_KEY,<a 
name="line.1108"></a>
+<span class="sourceLineNo">1109</span>                    
SnapshotDescriptionUtils.SNAPSHOT_TIMEOUT_MILLIS_DEFAULT),<a 
name="line.1109"></a>
+<span class="sourceLineNo">1110</span>            
conf.getLong(SnapshotDescriptionUtils.MASTER_SNAPSHOT_TIMEOUT_MILLIS,<a 
name="line.1110"></a>
+<span class="sourceLineNo">1111</span>                    
SnapshotDescriptionUtils.DEFAULT_MAX_WAIT_TIME));<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span>    int opThreads = 
conf.getInt(SNAPSHOT_POOL_THREADS_KEY, SNAPSHOT_POOL_THREADS_DEFAULT);<a 
name="line.1112"></a>
+<span class="sourceLineNo">1113</span><a name="line.1113"></a>
+<span class="sourceLineNo">1114</span>    // setup the default procedure 
coordinator<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span>    String name = 
master.getServerName().toString();<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span>    ThreadPoolExecutor tpool = 
ProcedureCoordinator.defaultPool(name, opThreads);<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span>    ProcedureCoordinatorRpcs comms = new 
ZKProcedureCoordinator(<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span>        master.getZooKeeper(), 
SnapshotManager.ONLINE_SNAPSHOT_CONTROLLER_DESCRIPTION, name);<a 
name="line.1118"></a>
+<span class="sourceLineNo">1119</span><a name="line.1119"></a>
+<span class="sourceLineNo">1120</span>    this.coordinator = new 
ProcedureCoordinator(comms, tpool, timeoutMillis, wakeFrequency);<a 
name="line.1120"></a>
+<span class="sourceLineNo">1121</span>    this.executorService = 
master.getExecutorService();<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span>    resetTempDir();<a 
name="line.1122"></a>
+<span class="sourceLineNo">1123</span>  }<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span><a name="line.1124"></a>
+<span class="sourceLineNo">1125</span>  @Override<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span>  public String getProcedureSignature() 
{<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span>    return 
ONLINE_SNAPSHOT_CONTROLLER_DESCRIPTION;<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span>  }<a name="line.1128"></a>
+<span class="sourceLineNo">1129</span><a name="line.1129"></a>
+<span class="sourceLineNo">1130</span>  @Override<a name="line.1130"></a>
+<span class="sourceLineNo">1131</span>  public void 
execProcedure(ProcedureDescription desc) throws IOException {<a 
name="line.1131"></a>
+<span class="sourceLineNo">1132</span>    
takeSnapshot(toSnapshotDescription(desc));<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span>  }<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span><a name="line.1134"></a>
+<span class="sourceLineNo">1135</span>  @Override<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span>  public boolean 
isProcedureDone(ProcedureDescription desc) throws IOException {<a 
name="line.1136"></a>
+<span class="sourceLineNo">1137</span>    return 
isSnapshotDone(toSnapshotDescription(desc));<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span>  }<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span><a name="line.1139"></a>
+<span class="sourceLineNo">1140</span>  private SnapshotDescription 
toSnapshotDescription(ProcedureDescription desc)<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span>      throws IOException {<a 
name="line.1141"></a>
+<span class="sourceLineNo">1142</span>    SnapshotDescription.Builder builder 
= SnapshotDescription.newBuilder();<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span>    if (!desc.hasInstance()) {<a 
name="line.1143"></a>
+<span class="sourceLineNo">1144</span>      throw new IOException("Snapshot 
name is not defined: " + desc.toString());<a name="line.1144"></a>
+<span class="sourceLineNo">1145</span>    }<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span>    String snapshotName = 
desc.getInstance();<a name="line.1146"></a>
+<span class="sourceLineNo">1147</span>    List&lt;NameStringPair&gt; props = 
desc.getConfigurationList();<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span>    String table = null;<a 
name="line.1148"></a>
+<span class="sourceLineNo">1149</span>    for (NameStringPair prop : props) 
{<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span>      if 
("table".equalsIgnoreCase(prop.getName())) {<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span>        table = prop.getValue();<a 
name="line.1151"></a>
+<span class="sourceLineNo">1152</span>      }<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span>    }<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span>    if (table == null) {<a 
name="line.1154"></a>
+<span class="sourceLineNo">1155</span>      throw new IOException("Snapshot 
table is not defined: " + desc.toString());<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span>    }<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span>    TableName tableName = 
TableName.valueOf(table);<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span>    
builder.setTable(tableName.getNameAsString());<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span>    builder.setName(snapshotName);<a 
name="line.1159"></a>
+<span class="sourceLineNo">1160</span>    
builder.setType(SnapshotDescription.Type.FLUSH);<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span>    return builder.build();<a 
name="line.1161"></a>
+<span class="sourceLineNo">1162</span>  }<a name="line.1162"></a>
+<span class="sourceLineNo">1163</span><a name="line.1163"></a>
+<span class="sourceLineNo">1164</span>  public KeyLocker&lt;String&gt; 
getLocks() {<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span>    return locks;<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span>  }<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span><a name="line.1167"></a>
+<span class="sourceLineNo">1168</span>}<a name="line.1168"></a>
 
 
 

Reply via email to