Exadel Studio Release Notes

These Exadel Studio release notes include the essential information for getting started immediately.

System Requirements • Plug-in Requirements • How Long Is the Trial Period? • Running for the First Time • Downloading and Installing • Adding Ajax4jsf Support to Exadel Studio • Upgrading • Uninstalling • Re-installing • Common Problems • User Guide, Tutorials and Demos • License Activation • Tomcat • Sample Applications • Getting Help

System Requirements

Eclipse
Before installing Exadel Studio 4.0.4, make sure you have the following Eclipse platforms installed.

Eclipse 3.2.2

Exadel Studio 4.0.4 will not work properly with any other Eclipse versions.

Java
Before installing Exadel Studio, make sure you have one of the following versions of Java installed.

JDK 1.5 or higher

It must be the full JDK, not just the JRE (Java Runtime Environment). For more information about target operating environments and compatible Java versions please refer to the Eclipse Web site. Please note that the Eclipse documentation states that you only need a Java Runtime Environment for Eclipse, but to use Exadel Studio actually requires a full JDK in order to compile Java classes and JSP pages.

Operating Systems

Windows
Linux

Plug-in Requirements

When you install the regular Exadel Studio download, it comes with all the required plug-ins. There is nothing extra to download. The regular download comes with the following plug-ins:

WTP runtime 1.5
GEF runtime 3.2
JEM runtime 1.2
EMF & SDO runtime 2.2
XSD runtime 2.2
Hibernate-tools-3.1.0 beta5 (without WTP, EMF, GEF, and other non-Hibernate plug-ins from Hibernate-tools-3.1.0 beta5)
QuickImage 0.2.0
Spring IDE 1.3.2
Sun Glassfish 0.3

There is also a "core" download available for the most current version, that comes just with Exadel Studio without any of the plug-ins listed above. These plug-ins are still required, but you are responsible for ensuring that they are available.

How Long Is the Trial Period?

Exadel Studio Pro is available for free use until August 30th, 2008 (for version 4.0.4). Then JBoss Developer Studio or JBoss Tools will have to be used.

Downloading and Installing

