Installation Guide Final version, 2002-11-04. (Updated 2003-06-02) Csaba Fulop, Andras Micsik (SZTAKI) & Rachel Heery (UKOLN)

Installation guide for the client

The client is written in Java.

• if you have not got Java installed then go to http://java.sun.com/
• download and install the latest version of J2SE JRE for your platform and OS
• for install and configuration instructions please look at the documents of Java

Download the latest client from the home page of the registry (CORESClient.jar)

• go to http://cores.dsd.sztaki.hu
• the link to the client is in the header ('the latest client')
• the method of downloading the file is dependent on your browser (usually click on the link)

Start the client

• enter 'java -jar CORESClient.jar' to the console in the directory where you have downloaded the client
• OR just double-click on the downloaded file to start the client (this is dependent on your operating system)
• for any further information about use of the client, see the user's manual.

Installation guide for the server

(based on Dave Beckett's Meg Registry Install guide)

1. Getting the source

The CORES registry software and schema creation tool are extended/enhanced versions of the tools developed by the earlier MEG registry project. The MEG registry software is currently downloadable from the CVS repository at ILRT, University of Bristol, browseable at

http://cvs.ilrt.org/cvsweb/meg/software/

The CORES software will be available from the same CVS as of 30 June 2003.

2. Building Registry (Server)

cd cores/src/server

This directory will be referred to as the <SERVER-DIR> below. This directory contains the registry, based on the Redland RDF system.

You will need to create some directories at this top level:

mkdir db logs redland

You will need to obtain Redland from http://www.redland.opensource.ac.uk/ and install it. The registry uses the stable 0.9.11 version and it is strongly recommended to use that release.

Once you have downloaded the 0.9.11 tar.gz, extract and built it:

./configure --prefix=<SERVER_DIR>/redland

The following fixes a bug in the Redland 0.9.11 configuration:

ln -s .libs/librdf.a

and the Perl interface:

cd perl
make test-perl
cd ..

and install the library and the Perl interface:

make install
cd perl
make install-perl

3. Installation and configuration of the web interface

Each of the cgi-bin programs or command line versions requires some environment specific variables. They can be set in the config/cores.conf file. They are:

• ROOT_DIR: the directory called <SERVER-DIR> above
• WEB_ROOT: the URL where you have put the registry
• DOMAIN: the domain part of the above URL
• CORES_ADMIN_EMAIL: the administrator's e-mail address
• REDLAND: the directory where you have installed Redland. Default is <SERVER-DIR>/redland

You have to set the following Apache configuration:

SetEnv LD_LIBRARY_PATH <SERVER DIR>/redland/lib:/usr/local/lib

to make the Redland shared library visible to Apache.

The cgi-bin programs have to be mapped to handle a set of URI space. Use the following aliases:

ScriptAlias /cgi-bin <SERVER-DIR>/cgi-bin
ScriptAlias /api <SERVER-DIR>/cgi-bin/api.pl
ScriptAliasMatch ^/$ <SERVER-DIR>/cgi-bin/browse.pl

(The order is important)

4. Loading the registry

To initialize the registry database run the script bin/reset-reg.pl. It will request the Administrator account details too (e-mail, password). Later you can clear the registry with this script.

Make the db directory and the new database writable by the Apache Web user/group. (You probably have to do the following as root)

chown -R apacheuser.apachegroup db
chmod -R 755 db

Or the more dangerous

chmod -R a+w db

After this load new schemas to the registry via the Administration page http://your.registry.com/cgi-bin/admin.pl, using the Administrator account that you have created. You have to supply the URL of the new schema in the textfield at Add Schema section.

Some schemas are available at http://www.cores-eu.net/registry/schema/