Introduction

This document provides detailed installation instructions for configuring and deploying VocBench version 2.0.

The installation package of Vocbench downloadable from its project site, which contains all or most of the components for installing VB2.0, will be referred along the guide as:

INST_PKG

When a file name for an installation component is referred in this guide without further specifying its full path, we are assuming it is in INST_PKG.

Requirements

Third Party Software

  1. Apache Tomcat web server (version 6.0 or higher)

    EXAMPLE: debian:apt-get update; apt-get install sun-java6-jdk apache2 tomcat6 libmysql-java


  2. MySQL database server (version  5.0 or higher)

    EXAMPLE:

  3. OWLIM. (you may postpone the installation of OWLIM if you want to test VocBench with a small thesaurus; we recommed however OWLIM for better reliability and larger scalability; see "Running VocBench on OWLIM SE")

Our Software

Data

  1. Administrator Database  {VB.DB.VERSION}

Installation Steps

Setting up the main Software Components

1.  Semantic Turkey Server Setup

In the directory ST-Server, there are batch files for Windows (.bat) and UNIX (.sh) to run the server.

A further integration step would ask for VocBench OSGi bundle {ST.VB-BUNDLE.VERSION} to be copied inside the ST-Server directory under folder ST-Server\extensions\service. However, the OSGi bundle already comes packed inside the ST-Server, so perform this only if you get a specific update of the OSGi bundle.


2.  Import the Administrator Database SQL Dump File ({VB.DB.VERSION}) on MySQL Server

EXAMPLE: debian: mysql -u {your.db.user} -p < administrator20.sql


3.  VOCBENCH Setup  

Running the System

Running Semantic Turkey

Running Vocbench

  1. Run Tomcat.
  2. Access VB from the browser at:

http://localhost:8080/<vocbench-deployment-name> (Change URL according to your configuration)

Example:

http://localhost:8080/vocbench-2.0

  1. VB has been preconfigured with administrator user. Use following credentials to connect as administrator. Administrators are the super users who can create new users and approve new users.

Administrator User Credentials:

Username: administrator

Password: 111111

In appendix A, there are specific instructions for performing some actions from behind-the-scenes, such as directly configuring a new project from the AdminDB of Vocbench, or creating the project through Semantic Turkey etc…

However, unless you experience some problem, you may follow the instructions in the next sections, which instruct the user on how to create and manage projects through the ST user interface


Project Management

The following sections instruct the user on how to create a new project

  1. Project Creation/Deletion
  2. SKOS Concept scheme Management
  3. Ontology Import
  4. Namespace Prefix Mapping Management
  5. Loading pre-existing data
  6. Enabling Indexing

1.   Project creation/deletion

Create new project    

    1. select “in memory/persistent”
    2. You can leave the other parameter values (1000, true, true) as they are
    3. Continue with the instructions as in “Running the system”

 

 Delete project

 

2.   SKOS Concept Scheme management

3.   Ontology Import

4.   Namespace Prefix Mapping Management

5.   Loading pre-existing data

6.   Enabling indexing

 

Creating a new User

We suppose here that you are both the user and administrator of vocbench (see section 4 on VOCBENCH setup).

To add a new user in VocBench follow these steps:

If you do not receive any email (maybe a misplaced configuration) you need to manually enable the account by modifying the admin DB (see FAQ 1)

 

There is a list of Frequently Asked Questions (FAQs) addressing specific issues related to installation