http://git-wip-us.apache.org/repos/asf/hbase-site/blob/fa1bebf8/devapidocs/src-html/org/apache/hadoop/hbase/client/HBaseHbck.html ---------------------------------------------------------------------- diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/client/HBaseHbck.html b/devapidocs/src-html/org/apache/hadoop/hbase/client/HBaseHbck.html index 370686c..2cd495b 100644 --- a/devapidocs/src-html/org/apache/hadoop/hbase/client/HBaseHbck.html +++ b/devapidocs/src-html/org/apache/hadoop/hbase/client/HBaseHbck.html @@ -26,81 +26,140 @@ <span class="sourceLineNo">018</span>package org.apache.hadoop.hbase.client;<a name="line.18"></a> <span class="sourceLineNo">019</span><a name="line.19"></a> <span class="sourceLineNo">020</span>import java.io.IOException;<a name="line.20"></a> -<span class="sourceLineNo">021</span>import org.apache.hadoop.conf.Configuration;<a name="line.21"></a> -<span class="sourceLineNo">022</span>import org.apache.hadoop.hbase.ipc.RpcControllerFactory;<a name="line.22"></a> -<span class="sourceLineNo">023</span>import org.apache.yetus.audience.InterfaceAudience;<a name="line.23"></a> -<span class="sourceLineNo">024</span>import org.slf4j.Logger;<a name="line.24"></a> -<span class="sourceLineNo">025</span>import org.slf4j.LoggerFactory;<a name="line.25"></a> -<span class="sourceLineNo">026</span>import org.apache.hbase.thirdparty.com.google.protobuf.ServiceException;<a name="line.26"></a> -<span class="sourceLineNo">027</span>import org.apache.hadoop.hbase.shaded.protobuf.RequestConverter;<a name="line.27"></a> -<span class="sourceLineNo">028</span>import org.apache.hadoop.hbase.shaded.protobuf.generated.MasterProtos.GetTableStateResponse;<a name="line.28"></a> -<span class="sourceLineNo">029</span>import org.apache.hadoop.hbase.shaded.protobuf.generated.MasterProtos.HbckService.BlockingInterface;<a name="line.29"></a> -<span class="sourceLineNo">030</span><a name="line.30"></a> -<span class="sourceLineNo">031</span><a name="line.31"></a> -<span class="sourceLineNo">032</span>/**<a name="line.32"></a> -<span class="sourceLineNo">033</span> * Use {@link ClusterConnection#getHbck()} to obtain an instance of {@link Hbck} instead of<a name="line.33"></a> -<span class="sourceLineNo">034</span> * constructing<a name="line.34"></a> -<span class="sourceLineNo">035</span> * an HBaseHbck directly. This will be mostly used by hbck tool.<a name="line.35"></a> -<span class="sourceLineNo">036</span> *<a name="line.36"></a> -<span class="sourceLineNo">037</span> * <p>Connection should be an <i>unmanaged</i> connection obtained via<a name="line.37"></a> -<span class="sourceLineNo">038</span> * {@link ConnectionFactory#createConnection(Configuration)}.</p><a name="line.38"></a> -<span class="sourceLineNo">039</span> *<a name="line.39"></a> -<span class="sourceLineNo">040</span> * <p>An instance of this class is lightweight and not-thread safe. A new instance should be created<a name="line.40"></a> -<span class="sourceLineNo">041</span> * by each thread. Pooling or caching of the instance is not recommended.</p><a name="line.41"></a> -<span class="sourceLineNo">042</span> *<a name="line.42"></a> -<span class="sourceLineNo">043</span> * @see ConnectionFactory<a name="line.43"></a> -<span class="sourceLineNo">044</span> * @see ClusterConnection<a name="line.44"></a> -<span class="sourceLineNo">045</span> * @see Hbck<a name="line.45"></a> -<span class="sourceLineNo">046</span> */<a name="line.46"></a> -<span class="sourceLineNo">047</span>@InterfaceAudience.Private<a name="line.47"></a> -<span class="sourceLineNo">048</span>public class HBaseHbck implements Hbck {<a name="line.48"></a> -<span class="sourceLineNo">049</span> private static final Logger LOG = LoggerFactory.getLogger(HBaseHbck.class);<a name="line.49"></a> -<span class="sourceLineNo">050</span><a name="line.50"></a> -<span class="sourceLineNo">051</span> private boolean aborted;<a name="line.51"></a> -<span class="sourceLineNo">052</span> private final BlockingInterface hbck;<a name="line.52"></a> -<span class="sourceLineNo">053</span><a name="line.53"></a> -<span class="sourceLineNo">054</span> private RpcControllerFactory rpcControllerFactory;<a name="line.54"></a> -<span class="sourceLineNo">055</span><a name="line.55"></a> -<span class="sourceLineNo">056</span> HBaseHbck(ClusterConnection connection, BlockingInterface hbck) throws IOException {<a name="line.56"></a> -<span class="sourceLineNo">057</span> this.hbck = hbck;<a name="line.57"></a> -<span class="sourceLineNo">058</span> this.rpcControllerFactory = connection.getRpcControllerFactory();<a name="line.58"></a> -<span class="sourceLineNo">059</span> }<a name="line.59"></a> -<span class="sourceLineNo">060</span><a name="line.60"></a> -<span class="sourceLineNo">061</span> @Override<a name="line.61"></a> -<span class="sourceLineNo">062</span> public void close() throws IOException {<a name="line.62"></a> -<span class="sourceLineNo">063</span> // currently does nothing<a name="line.63"></a> -<span class="sourceLineNo">064</span> }<a name="line.64"></a> -<span class="sourceLineNo">065</span><a name="line.65"></a> -<span class="sourceLineNo">066</span> @Override<a name="line.66"></a> -<span class="sourceLineNo">067</span> public void abort(String why, Throwable e) {<a name="line.67"></a> -<span class="sourceLineNo">068</span> this.aborted = true;<a name="line.68"></a> -<span class="sourceLineNo">069</span> // Currently does nothing but throw the passed message and exception<a name="line.69"></a> -<span class="sourceLineNo">070</span> throw new RuntimeException(why, e);<a name="line.70"></a> -<span class="sourceLineNo">071</span> }<a name="line.71"></a> -<span class="sourceLineNo">072</span><a name="line.72"></a> -<span class="sourceLineNo">073</span> @Override<a name="line.73"></a> -<span class="sourceLineNo">074</span> public boolean isAborted() {<a name="line.74"></a> -<span class="sourceLineNo">075</span> return this.aborted;<a name="line.75"></a> -<span class="sourceLineNo">076</span> }<a name="line.76"></a> -<span class="sourceLineNo">077</span><a name="line.77"></a> -<span class="sourceLineNo">078</span> /**<a name="line.78"></a> -<span class="sourceLineNo">079</span> * NOTE: This is a dangerous action, as existing running procedures for the table or regions<a name="line.79"></a> -<span class="sourceLineNo">080</span> * which belong to the table may get confused.<a name="line.80"></a> -<span class="sourceLineNo">081</span> */<a name="line.81"></a> -<span class="sourceLineNo">082</span> @Override<a name="line.82"></a> -<span class="sourceLineNo">083</span> public TableState setTableStateInMeta(TableState state) throws IOException {<a name="line.83"></a> -<span class="sourceLineNo">084</span> try {<a name="line.84"></a> -<span class="sourceLineNo">085</span> GetTableStateResponse response = hbck.setTableStateInMeta(<a name="line.85"></a> -<span class="sourceLineNo">086</span> rpcControllerFactory.newController(),<a name="line.86"></a> -<span class="sourceLineNo">087</span> RequestConverter.buildSetTableStateInMetaRequest(state));<a name="line.87"></a> -<span class="sourceLineNo">088</span> return TableState.convert(state.getTableName(), response.getTableState());<a name="line.88"></a> -<span class="sourceLineNo">089</span> } catch (ServiceException se) {<a name="line.89"></a> -<span class="sourceLineNo">090</span> LOG.debug("ServiceException while updating table state in meta. table={}, state={}",<a name="line.90"></a> -<span class="sourceLineNo">091</span> state.getTableName(), state.getState());<a name="line.91"></a> -<span class="sourceLineNo">092</span> throw new IOException(se);<a name="line.92"></a> -<span class="sourceLineNo">093</span> }<a name="line.93"></a> -<span class="sourceLineNo">094</span> }<a name="line.94"></a> -<span class="sourceLineNo">095</span>}<a name="line.95"></a> +<span class="sourceLineNo">021</span>import java.util.List;<a name="line.21"></a> +<span class="sourceLineNo">022</span>import java.util.concurrent.Callable;<a name="line.22"></a> +<span class="sourceLineNo">023</span>import java.util.stream.Collectors;<a name="line.23"></a> +<span class="sourceLineNo">024</span><a name="line.24"></a> +<span class="sourceLineNo">025</span>import org.apache.hadoop.conf.Configuration;<a name="line.25"></a> +<span class="sourceLineNo">026</span>import org.apache.hadoop.hbase.ipc.RpcControllerFactory;<a name="line.26"></a> +<span class="sourceLineNo">027</span>import org.apache.hadoop.hbase.shaded.protobuf.ProtobufUtil;<a name="line.27"></a> +<span class="sourceLineNo">028</span>import org.apache.hadoop.hbase.shaded.protobuf.RequestConverter;<a name="line.28"></a> +<span class="sourceLineNo">029</span>import org.apache.hadoop.hbase.shaded.protobuf.generated.MasterProtos;<a name="line.29"></a> +<span class="sourceLineNo">030</span>import org.apache.hadoop.hbase.shaded.protobuf.generated.MasterProtos.GetTableStateResponse;<a name="line.30"></a> +<span class="sourceLineNo">031</span>import org.apache.hadoop.hbase.shaded.protobuf.generated.MasterProtos.HbckService.BlockingInterface;<a name="line.31"></a> +<span class="sourceLineNo">032</span><a name="line.32"></a> +<span class="sourceLineNo">033</span>import org.apache.hbase.thirdparty.com.google.protobuf.ServiceException;<a name="line.33"></a> +<span class="sourceLineNo">034</span><a name="line.34"></a> +<span class="sourceLineNo">035</span>import org.apache.yetus.audience.InterfaceAudience;<a name="line.35"></a> +<span class="sourceLineNo">036</span><a name="line.36"></a> +<span class="sourceLineNo">037</span>import org.slf4j.Logger;<a name="line.37"></a> +<span class="sourceLineNo">038</span>import org.slf4j.LoggerFactory;<a name="line.38"></a> +<span class="sourceLineNo">039</span><a name="line.39"></a> +<span class="sourceLineNo">040</span><a name="line.40"></a> +<span class="sourceLineNo">041</span>/**<a name="line.41"></a> +<span class="sourceLineNo">042</span> * Use {@link ClusterConnection#getHbck()} to obtain an instance of {@link Hbck} instead of<a name="line.42"></a> +<span class="sourceLineNo">043</span> * constructing an HBaseHbck directly.<a name="line.43"></a> +<span class="sourceLineNo">044</span> *<a name="line.44"></a> +<span class="sourceLineNo">045</span> * <p>Connection should be an <i>unmanaged</i> connection obtained via<a name="line.45"></a> +<span class="sourceLineNo">046</span> * {@link ConnectionFactory#createConnection(Configuration)}.</p><a name="line.46"></a> +<span class="sourceLineNo">047</span> *<a name="line.47"></a> +<span class="sourceLineNo">048</span> * <p>NOTE: The methods in here can do damage to a cluster if applied in the wrong sequence or at<a name="line.48"></a> +<span class="sourceLineNo">049</span> * the wrong time. Use with caution. For experts only. These methods are only for the<a name="line.49"></a> +<span class="sourceLineNo">050</span> * extreme case where the cluster has been damaged or has achieved an inconsistent state because<a name="line.50"></a> +<span class="sourceLineNo">051</span> * of some unforeseen circumstance or bug and requires manual intervention.<a name="line.51"></a> +<span class="sourceLineNo">052</span> *<a name="line.52"></a> +<span class="sourceLineNo">053</span> * <p>An instance of this class is lightweight and not-thread safe. A new instance should be created<a name="line.53"></a> +<span class="sourceLineNo">054</span> * by each thread. Pooling or caching of the instance is not recommended.</p><a name="line.54"></a> +<span class="sourceLineNo">055</span> *<a name="line.55"></a> +<span class="sourceLineNo">056</span> * @see ConnectionFactory<a name="line.56"></a> +<span class="sourceLineNo">057</span> * @see ClusterConnection<a name="line.57"></a> +<span class="sourceLineNo">058</span> * @see Hbck<a name="line.58"></a> +<span class="sourceLineNo">059</span> */<a name="line.59"></a> +<span class="sourceLineNo">060</span>@InterfaceAudience.Private<a name="line.60"></a> +<span class="sourceLineNo">061</span>public class HBaseHbck implements Hbck {<a name="line.61"></a> +<span class="sourceLineNo">062</span> private static final Logger LOG = LoggerFactory.getLogger(HBaseHbck.class);<a name="line.62"></a> +<span class="sourceLineNo">063</span><a name="line.63"></a> +<span class="sourceLineNo">064</span> private boolean aborted;<a name="line.64"></a> +<span class="sourceLineNo">065</span> private final BlockingInterface hbck;<a name="line.65"></a> +<span class="sourceLineNo">066</span><a name="line.66"></a> +<span class="sourceLineNo">067</span> private RpcControllerFactory rpcControllerFactory;<a name="line.67"></a> +<span class="sourceLineNo">068</span><a name="line.68"></a> +<span class="sourceLineNo">069</span> HBaseHbck(ClusterConnection connection, BlockingInterface hbck) throws IOException {<a name="line.69"></a> +<span class="sourceLineNo">070</span> this.hbck = hbck;<a name="line.70"></a> +<span class="sourceLineNo">071</span> this.rpcControllerFactory = connection.getRpcControllerFactory();<a name="line.71"></a> +<span class="sourceLineNo">072</span> }<a name="line.72"></a> +<span class="sourceLineNo">073</span><a name="line.73"></a> +<span class="sourceLineNo">074</span> @Override<a name="line.74"></a> +<span class="sourceLineNo">075</span> public void close() throws IOException {<a name="line.75"></a> +<span class="sourceLineNo">076</span> // currently does nothing<a name="line.76"></a> +<span class="sourceLineNo">077</span> }<a name="line.77"></a> +<span class="sourceLineNo">078</span><a name="line.78"></a> +<span class="sourceLineNo">079</span> @Override<a name="line.79"></a> +<span class="sourceLineNo">080</span> public void abort(String why, Throwable e) {<a name="line.80"></a> +<span class="sourceLineNo">081</span> this.aborted = true;<a name="line.81"></a> +<span class="sourceLineNo">082</span> // Currently does nothing but throw the passed message and exception<a name="line.82"></a> +<span class="sourceLineNo">083</span> throw new RuntimeException(why, e);<a name="line.83"></a> +<span class="sourceLineNo">084</span> }<a name="line.84"></a> +<span class="sourceLineNo">085</span><a name="line.85"></a> +<span class="sourceLineNo">086</span> @Override<a name="line.86"></a> +<span class="sourceLineNo">087</span> public boolean isAborted() {<a name="line.87"></a> +<span class="sourceLineNo">088</span> return this.aborted;<a name="line.88"></a> +<span class="sourceLineNo">089</span> }<a name="line.89"></a> +<span class="sourceLineNo">090</span><a name="line.90"></a> +<span class="sourceLineNo">091</span> @Override<a name="line.91"></a> +<span class="sourceLineNo">092</span> public TableState setTableStateInMeta(TableState state) throws IOException {<a name="line.92"></a> +<span class="sourceLineNo">093</span> try {<a name="line.93"></a> +<span class="sourceLineNo">094</span> GetTableStateResponse response = hbck.setTableStateInMeta(<a name="line.94"></a> +<span class="sourceLineNo">095</span> rpcControllerFactory.newController(),<a name="line.95"></a> +<span class="sourceLineNo">096</span> RequestConverter.buildSetTableStateInMetaRequest(state));<a name="line.96"></a> +<span class="sourceLineNo">097</span> return TableState.convert(state.getTableName(), response.getTableState());<a name="line.97"></a> +<span class="sourceLineNo">098</span> } catch (ServiceException se) {<a name="line.98"></a> +<span class="sourceLineNo">099</span> LOG.debug("table={}, state={}", state.getTableName(), state.getState(), se);<a name="line.99"></a> +<span class="sourceLineNo">100</span> throw new IOException(se);<a name="line.100"></a> +<span class="sourceLineNo">101</span> }<a name="line.101"></a> +<span class="sourceLineNo">102</span> }<a name="line.102"></a> +<span class="sourceLineNo">103</span><a name="line.103"></a> +<span class="sourceLineNo">104</span> @Override<a name="line.104"></a> +<span class="sourceLineNo">105</span> public List<Long> assigns(List<String> encodedRegionNames) throws IOException {<a name="line.105"></a> +<span class="sourceLineNo">106</span> try {<a name="line.106"></a> +<span class="sourceLineNo">107</span> MasterProtos.AssignsResponse response =<a name="line.107"></a> +<span class="sourceLineNo">108</span> this.hbck.assigns(rpcControllerFactory.newController(),<a name="line.108"></a> +<span class="sourceLineNo">109</span> RequestConverter.toAssignRegionsRequest(encodedRegionNames));<a name="line.109"></a> +<span class="sourceLineNo">110</span> return response.getPidList();<a name="line.110"></a> +<span class="sourceLineNo">111</span> } catch (ServiceException se) {<a name="line.111"></a> +<span class="sourceLineNo">112</span> LOG.debug(toCommaDelimitedString(encodedRegionNames), se);<a name="line.112"></a> +<span class="sourceLineNo">113</span> throw new IOException(se);<a name="line.113"></a> +<span class="sourceLineNo">114</span> }<a name="line.114"></a> +<span class="sourceLineNo">115</span> }<a name="line.115"></a> +<span class="sourceLineNo">116</span><a name="line.116"></a> +<span class="sourceLineNo">117</span> @Override<a name="line.117"></a> +<span class="sourceLineNo">118</span> public List<Long> unassigns(List<String> encodedRegionNames) throws IOException {<a name="line.118"></a> +<span class="sourceLineNo">119</span> try {<a name="line.119"></a> +<span class="sourceLineNo">120</span> MasterProtos.UnassignsResponse response =<a name="line.120"></a> +<span class="sourceLineNo">121</span> this.hbck.unassigns(rpcControllerFactory.newController(),<a name="line.121"></a> +<span class="sourceLineNo">122</span> RequestConverter.toUnassignRegionsRequest(encodedRegionNames));<a name="line.122"></a> +<span class="sourceLineNo">123</span> return response.getPidList();<a name="line.123"></a> +<span class="sourceLineNo">124</span> } catch (ServiceException se) {<a name="line.124"></a> +<span class="sourceLineNo">125</span> LOG.debug(toCommaDelimitedString(encodedRegionNames), se);<a name="line.125"></a> +<span class="sourceLineNo">126</span> throw new IOException(se);<a name="line.126"></a> +<span class="sourceLineNo">127</span> }<a name="line.127"></a> +<span class="sourceLineNo">128</span> }<a name="line.128"></a> +<span class="sourceLineNo">129</span><a name="line.129"></a> +<span class="sourceLineNo">130</span> private static String toCommaDelimitedString(List<String> list) {<a name="line.130"></a> +<span class="sourceLineNo">131</span> return list.stream().collect(Collectors.joining(", "));<a name="line.131"></a> +<span class="sourceLineNo">132</span> }<a name="line.132"></a> +<span class="sourceLineNo">133</span><a name="line.133"></a> +<span class="sourceLineNo">134</span> @Override<a name="line.134"></a> +<span class="sourceLineNo">135</span> public List<Boolean> bypassProcedure(List<Long> pids, long waitTime, boolean force)<a name="line.135"></a> +<span class="sourceLineNo">136</span> throws IOException {<a name="line.136"></a> +<span class="sourceLineNo">137</span> MasterProtos.BypassProcedureResponse response = ProtobufUtil.call(<a name="line.137"></a> +<span class="sourceLineNo">138</span> new Callable<MasterProtos.BypassProcedureResponse>() {<a name="line.138"></a> +<span class="sourceLineNo">139</span> @Override<a name="line.139"></a> +<span class="sourceLineNo">140</span> public MasterProtos.BypassProcedureResponse call() throws Exception {<a name="line.140"></a> +<span class="sourceLineNo">141</span> try {<a name="line.141"></a> +<span class="sourceLineNo">142</span> return hbck.bypassProcedure(rpcControllerFactory.newController(),<a name="line.142"></a> +<span class="sourceLineNo">143</span> MasterProtos.BypassProcedureRequest.newBuilder().addAllProcId(pids).<a name="line.143"></a> +<span class="sourceLineNo">144</span> setWaitTime(waitTime).setForce(force).build());<a name="line.144"></a> +<span class="sourceLineNo">145</span> } catch (Throwable t) {<a name="line.145"></a> +<span class="sourceLineNo">146</span> LOG.error(pids.stream().map(i -> i.toString()).<a name="line.146"></a> +<span class="sourceLineNo">147</span> collect(Collectors.joining(", ")), t);<a name="line.147"></a> +<span class="sourceLineNo">148</span> throw t;<a name="line.148"></a> +<span class="sourceLineNo">149</span> }<a name="line.149"></a> +<span class="sourceLineNo">150</span> }<a name="line.150"></a> +<span class="sourceLineNo">151</span> });<a name="line.151"></a> +<span class="sourceLineNo">152</span> return response.getBypassedList();<a name="line.152"></a> +<span class="sourceLineNo">153</span> }<a name="line.153"></a> +<span class="sourceLineNo">154</span>}<a name="line.154"></a>
http://git-wip-us.apache.org/repos/asf/hbase-site/blob/fa1bebf8/devapidocs/src-html/org/apache/hadoop/hbase/client/Hbck.html ---------------------------------------------------------------------- diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/client/Hbck.html b/devapidocs/src-html/org/apache/hadoop/hbase/client/Hbck.html index e8e8581..74ccac7 100644 --- a/devapidocs/src-html/org/apache/hadoop/hbase/client/Hbck.html +++ b/devapidocs/src-html/org/apache/hadoop/hbase/client/Hbck.html @@ -27,35 +27,66 @@ <span class="sourceLineNo">019</span><a name="line.19"></a> <span class="sourceLineNo">020</span>import java.io.Closeable;<a name="line.20"></a> <span class="sourceLineNo">021</span>import java.io.IOException;<a name="line.21"></a> -<span class="sourceLineNo">022</span>import org.apache.hadoop.hbase.Abortable;<a name="line.22"></a> -<span class="sourceLineNo">023</span>import org.apache.hadoop.hbase.HBaseInterfaceAudience;<a name="line.23"></a> -<span class="sourceLineNo">024</span>import org.apache.yetus.audience.InterfaceAudience;<a name="line.24"></a> -<span class="sourceLineNo">025</span><a name="line.25"></a> -<span class="sourceLineNo">026</span>/**<a name="line.26"></a> -<span class="sourceLineNo">027</span> * Hbck APIs for HBase. Obtain an instance from {@link ClusterConnection#getHbck()} and call<a name="line.27"></a> -<span class="sourceLineNo">028</span> * {@link #close()} when done.<a name="line.28"></a> -<span class="sourceLineNo">029</span> * <p>Hbck client APIs will be mostly used by hbck tool which in turn can be used by operators to<a name="line.29"></a> -<span class="sourceLineNo">030</span> * fix HBase and bringging it to consistent state.</p><a name="line.30"></a> -<span class="sourceLineNo">031</span> *<a name="line.31"></a> -<span class="sourceLineNo">032</span> * @see ConnectionFactory<a name="line.32"></a> -<span class="sourceLineNo">033</span> * @see ClusterConnection<a name="line.33"></a> -<span class="sourceLineNo">034</span> * @since 2.2.0<a name="line.34"></a> -<span class="sourceLineNo">035</span> */<a name="line.35"></a> -<span class="sourceLineNo">036</span>@InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.HBCK)<a name="line.36"></a> -<span class="sourceLineNo">037</span>public interface Hbck extends Abortable, Closeable {<a name="line.37"></a> -<span class="sourceLineNo">038</span> /**<a name="line.38"></a> -<span class="sourceLineNo">039</span> * Update table state in Meta only. No procedures are submitted to open/ assign or close/<a name="line.39"></a> -<span class="sourceLineNo">040</span> * unassign regions of the table. This is useful only when some procedures/ actions are stuck<a name="line.40"></a> -<span class="sourceLineNo">041</span> * beause of inconsistency between region and table states.<a name="line.41"></a> -<span class="sourceLineNo">042</span> *<a name="line.42"></a> -<span class="sourceLineNo">043</span> * NOTE: This is a dangerous action, as existing running procedures for the table or regions<a name="line.43"></a> -<span class="sourceLineNo">044</span> * which belong to the table may get confused.<a name="line.44"></a> -<span class="sourceLineNo">045</span> *<a name="line.45"></a> -<span class="sourceLineNo">046</span> * @param state table state<a name="line.46"></a> -<span class="sourceLineNo">047</span> * @return previous state of the table in Meta<a name="line.47"></a> -<span class="sourceLineNo">048</span> */<a name="line.48"></a> -<span class="sourceLineNo">049</span> TableState setTableStateInMeta(TableState state) throws IOException;<a name="line.49"></a> -<span class="sourceLineNo">050</span>}<a name="line.50"></a> +<span class="sourceLineNo">022</span>import java.util.List;<a name="line.22"></a> +<span class="sourceLineNo">023</span><a name="line.23"></a> +<span class="sourceLineNo">024</span>import org.apache.hadoop.hbase.Abortable;<a name="line.24"></a> +<span class="sourceLineNo">025</span>import org.apache.hadoop.hbase.HBaseInterfaceAudience;<a name="line.25"></a> +<span class="sourceLineNo">026</span>import org.apache.yetus.audience.InterfaceAudience;<a name="line.26"></a> +<span class="sourceLineNo">027</span><a name="line.27"></a> +<span class="sourceLineNo">028</span>/**<a name="line.28"></a> +<span class="sourceLineNo">029</span> * Hbck fixup tool APIs. Obtain an instance from {@link ClusterConnection#getHbck()} and call<a name="line.29"></a> +<span class="sourceLineNo">030</span> * {@link #close()} when done.<a name="line.30"></a> +<span class="sourceLineNo">031</span> * <p>WARNING: the below methods can damage the cluster. For experienced users only.<a name="line.31"></a> +<span class="sourceLineNo">032</span> *<a name="line.32"></a> +<span class="sourceLineNo">033</span> * @see ConnectionFactory<a name="line.33"></a> +<span class="sourceLineNo">034</span> * @see ClusterConnection<a name="line.34"></a> +<span class="sourceLineNo">035</span> * @since 2.2.0<a name="line.35"></a> +<span class="sourceLineNo">036</span> */<a name="line.36"></a> +<span class="sourceLineNo">037</span>@InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.HBCK)<a name="line.37"></a> +<span class="sourceLineNo">038</span>public interface Hbck extends Abortable, Closeable {<a name="line.38"></a> +<span class="sourceLineNo">039</span> /**<a name="line.39"></a> +<span class="sourceLineNo">040</span> * Update table state in Meta only. No procedures are submitted to open/assign or<a name="line.40"></a> +<span class="sourceLineNo">041</span> * close/unassign regions of the table.<a name="line.41"></a> +<span class="sourceLineNo">042</span> * @param state table state<a name="line.42"></a> +<span class="sourceLineNo">043</span> * @return previous state of the table in Meta<a name="line.43"></a> +<span class="sourceLineNo">044</span> */<a name="line.44"></a> +<span class="sourceLineNo">045</span> TableState setTableStateInMeta(TableState state) throws IOException;<a name="line.45"></a> +<span class="sourceLineNo">046</span><a name="line.46"></a> +<span class="sourceLineNo">047</span> /**<a name="line.47"></a> +<span class="sourceLineNo">048</span> * Like {@link Admin#assign(byte[])} but 'raw' in that it can do more than one Region at a time<a name="line.48"></a> +<span class="sourceLineNo">049</span> * -- good if many Regions to online -- and it will schedule the assigns even in the case where<a name="line.49"></a> +<span class="sourceLineNo">050</span> * Master is initializing (as long as the ProcedureExecutor is up). Does NOT call Coprocessor<a name="line.50"></a> +<span class="sourceLineNo">051</span> * hooks.<a name="line.51"></a> +<span class="sourceLineNo">052</span> * @param encodedRegionNames Region encoded names; e.g. 1588230740 is the hard-coded encoding<a name="line.52"></a> +<span class="sourceLineNo">053</span> * for hbase:meta region and de00010733901a05f5a2a3a382e27dd4 is an<a name="line.53"></a> +<span class="sourceLineNo">054</span> * example of what a random user-space encoded Region name looks like.<a name="line.54"></a> +<span class="sourceLineNo">055</span> */<a name="line.55"></a> +<span class="sourceLineNo">056</span> List<Long> assigns(List<String> encodedRegionNames) throws IOException;<a name="line.56"></a> +<span class="sourceLineNo">057</span><a name="line.57"></a> +<span class="sourceLineNo">058</span> /**<a name="line.58"></a> +<span class="sourceLineNo">059</span> * Like {@link Admin#unassign(byte[], boolean)} but 'raw' in that it can do more than one Region<a name="line.59"></a> +<span class="sourceLineNo">060</span> * at a time -- good if many Regions to offline -- and it will schedule the assigns even in the<a name="line.60"></a> +<span class="sourceLineNo">061</span> * case where Master is initializing (as long as the ProcedureExecutor is up). Does NOT call<a name="line.61"></a> +<span class="sourceLineNo">062</span> * Coprocessor hooks.<a name="line.62"></a> +<span class="sourceLineNo">063</span> * @param encodedRegionNames Region encoded names; e.g. 1588230740 is the hard-coded encoding<a name="line.63"></a> +<span class="sourceLineNo">064</span> * for hbase:meta region and de00010733901a05f5a2a3a382e27dd4 is an<a name="line.64"></a> +<span class="sourceLineNo">065</span> * example of what a random user-space encoded Region name looks like.<a name="line.65"></a> +<span class="sourceLineNo">066</span> */<a name="line.66"></a> +<span class="sourceLineNo">067</span> List<Long> unassigns(List<String> encodedRegionNames) throws IOException;<a name="line.67"></a> +<span class="sourceLineNo">068</span><a name="line.68"></a> +<span class="sourceLineNo">069</span> /**<a name="line.69"></a> +<span class="sourceLineNo">070</span> * Bypass specified procedure and move it to completion. Procedure is marked completed but<a name="line.70"></a> +<span class="sourceLineNo">071</span> * no actual work is done from the current state/step onwards. Parents of the procedure are<a name="line.71"></a> +<span class="sourceLineNo">072</span> * also marked for bypass.<a name="line.72"></a> +<span class="sourceLineNo">073</span> *<a name="line.73"></a> +<span class="sourceLineNo">074</span> * @param pids of procedures to complete.<a name="line.74"></a> +<span class="sourceLineNo">075</span> * @param waitTime wait time in ms for acquiring lock for a procedure<a name="line.75"></a> +<span class="sourceLineNo">076</span> * @param force if force set to true, we will bypass the procedure even if it is executing.<a name="line.76"></a> +<span class="sourceLineNo">077</span> * This is for procedures which can't break out during execution (bugs?).<a name="line.77"></a> +<span class="sourceLineNo">078</span> * @return true if procedure is marked for bypass successfully, false otherwise<a name="line.78"></a> +<span class="sourceLineNo">079</span> */<a name="line.79"></a> +<span class="sourceLineNo">080</span> List<Boolean> bypassProcedure(List<Long> pids, long waitTime, boolean force) throws IOException;<a name="line.80"></a> +<span class="sourceLineNo">081</span>}<a name="line.81"></a> http://git-wip-us.apache.org/repos/asf/hbase-site/blob/fa1bebf8/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.InitializationMonitor.html ---------------------------------------------------------------------- diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.InitializationMonitor.html b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.InitializationMonitor.html index 27235ad..e5feb84 100644 --- a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.InitializationMonitor.html +++ b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.InitializationMonitor.html @@ -1202,8 +1202,8 @@ <span class="sourceLineNo">1194</span> // Page will talk about loss of edits, how to schedule at least the meta WAL recovery, and<a name="line.1194"></a> <span class="sourceLineNo">1195</span> // then how to assign including how to break region lock if one held.<a name="line.1195"></a> <span class="sourceLineNo">1196</span> LOG.warn("{} is NOT online; state={}; ServerCrashProcedures={}. Master startup cannot " +<a name="line.1196"></a> -<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined; operator intervention required. " +<a name="line.1197"></a> -<span class="sourceLineNo">1198</span> "Schedule an assign.", ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> +<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined.",<a name="line.1197"></a> +<span class="sourceLineNo">1198</span> ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> <span class="sourceLineNo">1199</span> // Check once-a-minute.<a name="line.1199"></a> <span class="sourceLineNo">1200</span> if (rc == null) {<a name="line.1200"></a> <span class="sourceLineNo">1201</span> rc = new RetryCounterFactory(1000).create();<a name="line.1201"></a> http://git-wip-us.apache.org/repos/asf/hbase-site/blob/fa1bebf8/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.MasterStoppedException.html ---------------------------------------------------------------------- diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.MasterStoppedException.html b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.MasterStoppedException.html index 27235ad..e5feb84 100644 --- a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.MasterStoppedException.html +++ b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.MasterStoppedException.html @@ -1202,8 +1202,8 @@ <span class="sourceLineNo">1194</span> // Page will talk about loss of edits, how to schedule at least the meta WAL recovery, and<a name="line.1194"></a> <span class="sourceLineNo">1195</span> // then how to assign including how to break region lock if one held.<a name="line.1195"></a> <span class="sourceLineNo">1196</span> LOG.warn("{} is NOT online; state={}; ServerCrashProcedures={}. Master startup cannot " +<a name="line.1196"></a> -<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined; operator intervention required. " +<a name="line.1197"></a> -<span class="sourceLineNo">1198</span> "Schedule an assign.", ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> +<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined.",<a name="line.1197"></a> +<span class="sourceLineNo">1198</span> ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> <span class="sourceLineNo">1199</span> // Check once-a-minute.<a name="line.1199"></a> <span class="sourceLineNo">1200</span> if (rc == null) {<a name="line.1200"></a> <span class="sourceLineNo">1201</span> rc = new RetryCounterFactory(1000).create();<a name="line.1201"></a> http://git-wip-us.apache.org/repos/asf/hbase-site/blob/fa1bebf8/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.RedirectServlet.html ---------------------------------------------------------------------- diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.RedirectServlet.html b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.RedirectServlet.html index 27235ad..e5feb84 100644 --- a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.RedirectServlet.html +++ b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.RedirectServlet.html @@ -1202,8 +1202,8 @@ <span class="sourceLineNo">1194</span> // Page will talk about loss of edits, how to schedule at least the meta WAL recovery, and<a name="line.1194"></a> <span class="sourceLineNo">1195</span> // then how to assign including how to break region lock if one held.<a name="line.1195"></a> <span class="sourceLineNo">1196</span> LOG.warn("{} is NOT online; state={}; ServerCrashProcedures={}. Master startup cannot " +<a name="line.1196"></a> -<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined; operator intervention required. " +<a name="line.1197"></a> -<span class="sourceLineNo">1198</span> "Schedule an assign.", ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> +<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined.",<a name="line.1197"></a> +<span class="sourceLineNo">1198</span> ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> <span class="sourceLineNo">1199</span> // Check once-a-minute.<a name="line.1199"></a> <span class="sourceLineNo">1200</span> if (rc == null) {<a name="line.1200"></a> <span class="sourceLineNo">1201</span> rc = new RetryCounterFactory(1000).create();<a name="line.1201"></a> http://git-wip-us.apache.org/repos/asf/hbase-site/blob/fa1bebf8/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.TableDescriptorGetter.html ---------------------------------------------------------------------- diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.TableDescriptorGetter.html b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.TableDescriptorGetter.html index 27235ad..e5feb84 100644 --- a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.TableDescriptorGetter.html +++ b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.TableDescriptorGetter.html @@ -1202,8 +1202,8 @@ <span class="sourceLineNo">1194</span> // Page will talk about loss of edits, how to schedule at least the meta WAL recovery, and<a name="line.1194"></a> <span class="sourceLineNo">1195</span> // then how to assign including how to break region lock if one held.<a name="line.1195"></a> <span class="sourceLineNo">1196</span> LOG.warn("{} is NOT online; state={}; ServerCrashProcedures={}. Master startup cannot " +<a name="line.1196"></a> -<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined; operator intervention required. " +<a name="line.1197"></a> -<span class="sourceLineNo">1198</span> "Schedule an assign.", ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> +<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined.",<a name="line.1197"></a> +<span class="sourceLineNo">1198</span> ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> <span class="sourceLineNo">1199</span> // Check once-a-minute.<a name="line.1199"></a> <span class="sourceLineNo">1200</span> if (rc == null) {<a name="line.1200"></a> <span class="sourceLineNo">1201</span> rc = new RetryCounterFactory(1000).create();<a name="line.1201"></a> http://git-wip-us.apache.org/repos/asf/hbase-site/blob/fa1bebf8/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.html ---------------------------------------------------------------------- diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.html b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.html index 27235ad..e5feb84 100644 --- a/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.html +++ b/devapidocs/src-html/org/apache/hadoop/hbase/master/HMaster.html @@ -1202,8 +1202,8 @@ <span class="sourceLineNo">1194</span> // Page will talk about loss of edits, how to schedule at least the meta WAL recovery, and<a name="line.1194"></a> <span class="sourceLineNo">1195</span> // then how to assign including how to break region lock if one held.<a name="line.1195"></a> <span class="sourceLineNo">1196</span> LOG.warn("{} is NOT online; state={}; ServerCrashProcedures={}. Master startup cannot " +<a name="line.1196"></a> -<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined; operator intervention required. " +<a name="line.1197"></a> -<span class="sourceLineNo">1198</span> "Schedule an assign.", ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> +<span class="sourceLineNo">1197</span> "progress, in holding-pattern until region onlined.",<a name="line.1197"></a> +<span class="sourceLineNo">1198</span> ri.getRegionNameAsString(), rs, optProc.isPresent());<a name="line.1198"></a> <span class="sourceLineNo">1199</span> // Check once-a-minute.<a name="line.1199"></a> <span class="sourceLineNo">1200</span> if (rc == null) {<a name="line.1200"></a> <span class="sourceLineNo">1201</span> rc = new RetryCounterFactory(1000).create();<a name="line.1201"></a>
