# Release Notes - Longhorn @version@, @date@

- Overview
- Requirements and Installation
- Support

## Overview

Longhorn is a server application that allows you to run pipelines using various pre-defined configurations.

This distribution contains:

- The Java .war file to instal on your application server, including a simple Web client.
- A .jar file with a client library for Java programs.

The source code for this package is hosted in the Okapi Framework project.

See the Longhorn wiki page for more information.

## Requirements and Installation

### Requirements

- Java Application Server with Java 1.6 or later

### Installation

To install Longhorn:

1. Deploy `okapi-longhorn.war` on your application server
2. Set up a working directory. Create `${user.dir}/okapi-longhorn-configuration.xml` pointing to the directory where temporary data can be stored:

       <?xml version="1.0" encoding="utf-8"?>
       <okapi-longhorn-configuration version="1">
       	<working-directory>/etc/okapi/longhorn/workspace</working-directory>
       </okapi-longhorn-configuration>

3. Test if the HTML client is available: http://localhost/okapi-longhorn/okapi-longhorn-sample-js-client.html (you may have to add the port or change the hostname)

### Uninstallation

To un-install Longhorn:

1. Un-deploy `okapi-longhorn.war`
2. Delete the working directory

## Support

If you have questions, suggestions or bugs to report, you can do this different ways:

- Read and post notes in the Okapi Tools users group (you need to be registered member to post, but not to read).
- Read an post issue reports on the Google Code project site.