geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo v2.1 > How to install Geronimo Eclipse Plugin
Date Wed, 30 Dec 2009 08:02:00 GMT
<html>
<head>
    <base href="http://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1519/1/1/_/styles/combined.css?spaceKey=GMOxDOC21&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background-color: white" bgcolor="white">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
     <h2><a href="http://cwiki.apache.org/confluence/display/GMOxDOC21/How+to+install+Geronimo+Eclipse+Plugin">How
to install Geronimo Eclipse Plugin</a></h2>
     <h4>Page <b>edited</b> by             <a href="http://cwiki.apache.org/confluence/display/~daition@gmail.com">delos</a>
    </h4>
     
          <br/>
     <div class="notificationGreySide">
         <style type='text/css'>/*<![CDATA[*/
table.ScrollbarTable  {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color:
#f0f0f0}
table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}

/*]]>*/</style><div class="Scrollbar"><table class='ScrollbarTable'><tr><td
class='ScrollbarPrevIcon'><a href="/confluence/display/GMOxDOC21/How+to+get+daily+Geronimo+Eclipse+Plugin+builds"><img
border='0' align='middle' src='/confluence/images/icons/back_16.gif' width='16' height='16'></a></td><td
width='33%' class='ScrollbarPrevName'><a href="/confluence/display/GMOxDOC21/How+to+get+daily+Geronimo+Eclipse+Plugin+builds">How
to get daily Geronimo Eclipse Plugin builds</a>&nbsp;</td><td width='33%'
class='ScrollbarParent'><sup><a href="/confluence/display/GMOxDOC21/Apache+Geronimo+Development+Tools+Project"><img
border='0' align='middle' src='/confluence/images/icons/up_16.gif' width='8' height='8'></a></sup><a
href="/confluence/display/GMOxDOC21/Apache+Geronimo+Development+Tools+Project">Apache Geronimo
Development Tools Project</a></td><td width='33%' class='ScrollbarNextName'>&nbsp;<a
href="/confluence/display/GMOxDOC21/How+to+open+a+bug+for+Geronimo+Eclipse+Plugin">How
to open a bug for Geronimo Eclipse Plugin</a></td><td class='ScrollbarNextIcon'><a
href="/confluence/display/GMOxDOC21/How+to+open+a+bug+for+Geronimo+Eclipse+Plugin"><img
border='0' align='middle' src='/confluence/images/icons/forwd_16.gif' width='16' height='16'></a></td></tr></table></div>
<p>We will be using Eclipse Galileo and Sun JDK 6.0&#43; for the illustration. Geronimo
Eclipse Plugin (GEP) can be installed using the following options:</p>
<div>
<ul>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-Prerequisites'>Prerequisites
</a></li>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-InstallingGEPwithinWTP'>Installing
GEP within WTP</a></li>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-InstallingGEPusingEclipseupdatemanager'>Installing
GEP using Eclipse update manager</a></li>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-ManualInstallation'>Manual
Installation</a></li>
<ul>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-Usingupdatesite.zip'>Using
updatesite.zip</a></li>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-Usingdeployable.zip'>Using
deployable.zip</a></li>
</ul>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-VerifyGEPinstallation'>Verify
GEP installation</a></li>
    <li><a href='#HowtoinstallGeronimoEclipsePlugin-UninstallingGEP'>Uninstalling
GEP</a></li>
</ul></div>
<p>This page describes how to install the current release of the GEP.  For information
about installing previous releases, see</p>

<p> <a href="http://geronimo.apache.org/development-tools.html#DevelopmentTools-PreviousReleases"
rel="nofollow">this page</a> .</p>
<div class='panelMacro'><table class='tipMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/check.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td><p>Note that with v2.2,
the v2.2 Geronimo server adapter feature provides server adapters for the v1.1.x, v2.0.x,
v2.1.x and v2.2 Geronino servers. The reason for supporting v1.1.x server is to make v1.1.x
server adapter compatible with latest version of eclipse. But since Geronimo 1.1 did not officially
support JDK 6, it's not recommended to use v1.1.x server adapter with JDK 6.See the requirement
in <a href="https://issues.apache.org/jira/browse/GERONIMODEVTOOLS-578" title="The JIRA
for the requirement of integrating v1.1 server adapter" rel="nofollow">GERONIMODEVTOOLS-578</a>
.</p>
</td></tr></table></div>

