Running The Server

PF/Tijah runs on a light database backend: MonetDB. To get started, you have to start the MonetDB server and load the Pathfinder module (of course you first have to install the system, see Download). If your run PF/Tijah under Windows, you start the server via the start menu on the task bar (Start -> MonetDB -> MonetDB XQuery Server). In unix-based systems, open a terminal window and type:

  Mserver --dbinit="module(pathfinder);"

Depending on your hardware and installation, you get get a report similar to the following. (Read the MonetDB/XQuery documentation if the server does not start properly.) If you have not used MonetDB/XQuery before, it is also recommended to take a short look at the MonetDB/XQuery first steps page.

  # MonetDB Server v4.36.4
  # based on GDK   v1.36.4
  # Copyright (c) 1993-July 2008, CWI. All rights reserved.
  # Copyright (c) August 2008-2010, MonetDB B.V.. All rights reserved.
  # Compiled for i686-pc-linux-gnu/32bit with 32bit OIDs; dynamically linked.
  # Detected 994.543 MiB (1042853888 bytes) main-memory.
  # Visit http://monetdb.cwi.nl/ for further information.
  # PF/Tijah module v0.13.0 loaded. http://dbappl.cs.utwente.nl/pftijah
  # MonetDB/XQuery module v0.36.4 loaded (default back-end is 'algebra')
  # XRPC administrative console at http://127.0.0.1:50001/admin

Warnings like the following: !WARNING: GDKlockHome: created directory /local/MonetDB/ etc. are normal: the server creates an empty database if you run it for the first time. Let's assume the file test.xq contains the following query:

  <test> { for $i in (1, 2, 3) return $i } </test>

Under windows, you can run XQuery statements by double clicking the test.xq file, which opens the query results in your web browser. Alternatively, you can open a DOS command prompt window and operate the system as done in Unix-based systems described next: Open another terminal window and type (please note that in versions before 0.20.0, mclient is called MapiClient):

  mclient -lxquery test.xq 

resulting in

  <test>1 2 3</test>

You now can go on using the system as described in the Getting started.