2.1. Installation

 Documentation Summary

 Page Summary

You need at least those 4 free development tools:

1. Java 5+ (6+ working): download Sun Jdk and install it.
2. Eclipse 3.2+: download Eclipse 3.2+ and unzip it somewhere (NOTE: it is always a good idea to avoid paths with whitespace).
3. Flex 2+ SDK: download Flex 2+ SDK and unzip it somewhere (NOTE: idem), say /flex_2_sdk.
4. Flex 2+ Ant Tasks: download Flex 2 Ant Tasks, unzip it and copy lib/flexTasks.jar to /flex_2_sdk/lib (adapt the path if you didn't install Flex 2 SDK in /flex_2_sdk).

You may also read and follow the recommandations of this excellent article in order to customize you development environment.

Granite Data Services relies on Log4j (version 1.2.8 tested) and JDOM (version 1.0 tested).

Corresponding jars are bundled in GDS sample projects (see below), but if you start from scratch don't forget to include them otherwise your application won't even launch!

Whatever you choose to install, read carefully the README.txt file that comes with each archive. You will have to edit the env.properties file (WARNING: use a simple text editor, this file contains useful comments and declaration order is important)

Go to GDS download area and choose one of:

• graniteds-ejb3-1.0.0.zip: Eclipse 3.2+ project with a JBoss4/EJB3 sample application. If you choose this option, you should also install JBoss 4.2.2 (see further documentation in EJB3 Services).
• graniteds-seam-1.0.0.zip: Eclipse 3.2+ project with a JBoss4/Seam/EJB3 sample application. If you choose this option, you should also install JBoss 4.2.2. (see further documentation in Seam Services).
• graniteds-spring-ejb3-1.0.0.zip: Eclipse 3.2+ project with a JBoss4/Spring sample application. If you choose this option, you should also download JBoss 4.2.2 (see further documentation in Spring Services).
• graniteds-guice-1.0.0.zip: Eclipse 3.2+ project with a JBoss4/Guice/Warp sample application. If you choose this option, you should also download JBoss 4.2.2 (see further documentation in Guice Services).
• granite-pojo-1.0.0.zip: Eclipse 3.2+ project with a Tomcat/Pojo (simple Java class services) sample application. If you choose this option, you should also download Tomcat 5+ (see further documentation in Pojo Services).
• granite-chat-1.0.0.zip: Eclipse 3.2+ project with a Tomcat/Data Push (chat) sample application. If you choose this option, you should also download Tomcat 6.0.14+ (see further documentation in Data Push).

After editing the env.properties file, you should be able to use the "deploy" target (build.xml): it will make several jars, compile .mxml and .as for the demo, pack and deploy everything. That's it.

Download org.granite.gas3_1.0.0.zip, unzip it in your Eclipse plugin directory and restart Eclipse. See specific documentation on Gas3 usage and configuration here.

It is sometime tricky to update an Eclipse plugin: if you experience any problems, close Eclipse, remove all Gas3 directories (in <ECLIPSE_HOME>/plugins/.), restart and reclose Eclipse, install again org.granite.gas3_1.0.0, restart Eclipse.