Installation Process

Installing OntoBroker under Microsoft Windows

The installation of OntoBroker is fast and easy. After starting the installation file, the installation process is initiated. In the following, you have to confirm the prompts in the windows that appear. Before installing OntoBroker, you have to check whether your computer meets the system requirements for the recommended configuration. Before installing OntoBroker, close all of the programs and applications on the computer. The installation wizard will guide you through the further installation process. During the installation, you will be asked for the KeyFile which should be stored in the OntoBroker installation folder.

NOTE: Keyfiles for different versions can be put into the same directory ONTOPRISE_LICENSE_HOME.

Installing OntoBroker under Linux

Before installing OntoBroker make sure you have an appropriate Java runtime environment installed (OntoBroker requires Java 1.6). Then:

•	Unzip the OntoBroker distribution into a folder (e.g. /usr/shared/ontoprise/ontobroker),

•	Copy the license key file (ob_prof.key.xml) into the same folder.

The setup process is now finished. You should be able to start OntoBroker using the commandline utilities.

NOTE: The installer automatically installs the correct runtime dependending on the target machine's bit-version.

System Requirements

Operating systems:

•	Windows XP Professional

•

Windows 7

•	Windows Vista

•	Windows Server 2003

•	Linux (tested on SUSE, Debian and Ubuntu)

Java platforms: Sun/OpenJDK Java 6 and later

Hardware:

•	Intel or AMD processors, 32-bit or 64-bit

•	Minimum: 1 core, 2 GHz and better, 1 GB RAM, 200 MB free hard disk space

•	Recommended: Quad core, 2.4 GHz and better, 4 GB RAM, 400 MB free hard disk space

Important Note About the Key File

When installing the keyfile, during the installation process you must make sure that the keyfile has the original name given by ontoprise and the original extension »*.key.xml«. Otherwise the keyfile has to be renamed and copied manually to the installation directory.

Note about Windows Vista/Windows 7

OntoBroker is fully compatible with Windows Vista and later versions. This means that OntoBroker will not try to write into "Program Files" etc. We recommend that you install OntoBroker to the suggested default location of the operating system.

Installing JDBC-Driver

For database schema imports, an appropriate JDBC Driver for the database may be required. While OntoBroker supports Oracle, MSSQL Server and DB2 out of the box, other drivers, such as MySQL may not be redistributed. If you have purchased a valid license for the driver, you may configure OntoBroker in the following way:

Copy the database driver to [OntoBroker]/lib (e.g. mysql-connector-java-5.1.5-bin.jar)

Afterwards write the settings to OntoConfig.prp:

ExternalDB.OtherDatabase.Driver = com.mysql.jdbc.Driver

ExternalDB.OtherDatabase.ConnectionURL = jdbc:mysql://$host$/$name$

Installing MySQL Drivers

1.	Change OntoConfig.prp.

Add the following two lines to the configuration file:

ExternalDB.OtherDatabase.Driver = com.mysql.jdbc.Driver

ExternalDB.OtherDatabase.ConnectionURL = jdbc:mysql://$host$/$name$

2.	Get the MySQL JDBC driver.

Download a recent version of the JDBC driver (e.g. mysql-connector-java-5.1.10-bin.jar).

3.	Convert to OSGi Bundle.

Download bnd.jar (Bnd can be downloaded here: http://www.aqute.biz/Code/Download).

a)	Run from the command line: java -jar bnd.jar wrap mysql-connector-java-5.1.10-bin.jar

As output you get mysql-connector-java-5.1.10-bin.bar

b)	Rename .mysql-connector-java-5.1.10-bin.bar to mysql-connector-java-5.1.10-bin.jar

For more information, see:

jonas.ow2.org/JONAS_5_2_0_M1/doc/doc-en/pdf/howto_install_jdbc_driver.pdf

4.	Copy to Extensions Directory

Copy the OSGi bundle, generated in the last step to the extensions directory of your OntoBroker or OntoStudio installation.

extensions/mysql-connector-java-5.1.10-bin.jar

5.	Start OntoBroker

Finally start OntoBroker or OntoStudio.