Versions Compared

Old Version 9

changes.mady.by.user Armando Stellato

Saved on

compared with

New Version 10

changes.mady.by.user Armando Stellato

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

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

...

Pls contact the authors of this guide if you find any discrepancy in the use of any of the conventions explained above.

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:

    • debian:apt-get install mysql-server

    • Note Root password
    • Add extra users for VocBench if required

  3. OWLIM (Version {OWLIM.VERSION}). (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)

Our Software

  • Semantic Turkey ServerVersion; use the package found in the INST_PKG: ST-Server.zip (see installation steps)

...

  • VocBench OSGi bundle for ST; just use the package found in INST_PKG; (usually, it comes already ambedded inside the Semantic Turkey package)

Data

  1. Administrator Database  {VB.DB.VERSION}

Installation Steps

Setting up the main Software Components

1.  Semantic Turkey Server Setup

...

Configuring a specific instance in 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)

1.    OWLIM REPOSITORY SETUP and DATA LOADING

...

This will be defined in a new version of the guide. If you have installed SemanticTurkeyData in the “Semantic Turkey Server Setup”, it will come with an already configured project for your first install.

Running the System

Running Semantic Turkey

  • Start Semantic Turkey by using the batch file in the ST-Server directory (server_run.bat for windows and server_run.sh for UNIX systems).

...

  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    

  • Login with the administrator privilege (Only administrator are allowed to delete the project)
  • Once logged in, list of currently available project will be displayed.
  • On the top right corner, click [+] button to add the project.
  • Add window will be prompted to input following parameters:
    • Project name
      • Name of the new project (e.g. {ST.PROJECT.NAME})
    • Project description
      • Description of the project
    • Project type
      • Type of the project (OWL, SKOS, SKOS-XL)
      • Only SKOS-XL is available at the moment.
    • Base URI
    • Semantic Turkey Server URL
  • Click [Connect] button to test the connection to ST Server.
  • If failed, will prompt service failed message. Check if ST Server is running and connection URL is correct.
  • In case of successful connection, it will prompt list of triple Store
    • OntologyManagerFactorySesame2Impl
  • After triple store selection, it will prompt for available triple storage mode as follows
    • In memory/persistent
    • In memory/no persist
    • Native store/persistent
    • Remote access

  1. Creating a plain Sesame2 project (no OWLIM)

    1. Now instead of remote access, 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”

  2. Creating an OWLIM project

  • Select remote access option and it will prompt to input following parameters:
    • repositoryId
      • ID of the sesame2 repository to be accessed  (e.g. {OWLIM.REPOSITORY_ID})
      • This should match the ID value used in repository (Repository ID value while creating new repository in OWLIM)
    • serverURL
    • Username
      • Identifier for the user connecting to the rdf repository
      • If not applicable, add “test” as this is mandatory field
    • Password
      • Password for the user connecting to the rdf repository
      • If not applicable, add “test” as this is mandatory field
    • Click on [?] icon to view each field information.
    • It is assumed that Repository Server is already running and new repository has been created.
    • Click [Add] button to create the project.
    • Newly created project will be added to the list.

...

  • Login with the administrator privilege (Only administrator are allowed to delete the project)
  • Once logged in, list of currently available project will be displayed.
  • Select the project to be deleted.
  • On the top right corner, click [-] button to delete the project.
  • Delete window with project name will be prompted.
  • Click [Delete] button to confirm deletion.
  • Delete project will be removed from the list.

 

2.   SKOS Concept Scheme management

  • After login, you will be directed to concept module.
  • If no concept scheme is selected by default, you will be prompted to go to Scheme module to select concept scheme.
  • Click on the [Schemes] link on the main menu bar, to go to Schemes module.
  • List of available concept schemes will be displayed.
  • If none of them is available, click [+] button on top right corner of list box to add new scheme.
  • Add scheme window will be prompted to add following parameters:
    • Scheme URI
    • Scheme label
    • Scheme language
  • After clicking [Add] button, newly added scheme will be displayed in the list.
  • To select the scheme, click on the check box.
  • To delete the scheme, click [-] button on the right end of each scheme.
  • Delete scheme window with scheme URI will be displayed.
  • Click [Delete] button to remove the concept scheme.
  • NOTE: Add/delete scheme is available only to administrator but selection of concept scheme is available to all users.

3.   Ontology Import

  • To import ontology, follow these link on the top menu bar
    • Administration > Ontology
  • Under Imports box, list of imported ontology will be displayed.
  • To import ontology, click [+] button on the top right corner
  • Four options are available

...

  • To delete the imported ontology, click [-] button on the right end of each ontology.

4.   Namespace Prefix Mapping Management

  • To manage namespace, follow these link on the top menu bar
    • Administration > Ontology
  • Under namespace management box, list of available namespace with their prefix will be displayed.
  • To add new namespace, click [+] button on the top right corner
  • Provide namespace (http://aims.fao.org/aos/agrontology#) and prefix (agro) and click [Add] button.
  • To edit namespace, click [pen] button on the right end of the namespace in the list.
  • Change namespace prefix and click [Edit] button.
  • To delete namespace, click [-] button on the right end of the namespace in the list.
  • Delete namespace window will be prompted with namespace and prefix.
  • Click [Delete] button to delete the namespace.

5.   Loading pre-existing data

  • To load RDF data, click on the [Load data] link in the main menu bar.
  • Input following parameter
    • Base URI: base uri of the data to be imported. (e.g. http://aims.fao.org/aos/agrovoc/)
    • RDF file: browser data file to be imported. (e.g. agrovoc_wb_20130507_VB.nt)
  • Click [Import button] to import data.
  • This process may take some time depending on the size of the data.

6.   Enabling indexing

  • To enable indexing, click on [Advanced search] link below top menu bar at the top right end.
  • Click on the [index] button at the right end.
  • It will prompt to confirm if you want to index. Click the [Ok] button to enable indexing.
  • This process may take some time.
  • This action is only available to administrator users.

...

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

Appendix A: Behind the Scenes Configuration and Management

Configuring the Administration DB for a new project        

The following steps can be skipped if the new project is created through the VocBench interface.

...

(“{ST.PROJECT.NAME}”, "AGROVOC Multilingual Thesaurus", null, “http://127.0.0.1:1979/semantic_turkey/resources/stserver/STServer”, “{ST.PROJECT.NAME}”, null,

null, "1","2.0");

Managing a project through Semantic Turkey services   

The following actions (Import ontology, Namespace management) can be skipped as can done via VocBench interface.

...

http://127.0.0.1:1979/semantic_turkey/resources/stserver/STServer?service=metadata&request=getNSPrefixMappings

Appendix B: OWLIM specific notes

How to use a custom ruleset

OWLIM allows for loading custom rulesets (used for inferencing) instead of the precompiled ones bundled with the OWLIM distribution. In particular, their standard OWL rulesets seem to have some bugs in the axiomatic triples (probably originating from wrong definitions in the OWL RL specifications), thus it may be mandatory to load custom versions of these rulesets. Here follow instructions for loading custom rulesets.

...