Creating WebUI Workspace using Eclipse Webtool
Contents
Overview
Eclipse Webtool support is added at revision 5969 in branches/stable and 5967 in branches/adempiere341 for the single ADempiere project setup workspace. This additions allows you to run or debug the Zk web client using Eclipse webtool (Europa JEE and above ) and Apache Tomcat.
You can verify that everything is in place by checking the project properties:
- Project Facets (do not change anything here.)
- Web Project Settings
Install Tomcat Runtimes
First, you need to install a Tomcat runtime for the deploying and running of the zk Web Client. Use Tomcat 5.5+
To install a new Tomcat runtime, open the preferences dialog Window->Preferences and select the Server->Installed Runtimes. Use the Search button to locate your tomcat installation home folder.
Define a New Server
- At the Servers view, right click to open the context menu and select New->Server.
If server view is not visible then you can use Window→Show View→Others ... to open it.
- Select the correct server type and the server runtime you have setup earlier.
- Add your project to the server instance to be created
- The created server instance is now ready for use. Just Start the server once and then stop it. Do not try to debug it at this moment.
Define location of ADempiere property file and ADempiere home
Now you have to define the location of your existng working 'Adempiere.properties' file and ADEMPIERE_HOME as system parameter for your Tomcat Instance. To do so, select Run->Open Run Dialog... and select the server instance you have created. Note Note that the entries for your server instance in the Run dialog will only be created after you have start it for at least one time. Select the arguments tab and append your property file path and home parameter at the end of VM arguments.
It is highlighted in the pictures below:
Hengsin 01:11, 4 August 2008 (EDT)
Trouble Shooting
I had a problem to start Tomcat with "NoClassDefFoundError". Missing class path to adempiere jars. Solved by editing run configuration. Go to classpath section at user entries add externall libs from tomcat\lib than add projects - AdempiereTrunk
Apache jars needs to be first in the classpath:
- Bootstrap Entries
- JRE Library
- User Entries
- tomcat_dir/bin/*.jar
- tomcat_dir/server/lib/*.jar
- Adempiere Project
- Adempiere Libraries