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  ⟨https://docs.ora‐
15       cle.com/javase/8/docs/api/java/util/logging/package-summary.html⟩ (JUL)
16       as the logging framework.
17
18
19       The default logging configuration is located at /usr/share/pki/etc/log‐
20       ging.properties.
21
22
23       By default only log messages with  level  WARNING  or  higher  will  be
24       logged on the console.
25
26
27              java.util.logging.ConsoleHandler.level = ALL
28              java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
29
30              java.util.logging.SimpleFormatter.format = %4$s: %5$s%6$s%n
31
32
33
34
35       For more information see the following documents:
36
37
38              • java.util.logging.ConsoleHandler            ⟨https://docs.ora‐
39                cle.com/javase/8/docs/api/java/util/logging/ConsoleHan‐
40                dler.html⟩
41
42              • java.util.logging.Level                     ⟨https://docs.ora‐
43                cle.com/javase/8/docs/api/java/util/logging/Level.html⟩
44
45              • java.util.logging.SimpleFormatter           ⟨https://docs.ora‐
46                cle.com/javase/8/docs/api/java/util/logging/SimpleFormat‐
47                ter.html⟩
48
49              • java.util.Formatter                         ⟨https://docs.ora‐
50                cle.com/javase/8/docs/api/java/util/Formatter.html⟩
51
52
53

CUSTOMIZATION

55       To  customize  the logging configuration, copy the default logging con‐
56       figuration into a new location:
57
58
59              $ cp /usr/share/pki/etc/logging.properties /etc/pki/logging.properties
60
61
62
63       Then edit the file as needed.  For example, to troubleshoot issues with
64       PKI library add the following lines:
65
66
67              netscape.level = ALL
68              com.netscape.level = ALL
69              org.dogtagpki.level = ALL
70
71
72
73       To troubleshoot issues with RESTEasy add the following line:
74
75
76              org.jboss.resteasy.level = ALL
77
78
79
80       Then  specify  the  location of the custom logging configuration in the
81       following parameter in /etc/pki/pki.conf:
82
83
84              PKI_LOGGING_CONFIG=/etc/pki/logging.properties
85
86
87
88       Then restart the application.
89
90

SEE ALSO

92       pki-server-logging(5)
93
94

AUTHORS

96       Dogtag PKI Team <devel@lists.dogtagpki.org>.
97
98

100       Copyright (c) 2016 Red Hat, Inc.  This is licensed under the  GNU  Gen‐
101       eral  Public  License,  version  2  (GPLv2).  A copy of this license is
102       available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
103
104
105
106PKI                            November 3, 2016                 pki-logging(5)
Impressum