UMLX Installation

UMLX requires (minimum versions)

Note that the EMFT OCL download is incomplete and requires ANTLR 2.7.2 to be downloaded and antlr.jar copied to eclipse/plugins/antlr_2.7.2/lib/antlr.jar.

Note that as of version 3.1, GEF uses the SWT polyline support that requires GDI+, which is not present on earlier versions of Windows, so you may need to get GDI+ (as a free download) from Microsoft.

UMLX 0.0.3 is built with Java 1.5.0_06, Eclipse 3.2M5a, EMF 2.2.0M5, EMFT OCL 1.0.0.M5, GEF 3.2M5. (EMF 2.2.0M4 introduced some minor but subtle signature changes, which weren't copnsistently built into OCL til 1.0.0.M5, so there is little chance of earlier versions building sucessfully.)

It is assumed that you have already successfully installed at least Java and Eclipse.

Maintenance of the UMLX sources also requires VE 1.2M1.

Execution of the UMLX OCL tests requires two NPE fixes in OCLPlugin.java. These are expected to be incorporated in the OCL 1.0.0 release.

EMF 2.2.0M5 Installation

EMF 2.2.0M5 may be downloaded piecemeal from its Update Site, but it perhaps easier just to download emf-sdo-xsd-SDK-2.1.0.zip and then copy all of the features and plugins to the corresponding folders in your Eclipse installation.

GEF 3.1 Installation

GEF 3.1 may be downloaded from GEF-ALL-3.1.zip and all of its features and plugins copied to the corresponding folders in your Eclipse installation.

UMLX Binary Installation

Within Eclipse, start up the Update Manager Install wizard by invoking: Help->Software Updates->Find and Install...

In the Feature Updates page select "Search for new features to install" and click Next.

Then in the Update Sites to Visit page, use New Remote Site... to define the UMLX Update Site as

http://download.eclipse.org/technology/gmt/umlx/updates/

for the main Eclipse download site in Canada. You may visit

http://www.eclipse.org/downloads/download.php?file=/technology/gmt/umlx/updates&format=plain

for a list of Mirrors.

Click OK

Ensure that the UMLX Update Site is selected, and then Click Finish to proceed to the Updates Wizard.

Select the desired UMLX release version and content.


One day there may be a stable Current rather than just Alpha release.
Click Next.

Accept the license terms – they're the standard Eclipse ones and click Next to get to the Installation page.

If you are happy to load UMLX in the same folder as Eclipse you may click Next immediately. However you may find it convenient to use separate locations for each Eclipse layered product and release, so that you can more easily see what you have and change it. You may therefore want to invoke Add Location... before proceeding.

When the feature has been downloaded, click Install to complete installation. Then when the plug-ins have been installed, hit Yes to restart.

UMLX Usage

UMLX adds no views, natures or perspectives so nothing appears to change.

You may verify that UMLX is installed by using Help->About Eclipse SDK.

You may read the UMLX User Guide and follow the tutorial by invoking Help->Help Contents.

You may create a new, or a copy of an example UMLX diagram by invoking New->File->Examples... UMLX Examples.

UMLX Source Installation

The UMLX feature includes a source plug-in. The source may be made visible within Eclipse by (using the Navigator menu) Import...->External Plug-ins and Fragments.

The amount of disk space used and visibility of the source may be controlled by selecting, binary, binary linked, or source projects. Next.

Select *umlx* and Add, then Finish.

UMLX Installation from CVS

Alternatively the sources may be downloaded from CVS.

Use Window->Open Perspective->Other..., CVS Repository Exploring, then click OK to open the CVS Repository perspective.

Within the CVS Repository Explorer, invoke New->Repository Location...

to define a repository entry with provide read-only access to the Eclipse Technology projects.
(If you are behind a firewall you should use Window->Preferences..., Team->CVS->SSH2 Connection Method|Proxy to enable a proxy connection through your firewall).
Then select all org.eclipse.gmt.umlx folders



...



...



...



(using a left click to select the top one and shift left click the bottom one) then use invoke Check Out from the right button menu.


When you return to the Package Explorer, you should find the projects exist and are probably building.

Each project defines its own preferences, so there should be no problems provided you have Java 5 available. There should be no errors or warnings.

You may invoke Run As...->JUnit test on the org.eclipse.umlx.tests plug-in to test the kernel functionality. Expect no errors or failures.



Edward D. Willink
21 March 2006