Download the appropriate installation file for your platform from www.exadel.com/web/portal/download
Unzip the file
Create a text file called com.exadel.studio.link in a folder called links within the Eclipse home folder (If the links folder isn't there, create it.)
The content of the file should be point to the place where you unzipped Exadel Studio:
```
path=<ExadelStudioHome>
```
for example: path=c:/ExadelStudioPro. (Always use forward slashes.)
Start Eclipse with -clean option: eclipse -clean

Adding RichFaces Support to Exadel Studio

Although the Exadel Studio palette shows RichFaces tags when you install Exadel Studio, you still need to add the RichFaces library in order to use the tags. We do it this way so you always have the most current version This will enable you to update your RichFaces version without having to wait for a new release of Exadel Studio. RichFaces support to any project can then be added with a custom capability which is also already defined.

Download and unzip RichFaces from http://labs.jboss.com/jbossRichfaces/ .
In Eclipse, select Window/Preferences/Exadel/Library Set and locate RichFaces in the list.
Click Add and browse to the location where you unzipped the RichFaces jar files.
Add the Jar files in the dialog box.
Click OK.

Afterwards, for any project that you create, just right-click it, select Exadel Studio/Add Custom Capabilities/, and check RichFaces. The assignment of the custom capability will make the necessary changes to web.xml file.

For more information on library sets and custom capabilities, look in the user guide.

Running Exadel Studio for the First Time

Launch Eclipse
Select Window/Open Perspective.../Other...
Select Exadel Studio from the perspective list

We recommend starting Eclipse with VM arguments to make more memory (heap) available for large-scale projects. Open the file <eclipse>\eclipse.ini and set the following:
eclipse -clean -vmargs -Xms512m -Xmx512m -XX:MaxPermSize=128m
This setting will allow the Java heap to grow to 512MB.
Another option to consider adding is:
-vm [path_to_jdk1.5]\bin\javaw.exe
This setting forces Eclipse to use a version 1.5+ JDK (helpful in Windows cases where Eclipse goes to the registry and picks up the wrong JDK).

Upgrading

To upgrade, just uninstall your current version and install the new version.

Make sure Eclipse is not running.
Uninstall your current version of Exadel Studio by deleting the file {EclipseHome}/links/com.exadel.studio.link
Start Eclipse:
eclipse -clean
Close Eclipse
Install the new version of Exadel Studio.
After installation, start Eclipse with the -clean option:
eclipse -clean
This step is very important as it will clear the Eclipse cache of the old uninstalled plug-in.

Uninstalling

Make sure Eclipse is not running.
Uninstall your current version of Exadel Studio by deleting the file {EclipseHome}/links/com.exadel.studio.link
Start Eclipse with the -clean option:
eclipse -clean
This step is very important as it will clear the Eclipse cache of the uninstalled plug-in.

Common Installation Problems

See the Exadel Studio FAQ.

Re-installing and Clearing the Eclipse Cache

The following steps might be useful if you experience problems with the Exadel Studio plug-in. The steps will clear the Eclipse cache and in a sense reinstall Exadel Studio.

Close the Exadel Studio perspective
Make sure Eclipse is not running.
Rename the file {EclipseHome}/links/com.exadel.studio.linkto
com.exadel.studio.link.tmp
Start Eclipse:
eclipse -clean
(You might see an error message. You can just ingore it)
Close Eclipse
Rename the file back to com.exadel.studio.link
Start Eclipse
eclipse -clean
This step is very important as it will clear the Eclipse cache of the previous plug-in.

User Guide, Tutorials and Demos

License Activation

Not required for the current version of Exadel Studio.

Tomcat

The Exadel Studio installer will install Tomcat for running your applications if you select this option during the installation process. This Tomcat listens to port 8080. If you want to use a different Tomcat server than ours, you can select it during installation or you can change the setting in Exadel Studio to make it use a different version.

Sample Applications

Exadel Studio comes with sample applications that you can run out of the box.

Sample JSF Application

Launch Eclipse.
Select File/New/Project... from the menu bar.
Select Exadel Studio/JSF/JSF Project within the dialog box.
Click Next.
Enter jsfExample as the project name.
Leave the project folder location and version as is.
Select the JSFKickStart template.
Click Finish.
To open this JSF project (actually the configuration file), browse to jsfExample/WebContent/WEB-INF/face-config.xml inside the Package Explorer view. Then, open the file by double-clicking on it. The file should open up in a Tree viewer (Diagram viewer for Exadel Studio Pro).
If you have Eclipse set to not compile automatically, select Project/Build All from the menu bar.
Start the Tomcat server by clicking on the Start Tomcat Server icon (green arrow button) in the toolbar.
Once the Tomcat server has started, start the application by clicking on the Run Application button in the toolbar (running man over the butterfly). You can also start the application by entering http://localhost:8080/jsfExample in your browser.

Sample Struts Application

Launch Eclipse.
Select File/New/Project... from the menu bar.
Select Exadel Studio/Struts/Struts Project within the dialog box.
Click Next.
Enter strutsSample as the project name.
Leave the project folder location and version as is.
Select the KickStart template.
Click Finish.
To open this Struts project (actually the configuration file), browse to strutsSample/WebContent/WEB-INF/struts-config.xml inside the Package Explorer view. Open the file by double-clicking on it. The file should open up in a Diagram viewer.
If you have Eclipse set to not compile automatically, select Project/Build All from the menu bar.
Start the Tomcat server by clicking on the Start Tomcat Server icon (green arrow button) in the toolbar.
Once the Tomcat server has started, start the application by clicking on the Run Application button in the toolbar (running man over the butterfly). You can also start the application by entering http://localhost:8080/strutsSample in your browser.

Help

Exadel Studio Pro is an unsupported product except for those whose annual subscription has not run out yet. For these users, email your queastions to support@exadel.com.