WTP FAQ

Eclipse Web Tools Frequent Asked Questions

Many of the FAQ's found on this page have been pulled from the WTP newsgroup. Thank you to everyone that took the time to answer these questions.

Looking for FAQ's related to the development of WTP? See the Committer FAQ.

If you have identified a FAQ that is not in this list, please add it to the list. You will need a bugzilla user id in order to edit the page.

General

How is the Eclipse Web Tools platformed licenesed?

The Eclipse Web Tools Platform consists of software produced by the Eclipse Project combined with third party software from other open source projects. The software produced by the Eclipse Project is made available under the Eclipse Public License. Third party components are made available under their own licenses. The detailed licensing information can be found in the Eclipse.org Software User Agreement (notice.html) file in the root directory of the SDK download. Licensing for third party components is described in about.html files in the respective subdirectories.

How can I tell what is new and noteworthy within an specific release?

To be filled in.

How can I find a list of known problems with a release?

To be filled in.

Why am I getting a java.lang.OutOfMemoryError: PermGen space?

The default maximum PermGen space set by your JRE may be too small. You can increase the maximum PermGen size by launching WTP with VM argument: -XX:MaxPermSize=128m

Note that this issue only appears to happen using a Sun Java Runtime. Others runtime environments do not seem to have this issue.

After updating to Eclipse Europa why did I get this "can't find view" error?

After updating to Eclipse Europa I restart and get this error:

Problems occurred restoring workbench.

Could not find view: org.eclipse.wst.rdb.server.ui.navigator.serverExplorer

These errors are expected as RDB is not a part of Europa, so the associated RDB views and perspectives are not there. The user can use the new DTP views and perspectives.

Who are the contributors to the Eclipse Web Tools Platform Project?

We have a whole page listing the hard working contributors to this project. See the Committer FAQ if you are a committer.

What version of Eclipse does WTP work with?

• WTP 1.0.x supports Eclipse 3.1.x.
• WTP 1.5.x supports Eclipse 3.2.
• WTP 2.0 is planned for Eclipse 3.3.

To use WTP with Eclipse 2.1.x see the IBM alphaWorks project IBM Web Tools for Eclipse.

Which zip file should I download?

The WTP SDK (wtp-sdk-*.zip) includes both the Web Standard Tools and J2EE Standard Tools, including source and both user and programmer documentation. If you aren't sure which download you need, you should probably get the SDK.

The software development kit (SDK) downloads are for developers wishing to build solutions on top of the Web Tools Platform, while the non-SDK (e.g.: wtp-0.7.zip) downloads are suitable for everyone else's use. The project also provides separate builds of the Web Standard Tools (wtp-wst-*.zip) by themselves for those uninterested in the tooling for J2EE standards.

How do I install WTP?

• Automatic installation using the Update Manager in Eclipse 3.2.x
• The Web Tools Platform has several required projects that must all be installed for proper operation. Each WTP build is built and tested with specific versions of these "prereqs" (see the Requirements section on each specific build's download page) and it's recommended that only those versions be installed and active when used with a particular WTP build. The WTP download page for each build details the complete list of requirements and provides links to download the supported versions. Downloading and unpacking each should place its contents into a folder named eclipse.
  • Unpack the Eclipse SDK
  • Unzip the Graphical Editor Framework (GEF) into the same location
  • Unzip the Eclipse Modeling Framework (EMF) / XML Schema Infoset Model (XSD) / Service Data Objects (SDO) into the same location
  • Unzip the Java EMF Model (JEM) from the Visual Editor Project into the same location [if listed among the prereqs]
  • Unzip the Web Tools Platform build into the same location

WTP should now be installed. Launch Eclipse with the -clean option one time to ensure all plug-ins are detected properly.

The identical revision of the full VE-SDK may be substituted for the listed JEM-SDK version if you wish to use the Visual Editor and the Web Tools Platform at the same time.

A screencast that includes setting up Xdoclet and a JBoss 3.x test server is also available.

Are there any WTP tutorials available?

Yes! See the WTP Community Resources page.

Data Tools

Where can I find the WTP Data Tools?

Select Window->Show View->Other...->Data. You can then open the Database Explorer and Data Output views. Note: WTP 2.0 will not contain its own data tools as the Data Tools Project is now available.

J2EE

Where can I find the New J2EE Web Module wizard?

J2EE Web Module has been renamed Dynamic Web Project.

Does the WTP include a visual JSP editor?

There is no visual JSP editor in WTP 1.5.

A Web Page Designer is available as part of WTP 2.0.

How do I install XDoclet in WTP?

To install XDoclet:

1. Download XDoctlet from http://sourceforge.net/project/showfiles.php?group_id=31602.
2. Unzip XDoclet to a directory on your machine such as C:\XDoclet
3. Specify the directory in which XDoclet is located in Window->Preferences->J2EE Annotations->XDoclet.

What types of EJBs does WTP support?

WTP supports entity, session and messages driven beans. Support for the Java Persistence Architecture (JPA) is available from the Eclipse Dali Project.

The license dialog hangs Eclipse or doesn't allow me to click accept. What can I do?

This issue is fixed in WTP 1.5.3. If you are experiencing this issue please update to a 1.5.x or greater version.