Skip to content
Permalink
master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
 
 
Cannot retrieve contributors at this time
This README is for running Rapla as server. You will find more information on our
documentation pages on
http://code.google.com/p/rapla/
The Rapla server:
---------------------------
Download the binary-distribution or build one with "build dist-bin"
You can start it with:
raplaserver.bat (Windows)
raplaserver.sh run (Unix)
If you want to install Rapla-Server as a SERVICE on Win NT/2000/XP/Vista/7 or linux
use the scripts in the service/bin folder to test/install/uninstall rapla as a service.
You can also try the script service/bin/TestWrapper instead of raplaserver if it fails
because java command is not found.
With a running server point your browser to
http://localhost:8051
You should see the rapla welcome screen. Click on start with webstart
and the webstart client should launch. If not launched automatically,
you should choose the webstart program from your
java installation (e.g. C:\Program Files (x86)\Java\jre7\bin\javaws.exe under Windows).
You can login with username "admin" and empty password
Thats it.
Installing into another servlet container
-----------------------------------------
If you want to use another servlet container (e.g. tomcat) you can
copy the rapla.war in the webapps folder to the webapps folder of
your servlet container.
You need to set a jndi entry jdbc/rapladb in the servlet container if you are using a database
or resource/raplafile if you are using the file, see contexts/rapla.xml for the setting in jetty.
See the documentation of your servelt-container for more details about how to set both entries from contexts/rapla.xml
in the container of your choice.
Installing in Apache or IIS
----------------------------
You can install Jetty with apache or IIS by adding
the AJP13 listener in etc/jetty.xml.
See http://www.eclipse.org/jetty/ for more information
Troubleshooting:
----------------
1. The most commen error will be long stacktrace with
"Caused by: java.net.BindException: Could not bind to port 8051"
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 etc/jetty.xml
<Call name="addConnector">
<Arg>
<New class="org.eclipse.jetty.server.nio.SelectChannelConnector">
<Set name="port"><SystemProperty name="jetty.port" default="8051"/></Set>
2. look in the troubleshooting faq under http://code.google.com/p/rapla/
3. Post a question to rapla-developers@lists.sourceforge.net
Running Multiple Rapla servers:
-------------------------------
There is no Problem running multiple rapla servers on one computer. You just need to copy the contexts/rapla entry folder and rename it to another name and edit the entries
Considering the original rapla.xml
<Set name="contextPath">/</Set>
<New id="raplafile" class="org.eclipse.jetty.plus.jndi.EnvEntry">
<Arg></Arg>
<Arg>raplafile</Arg>
<Arg type="java.lang.String"><SystemProperty name="jetty.home" default="." />/data/data.xml</Arg>
<Arg type="boolean">true</Arg>
</New>
<New id="rapladb" class="org.eclipse.jetty.plus.jndi.Resource">
<Arg>jdbc/rapladb</Arg>
<Arg>
<New class="org.hsqldb.jdbc.JDBCDataSource">
<Set name="Url">jdbc:hsqldb:data/rapla-hsqldb</Set>
<Set name="User">db_user</Set>
<Set name="Password">your_pwd</Set>
</New>
</Arg>
</New>
<New id="rapladatasource" class="org.eclipse.jetty.plus.jndi.EnvEntry">
<Arg></Arg>
<Arg>rapladatasource</Arg>
<!--
<Arg type="java.lang.String">rapladb</Arg>
-->
<Arg type="java.lang.String">raplafile</Arg>
<Arg type="boolean">true</Arg>
</New>
If you want a second instance running on a different context. e.g. secondRapla.xml
<Set name="contextPath">/secondRapla</Set>
<New id="raplafile" class="org.eclipse.jetty.plus.jndi.EnvEntry">
<Arg></Arg>
<Arg>raplafile</Arg>
<Arg type="java.lang.String"><SystemProperty name="jetty.home" default="." />/data/secondRapla_data.xml</Arg>
<Arg type="boolean">true</Arg>
</New>
<New id="rapladb" class="org.eclipse.jetty.plus.jndi.Resource">
<Arg>jdbc/rapladb</Arg>
<Arg>
<New class="org.hsqldb.jdbc.JDBCDataSource">
<Set name="Url">jdbc:hsqldb:data/secondRapla-hsqldb</Set>
<Set name="User">db_user</Set>
<Set name="Password">your_pwd</Set>
</New>
</Arg>
</New>
<New id="rapladatasource" class="org.eclipse.jetty.plus.jndi.EnvEntry">
<Arg></Arg>
<Arg>rapladatasource</Arg>
<!--
<Arg type="java.lang.String">rapladb</Arg>
-->
<Arg type="java.lang.String">raplafile</Arg>
<Arg type="boolean">true</Arg>
</New>
Now you should have two applications running
http://localhost:8051/
http://localhost:8051/secondRapla/
Acknowledgment
---------------
Rapla includes free software developed from other organizations and third parties.
For a complete list of all external libraries, take a look at legal/readme.txt