HBASE-20347 [DOC] upgrade section should warn about logging changes

Project: http://git-wip-us.apache.org/repos/asf/hbase/repo
Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/732c31e0
Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/732c31e0
Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/732c31e0

Branch: refs/heads/HBASE-19064
Commit: 732c31e0416afc35366086f19e26f84569a3b43c
Parents: 281c29f
Author: Michael Stack <st...@apache.org>
Authored: Wed Apr 11 15:32:55 2018 -0700
Committer: Michael Stack <st...@apache.org>
Committed: Wed Apr 11 15:34:44 2018 -0700

----------------------------------------------------------------------
 src/main/asciidoc/_chapters/upgrading.adoc | 12 ++++++++++++
 1 file changed, 12 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hbase/blob/732c31e0/src/main/asciidoc/_chapters/upgrading.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/_chapters/upgrading.adoc 
b/src/main/asciidoc/_chapters/upgrading.adoc
index 67c5dbc..0c7edcc 100644
--- a/src/main/asciidoc/_chapters/upgrading.adoc
+++ b/src/main/asciidoc/_chapters/upgrading.adoc
@@ -430,6 +430,18 @@ The following metrics have been added:
 
 * 'totalRowActionRequestCount' is a count of region row actions summing reads 
and writes.
 
+[[upgrade2.0.logging]]
+.Changed logging
+HBase-2.0.0 now uses link:https://www.slf4j.org/[slf4j] as its logging 
frontend.
+Prevously, we used link:http://logging.apache.org/log4j/1.2/[log4j (1.2)].
+For most the transition should be seamless; slf4j does a good job interpreting
+_log4j.properties_ logging configuration files such that you should not notice
+any difference in your log system emissions.
+
+That said, your _log4j.properties_ may need freshening. See 
link:https://issues.apache.org/jira/browse/HBASE-20351[HBASE-20351]
+for example, where a stale log configuration file manifest as netty 
configuration
+being dumped at DEBUG level as preamble on every shell command invocation.
+
 [[upgrade2.0.zkconfig]]
 .ZooKeeper configs no longer read from zoo.cfg
 

Reply via email to