The webapp distribution:

Rapla webapp installation is very easy: Download the binary-distribution or BuildGuide one with "build dist-bin".

You can start it with: 

raplaserver.bat

(Windows) 

raplaserver.sh run

(Unix)

With a running server point your browser to http://localhost:8051

to see if the server is running: http://localhost:8051/server should print: 

Server running

You can login with username "admin" and empty password

Thats it.

Install as NTService

If you want to install Rapla-Server as a SERVICE on Win NT/2000/XP download rapla-nt-service-x.x.zip from our download section.

Installing into another servlet container

Tomcat-Postgresql-Installation

jboss-Postgresql-Installation

If you want to use another servlet container (e.g. tomcat) you can copy the webapp (without s) folder to the webapps (with s) folder of your servlet container and rename webapp (without s) to rapla. See the documentation of your servelt-container for more details

Installing in Apache or IIS

You can install Jetty with apache or IIS by uncommenting the AJP13 listener in jetty/conf/main.xml

For an example installation with apache see ApacheJettyRaplaInstallation

Troubleshooting:

  1. The most commen error will be long stacktrace with

Caused by: java.net.BindException: Could not bind to port 8050 somewhere hidden between the lines. This means that either another rapla server is running (so stop or kill this process) or that this port is blocked by another application. You need to configure another the port in raplaclient.xconf and raplaserver.xconf.

  1. With jetty there is also a second port conflict which results in 
    [1]=java.net.BindException: Address already in use

Same as above: change in jetty/conf/main.xml the port 8051 

  <Call name="addListener">
    <Arg>
      <New class="org.mortbay.http.SocketListener">
        <Set name="Port"><SystemProperty name="jetty.port" default="8051"/></Set>
  1. if you have a firewall, open the port 8051. 8051 will display the HTML-Page, the applet and the webapp-executable, and 8050 will be used to communicate between the webapp resp. the applet and the server.
  1. look in the troubleshooting faq under http://rapla.sourceforge.net/doc/troublefaq.html
  1. Download the binary distribution and check if it works.