Azzurri Clay - Database Modeling in Eclipse

	Constructing high-quality business solutions	Azzurri Limited

Home \| Services \| Software \| Inquiries \| Company

Home > Software > Clay > Installation

Printable Page

Installation

There are two ways to install Clay:

Download the distribution file and unzip it into your Eclipse installation, as described below.
Use the Eclipse Update Manager, as described in our Eclipse update site.

You need to install GEF before installing Clay. Eclipse will refuse to install Clay if GEF is not installed. You can find details on installing GEF below.

Installing Clay using the Eclipse Update Manager

Please go to our Eclipse update site for a detailed description of how to do this.

Installing Clay from the distribution archive file

Download the distribution file, and save it to your harddisk. Unzip the archive file directly into your ${ECLIPSE_HOME} installation (the parent folder of the features and plugins folders). You can confirm that the Clay Core feature is correctly installed by checking that the following directories exist:

${ECLIPSE_HOME}/features/jp.azzurri.clay.core_1.0.0
${ECLIPSE_HOME}/plugins/jp.azzurri.clay.core_1.0.0
${ECLIPSE_HOME}/plugins/jp.azzurri.clay.ui.jdbc_1.0.0
${ECLIPSE_HOME}/plugins/jp.azzurri.clay.ui_1.0.0

Installing the Eclipse Graphical Editor Framework (GEF)

This plugin depends on the Graphical Editor Framework from the Eclipse Tools project. If you have not installed GEF already, you can download it from the Eclipse website. It is recommended to use a version of GEF that matches your Eclipse version:

GEF 3.0.0 when using Eclipse 3.0
GEF 2.1.3 when using Eclipse 2.1.3
GEF 2.1.2 when using Eclipse 2.1.2
GEF 2.1.1 when using Eclipse 2.1.1

Please note that Clay is not backwards compatible with GEF 2.1.0 or previous versions. You need GEF 2.1.1 or higher.
Clay Pro 1.0.5 requires GEF 2.1.2 or higher.

Download the correct version of GEF for your version of Eclipse and unzip it into your ${ECLIPSE_HOME} directory (not to the plugins directory!). You can confirm that GEF is installed correctly by checking that the following directories exist:

${ECLIPSE_HOME}/features/org.eclipse.gef_2.1.x
${ECLIPSE_HOME}/plugins/org.eclipse.draw2d_2.1.x
${ECLIPSE_HOME}/plugins/org.eclipse.gef_2.1.x

If Eclipse is already running, your should exit Eclipse and restart it. The changes will be picked up when you restart Eclipse. The first time you restart Eclipse after installing GEF you will see a Configuration Change dialog like in the image below. Make sure that the Graphical Editor Framework option is checked and press Finish.

You may need to restart Eclipse after pressing the Finish button.

Enabling features

If Clay or GEF do not work after installation, either feature may be disabled. You can confirm that both features are enabled by selecting Help > Software Updates > Update Manager from the Eclipse menu. This will show the Install/Update Perspective.

In the Install Configuration view, first make sure that Show Disabled Features is toggled to ON in the toolbar.

Now drill down in the Eclipse Platform tree view. Both the Graphical Editing Framework and Clay need to be present (if not, they are not installed) and enabled. If they are not enabled, select the disabled feature and press the Enable Now button in the Preview view.

Home > Software > Clay > Installation