-
Notifications
You must be signed in to change notification settings - Fork 0
Installation Guide
The client side of Rapla itself does not require any installation at all, Rapla-Client is based on Java Web Start Technology. So JAVA 8 (LTS) with Java Web Start or Java11 with Java Web Start technology provided via openwebstart.com is necessary software on the client. And on the server as well - but that's another topic. As you know, Rapla scales very well and is also suited for Client-Server-Database Installations with 100s of planning staff. But for the moment, we focus on the standalone installation where client and server components reside on the same computer:
When running Rapla in standalone mode, there is no need to install Java Web Start, because client and server can be startet directly. For further enhancements towards a Client-Server Application it is yet described here:
Although being terminated from Oracle, nowadays it's IBM Semeru which gives us excellent support for the client side of Java technology. IBM Semeru Runtimes are free production-ready binaries built with the OpenJDK class libraries, Eclipse OpenJ9 JVM and IcedTea-Web. Security patches for JAVA 8 (LTS) with Web Start are expected to be provided until May 2026 as stated from IBM on their Semeru Lifecycle page (last checked February 2022). We recommend using IBM Semeru.
Openwebstart.com (for Rapla2.0.x and higher)
There are others projects around, but one to mention is the openwebstart.com initiative. OpenWebStart is based on IcedTea-Web and follows – like IBM Semeru – the JNLP-specification. At the time of this writing it is an alternative to the above-mentioned IBM Semeru Runtimes.
With openwebstart you can either use the downloaded JVM (downloaded with the first start of Rapla2) or you can configure your Java environment manually.
Again, Java Web Start is necessary on the client side, only when working in Client-Server mode. For standalone installation Java 8 or Java 11 (Since Rapla2.0.x) is sufficiant.
Start rapla.bat (rapla.sh under Unix). If the .jar extension is associated to your Java Runtime Enviroment you can also double-click on the rapla.jar (rapla.jar is located in the lib subfolder of your binary-distribution)
Type:
rapla.sh
(Unix)
rapla.bat
(windows)
call rapla.bat
(win NT/2000)
You can also start Rapla by directly calling the java command. Change into the rapla-directory and type:
java -jar lib/common/rapla.jar
To start Rapla from the command-line, you have to set the java command in your PATH-Variable (if its not already there) Example:
setenv PATH $PATH:/usr/local/java/bin
(Unix)
set PATH=%PATH%:c:\Programme\Java\jre6\bin
(Windows)
This error happens when there is many events (data.xml > 900Ko). Before starting RAPLA, indicate a bigger maximum heap size. In the examples it is set to 500Mb:
setenv JAVA_OPTIONS "-Xmx500M"
(Unix)
set JAVA_OPTIONS=-Xmx500M
(Windows)