Installation

Installation
What are the system requirements for installing WSMO Studio?

WSMO Studio requires:

  • JRE 1.5+
  • Eclipse 3.2 (NOTE: if you're using the standalone distribution then you don't need to download and install Eclipse separately, since it is included in the distribution)

What are the differences between installing the standalone distribution, installing individual plug-ins or using the update site?

The standalone distribution insludes most of the available WSMO Studio plug-ins, plus the required Eclipse components. If you intend to use most plug-ins then this mode of installation is probably most suitable for you. NOTE: the standalone distribution does not include the WSMO Visualiser plug-in, since its licence (GPL) restricts such distribution. The plug-in can be downloaded individually from SourceForge or by using the update site

Individual plug-ins can be downloaded from SourceForge, and copied into any existing Eclipse installation.

Finally, the update site allows you to update specific plug-ins, once we release a new version, without re-installing the full WSMO Studio

How do I use the update site?

  1. Within WSMO Studio, go to Help --> Software Updates --> Find and Install
  2. Select "Search for new features to install"
  3. The WSMO Studio update site should appear (http://www.wsmostudio.org/updates/). If not, then add its URL manually ("New Remote Site", and then specify the URL)
  4. Proceed, and a list of updates (if any) or new plug-ins will appear

Which 3rd party libraries are distributed with WSMO Studio?
The following 3rd party libraries are included in WSMO Studio

componentversionlicenceURL
Eclipse3.2Eclipse Public Licencehttp://www.eclipse.org
Sesame1.2.3LGPLhttp://www.openrdf.org
Axis1.3Apache Software Licencehttp://ws.apache.org/axis/
WSML 2 Reasoner Framework20060307LGPLhttp://dev1.deri.at/wsml2reasoner/
ORDI0.3.0LGPLhttp://sourceforge.net/projects/ordi/
wsmo4j0.5.2LGPLhttp://wsmo4j.sourceforge.net

How do I install the reasoner modules for the WSML Reasoner?

The reasoning related functionality in WSMO Studio is comprised of three components:

due to the licences of the two reasoner modules, they cannot be bundled together with an LGPL distribution, such as WSMO Studio. In order to configure the reasoners for use within WSMO Studio one should follow the steps:

  1. The WSML Reasoner GUI and the WSML Reasoning Framework will be installed by default with WSMO Studio
  2. Download the reasoner module that you prefer (MINS or KAON2). Note that the reasoners provide different functionality and different licences
  3. Copy the reasoner jars (mins-20060202.jar for MINS, or kaon2.jar for KAON2) into the WSMO-Studio-X.Y.Z/plugins/org.wsmostudio.reasoner.wsml_flight_X.Y.Z/lib folder
  4. Start WSMO Studio and configure the reasoner preferences (Window --> Preferences --> WSMO Studio --> WSML Reasoner)
  5. Try a satisfiability check on some of the sample ontologies (from the context menu choose "Test WSML-Flight satisfiability"). Instead of getting a message about missing reasoners, you should get a message from the WSML Flight reasoner that states whether the ontology is satisfiable or not

How do I install the WSMO Visualiser?

The WSMO Visualiser is distributed under a GPL licence and cannot be packaged with the standalone WSMO Studio distribution (LGPL). So you need to either:

  • get it from the update site (see above)
  • or, get it from SourceForge and copy it into WSMO Studio / Eclipse

I have installed the INFRAWEBS Axiom editor plug-in ,but it doesn't seem to be working ...

This problem can appear only if you're trying to use the Axiom Editor plug-in with a WSMO Studio version older than 0.4.0. The Axiom editor uses functionality from the Eclipse Graphical Editing Framework, which was not distributed with Studio versions 0.3.x and should be downloaded from http://download.eclipse.org/tools/gef/downloads/.

Note that you should not be experiencing such problems with releases 0.4.0+, since GEF is now bundled with WSMO Studio.

Where can I find version x.y.z of WSMO Studio?

Old releases are available at http://www.wsmostudio.org/download/old/ and at SourceForge

Usage

Usage
What is the quick way of getting started with WSMO Studio?
  1. Read the rest of the FAQ ;)
  2. See the flash demo
  3. Read the User Guide
  4. If there are still unresolved mysteries, post a question to the mail list (be sure to search the archives first)
Which plug-ins do I need?

Here is a short description of the available plug-ins:

