Larissa LRS

Introduction

Larissa LRS is a free-to-use LRS implementation in progress. Its aim is to provide a free-to-use locally deployable LRS that scales well beyond the ADL Reference Implementation. The target specification is at https://github.com/adlnet/xAPI-Spec/blob/1.0.1/xAPI.md.

Requirements

Building

• JDK 7+
• Maven 3.0.4+

Deployment

• Tomcat 6.x/7.x (other containers may work)
• CouchDB 1.5.0+ (earlier versions probably will work, but testing with 1.5.0)

Building

• Run mvn package from the root of this folder.

You may run an integration-test if you have a CouchDB running at port 5984 (default CouchDB port). You do this by running the command mvn verify from the root of this folder.

Note that the commonly used command mvn install also runs the 'verify' phase. Therefore, use mvn package if you do not want this to happen.

Deployment

• Copy target/larissa-<version>.war to <Tomcat>/webapps/larissa.war.

• Add users with role 'user', e.g.

<role rolename="user"/>
<user username="larissa" password="lrstester" roles="user"/>

to <Tomcat>/conf/Tomcat-users.xml.

• First start CouchDB and then start Tomcat.

Configuration

Configurable properties are in WEB-INF/lrs.conf.

The location of the properties file is determined by the value of the context-parameter lrs.config, relative to location of the webapp folder.

xAPI Coverage

General

• no OAUth support yet

Statement API

• no support for attachments
• a StatementRef in a SubStatement will currently not respect Filter Conditions for StatementRefs when querying.
• agent query-parameter only accept Agents, not Groups
• format=ids queries only work when using filter-parameters (e.g. not statementId)
• format=canonical queries do not work

Document APIs (State, Activity Profile, Agent Profile)

• not there yet