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 with Eclipse (Version 3.1 or above, available at

http://www.eclipse.org)

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: <CONTROL_TAG> <PORT_NUMBER>
<DOMAIN_NAME>; 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 Attribute Description Value(s)

semanticore
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.

agent
name Used to define the Agent’s Any string without blank
name. spaces.
class The Java class that String that indicates the Java
implements the Agent. class.
param A parameter to send to the Any string.
Agent (optional).

After these configurations, SemantiCore is ready to run.

© 2007 Intelligent Systems Engineering Group. All rights reserved.

Examples:

1.

<?xml version="1.0" encoding="ISO-8859-1"?>

<semanticore>
<agent name="Agent_1" class="semanticore.test.Agent"/>
</semanticore>

2.

<?xml version="1.0" encoding="ISO-8859-1"?>

<semanticore>
<agent name="Agent_1" class="semanticore.test.Agent"/>
<agent name="Agent_2" class="semanticore.test.Agent"/>
<agent name="Agent_3" class="semanticore.test.Agent"/>
</semanticore>

3.

<?xml version="1.0" encoding="ISO-8859-1"?>

<semanticore showintro=”false” showgui=”false”>
<agent name="Agent_1" class="semanticore.test.Agent"/>
</semanticore>

© 2007 Intelligent Systems Engineering Group. All rights reserved.