Building the Exam Server

runtime requirements

  • JDK at least version 1.5
  • maven 2.1.0+ to build the project
  • tomcat 5.5+ installation

Setting the environment

The following environment variables have to be set in the file /home/user/.profile

export LANG=de_DE@euro.UTF-8

Download the examServer

We use SVN to get a copy of the working directory:
-# svn co https://elateportal.svn.sourceforge.net/svnroot/elateportal/trunk/examServer

Settings

  1. Go to the directory where you downloaded the examServer
  2. copy build.properties.sample to build.properties
  3. edit {tomcat-path}/conf/server.xml file
    1. at element server change attribute to an unused port e.g. 8006
    2. add attribute address="127.0.0.1" to restrict unsecure access to localhost only. DO NOT remove this connector, this breaks the pdf bulk export feature...
    3. uncomment the SSL Connecter element
      set also to an unused port e.g. 8443
    4. add the following attributes to the connector element (be sure that is the SSL connector element)
      • scheme="https"
      • secure="true"
      • sslProtocol="TLS"
      • clientAuth="true"
      • truststoreFile="conf/server.truststore"
      • truststorePass="*******"
      • emptySessionPath="true"
      • useBodyEncodingForURI="false"
      • URIEncoding="UTF-8"

  4. add to {tomcat-path/bin/catalina.{sh|bat}}:
    • {set|export} CATALINA_OPTS=-Dcom.sun.management.jmxremote
    • {set|export} CATALINA_OPTS="-server -Xmx786m -XX:MaxPermSize=256m"

  5. make sure you have already recent copies of the taskmodel artifacts (taskmodel-core, taskmodel-api, taskmodel-core-view), if not:
    1. Checkout the taskmodel sources: svn co http://elateportal.svn.sourceforge.net/svnroot/elateportal/trunk/taskmodel
    2. cd taskmodel
    3. mvn install to install all taskmodel artifacts
    4. cd taskmodel-core-view
    5. mvn install -PdeployTomcat -Dtomcat.path=/path/to/your/tomcat to deploy the view web application
  6. Now we deploy the webapp examServer.
    Execute this command in the examServer source directory:
    -mvn install -PdeployTomcat -Dtomcat.path=/path/to/your/tomcat
    - startup tomcat: # ~/tomcat/bin/startup.sh

Running the Exam Server

Check if you fulfill following points

  • You need the client certificate to authenticate yourself to the examserver
  • The exact URL to the examServer
  • initial user/password: admin/admin

Additional

If you use images in the complex-task-definition than

  • put the images under tomcat/webapps/ROOT/
  • in the definition use <img src=/<image></img>

Install new client certificats

  • get client-server-certs.zip and unpack
  • need functional ant install
  • edit build.xml to your needs, save
  • run ant cer2pkcs12 to get self-signed-certificat
  • after successful build you got
    • client.p12 for import to browser and java
    • server.truststore put to $TOMCAT_HOME/conf/
  • edit $TOMCAT_HOME/conf/server.xml and put following attributs to your https connector as above