You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tomee.apache.org by rm...@apache.org on 2015/12/12 12:04:03 UTC
svn commit: r1719651 - in /tomee/site/trunk/content: documentation.mdtext
getting-started-with-eclipse-and-webby.md tomee-and-eclipse.mdtext
Author: rmannibucau
Date: Sat Dec 12 11:04:02 2015
New Revision: 1719651
URL: http://svn.apache.org/viewvc?rev=1719651&view=rev
Log:
TOMEE-1624 documentation page update with IDE part
Modified:
tomee/site/trunk/content/documentation.mdtext
tomee/site/trunk/content/getting-started-with-eclipse-and-webby.md
tomee/site/trunk/content/tomee-and-eclipse.mdtext
Modified: tomee/site/trunk/content/documentation.mdtext
URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/documentation.mdtext?rev=1719651&r1=1719650&r2=1719651&view=diff
==============================================================================
--- tomee/site/trunk/content/documentation.mdtext (original)
+++ tomee/site/trunk/content/documentation.mdtext Sat Dec 12 11:04:02 2015
@@ -1,100 +1,101 @@
Title: Documentation
-See also the [examples page](examples-trunk/index.html) for downloadable, executable and code-focused view of Java EE and TomEE.
+See also the [examples page](examples-trunk/index.html) for downloadable, executable and code-focused view of Java EE and TomEE.
You can also find us on IRC freenode.org #openejb and #tomee
{row
{span-one-third
-###General Guides
-[Get started with Intellij](tomee-and-intellij.html), [Debugging in Intellij](contrib/debug/debug-intellij.html)
-[Get started with Eclipse](tomee-and-eclipse.html)
-[Get started with Netbeans](tomee-and-netbeans.html)
-[Get started with Maven](tomee-mp-getting-started.html)
-[Eclipse WTP and TomEE logging](tomee-logging-in-eclipse.html)
-[Comparison: OpenEJB, TomEE, TomEE+](comparison.html)
-[TomEE Directory structure](tomee-directory-structure.html)
-[TomEE Configuration](Configuring-in-tomee.html)
-[TomEE Security](tomee-and-security.html)
-[Deploying in TomEE](deploying-in-tomee.html)
-[The 'tomee' webapp](tomee-webapp.html)
-[Install TomEE using the drop-in WAR](installation-drop-in-war.html)
-[TomEE Reference Card](refcard/refcard.html)
+###IDE
+[Get started with Intellij](tomee-and-intellij.html), [Debugging in Intellij](contrib/debug/debug-intellij.html)
+[Get started with Eclipse (WTP)](tomee-and-eclipse.html)
+[Get started with Eclipse (m2e-Webby)](getting-started-with-eclipse-and-webby.html)
+[Get started with Netbeans](tomee-and-netbeans.html)
+
+###General Informations
+[Comparison: OpenEJB, TomEE, TomEE+](comparison.html)
+[TomEE Directory structure](tomee-directory-structure.html)
+[Deploying in TomEE](deploying-in-tomee.html)
+[The 'tomee' webapp](tomee-webapp.html)
+[TomEE Reference Card](refcard/refcard.html)
[ApplicationComposer](application-composer/index.html)
}
{span-one-third
###Configuration
-[System Properties](system-properties.html)
-[Deployments](deployments.html)
-[Containers and Resources](containers-and-resources.html)
-[JMS Resources and MDB Container](jms-resources-and-mdb-container.html)
-[Configuring DataSources](configuring-datasources.html)
-[Configuring JavaMail](configuring-javamail.html)
-[Security](security.html)
-[EJB Clients](clients.html)
-[EJB over SSL](ejb-over-ssl.html)
-[JNDI Names](jndi-names.html)
-[Changing JMS implementations](changing-jms-implementations.html)
-[Changing JPA to Hibernate](tomee-and-hibernate.html)
+[System Properties](system-properties.html)
+[Deployments](deployments.html)
+[Configuring Resources](Configuring-in-tomee.html)
+[Configuring DataSources](configuring-datasources.html)
+[Containers and Resources](containers-and-resources.html)
+[JMS Resources and MDB Container](jms-resources-and-mdb-container.html)
+[Configuring JavaMail](configuring-javamail.html)
+[TomEE Security](tomee-and-security.html)
+[Security How To](security.html)
+[EJB Clients](clients.html)
+[EJB over SSL](ejb-over-ssl.html)
+[JNDI Names](jndi-names.html)
+[Changing JMS implementations](changing-jms-implementations.html)
+[Changing JPA to Hibernate](tomee-and-hibernate.html)
}
{span-one-third
###Testing Techniques
-[Application discovery via the classpath](application-discovery-via-the-classpath.html)
-[Embedded Configuration](embedded-configuration.html)
-[Configuring DataSources in Tests](configuring-datasources-in-tests.html)
-[Configuring PersistenceUnits in Tests](configuring-persistenceunits-in-tests.html)
-[Configuring Containers in Tests](configuring-containers-in-tests.html)
-[Configuring Logging in Tests](configuring-logging-in-tests.html)
-[Alternate Descriptors](alternate-descriptors.html)
-[Unit Testing Transactions](unit-testing-transactions.html)
-[TestCase with TestBean inner-class](testcase-with-testbean-inner-class.html)
-[TestCase Injection (@LocalClient)](local-client-injection.html)
+[Application discovery via the classpath](application-discovery-via-the-classpath.html)
+[Embedded Configuration](embedded-configuration.html)
+[Configuring DataSources in Tests](configuring-datasources-in-tests.html)
+[Configuring PersistenceUnits in Tests](configuring-persistenceunits-in-tests.html)
+[Configuring Containers in Tests](configuring-containers-in-tests.html)
+[Configuring Logging in Tests](configuring-logging-in-tests.html)
+[Alternate Descriptors](alternate-descriptors.html)
+[Unit Testing Transactions](unit-testing-transactions.html)
+[TestCase with TestBean inner-class](testcase-with-testbean-inner-class.html)
+[TestCase Injection (@LocalClient)](local-client-injection.html)
}
}
{row
{span-one-third
###Discovery and Failover
-[Overview](ejb-failover.html)
-[Multicast Discovery (UDP)](multicast-discovery.html)
-[Multipulse Discovery (UDP)](multipulse-discovery.html)
-[Multipoint Discovery (TCP)](multipoint-discovery.html)
-[Multipoint Considerations](multipoint-considerations.html)
-[Multipoint Recommendations](multipoint-recommendations.html)
-[Logging Events](failover-logging.html)
+[Overview](ejb-failover.html)
+[Multicast Discovery (UDP)](multicast-discovery.html)
+[Multipulse Discovery (UDP)](multipulse-discovery.html)
+[Multipoint Discovery (TCP)](multipoint-discovery.html)
+[Multipoint Considerations](multipoint-considerations.html)
+[Multipoint Recommendations](multipoint-recommendations.html)
+[Logging Events](failover-logging.html)
}
{span-one-third
###OpenEJB Standalone Server
-[Understanding the Directory Layout](understanding-the-directory-layout.html)
-[Startup](startup.html)
-[Deploy Tool](deploy-tool.html)
-[Properties Tool](properties-tool.html)
+[Understanding the Directory Layout](understanding-the-directory-layout.html)
+[Startup](startup.html)
+[Deploy Tool](deploy-tool.html)
+[Properties Tool](properties-tool.html)
}
{span-one-third
###Spring
-[Spring and OpenEJB 3.0](spring-and-openejb-3.0.html)
-[Spring and OpenEJB 3.1 and later](spring.html)
-[Spring, EJB and JPA example](spring-ejb-and-jpa.html)
+[Spring and OpenEJB 3.0](spring-and-openejb-3.0.html)
+[Spring and OpenEJB 3.1 and later](spring.html)
+[Spring, EJB and JPA example](spring-ejb-and-jpa.html)
}
}
{row
{span-one-third
###Arquillian
-[Arquillian Primer - What you need to know](arquillian-getting-started.html)
-[Using the TomEE Arquillian adapters](arquillian-available-adapters.html)
+[Arquillian Primer - What you need to know](arquillian-getting-started.html)
+[Using the TomEE Arquillian adapters](arquillian-available-adapters.html)
}
{span-one-third
###TomEE Maven Plugin
-[Getting started](tomee-mp-getting-started.html)
-[tomee-maven-plugin reference documentation](maven/index.html)
-[TomEE simple webapp archetype documentation](tomee-mp-getting-started.html)
+[Getting started](tomee-mp-getting-started.html)
+[tomee-maven-plugin reference documentation](maven/index.html)
+[TomEE simple webapp archetype documentation](tomee-mp-getting-started.html)
}
{span-one-third
###Tips and Tricks
-[Global Concurrency Management](tip-concurrency.html)
-[WebLogic Lookup](tip-weblogic.html)
-[Jersey Client](tip-jersey-client.html)
+[Install TomEE using the drop-in WAR](installation-drop-in-war.html)
+[Global Concurrency Management](tip-concurrency.html)
+[WebLogic Lookup](tip-weblogic.html)
+[Jersey Client](tip-jersey-client.html)
+}
}
-}
\ No newline at end of file
Modified: tomee/site/trunk/content/getting-started-with-eclipse-and-webby.md
URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/getting-started-with-eclipse-and-webby.md?rev=1719651&r1=1719650&r2=1719651&view=diff
==============================================================================
--- tomee/site/trunk/content/getting-started-with-eclipse-and-webby.md (original)
+++ tomee/site/trunk/content/getting-started-with-eclipse-and-webby.md Sat Dec 12 11:04:02 2015
@@ -1,6 +1,6 @@
# TomEE and Eclipse using Webby
-If you want to use Eclipse and WTP (the classic way), please read this [docs](http://openejb.apache.org/tomee-and-eclipse.html).
+If you want to use Eclipse and WTP (the classic way), please read this [docs](http://tomee.apache.org/tomee-and-eclipse.html).
If you intends to run a Maven WAR project, you can adopt [m2eclipse-webby](https://github.com/tesla/m2eclipse-webby), because it will be more efficient. In this case, follow this docs.
Modified: tomee/site/trunk/content/tomee-and-eclipse.mdtext
URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/tomee-and-eclipse.mdtext?rev=1719651&r1=1719650&r2=1719651&view=diff
==============================================================================
--- tomee/site/trunk/content/tomee-and-eclipse.mdtext (original)
+++ tomee/site/trunk/content/tomee-and-eclipse.mdtext Sat Dec 12 11:04:02 2015
@@ -16,15 +16,15 @@ Notice: Licensed to the Apache Softwa
specific language governing permissions and limitations
under the License.
-Using TomEE in Eclipse is pretty simple since it uses the existing Tomcat 7 server adaptor that comes
+Using TomEE in Eclipse is pretty simple since it uses the existing Tomcat 7 server adaptor that comes
with Eclipse.
-## Quick Start:
+## Quick Start
-An excellent instructional video with step-by-step instructions on how to install Eclipse, TomEE
+An excellent instructional video with step-by-step instructions on how to install Eclipse, TomEE
and create/deploy your first project is available on YouTube here: [Getting Started with Apache TomEE][1] (Remember to select the 'Generate web.xml descriptor' checkbox during project setup. Otherwise the ejb does not get injected and you will get an error.).
-1. Download and install both Apache TomEE and Eclipse.
+1. Download and install both Apache TomEE and Eclipse.
1. Start Eclipse and from the main menu go to **File** - **New** - **Dynamic Web Project**
@@ -36,7 +36,7 @@ and create/deploy your first project is
1. Change the **Name** field to *TomEE* to indicate that this is a TomEE server rather than a Tomcat server.
-1. Set the **Tomcat installation directory** by clicking the **Browse** button and selecting the folder
+1. Set the **Tomcat installation directory** by clicking the **Browse** button and selecting the folder
where you extracted TomEE
1. Click **Finish** to return to the New Project dialog
@@ -52,42 +52,42 @@ where you extracted TomEE
1. Click **Finish** - Eclipse will start TomEE and deploy your project
## Advanced installation
-
-1. In Eclipse, click on the **Servers** tab, right click and select New - Server.
-1. Select **Apache - Tomcat v7.0 Server** and click **Next**
+1. In Eclipse, click on the **Servers** tab, right click and select New - Server.
-1. Set the **Tomcat installation directory** by clicking the **Browse** button and selecting the folder
+1. Select **Apache - Tomcat v7.0 Server** and click **Next**
+
+1. Set the **Tomcat installation directory** by clicking the **Browse** button and selecting the folder
where you extracted TomEE
-1. Add your webapp to the server. Click **Finish**.
+1. Add your webapp to the server. Click **Finish**.
-1. In the **Servers** tab, double click on your server to open up the **Overview** page.
-Click on the **Modules** tab
+1. In the **Servers** tab, double click on your server to open up the **Overview** page.
+Click on the **Modules** tab
-1. Click **Add External Web Module**. In the **Add Web Module** dialog, for document base, browse
-to `<TomEE>/webapps/tomee`. Set **Path:** to `/tomee`. Uncheck **Auto reloading enabled**. Click OK.
+1. Click **Add External Web Module**. In the **Add Web Module** dialog, for document base, browse
+to `<TomEE>/webapps/tomee`. Set **Path:** to `/tomee`. Uncheck **Auto reloading enabled**. Click OK.
-1. Return to the **Overview** tab for the server.
+1. Return to the **Overview** tab for the server.
1. Deselect the **Modules auto reload by default** checkbox.
-1. If you do not want Eclipse to take control of your TomEE installation, select **Use Workspace Metadata**
+1. If you do not want Eclipse to take control of your TomEE installation, select **Use Workspace Metadata**
under **Server Locations**. Please review the *Workspace Metadata Installation* section below for additional steps
in this scenario. Otherwise, select **Use Tomcat Installation**
-1. Click the Save button in Eclipse so the server configuration gets saved.
+1. Click the Save button in Eclipse so the server configuration gets saved.
-1. Click on your webapp project, then select Project - clean. Hit OK. This will cause
-Eclipse to clean and rebuild
+1. Click on your webapp project, then select Project - clean. Hit OK. This will cause
+Eclipse to clean and rebuild
-1. In the **Servers** tab, right click on the server and select **Publish**.
+1. In the **Servers** tab, right click on the server and select **Publish**.
1. Start the server.
### Workspace Metadata Installation
-If you used **Use Workspace Metadata** in the **Server Locations** definition of the TomEE server,
-you will have to add TomEE specific configuration files to your Servers project in your workspace
+If you used **Use Workspace Metadata** in the **Server Locations** definition of the TomEE server,
+you will have to add TomEE specific configuration files to your Servers project in your workspace
in case you need to change system properties or add containers / resources and have those reflected in the
server running under Eclipse.
@@ -103,11 +103,11 @@ server running under Eclipse.
1. Click **Finish** to import the files.
-1. In the **Servers** tab, right-click the TomEE server and select **Publish** to publish the files to the
+1. In the **Servers** tab, right-click the TomEE server and select **Publish** to publish the files to the
Eclipse metadata folder
-If you need to modify system properties or change your TomEE resources, containers, etc., you now need to make
-those changes in the Workspace / Servers / `<`Your Server`>` location and publish them to the server for
+If you need to modify system properties or change your TomEE resources, containers, etc., you now need to make
+those changes in the Workspace / Servers / `<`Your Server`>` location and publish them to the server for
the changes to take effect.
### JSP Hot Deployment
@@ -127,5 +127,15 @@ This is the relevant snippet of the web.
....
</servlet>
+## How to use JULI for TomEE in WTP?
+
+It seems that WTP doesn't manage correctly Tomcat logging configuration (which needs to be done through
+system properties). A quick workaround is to add these properties manually:
+
+ -Djava.util.logging.config.file="<tomee>/conf/logging.properties"
+ -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
+
+More information on: http://wiki.eclipse.org/WTP_Tomcat_FAQ#How_do_I_enable_the_JULI_logging_in_a_Tomcat_5.5_Server_instance.3F
+
- [1]: http://www.youtube.com/watch?v=Lr8pxEACVRI "Getting Started with Apache TomEE"
\ No newline at end of file
+ [1]: http://www.youtube.com/watch?v=Lr8pxEACVRI "Getting Started with Apache TomEE"