LoFiMo Documentation
Installation
LoFiMo is written in Java. To run it needs an installed JRE (Java Runtime Environment) or JDK (Java Development Kit) version 1.5.0 (aka J2SE 5.0) which can be downloaded here.
To install LoFiMo extract the archive to whereever you want LoFiMo to reside.
Edit the configuration file lofimo.cfg and the cascading style sheet lofimo.css to fit your needs.
Under unix make sure the file permissions of the run script allow execution (run "chmod +x run").
Configuration
By default LoFiMo reads its configuration from the file lofimo.cfg. The configuration file consists of these sections:
- Main section
- Log section
- Output section
- Input section
- Filter section
In the configuration file styles can be assigned which have to be entered in the cascading style sheet lofimo.css. There's also a number of built in styles LoFiMo uses which must be present in the style sheet. A description of the built in styles can be found here.
Running
Change to the location where lofimo.jar and the run-script reside and execute the script (by typing ./run under unix or run under windows).
If you are not using a run script LoFiMo can be started by typing e.g. java -jar lofimo.jar
Once LoFiMo is started use your web browser to connect to it. The URL consists of the machine name on which LoFiMo is running and the port that was set in the configuration.
If LoFiMo is running on the same machine as the web browser and the port has not been changed in the configuration use the URL http://127.0.0.1:6543 or http://localhost:6543.
General
In the configuration file LoFiMo is assigned multiple inputs i.e. log files. From each line read from an input a log entry is created. A log entry is a single line LoFiMo displays. Log entries can be manipulated by filters.
For each input multiple filters can be assigned.
In live mode LoFiMo displays the log entries as soon as they are read from inputs. In page mode a predefined number of log entries is shown per page and the list of available log entries is devided into pages through which the user can flip.
In both modes a small menu is displayed from which the mode can be changed. From this menu it is also possible to reload the page or start a re-initializiation during which LoFiMo reloads the configuration file. Thus it is possible to configure new inputs and filters while LoFiMo is running. The style sheet is reloaded every time it is changed i.e. there's no need to reinit for changes in the CSS to take affect.