Demaq Quick Installation Overview
=================================
This is a quick overview how to install the Demaq system. See the Demaq manual
(available from http://www.demaq.net) for a more comprehensive description.

0. Install required libraries and tools, this includes:
   - Xalan-C
   - Xerces-C
   - Intel Unicode Library (ICU)
   - Autoconf
   - Automake
   - GNU or Intel C/C++ compiler
   - Java JDK 1.5 or higher (requires javac and java)
   - Boost graph library
0b. Install optional libraries and tools, these include:
   - libnewmat for spectral graph bisection in Legion distribution compiler
   - libmetis for multi-level graph partitioning in Legion distribution compiler
   - graphviz for dot-file visualization
1. Get the Demaq source code (from http://www.demaq.net) and extract it to an arbitrary directory
   (referred to as "demaq source directory" in the remainder of this overview)
2. Get a Natix version with Demaq Queuing extensions (from http://www.demaq.net) and extract it
   to an arbitrary directory (referred to as "natix source directory" in the remainder).
   IMPORTANT: Using a conventional Natix version without Demaq extensions WILL NOT WORK.
3. Create an additional directory to compiler the Demaq system
   (referred to as "demaq build directory" in the remainder of this overview)
4. Run the automake.sh script in the demaq source directory to properly create automake
   infrastructure
5. Change current directory to the demaq build directory and invoke the configure script located
   in the demaq source directory.
   - Make sure to include the /include sub-directory of natix source directory
    (and optional library includes) in the CPPFLAGS
   - Make sure to add the /lib sub-directory of the natix source directory
    (and optional libraries) in the LDFLAGS
  EXAMPLE:
/home/alex/demaq/configure CXX="gcc" CXXFLAGS="-O2 -W -Wall -Wpointer-arith -Woverloaded-virtual -Winline" CPPFLAGS="-I/home/alex/natix/include" LDFLAGS="-L/home/alex/natix/lib"
6. Compile the Demaq system by invoking make in the demaq build directory
   NOTE: If you get compiler errors complaining about missing Index-related requests in Natix
         you have a conventional Natix release without Demaq extensions (@see point 2)
7. Install Saxon (available from http://saxon.sourceforge.net/) for XQuery execution to an arbitrary
   directory. Both schema-aware and schema-agnostic versions of Saxon will work.
8. Set up environment:
  - export demaq source directory as DEMAQ_SRCDIR environment variable
    EXAMPLE: export DEMAQ_SRCDIR=/home/alex/demaq
  - add location of Natix library to LD_LIBRARY_PATH export
    EXAMPLE: export LD_LIBRARY_PATH=-$LD_LIBRARY_PATH:/home/alex/natix/lib
  - add Saxon and src/xquery subdirectory of demaq build directory to CLASSPATH
    EXAMPLE: export CLASSPATH=$CLASSPATH:/home/alex/saxon9/saxon9.jar:/home/alex/demaq_build/src/xquery/:.
9. You should now be able to use the Demaq system. If you encounter any problems during the
   installation feel free to send feedback / questions to alex@demaq.net .

-- 
Copyright 2005-2009 Demaq Development Team

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.