= General Questions = === What is Rapla? === A software tool for distributed planning the schedules of resources or persons. === Do I need a server for Rapla? === You will only need a server in multiuser mode. For more information about server-setup consult README.txt. === Do I need a database for Rapla? === No, Rapla stores all information in a xml-file. You can however use a database to store the xml-fragments for better scalability and to take advantage of the transaction and backup mechanisms provided by your Database. === How can I use Rapla? === Get the latest binary from the download-section and follow the instructions in INSTALL.txt. === What is the difference between the binary and the webapp distribution? === The webapp distribution is recomended for multiuser access. It comes with a small servlet-container ( thats in short a web-server for java-applications) and runs out of the box when you launch rapla-webapp. Point your browser to http://localhost:8051/ to launch the clients. You can also use html-read only views with this version. For more information see Webapp-Installation. === Where can I get the latest (probably unstable) development sources? === You can checkout the latest version with the following commands: {{{ svn co https://rapla.svn.sourceforge.net/svnroot/rapla/trunk rapla }}} Anonymous checkout means, that you have read-only access to the repository. If you want to contribute to the project, contact rapla-developers@lists.sourceforge.net For more information about sourceforge svn-access click here === Can I change the size of the granularity of the timscale from 15 minutes to another granularity? === You can change them in the options menu under calendar === I've first experimented with the standalaon-version and now want to change to the webapp version. How can I reuse my existing data? === Make sure the server is stopped. After that replace the file webapp/WEB-INF/data.xml with the data.xml of your standalone version and restart the server. === The apache-license is not compatible with the GNU-license. Why can you link Rapla with apache-libraries? === There is a statement in the COPYRIGHT-NOTICE of each source-file, that gives you the permission to link the program with every library, wich license fulfills the Open Source Definition as published by the Open Source Initiative (OSI). (we asked someone at gnu.org for that statement). === Can I build Rapla without ant in my favourite IDE? === We encourage the use of Ant, if you however can't or dont't want to use Ant in your IDE then you have to pay attention to following points: * Include the needed libraries into your Classpath. What libraries are needed to compile Rapla depends on your JDK and what features of rapla you want to use. * The Starting class is org.rapla.Main (for normal use) and org.rapla.gui.RaplaApplet (for the Applet) * pass the location of rapla.xconf as an Argument upon starting Rapla e.g. java org.rapla.Main -c rapla.xconf * You will need to generate the resource-files manually. See RaplaResource.xml for more info. * The server start class is org.rapla.MainServer === How do I install the Rapla-server as a win2000/NT service? === You will need a native service wrapper. wrapper.sourceforge.net is a possible solution. Include the requiered libraries into the wrapper.conf file. You find a sample installation rapla-nt-service.zip in the download section ---- = Troubleshooting = === I've downloaded Rapla but can't login after starting, the logins on your site don't work? === Rapla starts per default with a minimum data-file: data.xml. The only possible login is admin (empty password). To use the simpsons-samples file follow the instructions in INSTALL.txt. === Admin is a default user at all times. === This is the default for single-user single-computer. If you want to use multiple logins you have to modify rapla.xconf: {{{ }}} There will still be no password check (see next question). === Rapla doesn't check my password. I can enter anything! === Rapla is probably configured to work on a local file-storage. On local files password checking makes no sense. If you configure Rapla for multiuser mode passwords will be validated. See README.txt and Server Installation === Under Windows after calling build.bat or start.bat I got the message "command or filename not found." === That means: The java command was not found. Make sure Java was properly installed and the java command is on your path. Set java in your PATH (if its not already there) e.g.: {{{ set PATH=%PATH%;c:\Programme\Java\j2re1.4\bin }}} To make this a permanent change {{{ under Windows 95/98 add the line to autoexec.bat under NT/2000 modify PATH in the Enviroment-Dialog in the System-Properties. }}} === Under Unix after calling build.sh or rapla.sh I got the message "Command not found." === Same as above, add java to your path, e.g. {{{ export PATH=$PATH:/usr/local/java/bin }}} or set JAVA_HOME (see the next question) === Under Unix after calling build.sh or rapla.sh I got the message "cannot find class java/lang/Thread". === If JAVA_HOME is not set rapla.sh guesses it by invoking {{{ which java }}} Type {{{ java -version }}} to show your default java version. Rapla needs at least Java 1.3 to run Rapla. (1.4.1 is recommended and looks much +better). You can try to set JAVA_HOME to the java 2 installation before calling Rapla (See next question). === I got the message "You must set JAVA_HOME to point at your Java Development Kit installation". === This is done under Windows from the Commandline with the SET command e.g. set JAVA_HOME=c:\Programme\your_java_vendor\ Under unix use {{{ export JAVA_HOME=/usr/local/your_java_vendor }}} Note: A Java Runtime Enviroment is not sufficent, because it doesn't include a Compiler. To make this a permanent change {{{ under Windows 95/98 add the line to autoexec.bat under NT/2000 modify/create the JAVA_HOME entry in the Enviroment-Dialog in the System-Properties. }}} === When starting the raplaserver or raplawebapp I get a long stacktrace-output with "Caused by: java.net.BindException: Could not bind to port 8051" somewhere hidden between the lines. === This means that either another jetty 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. === Windows 98 tells me that I don't have enough Environment- Memory. === This is another neat feature from DOS-times. 'build.sh' uses as little enviroment-space as possible to avoid this message. If it still occures its an indication that your environment-memory was already full before. To increase memory add the following line to your config.sys (and restart) {{{ shell=c:\command.com /E:4096 /P }}} === I've got an compilation-error with the latest CVS-Version. === To prune emtpy dirs and create new ones try the following cvs options: {{{ cvs update -P -d }}} To clean up the build run {{{ build clean }}} before compilation. If compilation still fails send a mail to our mailing-list. === I have a dual monitor and Rapla doesn't scroll on my second monitor. === This is a known issue with java. Please use the first monitor for displaying the main view. You can use the second for the appointments. === I have a question not addresed by the FAQ. Where do I get more information? === Post your question or feature-request to the Rapla-Mailinglist