Program: qios
File: README
Author: I.Savnik
Date: 01/10/07


OVERVIEW

Qios is a system for the manipulation of data from Internet data
sources. It is intended to serve as the lightware kernel of the
Internet data server. The system currently provides the interface for
XML. The treatment of other data formats requires addition of the
interface routines for the conversion of data into internal database
format.

INSTALLATION

-- Qios was tested with Perl version 5.6.0 but version 5.003 should 
   also be ok. The Perl programming language can usually be found on 
   all Unix stations. The latest version of Perl for Unix is available at 
   <http://www.perl.com/>. 

   Perl for Windows OS is available at 
   <http://aspn.activestate.com/ASPN/Downloads/ActivePerl/>. 

-- Install Berkeley DB available from <http://www.sleepycat.com/download.html>. 
   Alternatively Berkeley DB is available also at 
   <http://www.perl.com/CPAN-local/src/misc/>.

   Some Linux OS-s (eg. RedHat Linux) have included version 1 of 
   Berkeley DB in their distributions. 
   If you are running IRIX, then get Berkeley DB version 1
   from <http://reality.sgi.com/ariel>.

-- DB_File module is Perl interface for Berkeley DB (v1,v2 or v3).
   It is normaly provided together with Perl distribution but it can be 
   also obtained at 
   <http://www.perl.com/CPAN-local/modules/by-module/DB_File/>.
   Qios was tested with DB_File v1.76.

-- Install the latest versions of the following Perl modules (paths are 
   relative to CPAN directory eg. <http://www.perl.com/CPAN-local/> or,
   better, at the nearest CPAN archive): 

   libwww-perl </modules/by-module/LWP/libwww-perl-x.xx.tar.gz> <5.47>
   XML::Parser </modules/by-module/XML/XML-Parser-x.xx.tar.gz> <2.27>
   HTML::Parser </modules/by-module/HTML/HTML-Parser-3.25.tar.gz> <3.03>
   libnet </modules/by-module/Net/libnet-x.xx.tar.gz> <1.0607>
   Term::ReadLine </modules/by-module/Term-ReadLine-Perl-x.xx.tar.gz> <0.9908>
   URI </modules/by-module/URI-x.xx.tar.gz> <1.04>
   MIME::Base64 </modules/by-module/MIME-Base64-x.xx.tar.gz> <2.11>
   Digest::MD5 </modules/by-module/Digest-MD5-x.xx.tar.gz> <2.09>

   On the right-hand side of above table is the version of the module
   in use while testing Qios. The order of the installation is  
   bottom-up.
   
-- Unpack the Qios distribution in the separate directory. 
   The file "install" is a simple shell script which can be 
   edited in the case that paths for Perl modules and binary directory
   do not match your configuration.
   
   Run installation program by entering "./install".
   Please edit the file "install" to costumize the path variables 
   for your system.

-- The documentation of the system Qios:
   1. The "help" command in qios provides basic descriptions of 
      qios commands.
   2. The example domains "SPJ" and "mondial" are in sub-directories
      "src/spj" and "src/mondial". 
   3. All modules are documented using Unix man pages.
      See "man qios" for further details. 
   4. The papers presenting the main ideas of qios design 
      can be found in directory "doc".
   

Have fun!
-------------------------------------------------------------------------------