Dividing Problems and finding Log Files

Don't Panic

If users report a problem, always start by dividing it: Verify if the problems exists at all.

Also take a note when the problem occurred (ideally when the user had it and when you reproduced it), so you can reduce the amount of log data you have to analyze.

Once it's sure there is a problem, narrow it down. Never ever forget about basics like cables, network connectivity, DHCP servers, DNS, and especially firewalls and proxies.

Once it seems clear where the problem lies, read the log files. Carefully. Twice. Again.

osgi-runner log file: osgi.log

osgi-runner only uses one log file: osgi.log.

In Windows installations you find it in the log\ subdirectory of the osgi-runner installation directory, i.e. usually C:\Program Files\osgi-runner\log resp. /var/log/osgi-runner/osgi.log.

Configuring logging details like log levels

Log levels can be changed editing osgi-runner's config file adm.d/org.ops4j.pax.logging.cfg, which directly configures osgi-runber's Log4J.

For instance, to extend the logging of the login services to DEBUG, add these lines:

# all login parts
log4j.logger.org.clazzes.login=DEBUG

# LDAP/ADS login parts
log4j.logger.org.clazzes.login.ldap=DEBUG

This configuration file also allows to configure the name of the log file, the rotation pattern, and so on.