Versions Compared

Key

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

This guide could be outdated with respect to latest OWLIM versions. We will probably remove it and limit our instructions on how to interact with an OWLIM project (actually, identical to the Quick Test Drive guide, except you have to choose "remote access" and connect to an existing OWLIM repository).

This guide is meant to remain as “static” as possible, along different configuration scenarios embracing data and vocabulary updates, changes in the various installation settings etc. For this reason, reference is made to an external wiki page on the google project site of Semantic Turkey:

https://code.google.com/p/agrovoc-cs-workbench/wiki/VB2_Installation (note: if you want to perform a quick test-drive of ST, you don't need to follow this)

In the above wiki page, several configuration parameters have been defined, belonging to the different components which are part of VB2.0. The user may refer to a particular installation configuration presented there, as a series of ATTRIBUTE-VALUE pairs, where ATTRIBUTE is one of the configuration parameters required by the installation and VALUE represents the specific value which will be assigned for that particular configuration. This installation guide will use ATTRIBUTE names which are consistent with those present in the wiki.

The ATTRIBUTE will be explicitly mentioned by wrapping it between {} brackets.

E.g. {OWLIM.TOTAL_CACHE_MEMORY}

OWLIM Setup  

By using the content of {OWLIM.VERSION}, follow the instructions online at: http://owlim.ontotext.com/display/OWLIMv54/OWLIM-SE+Installation#OWLIM-SEInstallation-Easyinstall only for deploying the OWLIM .war files into Tomcat. We will ot use OWLIM for a first inst

and stop before the instruction starting with this text:
“Fill in the fields as required…”   
follow now the specific instructions here below for creating a repository

  • If you followed the above instructions, you should now be sitting in front of the sesame2 workbench web application, with the “New Repository” Form on the screen. There should be two text fields to be filled up, fill:
    • ID: {OWLIM.REPOSITORY_ID}
    • Title: whatever you like, the title is not important, it is just a comment field
    • After filling the above parameters and clicking on the next button, you will get to a second page with lot more parameters. Fill all of them with all the configuration parameters starting with the “OWLIM.” prefix, from the following configuration sections:
      • {OWLIM General}
      • {OWLIM Repository Configuration}
      • {Data Configuration}         

Also, other than all the “OWLIM.” prefixed properties, consider the {DATA.BASEURL} to be used in the “Base URL” field of the configuration.

In particular, be sure to check that all the parameters starting with {OWLIM. in the interested configurations have found a match in the entries (with a similar name) in the form, and leave untouched all those form fields which are not specified in the configurations.   
Confirm after all the fields have been filled up, by clicking the “create” button.

  • Now, the just-created repository should be already selected in the Sesame2 workbench. However, to be certain of that, click, from the menu on the left, on the “Repositories” section and then select the repository you just created.
  • Now it’s time to import the the SKOS Data file for the Concept Scheme you are using. To do so:
    • Click on the “Modify\Add” option on the left menu. You should see a form called “Add RDF”.
    • You may fill the Base URI field with the ({DATA.BASEURL}) value. However, if you import an NT file (which we recommend), there is no need to fill this field (the NT format already contains full URIs and no unprefixed local name). In any case, always uncheck the "use base URI as context identifier" and do not specify any value for "Context". Leave the other choices untouched.
    • Select with the radio button the option: “Select the file containing the RDF data you wish to upload” and then, in the “RDF Data File” field, choose the one specified in {DATA.VERSION} from your file system.
    • Then Click Upload

 2.   Add the new project to Semantic Turkey

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.

 

Create a new project   with OWLIM

Follow the steps in Configuring OWLIM-SE for ST (section Create new project), until "Creating a plain Sesame2 project (no OWLIM)" excluded. Then follows these steps for connecting to the OWLIM instance.

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.