Permalink
Cannot retrieve contributors at this time
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?
2015rapla/rapla/README-Server.txt
Go to fileThis commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
153 lines (113 sloc)
4.9 KB
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 | |