Semantic Ore - Installation Guide

Installation Guide

© 2007 Intelligent Systems Engineering Group. All rights reserved.

1 Introduction This guide describes how to install and configure the framework SemantiCore. 2 SemantiCore Installation 2.1 Sofware Requirements The software requirements to execute the system is the Java Run Time Environment version 1.5 or above. In order to build an application with SemantiCore it is also necessary to have JDK1.5 or above installed. 2.2 Downloading SemantiCore SemantiCore can be downloaded from http://semanticore.pucrs.br/semanticore. The download is located on the SemantiCore session “Downloads”. The file “Semanticore.zip” contains three compressed files, as following: 1. SemantiCore’s jar file; 2. semanticoreconfig.xml; 3. semanticoreinstantiation.xml. SemantiCore uses the Jena framework version 2.2. It can be downloaded from http://jena.sourceforge.net/downloads.html.

2.3 Using Semanticore http://www.eclipse.org)

with

Eclipse

(Version

3.1

or

above,

available

at

Create a new project in Eclipse. The project’s directory will be available under Eclipse’s workspace. Copy the SemantiCore jar file, and the semanticoreconfig.xml and semanticoreinstantiation.xml configuration files to the project’s root directory. Configure the project’s “Build Path” (figure 1) as follows. Select the project into the “Eclipse Package Explorer” or the “Navigator” with right-click, select “Properties”, and then “Build Path”. A new window will be displayed. Select the Libraries tab and press the buttons “Add External Jar” or “Add Jar” (if the SemantiCore jar file and the Jena lib jars are in the project’s root directory). Select the libraries situated in the Jena’s lib directory and also the SemantiCore’s jar file and confirm the operation.

© 2007 Intelligent Systems Engineering Group. All rights reserved.

Figure 1: Java Build Path

2.4 Running SemantiCore using Eclipse: 1. Right click on the Project. 2. Select the “Run As” option. 3. Select the “Run…” option to configure the Running options. 4. Select “Java Application”. 5. Select the “New” option. 6. Inform the name for this configuration. 7. Inform the Project for this configuration. 8. In the Field “Main class”, type “semanticore.domain.SemantiCore”. 9. Select the “Include libraries when searching for a main class” check box. 10. Select the “Arguments” tab. 11. Inform the type of SemantiCore’s execution as follows: a. Main Domain: the parameters required to execute the main domain are provided in the format: ; where: i. SemantiCore control tag: “MAIN”; ii. Port number: Indicates the local connection port;

© 2007 Intelligent Systems Engineering Group. All rights reserved.

iii. Domain name: Indicates the name of the SemantiCore Domain that will run on this machine; iv. Example: “main 10000 PUCRS” b. Part of the Domain: i. SemantiCore control tag: “REMOTE”; ii. Port number: Indicates the local port number; iii. Domain part name: Indicates the domain part name; iv. Main domain address: IP address of the Main Domain; v. Main domain port: Port of the Main domain; vi. Main domain name: Name of Main Domain; vii. Example: remote 15000 INF localhost 10000 PUCRS

2.5 Configuring “semanticoreconfig.xml” file This XML file contains some tags and attributes necessary to initialize SemantiCore. The following parameters can be used to configure it:

Tag semanticore

Attribute

Description

Value(s)

showintro

Used to define if the SemantiCore introduction window will be displayed (optional).

showgui

Used to define if the SemantiCore main window will be displayed (optional).

The default value is “true”. The possible values for this attribute are the string “true”, to show, or “false”, to hide the window. The default value is “true”. The possible values for this attribute are the string “true”, to show, or “false”, to hide the window.

name

Used to define the Agent’s name. The Java class that implements the Agent. A parameter to send to the Agent (optional).

agent

class param

Any string without blank spaces. String that indicates the Java class. Any string.

After these configurations, SemantiCore is ready to run.

© 2007 Intelligent Systems Engineering Group. All rights reserved.

Examples: 1. <semanticore> 2. <semanticore> 3. <semanticore showintro=”false” showgui=”false”>

© 2007 Intelligent Systems Engineering Group. All rights reserved.