plug-indescriptionmandatory / optionalEclipse nameSourceForge nameversion
wsmo4jThis plug-in provides a simple wrapper around the wsmo4j library so that it can be exported to other WSMO Studio plug-insmandatorycom.ontotext.wsmo4jwsmo4j plug-in0.6.1. v20061103
RuntimeThis plug-in represents a core set of functionality that is reused by other plug-ins. It is responsible for the project management in the workspace, the connection with the underlying (WSMO) object model. Additionally, it maintains a set of image icons for the graphical representation of the WSMO objects in the UImandatoryorg.wsmostudio.runtimeWSMO Studio Runtime0.5.3
WSMOThis plugin provides the WSMO perspective in WSMO Studio, e.g. create WSML descriptions of ontologies, mediators, services, goals, capabilities and interfaces. It comes with a set of UI components for viewing and editing the various WSMO objectsmandatoryorg.wsmostudio.uiWSMO plug-in0.5.3
RepositoryThis plug-in provides the Repository perspective in WSMO Studio, e.g. working with remote ontology/service/goal repositories. It contains an extension point which allows 3rd parties to supply adapters to their own repositories. At present there are such adapters for a local ORDI repository and a Web Service facade to a remote repositoryoptionalorg.wsmostudio.repositoryRepository plug-in0.5.2
ORDI adapter (Repository)This plug-in provides an ORDI adapter to the Repository plug-in and a built-in local repository based on Sesame.optionalorg.wsmostudio.repository.ordiRepository ORDI adapter0.5.1
IRS-III adapter (3rd party)The IRS-III plug-in is a front-end that integrates IRS-III into WSMO Studio. The plug-in supports importing and exporting WSMO entities, such as Goals, Mediators, Web Services and Ontologies, to and from the reasoning server. Furthermore, it allows users to achieve Goals using the IRS-III directly from the editor, through a simple point-and-click interface.optionaluk.ac.open.kmi.repositoryN/A0.2.0
WebService adapter (Repository)This plug-in provides a WebService facade to a remote Repository. See the WSDL definition optionalorg.wsmostudio.repository.webserviceRepository WebService adapter0.5.0
ChoreographyThis plug-in provides support for creating WSMO centric choreography descriptionsoptionalorg.wsmostudio.choreographyChoreography plug-in0.5.1
SAWSDL editorThis plug-in provides support adding semantic annotations to WSDL descriptions according to the SAWSDL recommendationoptionalorg.wsmostudio.grounding.wsdlsSAWSDL plug-in0.5.3
Discovery plug-inThis plug-in provides a front end to goal-based discovery engines, such as EPFL QoS-enabled Service Discovery Componentoptionalorg.wsmostudio.discoveryDiscovery plug-in0.0.1
WSML Reasoner adapterThis plug-in provides the option of checking ontology consistency by using a WSML Reasoner optionalorg.wsmostudio.reasoner.wsml_flightWSML reasoner adapter0.5.1
WSMO Visualiser (3rd party)This is a version of the WSMO Visualiser from WSMT, adapted to WSMO Studio. Check out the FAQ page for installation instructionsoptionalorg.deri.wsml.eclipse.visualizerWSMT Visualiser0.0.4
Axiom Editor (3rd party)Axiom Editor is an ontology-driven user-friendly tool for graphical construction of complex logical expressions (called axioms) based on available set of ontologies.optionalorg.infrawebsInfrawebs Editor1.0.9

Note that the standalone distribution includes all the plug-ins which are licensed under a LGPL compatible licence (in other words - any open source licence apart from GPL)

A list of 3rd party plug-ins is available here

How can I import/export WSML-XML, OWL-DL and RDF into/from WSMO Studio?

Import/Export is available from the File menu

You can import from WSML-XML and a subset of OWL-DL and RDF, but export is supported only for WSML-XML and OWL-DL. See D16.1: WSML Family of Representation Languages for details on the WSML mapping to XML, OWL-DL and RDF

I need more WSML examples!

So do we!

The WSMO Working Group provides some sample ontologies within various deliverables, especially D3.x, but unfortunatelly most of the WSML samples are invalid or incomplete. Hopefully someone will fix all the broken WSML examples some day.

Problems

Problems
WSMO Studio is not working...

Please submit a bug report at http://sourceforge.net/tracker/?group_id=119791&atid=684995. Try to provide as much information about the problem as possible, so that we can track it down faster.