Skip to content

openImaDis Logs

Nimisha Gupta edited this page Aug 16, 2016 · 1 revision

Table of Contents

openImaDis Logging

There are 3 kinds of log generated by openImaDis system.

 1. Logs generated by openImaDis server.
 2. Logs generated by worker.
 3. Logs generated by bioformats

All logs are maintained using Apache Logging Library - Log4J. The log files are never deleted by the system, however they can be deleted manually from the admin-web-interface. There is no rotation policy in maintaining log files, everyday new log file is generated and is timestamped by the date. The location where the log files are generated vary according to who generates the log.

1. openImaDis server logs

In context.xml file there is a section in which all the properties regaring the logs are specified. eg. param/LogRoot specifies the directory where the log files are generated. It is set to /data/cmms/log_storage

param/LogLevel specifies the log level like INFO, WARNING etc. It is set to INFO.

param/LogFileName specifies the prefix of the log file. The suffix of the log file will be the date followed by integer counter starting from 1. After max file size is reached new log file will be generated increamenting the counter. So name of the log file = <logfilename></logfilename><date></date><counter></counter>. The logFileName is set to avadis_iserver.txt. Example log file generated from openImaDis server is avadis_iserver_2012_10_03.13.txt

param/MaxLogSize specified the max size of individual log file. It is set to 1MB.

2. Worker logs

Worker is another java process which runs outside tomcat and serves the openImaDis server to do time consuming jobs eg. Generating movie, rebuilding the search indices etc. The properties of worker are specified in iworker.properties files.

iengine.log.dir = specifies the directory where the log files are generated. It is set to /data/cmms/log_storage

iengine.log.filename = specifies the log file prefix. Exactly like openImaDis server these log files have <logfilename></logfilename><date></date><counter></counter> nature. The worker logs prefix is set to avadis_worker_log.txt. So, similar to openImaDis server log, the example log file from worker will have name: avadis_worker_log_2012_10_03.25.txt

iengine.log.size = specifies the max size of the individual log file. It is set to 1MB.

iengine.log.level = specifies the log level. It is set to INFO.

3. Bioformat logs

The different image formats are read using bioformats imaging library. The logs generated by the bioformats library are placed in same directory where worker logs are generated. The name of bioformats log is bioformats.log<date></date>. eg. bio-formats.log.2012-10-01.