1pki-logging(5)         PKI Common Logging Configuration         pki-logging(5)
2
3
4

NAME

6       pki-logging - PKI Common Logging Configuration
7
8

LOCATION

10       /usr/share/pki/etc/logging.properties, /etc/pki/logging.properties
11
12

DESCRIPTION

14       PKI clients and tools use java.util.logging (JUL) as the logging frame‐
15       work   (see    https://docs.oracle.com/javase/8/docs/api/java/util/log
16       ging/package-summary.html).
17
18       The default logging configuration is located at /usr/share/pki/etc/log‐
19       ging.properties.
20
21       By default only log messages with  level  WARNING  or  higher  will  be
22       logged on the console.
23
24
25              java.util.logging.ConsoleHandler.level = ALL
26              java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
27              java.util.logging.SimpleFormatter.format = %4$s: %5$s%6$s%n
28
29              .level = WARNING
30              .handlers = java.util.logging.ConsoleHandler
31
32       For more information see the following documents:
33
34       - https://docs.oracle.com/javase/8/docs/api/java/util/logging/ConsoleHandler.html
35       - https://docs.oracle.com/javase/8/docs/api/java/util/logging/Level.html
36       - https://docs.oracle.com/javase/8/docs/api/java/util/logging/SimpleFormatter.html
37       - https://docs.oracle.com/javase/8/docs/api/java/util/Formatter.html
38
39

CUSTOMIZATION

41       To  customize  the logging configuration, copy the default logging con‐
42       figuration into a new location:
43
44       $ cp /usr/share/pki/etc/logging.properties /etc/pki/logging.properties
45
46       Then edit the file as needed.  For example, to troubleshoot issues with
47       PKI library add the following lines:
48
49
50              netscape.level = ALL
51              com.netscape.level = ALL
52              org.dogtagpki.level = ALL
53
54       To troubleshoot issues with RESTEasy add the following line:
55
56
57              org.jboss.resteasy.level = ALL
58
59       Then  specify  the  location of the custom logging configuration in the
60       following parameter in /etc/pki/pki.conf:
61
62
63              LOGGING_CONFIG=/etc/pki/logging.properties
64
65       Then restart the application.
66
67

AUTHORS

69       Dogtag Team <pki-devel@redhat.com>.
70
71
73       Copyright (c) 2016 Red Hat, Inc. This is licensed under the GNU General
74       Public  License, version 2 (GPLv2). A copy of this license is available
75       at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
76
77

SEE ALSO

79       pki-server-logging(5)
80
81
82
83version 10.3                   November 3, 2016                 pki-logging(5)
Impressum