You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by gg...@apache.org on 2017/07/04 06:00:08 UTC

karaf git commit: [KARAF-5116] Updating documentation related to karaf.log.console property

Repository: karaf
Updated Branches:
  refs/heads/karaf-4.1.x ec5dc8592 -> d111d7f22


[KARAF-5116] Updating documentation related to karaf.log.console property


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

Branch: refs/heads/karaf-4.1.x
Commit: d111d7f22b7221228beec612a443c670e113e1fa
Parents: ec5dc85
Author: Grzegorz Grzybek <gr...@gmail.com>
Authored: Tue Jul 4 07:57:20 2017 +0200
Committer: Grzegorz Grzybek <gr...@gmail.com>
Committed: Tue Jul 4 07:59:56 2017 +0200

----------------------------------------------------------------------
 manual/src/main/asciidoc/user-guide/log.adoc | 26 +++++++++++++++++++++++
 1 file changed, 26 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/karaf/blob/d111d7f2/manual/src/main/asciidoc/user-guide/log.adoc
----------------------------------------------------------------------
diff --git a/manual/src/main/asciidoc/user-guide/log.adoc b/manual/src/main/asciidoc/user-guide/log.adoc
index 1ab1b72..664a3f5 100644
--- a/manual/src/main/asciidoc/user-guide/log.adoc
+++ b/manual/src/main/asciidoc/user-guide/log.adoc
@@ -160,6 +160,32 @@ A default configuration in `etc/log4j2.xml` could be:
 </Configuration>
 ----
 
+==== `karaf.log.console` property
+
+Before Karaf starts _proper_ logging facilities (pax-logging), it may configure `java.util.logging`. Standard
+Java logging is used initially by `Main` class and `org.apache.karaf.main.lock.Lock` implementations.
+In order to configure logging level, please set system property `karaf.log.console` to one of standard JUL
+levels:
+
+* `SEVERE` (highest value)
+* `WARNING`
+* `INFO`
+* `CONFIG`
+* `FINE`
+* `FINER`
+* `FINEST`  (lowest value)
+
+For example, setting `karaf.log.console` to `INFO` (or lower) will turn on these logs when starting Karaf:
+
+[source,options="nowrap"]
+----
+Jul 04, 2017 7:53:18 AM org.apache.karaf.main.Main launch
+INFO: Installing and starting initial bundles
+Jul 04, 2017 7:53:18 AM org.apache.karaf.main.Main launch
+INFO: All initial bundles installed and set to start
+...
+----
+
 ==== Commands
 
 Instead of changing the `etc/org.ops4j.pax.logging.cfg` file, Apache Karaf provides a set of commands allowing to