This is an automated email from the ASF dual-hosted git repository.
mmiklavcic pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/metron.git
The following commit(s) were added to refs/heads/master by this push:
new 7219606 METRON-2212 Add debugging developer docs to hbase-server
README (mmiklavc) closes apache/metron#1481
7219606 is described below
commit 7219606fd56258c3037c73e5709f2144702fe37a
Author: mmiklavc <michael.miklav...@gmail.com>
AuthorDate: Thu Aug 22 09:44:53 2019 -0600
METRON-2212 Add debugging developer docs to hbase-server README (mmiklavc)
closes apache/metron#1481
---
metron-platform/metron-hbase-server/README.md | 27 +++++++++++++++++++++++++++
1 file changed, 27 insertions(+)
diff --git a/metron-platform/metron-hbase-server/README.md
b/metron-platform/metron-hbase-server/README.md
index a3b83e2..15874a5 100644
--- a/metron-platform/metron-hbase-server/README.md
+++ b/metron-platform/metron-hbase-server/README.md
@@ -42,3 +42,30 @@ HBase table name for the enrichments list. Defaults to
`enrichment_list`.
#### `enrichment.list.hbase.cf`
HBase table column family for the enrichments list. Defaults to `t`.
+
+## Debugging
+
+If you have trouble with a RegionServer failing to start due to a coprocessor
problem, e.g.
+```
+2019-08-13 14:37:40,793 ERROR [RS_OPEN_REGION-regionserver/node1:16020-0]
regionserver.HRegionServer: ***** ABORTING region server
node1,16020,1565707051425: The coprocessor
org.apache.metron.hbase.coprocessor.EnrichmentCoprocessor threw...
+```
+
+you may need to temporarily disable coprocessor loading while you fix the
issue.
+
+### Disabling coprocessor loading
+
+* Navigate to HBase > Config in Ambari
+* Expand the `Custom hbase-site` subpanel
+* Add the property "`hbase.coprocessor.enabled`" and set it to `false`.
**Note:** you can also use the property `hbase.coprocessor.user.enabled`
instead. From the HBase documentation:
+ > Enables or disables user (aka. table) coprocessor loading. If 'false'
(disabled), any table coprocessor attributes in table descriptors will be
ignored. If "hbase.coprocessor.enabled" is 'false' this setting has no effect.
+* Restart the HBase regionservers. You should notice a similar message to the
following in your regionserver logs.
+ ```
+ 2019-08-13 15:49:18,859 INFO [regionserver/node1:16020]
regionserver.RegionServerCoprocessorHost: System coprocessor loading is disabled
+ 2019-08-13 15:49:18,859 INFO [regionserver/node1:16020]
regionserver.RegionServerCoprocessorHost: Table coprocessor loading is disabled
+ ```
+* HBase should now start successfully
+
+#### Reference
+
+* https://hbase.apache.org/1.1/book.html#load_coprocessor_in_shell
+* https://hbase.apache.org/1.1/book.html#hbase_default_configurations
