The Ontodella server README-file $Id: INSTALL,v 1.1 2004/03/18 14:53:32 kimvilja Exp $ This readme file describes how to get started and get more information about the Ontodella server. 0. BEFORE GETTING STARTED The Ontodella server is created in the following environment and using the following software: * tested on PentiumIII 2.6GHz with 1GB RAM * a Linux operating system, including the system tools * tar * sh - shell interpreter * SWI-Prolog interpreter (http://www.swi-prolog.org) * (optional) servlet engine (tested on Apache Tomcat 4.x) Other operating systems and software may or may not be compatible with the Ontodella server. 1. GETTING STARTED Ungzip and untar the ontodella-[date].tar.gz file (where [date] is the date of the distribution, eg., 20031203) by typing the following command line command (in Linux or similar): tar -zxvf ontodella-[date].tar.gz This will explode the tar archive in a directory structure as follows: /ontodella-[date] /ontodella-[date]/bin /ontodella-[date]/conf /ontodella-[date]/data /ontodella-[date]/src/prolog /ontodella-[date]/src/perl /dist-[date]/doc ... Move to the ontodella-[date] -directory by typing: cd ontodella-[date] To start the Prolog-based Ontodella server, you must have the SWI-Prolog interpreter installed in to your system. You can get the SWI-Prolog from http://www.swi-prolog.org/. When you have installed SWI-Prolog you should be able to start the interactive prolog interface by typing 'pl' (or including the path, e.g., /home/myhome/prolog/bin/pl ). When prolog is installed, you should create a configuration file .ontodella in your $HOME directory. Use ontodella.sample as an example. Open the $HOME/.ontodella file in to your editor, e.g., emacs. Change the values of the following variables, if needed: * ONTODELLA_HOME -- should contain the path to the ontodella directory. * PROLOG -- should contain the start command (and path, if needed) of the prolog interpreter. * PLPARAMS -- parameters for the prolog interpreter such as how much memory the prolog interpreter may use. See more information from the swi-prolog documentation (http://www.swi-prolog.org). Save the changes and exit the editor. Make the bin/*.sh scripts executable by typing the following command (when located in the ontodella-[date] -directory): chmod u+x bin/*.sh 2. RUNNING THE SERVER 2.1 TEST MODE Start the ontodella server by typing: bin/run-onto.sh The Ontodella Prolog-based http-server should now be up and running, listening on the port displayed during the startup sequence (e.g., 31332). You can stop the server by typing "halt.", e.g., ?- halt. The server should now have been stopped. 2.2 PRODUCTION MODE You may want to run the server using a screen, so that you can detach the process from your current terminal. To run ontogator in a screen, type: bin/screen-run-onto.sh 2.3 CREATING CATEGORIES FOR ONTOGATOR You may want to create "Ontogator categories" for the Ontogator navigator module created as a part of the MuseumFinland system. The categories can be created by running the following script: bin/run-cache_categories.sh Please notice, that the creation of the categories can be very slow and can take up to 8 hours to complete on a fast PentiumIII/2.5GHz/1GB RAM -type machine. 3. DOCUMENTATION All documents are located in the "doc" directory. For information about installation, please read the "installation-manual.ps" (PostScript) or "installation-manual.pdf" (PDF). --------------------------------------------------------------------- Copyright (c) Semantic Computing Research Group, 2002-2004. http://www.cs.helsinki.fi/group/seco/