Configuring HCL Compass CM API logging
You can configure HCL Compass CM API logging.
About this task
HCL Compass CM API logging is controlled
by using the logging.properties
file that is associated with the JRE that runs your
application. The logging.properties
file is located in the jre\lib
directory of your JDK.
Logging is disabled by default. You should enable logging at the INFO level.
These settings result in a log file named CMLogger[#].log
,
where [#
] designates the file
rotation number. Each file is located in the HOME directory of the
logged-in user; the output rolls from file to file as each is full.
Using
the logging.properties
entries in the previous example
designates that the log records are appended to the end of the applicable
file, and each entry is stored in simple format. You must stop and
restart the application for the changes to the file to be recognized.
When a log output file is full, a new file is created and the previous file is renamed to contain the date and timestamp when the file rotation occurred. Each file holds 20 MB of data and new entries are appended to the existing entries, including across application restarts. When the log file count reaches 20, the rotation to a new file causes the oldest file to be deleted.
For more information about how to
configure Java™ logging, see
the Javadoc documentation associated with your JDK for java.util.logging.Logger
and java.util.logging.FileHandler
.
If you create a custom log properties file, you must specify the location of the file by using the -D argument. For example:
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties your_client_java_program_that_uses_CM-API