Installing Muralog

Muradoralog is a java application which is responsible for collecting the statistics information of fedora access and store into a database. The statistics information is pre-generated by MuraPEP and stored in a plain file. It should be deployed on the server which the fedora and MurePEP are deployed on.

Prerequisites

  • Sun JDK 1.5.x
  • Apache Ant 1.5.1 or later
  • PostgreSQL 8.1

Instructions

  • Create a database in PostgreSQL to store the statistics information if it is not existing. For example:

CREATE DATABASE "muradoralog" WITH ENCODING='SQL_ASCII' OWNER="fedoraAdmin";

  • Download muradoralog from http://drama.ramp.org.au/software/
  • Configuration
    1. Modify muradoralog.properties under the directory src to configure datasource parameters and the path of statistics file.By default, the statistics file will be found out in tomcat/logs/statistics.log.
    2. Modify mymanifest.mf to specify the libraries in the classpath if needed.
  • Usage Under the root directory of the package there are some commands you can use:
    1. #ant run This command will compile, package and execute the program in one go.
    2. #ant jar T his command will generate an executable jar package called muradoralog.jar.
    3. #java -jar muradoralog.jar This command will execute the jar package generated from above. Note: by default, to make it find the needed libraries, you must run it under the directory which has a subdirectory lib. Otherwise you need to edit mymanifest.mf for the classpath or specify the classpath by some other ways.
    4. #ant clean This command will clean all generated stuff.
    5. To make it automated process at predefined time intervals, you can setup a cron job. For example:

0 0 * * * /path/muradoralog/java -jar muradoralog.jar

This means that the job will be executed at middle night everyday.

Back to Deployment Guides