<h1><a name="HowtoinstallGeronimoEclipsePlugin-Prerequisites"></a>Prerequisites
<a name="HowtoinstallGeronimoEclipsePlugin-Prereqs"></a></h1>

<ul>
	<li>Java J2SE 1.5.0 or greater</li>
	<li>Eclipse IDE for Java EE Developers (Galileo (Eclipse 3.5)&nbsp; or Ganymede
(Eclipse 3.4))
	<ul>
		<li><a href="http://www.eclipse.org/downloads/" title="Eclipse Galileo download
link" rel="nofollow">Eclipse Galileo Download</a></li>
		<li><a href="http://www.eclipse.org/downloads/packages/" rel="nofollow">Eclipse
Ganymede Download</a></li>
	</ul>
	</li>
	<li>Apache Geronimo 2.2 server
	<ul>
		<li><a href="http://geronimo.apache.org/apache-geronimo-v22-release.html" rel="nofollow">Apache
Geronimo downloads</a></li>
	</ul>
	</li>
</ul>


<p>See <a href="/confluence/pages/createpage.action?spaceKey=GMOxDOC21&amp;title=PLUGIN_RELEASE-NOTES-2.2.txt&amp;linkCreation=true&amp;fromPageId=96518"
class="createlink">PLUGIN_RELEASE-NOTES-2.2.txt</a> for additional details.</p>

<h1><a name="HowtoinstallGeronimoEclipsePlugin-InstallingGEPwithinWTP"></a>Installing
GEP within WTP</h1>

<ol>
	<li>Once you have all the <a href="#HowtoinstallGeronimoEclipsePlugin-Prerequisites">Prerequisites</a>
installed, launch Eclipse from &lt;Eclipse_Home&gt;/eclipse.</li>
	<li>By default Eclipse will be launched with Java EE perspective.</li>
	<li>Select the servers tab as shown in the figure and select New-&gt;Server.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure1.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>On the next screen select <b>Download Additional Server Adapters</b>
as shown in the figure.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure2.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Select <b>Geronimo V2.2 Server Adapter</b> v2.2 adapter and select
Next.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/DownLoadServerAdapters.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Accept the license agreement and select Finish.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure4.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Next screen will ask for confirmation. Select Ok. Once done Geronimo V2.1 server
adapter will be downloaded and installed.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure5.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Once the adapter is installed you will be prompted to restart the server. Select
Yes.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure6.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
</ol>


<div class='panelMacro'><table class='tipMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/check.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td><p>From version 3.4, Eclipse
adopt a new update manager called P2. The update manager can't uninstall plugins that isn't
installed by P2. As a result, with this method, GEP can't be uninstalled by eclipse update
manager in eclipse 3.4. See <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=245469"
title="Bug for uninstall problem in eclipse" rel="nofollow">Bug245469</a> for details.</p>
</td></tr></table></div>

<h1><a name="HowtoinstallGeronimoEclipsePlugin-InstallingGEPusingEclipseupdatemanager"></a>Installing
GEP using Eclipse update manager</h1>

<p><img class="emoticon" src="/confluence/images/icons/emoticons/star_yellow.gif"
height="16" width="16" align="absmiddle" alt="" border="0"/> A video desktop demonstration
of <a href="http://cwiki.apache.org/GMOxDOC22/video-of-installing-gep-with-eclipse-update-manager.html"
rel="nofollow">Installing the Apache Geronimo Eclipse Plugin with the Eclipse Update Manager</a>
is available.</p>
<ol>
	<li>Once you have all the prerequisites installed. Launch Eclipse from &lt;Eclipse_Home&gt;/eclipse.</li>
	<li>By default Eclipse will be launched with Java EE perspective.</li>
	<li>Select <b>Help-&gt;Software Updates..</b> from the menu.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure7.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>On the next screen select <b>Available Software</b> tab. Select <b>Add
Site</b>.<br/>
<img src="/confluence/download/attachments/96518/AddSite.png" align="absmiddle" border="0"
/><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Copy and paste the following site to <b>Add Site</b> window and Select
<b>Ok</b>.
<br clear="all" />
<br clear="all" />
<br clear="all" />
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-html">http://apache.org/dist/geronimo/eclipse/updates/
</pre>
</div></div>
<p><img src="/confluence/download/attachments/96518/figure9.png" align="absmiddle"
border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></p></li>
	<li>Expand <a href="http://apache.org/dist/geronimo/eclipse/updates/" rel="nofollow">http://apache.org/dist/geronimo/eclipse/updates/</a>
