Prerequisites

  • Have a PostgreSQL 7.x database available (http://www.postgresql.org). In theory other databases like Oracle or MySQL could be used as well. OLR uses a database to store the RDF descriptions of courses.

Getting OLR

  • Download a binary or source archive
  • Unpack the archive at a place of your choice refered as OLR_HOME

Installing the binary version

Installing the source version

Prerequisites

  • Make sure you have Maven 1.x installed (http://maven.apache.org)
  • If you run the OLR build the first time, you will need an internet connection so that Maven can download dependency packages from remote repositories.

Build

Installing as web application

  • Download the OLR war file distribution.
  • Copy it to your servlet engines/appservers (web) application directory refered as WEBAPP_DIR.
  • Restart the servlet engine/application server if needed
  • Edit [WEBAPP_DIR]/olr/WEB_INF/Torque.properties and set the right JDBC connection url

The OLR application will be mounted as [WEBAPP_CONTEXT]/olr where WEBAPP_CONTEXT is the URl prefix of the used web application container i.e. Tomcat, Jetty or JBoss.

NOTE: Sometimes you need to move [WEBAPP_CONTEXT]/lib/postgresql-7.4-jdbc3.jar to another file and back. A restart of the OLR web application is also required. To do that, simply restart your application server.

Setting up the database

In order to run OLR a database like PostgreSQL (or maybe others) is needed. You should create a database and an appropriate database user for the OLR application.

Prepare PostgreSQL database

Create a database user.

NOTE: On some systems you need to be logged in as user "postgres".
createuser olr

Create the database

createdb -O olr -E UNICODE olr

-O specifies the user who owns the database named olr. For more information on PostgreSQL databases see the PostgeSQL documentation at http://www.postgresql.org/docs/.

Create database tables and initial data

In order to create the OLR database tables and intial data you need to define the right jdbc database connection settings in the file OLR_HOME/target/conf/Torque.properties.

Now switch to the OLR installation directory or to one of the build directories like target/ and run

ant

Good luck :)

Running OLR

After you have installed the binary or source version of OLR you can start OLR as follows.

cd OLR_HOME/target/bin
./run

The OLR System is by default accessible loading the URL http://localhost:8002 in a web browser.

If OLR runs within an seperate servlet container OLR can be accessed via the URL http://servletconatiner:port/olr where servletconatiner and port need to be replaced by values appropriate to the environment of the used servlet container.

Once the start page is loaded you can log into the OLR system using the login name admin and password olr.

It is recommended to change the administrator password shown above as soon as possible.

Building Eclipse project files

Extending OLR using Eclipse is easy since the build system generates an Eclipse project for OLR. Just go to the directory OLR_HOME and execute the command

maven eclipse

In order to use OLR within Eclipse, create a new java project in Eclipse and choose the OLR root directory as project directory.

NOTE: Generating the Eclipse project while Eclipse is opened might cause the project to get out of synch. In that case you need to refresh the project after an Ant run i.e. by "right clicking" on the project and choosing "refresh".

Thanks for using OLR.