1. Introduction

This installation guide describes one way to set up a linux test environment with Demaq EDU. This is obviously not the only way, but it is a fairly useful way for testing purposes, because you will work with a Virtual Machine, that you can completely mess up without affecting your common hosting system. Also it is as easy as copy and paste to backup or restore the whole virtual system.

2. Setting up a Virtual Machine

2.1 Overview

This chapter will walk you through the setup of a Virtual Machine with Suse Linux 10. Feel free to skip it if you already have a Linux Machine up and running.

2.2 Creating a virtual machine

  1. Go to http://www.easyvmx.com/easyvmx.shtml.
  2. required settings (The 4 green fields):
  1. recommendations:
  1. click create virtual machine and download the yourName.zip, that you can unzip in <VMX_PATH>

2.3 Get SuSE Linux 10

  1. Go to http://de.opensuse.org/Stabile_Version#Herunterladen.
  2. choose the x86 DVD version (File is ending on *.iso)
  3. as this is an 3.5 GB download consider to use Free Download Manager (http://www.freedownloadmanager.org). ) or a similar tool

2.4 Get Daemon Tools (optional)

Daemon Tools is a virtual cd/dvd-rom emulator which makes it possible to start the SuSE Linux iso-file directly from your Harddisc. ( If you prefer burning the image on a dvd, go that way: http://isorecorder.alexfeinman.com/isorecorder.htm).

  1. Go to http://www.daemon-tools.cc
  2. click on downloads and download the latest Daemon tools version
  3. install daemon tools and start it
  4. right click on the red lightning icon in the taskbar
  5. choose Virtual CD/DVD-ROM > Device 0 > MountImage
  6. browse to the location of the SUSE-Linux-10.1-Remastered-DVD-i386.iso and double click on it
  7. Try to find out which drive letter your new virtual DVD-ROM drive has (look it up in My Computer for example)
  8. Open the .vmx-file in your <VMX_PATH> with wordpad
  9. find the part “# Settings for physical CDROM drive” and change the filename key to the drive-letter of your virtual DVD-ROM drive (e.g.: ide1:0.fileName = "G:")

2.5 Get VMWare Player

The VMWare Player is the emulator for your Linux testing environment. It emulates a fully qualified Computer, on which you will install Linux.

  1. Go to http://www.vmware.com/de/products/player 
  2. download the latest VMware Player version
  3. install VMware Player 
  4. double click on the vmx file from section 2.2
  5. The SuSe Linux installation process should start

3. Installing Demaq EDU

3.1 Install the Demaq EDU base package

Extract the Demaq EDU package to a directory where you have read, write and execute access rights. If you are unsure, just use /home/yourusername/demaqedu .
Next, set the XFROGGER_HOME environment variable to this directory. Don't forget to "export" the variable by typing "export XFROGGER_HOME".
We suggest you edit the .profile file in the /etc directory accordingly.


3.2 Install additional packages

 Use your distribution's packet manager to install the following packets if they are not already present


3.3 (optional) Compile the web-service server application and other utilities

cd bin
run compile_server.sh
run compile_writefile.sh
run compile_xpath.sh

Test the installation

run from the demaq EDU home directory:
sh ./check_prerequisites.sh

Contact information

Homepage of the Demaq project : http://www.demaq.net

E-Mail (please replace "-at-" with "@")

Dennis Knochenwefel: demaq-at-knochenwefel.de
Martin Kremer: demaq-at-martin-kremer.de


Mannheim, June 2007