Mailing-List: contact scm-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@geronimo.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r689643 -
 /geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt
Date: Wed, 27 Aug 2008 22:30:36 -0000
To: scm@geronimo.apache.org
From: tkirby@apache.org
Message-Id: <20080827223036.67E3D238899B@eris.apache.org>

Author: tkirby
Date: Wed Aug 27 15:30:35 2008
New Revision: 689643

URL: http://svn.apache.org/viewvc?rev=689643&view=rev
Log:
GERONIMODEVTOOLS-505 PLUGIN_RELEASE-NOTES-2.1.2.txt missing from distribution
create/put release notes in svn

Added:
    geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt   (with props)

Added: geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt
URL: http://svn.apache.org/viewvc/geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt?rev=689643&view=auto
==============================================================================
--- geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt (added)
+++ geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt Wed Aug 27 15:30:35 2008
@@ -0,0 +1,332 @@
+Release Notes -- Apache Geronimo Eclipse Plugin -- Version 2.1.2
+
+
+Helpful URLs
+------------
+Eclipse IDE for Java EE Developers:         http://www.eclipse.org/downloads/
+Geronimo Devtools:                          http://geronimo.apache.org/devtools.html
+Geronimo Eclipse Update Site:               http://geronimo.apache.org/devtools
+Quick start - fast and easy development:    http://cwiki.apache.org/GMOxDOC21/quick-start-fast-and-easy-development.html
+Sun's J2SE 5.0 Downloads site:              http://java.sun.com/javase/downloads/index_jdk5.jsp
+5-minute Tutorial using GEP:                http://cwiki.apache.org/GMOxDOC21/5-minute-tutorial-on-enterprise-application-development-with-eclipse-and-geronimo.html
+
+
+
+System Requirements
+-------------------
+1. Sun JDK 5.0+ (J2SE 1.5)
+
+2. Eclipse IDE for Java EE Developers (Ganymede or Europa), which is platform-specific
+
+3. Geronimo server (2.0.x or 2.1.x)
+
+
+
+Notes
+-----
+You will likely need to increase the default setting for maximum PermGen size
+for your Eclipse installation (especially for Sun's JDK 1.5.0_x on the Windows
+platform) to prevent "java.lang.OutOfMemoryError: PermGen" errors. From the
+command line you can use:
+
+        eclipse -vmargs -Xms128m -Xmx512m -XX:MaxPermSize=128m
+
+Or you can edit your eclipse.ini file. An example is shown below but remember
+that each argument has to be on seperate lines:
+
+        -vmargs
+        -Xms128m
+        -Xmx512m
+        -XX:MaxPermSize=128m
+
+
+
+Geronimo Eclipse Plugin Version 2.1.2 Enhancements
+--------------------------------------------------
+1. Eclipse Ganymede support (along with continued Europa support)
+
+2. Java 1.6 runtime support (along wiht continued 1.5 runtime support)
+
+3. Numerous enhancements the Geronimo deployment plan editors
+
+4. "Download and Install" server feature replaced with a URL link to the Geronimo Server download page
+
+
+
+Installation Option #1: Install from within WTP
+-----------------------------------------------
+There a several installation alternatives, but the easiest method is not to
+download the plugin at all !! It can be installed directly from within WTP by
+clicking on the "Don't see your server listed?" link when defining a server
+runtime in WTP. Select it, then select Geronimo 2.1.2 and the installation
+process will begin. Once the workbench restarts Geronimo 2.1.2 support will be
+available.
+
+1 -- Invoke the eclipse executable from your /eclipse directory.  Select or
+     accept the default workspace.
+
+2 -- Open the Preferences dialog:
+
+     a. Window  --> Preferences --> Server --> Installed Runtimes --> Click
+        "Add"
+
+     b. Select "Download addtional server adapters
+
+     c. Select the "Geronimo v2.1 Server Adapter 2.1.2" adapter
+
+     d. Select Next --> Accept the license agreement --> Next --> Finish
+
+     e. It will then download and install the plugin artifacts (takes a few
+        seconds)
+
+     f. Select "Install All"
+
+     g. Select Yes to restart Eclipse
+
+3 -- Verify that the GEP was correctly installed:
+
+     a. Help --> About Eclipse Platform
+
+     b. Ensure that the Geronimo icon displays somewhere in the row of icons in the "About 
+        Eclipse Platform" pane. If not, the GEP was not installed correctly. 
+
+4 -- Define a new server. From Eclipse select:
+
+     a. File --> New --> Other --> Server --> Server --> Next --> Apache. 
+        At this point you must see the Apache Geronimo v2.1 Server selection
+        or the plugin was not installed/unzipped correctly. 
+
+     b. Select "Apache Geronimo v2.1 Server" --> Next --> then enter the root 
+        directory of your Geronimo server installation --> Next --> Next --> 
+        Next --> Finish
+
+     c. Now in the Java EE perspective you should see the Apache Geronimo v2.1 
+        server (bottom pane, middle tab usually) that you can now start in 
+        Eclipse (either right-click on it and select start or select the little
+        green and white arrow on the far right of the server pane). You should 
+        then see the console and the familiar server startup messages.
+	
+     d. Right-click on the server and select "Launch Geronimo Console" to bring
+        up an admin console browser window in Eclipse.
+
+
+
+Installation Option #2: Use Eclipse Update Site
+-----------------------------------------------
+Alternatively, you can download both the Eclipse Plugin from the Eclipse Update 
+Site. Again if you've never done this before the steps are fairly straightforward:
+
+1 -- Invoke the eclipse executable from your /eclipse directory.  Select or
+     accept the default workspace. 
+
+2 -- Open the Eclipse Software Updates dialog:
+
+     a. Help --> Software Updates --> Available Software
+
+     b. On the "Available Software" tab you must add a new remote site to 
+        point to the Staging site.  Click "Add Site" button --> set URL to this:
+   
+        http://apache.org/dist/geronimo/eclipse/updates/
+
+     c. Expand this site and select the "Geronimo v2.1 Server Adapter" and click the
+        "Install" button. You may likely have to wait a few seconds while Eclipse 
+        resolves the dependencies. 
+
+     d. Select Next --> Accept the license agreement --> Finish
+
+     e. It will then download and install the plugin artifacts (takes a few 
+        seconds)
+
+     f. Select Yes to restart Eclipse
+
+3 -- Verify that the GEP was correctly installed:
+
+     a. Help --> About Eclipse Platform
+
+     b. Ensure that the Geronimo icon displays somewhere in the row of icons in the "About 
+        Eclipse Platform" pane. If not, the GEP was not installed correctly. 
+
+4 -- Define a new server. From Eclipse select:
+
+     a. File --> New --> Other --> Server --> Server --> Next --> Apache. 
+        At this point you must see the Apache Geronimo v2.1 Server selection
+        or the plugin was not installed/unzipped correctly. 
+
+     b. Select "Apache Geronimo v2.1 Server" --> Next --> then enter the root 
+        directory of your Geronimo server installation --> Next --> Next --> 
+        Next --> Finish
+
+     c. Now in the Java EE perspective you should see the Apache Geronimo v2.1 
+        server (bottom pane, middle tab usually) that you can now start in 
+        Eclipse (either right-click on it and select start or select the little
+        green and white arrow on the far right of the server pane). You should 
+        then see the console and the familiar server startup messages.
+	
+     d. Right-click on the server and select "Launch Geronimo Console" to bring
+        up an admin console browser window in Eclipse.
+
+
+
+Installation Option #3: Install Plugin Manually
+-----------------------------------------------
+You can just download the plugin itself and unzip it into the same directory
+where the prereq was installed (e.g., /eclipse). If you choose this option 
+you must have an installed version of the Geronimo 2.1 server somewhere on your 
+system so that you can define a Geronimo Server configuration. If you've never 
+done this before the steps are fairly straightforward:
+
+1 -- Download the GEP and unzip into your /eclipse directory. You can 
+     download the plugin from here: 
+
+     http://apache.org/dist/geronimo/eclipse/2.1.2/
+
+2 -- Invoke the eclipse executable from your /eclipse directory. Select or
+     accept the default workspace. 
+
+3 -- Verify that the GEP was correctly installed:
+
+     a. Help --> About Eclipse Platform
+
+     b. Ensure that the Geronimo icon displays somewhere in the row of icons in the "About 
+        Eclipse Platform" pane. If not, the GEP was not installed correctly. 
+
+4 -- Open the Java EE perspective. From within Eclipse:
+
+     a. Close the Welcome tab
+
+     b. Select Window --> Open Perspective --> Other --> Java EE
+        You should now be in the Java EE perspective. You can see the open 
+        perspective tabs in the upper right-hand corner of your Eclipse  
+        workspace.
+
+5 -- Define a new server. From Eclipse select:
+
+     a. File --> New --> Other --> Server --> Server --> Next --> Apache. 
+        At this point you must see the Apache Geronimo v2.1 Server selection
+        or the plugin was not installed/unzipped correctly. 
+
+     b. Select "Apache Geronimo v2.1 Server" --> Next --> then enter the root 
+        directory of your Geronimo server installation --> Next --> Next --> 
+        Next --> Finish
+
+     c. Now in the Java EE perspective you should see the Apache Geronimo v2.1 
+        server (bottom pane, middle tab usually) that you can now start in 
+        Eclipse (either right-click on it and select start or select the little
+        green and white arrow on the far right of the server pane). You should 
+        then see the console and the familiar server startup messages.
+	
+     d. Right-click on the server and select "Launch Geronimo Console" to bring
+        up an admin console browser window in Eclipse.
+
+
+
+Bug Fixes and New Features
+--------------------------
+GERONIMODEVTOOLS-208    Always appends default value into Server VM Arguments field after modifying this field.
+
+GERONIMODEVTOOLS-216    Remote server support
+
+GERONIMODEVTOOLS-251    J2EE dependencies in an Enterprise Applicaition artifact not maintained across Eclipse restart (and undeploy/redploy cycle)
+
+GERONIMODEVTOOLS-275    Eclipse does not allow to download Apache Geronimo
+
+GERONIMODEVTOOLS-332    GEP should be made to work with the Trunk version of the Geronimo Server
+
+GERONIMODEVTOOLS-325    "Download and Install" button should be disabled/enabled appropriately
+
+GERONIMODEVTOOLS-340    GEP editor error opening Geronimo deployment plan(s) with 1.1 namespaces
+
+GERONIMODEVTOOLS-345    Reported server state falls out-of-sync after Windows Hibernate
+
+GERONIMODEVTOOLS-349    GEP synchronization with a server running outside of Eclipse no longer works
+
+GERONIMODEVTOOLS-356    geronimo-service.xml support in GEP is incomplete
+
+GERONIMODEVTOOLS-367    unable to include modules and ext-modules
+
+GERONIMODEVTOOLS-392    unable to set hidden-classes and non-overridable-classes for environment
+
+GERONIMODEVTOOLS-402    Upgrade GEP to support Eclipse 3.4 and WTP 3.0
+
+GERONIMODEVTOOLS-404    simplify the Dependency GUI code
+
+GERONIMODEVTOOLS-405    MDB EJB deploy failure
+
+GERONIMODEVTOOLS-410    Providing better editor support in Source page of Geronimo Deployment Plan Editors
+
+GERONIMODEVTOOLS-411    Add Syntax-highlighting feature in Source page of Geronimo Deployment Plan Editor
+
+GERONIMODEVTOOLS-412    Add Content assist feature to the source page of Geronimo Deployment Plan Editor
+
+GERONIMODEVTOOLS-415    Delete schema files in plugins\org.apache.geronimo.jee.v21.jaxbmodel which is a duplicate after GERONIMODEVTOOLS-412 fix
+
+GERONIMODEVTOOLS-417    Create a separate installable runtime feature for each version and type of geronimo server
+
+GERONIMODEVTOOLS-420    Add size information to features so Eclipse Update Manager can show them to users
+
+GERONIMODEVTOOLS-425    Query Dynamic Information from Server
+
+GERONIMODEVTOOLS-426    importing GEP feature plugins gives errors when building workspace
+
+GERONIMODEVTOOLS-427    Invalid text in generated geronimo-application-client.xml
+
+GERONIMODEVTOOLS-428    NullpointerException deploying warfile without Geronimo deployment descriptor
+
+GERONIMODEVTOOLS-429    Testcase failures in org.apache.geronimo.st.core plugin
+
+GERONIMODEVTOOLS-431    When defining a new project the "Project Facets" wizard is not presented to the user when using Ganymede.
+
+GERONIMODEVTOOLS-434    Query Dynamic Information from Server using JMX
+
+GERONIMODEVTOOLS-435    Define new server testcase
+
+GERONIMODEVTOOLS-436    5 Minute tutorial testcase
+
+GERONIMODEVTOOLS-438    Close Welcome pane testcase
+
+GERONIMODEVTOOLS-439    Download/install new server testcase
+
+GERONIMODEVTOOLS-440    Convert the old deployment plan to the current version using NamespaceFilter
+
+GERONIMODEVTOOLS-441    Retrieving Metadata complete Deployment Descriptor for Web Projects
+
+GERONIMODEVTOOLS-444    5 Minute tutorial web browser testcase
+
+GERONIMODEVTOOLS-445    Remove helloworld testsuite -- no longer needed
+
+GERONIMODEVTOOLS-446    Repeated "mvn install" of testsuite not working without clean
+
+GERONIMODEVTOOLS-448    Cache the Dynamic server info retrieved using JMX
+
+GERONIMODEVTOOLS-457    Empty Web Container setting causes "xml problem for web app" during deployment
+
+GERONIMODEVTOOLS-458    NullPointerException when creating new geronimo-web.xml
+
+GERONIMODEVTOOLS-459    Testsuite fails on Windows 2003 server -- not able to find a terminal session
+
+GERONIMODEVTOOLS-467    Can't uninstall runtime after installing it via eclipse update manager in Ganymede
+
+GERONIMODEVTOOLS-468    JAXBException when marshalling geronimo-web.xml
+
+GERONIMODEVTOOLS-469    Remove Core Geronimo Feature
+
+GERONIMODEVTOOLS-470    Support JAXB RI with Java 5 
+
+GERONIMODEVTOOLS-474    Ensure IBM 1.6 JDK works with GEP 2.1.2
+
+GERONIMODEVTOOLS-475    GEP does not build on Mac with Java 6
+
+GERONIMODEVTOOLS-476    Don't download server images. Refer to AG website for this.
+
+GERONIMODEVTOOLS-477    Add a Support popup menu option to a server to launch a browser window to Geronimo Home page
+
+GERONIMODEVTOOLS-478    Include build date in the About information for features
+
+GERONIMODEVTOOLS-479    Handle Java 1.6 rt.jar for Java 1.5 user
+
+GERONIMODEVTOOLS-480    Support Web application test using the embeded browser in testsuite
+
+GERONIMODEVTOOLS-482    missing image for GEP features in "About Eclipse Platform" Dialog
+
+GERONIMODEVTOOLS-484    Fix missing source license headers
+

Propchange: geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt
------------------------------------------------------------------------------
    svn:keywords = Date Revision

Propchange: geronimo/devtools/eclipse-plugin/trunk/PLUGIN_RELEASE-NOTES-2.1.2.txt
------------------------------------------------------------------------------
    svn:mime-type = text/plain