Usage Tracker Installation

System requirements

Java runtime environment (openjdk) Apache Tomcat version 5.0 or higher

Download

Binaries of the Usage Tracker are available in .deb and .rpm format. Packages can be downloaded from:

http://resources.venus-c.eu/accounting/deb/venusc-mab-usagetracker-2.0.0-latest.deb http://resources.venus-c.eu/accounting/rpm/venusc-mab-usagetracker-2.0.0-latest.noarch.rpm

Install

Once you've downloaded the package format suitable for your system, the Usage Tracker can be installed by running:

dpkg -i venusc-mab-usagetracker-«version».deb

or

rpm -i venusc-mab-usagetracker-«version».noarch.rpm

Prerequisites

The Usage Tracker adopts a document-oriented database (MongoDB in the current implementation) to persist records. A running instance of MongoDB is expected by the Usage Tracker. The instance can either run on the local machine or a remote one.

Configuration

Configuration of the usage tracker is entirely property-file-based. The pre-defined location for configuration files is /opt/venus-c/etc/. Two configuration files are expected by the usage tracker: /opt/venus-c/etc/venusc-mab-usagetracker.properties /opt/venus-c/etc/venusc-mab-usagetracker-log4j.properties The first one provides connection parameters (e.g. location, db name, username, password) for the records database. The second one just configures logging facilities.

You should disable the Usage Tracker internal security by editing the first configuration file in this way:

authn.enabled = false authz.enabled = false

Deploying the Usage Tracker in Tomcat

The service should be deployed automatically during installation. However, in case of trouble or manual (un)deployment, it can be done by:

copying the context file (i.e. /opt/venus-c/etc/usagetracker.xml) to /etc/tomcat«ver»/conf/Catalina/localhost/
make sure Tomcat is up and running

Testing your installation

Connect to http://<deployhost>:8080/usagetracker/rest/usagerecords you should get an empty XML result: <rawUsagerecords/>