Chapter 5. Download and Installation

5.1. Download OpenWMS.org

All versions of OpenWMS.org can you find here (http://www.openwms.org/docs/downloads.html)

Please visit the download page and download the latest version of OpenWMS.org.

5.2. Unpack and Install OpenWMS.org

Unzip the downloaded file to your harddrive.

Inside the unzipped folder you find two directories containing all the bundles that have to be installed in dmServer. Please copy all files of the bundles directory to dmServer's user repository (usually to $SERVER_HOME/repository/usr ). Within the pickup directory you find the OpenWMS.org web application that has to be copied to dmServer's hot-deployment directory (usually to $SERVER_HOME/pickup ).

$ cp bundles/* $SERVER_HOME/repository/usr
$ cp pickup/* $SERVER_HOME/pickup

In a third directory you find the license agreement files of all third party libraries that are shipped with OpenWMS.org. Please read and accepts the license agreements before using OpenWMS.org.

Last but not least, you have to tell dmServer to start all bundles listed in the OSGi Plan file org.openwms.app.plan. Therefor you must add this plan to the list of plans in dmServers config file com.springsource.kernel.userregion.properties.

Open $SERVER_HOME/config/com.springsource.kernel.userregion.properties

Scroll down to the last line in this file where the initialArtifacts are listed and add the org.openwms.app.plan file. It should looks like:

initialArtifacts=..., repository:plan/org.openwms.app.plan, ...

Without this entry dmServer will not start our bundles in the repository directory, but will start the Web Application. Due to the lack of backend services the OSGi container won't be able to resolve the service dependencies of the frontend application and will throw an exception.