This is the installation-guide for a single user Rapla binary distribution

Other Installation guides:

• BuildGuide If you have downloaded the source-distribution, you must first build a binary distribution!
• TestingTheSimpsons for an example installation.
• ServerInstallation for more information about howto install a rapla server for multiuser access.
• WebappInstallation a howto on installing rapla as web-application
• DatabaseInstallation for the new experimantal sql-database support
• HtmlCalendarInstallation for displaying the week-,month-, day view via a read-only html interface.
• EmailNotificationInstallation for notification on allocation-changes for certain resources.
• LDAPAuthentication you can verify the passwords against a LDAP-server
• XMLPHPextension to export reservations in xml format and a web interface to get printer friendly outputs.

Requirements:

You need JAVA: JRE 1.4 at least (1.6 recommended). You can download it from [java.sun.com|http://java.sun.com/j2se/downloads.html]

• The SDK works for the binary and source distribution but is very large (>20 MB)
• The JRE will only work for the binary distribution (Compiler missing) but is much smaller (12MB)

---

Starting Rapla:

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

(win95/98)

call rapla.bat

(win NT/2000)

Starting rapla directly from the command-line with the java command

You can also start Rapla by directly calling the java command. Change into the rapla-directory and type:

java -jar lib/common/rapla.jar

I got the "Command not found" Error'''

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\j2re1.4.1\bin

(Windows)

I got the "java.lang.Out Of Memory Error: Java heap space" Error'''

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)

---

Making the Weekend visible

Delete the line <exclude-days>1,7</exclude-days> in rapla.xconf or raplaclient.xconf. 1 stands for sunday and 7 for saturday.

 <locale>
     ...
     <!-- This days should only be visible in the week-view, when
          there is an appointment to display.  -->
     <exclude-days>1,7</exclude-days>
  </locale>