Sculptor Installation Guide

This instruction describes what you need to install and configure to be able to use Sculptor as normal developer, e.g. for getting started with the Hello World Tutorial.

Table of Contents:

JDK

Install JDK 6 or JDK 5.

Maven

Maven is used for generating source code and building the system.

1. Install Maven2. Use Maven 2.0.8 or later.

2. Define JAVA_HOME environment variable.

I often put JAVA_HOME and MAVEN_OPTS directly in mvn.bat. I increase the heap size for better performance and avoiding out of memory. Windows: set JAVA_HOME=c:\devtools\jdk1.6.0_03 set MAVEN_OPTS=-Xms128m -Xmx1024m Mac OS X: JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home MAVEN_OPTS="-Dfile.encoding=iso-8859-1 -Xms128m -Xmx1024m"

Eclipse and Plugins

1. Install Eclipse 3.4 Ganymede, Eclipse IDE for Java EE Developers

2. oAW 4.3
Use Update Site: http://www.openarchitectureware.org/updatesite/milestone/site.xml

3. Sculptor DSL Editor
Use update site http://fornax-platform.org/updatesite/
Select Sculptor DSL Feature 1.4.0

(DSL editor 1.4.0 is ok even though you use the latest 1.5.0-SNAPSHOT version of Sculptor.)

4. Subversive
(It is not mandatory to use the Subversive plugin.)

Configuration in Eclipse

Add 'Classpath Variable' in Eclipse for M2_REPO=<your local repository location>
You find this setting in Window -> Preferences -> Java -> Build Path -> Classpath Variables
The local repository location is by default in .m2/repository in your home directory (Document and Settings in Windows)

Add 'String Substitution Variable' in Eclipse for MAVEN_EXEC=<MAVEN_HOME>/bin/mvn.bat

If you are using Mac OS X you should change the default file encoding in Eclipse to ISO-8859-1. Preferences -> General -> Workspace

Maven Launcher

Maven can be executed from the command prompt, but when developing a better alternative is to run it inside Eclipse as an external tool. You can checkout some preconfigured launchers from Fornax Subversion repository. The menu items for this are available in the external tools menu.

Checkout https://fornax.svn.sourceforge.net/svnroot/fornax/trunk/maven-launcher/

Use the subversive plugin, open view SVN Repositories. Connect to the Subversion repository root: https://fornax.svn.sourceforge.net/svnroot/fornax/

If you don't see the list of fornax maven commands under the 'External tools' menu in Eclipse, try closing the 'Maven Launcher' project and open it again.

Continue

Now you are ready to continue with the 2. Hello World Tutorial (CSC).