and Select <b>Geronimo v2.1 Server Adapter</b> v2.1.4.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/EclipseUpdateMgrScreen.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Once done you have to wait a few seconds while Eclipse resolves dependencies.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure11.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Once done, the <b>Install</b> window will pop up. Select <b>Next</b>.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/ConfirmInstall.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Accept the license and Select <b>Finish</b>.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/ReviewLicense.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Installation will start and will take time few minutes. A progress window will
display the jars being installed.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure14.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Once GEP is installed you will be prompted to restart. Select yes.<br/>
<img src="/confluence/download/attachments/96518/figure15.png" align="absmiddle" border="0"
/></li>
</ol>


<h1><a name="HowtoinstallGeronimoEclipsePlugin-ManualInstallation"></a>Manual
Installation</h1>

<h2><a name="HowtoinstallGeronimoEclipsePlugin-Usingupdatesite.zip"></a>Using
updatesite.zip</h2>

<ol>
	<li>Download the package <b>geronimo-eclipse-plugin-2.1.4-updatesite.zip</b>
from <a href="http://apache.org/dist/geronimo/eclipse/2.1.4/" rel="nofollow">http://apache.org/dist/geronimo/eclipse/2.1.4/</a>.</li>
	<li>Once done, unzip the package to a directory on your machine.</li>
	<li>Follow the instructions in <a href="#HowtoinstallGeronimoEclipsePlugin-InstallingGEPusingEclipseupdatemanager">Installing
GEP using Eclipse update manager</a> section.  When adding a an update site in step
5, choose <b>Local</b>, and navigate to the directory where you unzipped the updatesite.zip
package in the previous step.</li>
</ol>


<h2><a name="HowtoinstallGeronimoEclipsePlugin-Usingdeployable.zip"></a>Using
deployable.zip</h2>

<ol>
	<li>Download the package <b>geronimo-eclipse-plugin-2.1.4-deployable.zip</b>
from <a href="http://apache.org/dist/geronimo/eclipse/2.1.4/" rel="nofollow">http://apache.org/dist/geronimo/eclipse/2.1.4/</a>.</li>
	<li>Once done, unzip the package to your eclipse installation directory.  For Ganymede,
unzip to the eclipse/dropins directory.  You may get a prompt regarding file replacement.
Select All.</li>
	<li>Restart eclipse with the &#45;clean option.</li>
</ol>


<h1><a name="HowtoinstallGeronimoEclipsePlugin-VerifyGEPinstallation"></a>Verify
GEP installation</h1>

<ol>
	<li>Select Help-&gt;About Eclipse Platform.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure16.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>You can see a <b>G</b> icon in the <b>About Eclipse Platform</b>.
This confirms the successful installation of GEP. Click the icon.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure17.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>On the next screen you can view details&#45; License, Plug-in-Details and set
the Columns of the table being displayed.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/96518/figure18.png"
align="absmiddle" border="0" /></li>
</ol>


<h1><a name="HowtoinstallGeronimoEclipsePlugin-UninstallingGEP"></a>Uninstalling
GEP</h1>

<p>GEP may be uninstalled in a similar manner in which it was installed.</p>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/warning.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td><p>Uninstall does not work
well on Ganymede, especially for GEP.  It will uninstall GEP, but then you can't reinstall
it, as it doesn't really get uninstalled.  The only way to reinstall GEP in Ganymede is to
reinstall Ganymede itself&#33;  See <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=244935"
rel="nofollow">Eclipse Bugzilla 244935</a> for details, and hopefully a fix soon&#33;</p></td></tr></table></div>
     </div>
     <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href="http://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
       </div>

       <a href="http://cwiki.apache.org/confluence/display/GMOxDOC21/How+to+install+Geronimo+Eclipse+Plugin">View
Online</a>
       |
       <a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=96518&revisedVersion=25&originalVersion=24">View
Change</a>
              |
       <a href="http://cwiki.apache.org/confluence/display/GMOxDOC21/How+to+install+Geronimo+Eclipse+Plugin?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message