Skip to end of metadata
Go to start of metadata

When KIM is started, all the activity is recorded in the log files contained in the <KIM_HOME>/log folder. The web interface puts its messages to the servlet container's logs (for Apache Tomcat they are located in <TOMCAT_HOME>/logs). If you experience trouble running KIM, these logs should be your primary source for getting information about what happened. In case KIM crashes, has shutdown issues, or severe functional problems, you should increase the logging level of KIM in order to isolate the issue. You can control the amount of details in the KIM logs by modifying the configuration file <KIM_HOME>/config/logback.xml.
For KIM versions up to 3.0 modify the log4j file <KIM_HOME>/config/log.prop.

Log modes Description
INFO The default KIM logging level
TRACE
The most detailed logging mode available.
DEBUG
Designates fine-grained informational events that are most useful to debug an application.
WARN
Designates potentially harmful situations.
ERROR
Designates error events that might still allow the application to continue running.
FATAL
Records only errors of application crashes.

For more information about logging options, please see the log4j 1.2 documentation.

Using DEBUG or TRACE modes can sometimes lead to big logs with size of many gigabytes. We recommend that you use DEBUG mode only to collect more detailed information about your problem and then switch back to INFO mode.

Sometimes the logs may not help to solve the problems you might experience with KIM. In that case, after you isolate a scenario reproducing the problem, please follow the procedure below to collect and send us the full logging information.

1. Stop KIM.
2. Enable DEBUG logging of KIM by changing the line

to

in the KIM section of <KIM_HOME>/config/log.prop

Please keep in mind that KIM performance will be significantly reduced in DEBUG mode.

3. Archive and then delete the contents of the <KIM_HOME>/log folder.
4. Open the servlet container log folder, archive and delete its content
5. Start KIM.
6. Execute the scenario leading to the problem.
7. Stop KIM.
8. Collect the following logs:

  • The contents of the <KIM_HOME>/log folder.
  • The console output of KIM.

On Linux, start KIM with

. This will put the console output in <KIM_HOME>/bin/nohup.out .

  • The console output or any other scripts used in the tests - tools/populate, tools/rdf etc.
  • The contents of the servlet container log folder.

9. Zip and send them to kim-discussion@ontotext.com.

When debugging a shutdown issue of KIM, start from step 7.

For KIM version 3.7, in order to enable the DEBUG mode you need to change all WARN values to DEBUG in the <KIM_HOME>/config/logback.xml file.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.