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.2 > Installing Geronimo Eclipse Plugin
Date Mon, 20 Dec 2010 08:39:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1810/9/1/_/styles/combined.css?spaceKey=GMOxDOC22&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/GMOxDOC22/Installing+Geronimo+Eclipse+Plugin">Installing
Geronimo Eclipse Plugin</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~maojia508">maojia</a>
    </h4>
        <br/>
                         <h4>Changes (2)</h4>
                                 
    
<div id="page-diffs">
            <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >h1. Uninstalling GEP {anchor:UninstallGEP}
<br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">GEP
may be uninstalled in a similar manner in which it was installed. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">You
can cleanly uninstalled GEP only if you have installed it cleanly. To do so, install your
GEP by using [Eclipse update manager|#Installing GEP using Eclipse update manager|Installing
GEP using Eclipse update manager]. If your GEP was [installed within WTP|#Installing GEP within
WTP|Installing GEP within WTP], reinstall it with [Eclipse update manager|#Installing GEP
using Eclipse update manager|Installing GEP using Eclipse update manager] to update some meta
information so that a clean uninstallation can be preformed. <br> <br>You can
uninstall GEP by selecting either of the followings: <br>* Help-&gt;Install New
Software-&gt; What is already installed?  <br>* Help-&gt;AboutEclipse-&gt;Instalation
Details  <br> <br> <br></td></tr>
            <tr><td class="diff-unchanged" >{note} <br>Uninstall does not
work well on Ganymede, especially for GEP.  It will uninstall GEP, but then you can&#39;t
reinstall it, as it doesn&#39;t really get uninstalled.  The only way to reinstall GEP
in Ganymede is to reinstall Ganymede itself\!  See [Eclipse Bugzilla 244935|https://bugs.eclipse.org/bugs/show_bug.cgi?id=244935]
for details, and hopefully a fix soon\! <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
        </table>
</div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <p><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/GMOxDOC22/Installing+Eclipse"><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/GMOxDOC22/Installing+Eclipse">Installing
Eclipse</a>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDOC22/Development+environment"><img border='0' align='middle'
src='/confluence/images/icons/up_16.gif' width='8' height='8'></a></sup><a
href="/confluence/display/GMOxDOC22/Development+environment">Development environment</a></td><td
width='33%' class='ScrollbarNextName'>&nbsp;</td></tr></table></div>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='#InstallingGeronimoEclipsePlugin-Prerequisites'>Prerequisites
</a></li>
    <li><a href='#InstallingGeronimoEclipsePlugin-InstallingGEPwithinWTP'>Installing
GEP within WTP</a></li>
    <li><a href='#InstallingGeronimoEclipsePlugin-InstallingGEPusingEclipseupdatemanager'>Installing
GEP using Eclipse update manager</a></li>
    <li><a href='#InstallingGeronimoEclipsePlugin-ManualInstallation'>Manual Installation</a></li>
<ul>
    <li><a href='#InstallingGeronimoEclipsePlugin-Usingupdatesite.zip'>Using updatesite.zip</a></li>
    <li><a href='#InstallingGeronimoEclipsePlugin-Usingdeployable.zip'>Using deployable.zip</a></li>
</ul>
    <li><a href='#InstallingGeronimoEclipsePlugin-VerifyGEPinstallation'>Verify
GEP installation</a></li>
    <li><a href='#InstallingGeronimoEclipsePlugin-UninstallingGEP'>Uninstalling
GEP </a></li>
</ul></div>
<p>This page describes how to install the current release of the GEP (GEP 2.2). For
information about installing previous releases, see <a href="http://geronimo.apache.org/development-tools.html#DevelopmentTools-PreviousReleases"
class="external-link" 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>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" class="external-link"
rel="nofollow">GERONIMODEVTOOLS-578</a>.

<p>If you plan to upgrade GEP to the latest version, you have to uninstall the existing
one from your Eclipse first. See <a href="#InstallingGeronimoEclipsePlugin-UninstallGEP">Uninstalling
GEP</a> for more details.</p></td></tr></table></div>


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

<ul>
	<li>Java SE 1.6.0</li>
	<li>Eclipse IDE for Java EE Developers (Helios (Eclipse 3.6), Galileo (Eclipse 3.5),
Ganymede (Eclipse 3.4))
	<ul>
		<li><a href="http://www.eclipse.org/downloads/packages/" class="external-link"
rel="nofollow">Eclipse Helios Download</a></li>
		<li><a href="http://www.eclipse.org/downloads/packages/release/galileo/sr2" class="external-link"
rel="nofollow">Eclipse Galileo Download</a></li>
		<li><a href="http://www.eclipse.org/downloads/packages/release/ganymede/sr2" class="external-link"
rel="nofollow">Eclipse Ganymede Download</a></li>
	</ul>
	</li>
	<li>Apache Geronimo 2.2 server
	<ul>
		<li><a href="http://geronimo.apache.org/downloads.html" class="external-link" rel="nofollow">Apache
Geronimo downloads</a></li>
	</ul>
	</li>
</ul>


<p>Sun JDK 6.0 can be downloaded from <a href="http://java.sun.com/javase/downloads/index.jsp"
class="external-link" rel="nofollow">Sun's J2SE 6.0 Downloads site</a>. The Eclipse
IDE for Java EE Developers can be downloaded from the <a href="http://www.eclipse.org/downloads/"
class="external-link" rel="nofollow">Eclipse Downloads site</a>.  Download and extract
the <b>Eclipse IDE for Java EE Developers</b> archives to a directory of your
choice (for e.g. C:\eclipse).  The archive will be extracted to a directory named eclipse
under the directory you specified (for e.g. C:\eclipse\eclipse), referred to as <em>&lt;ECLIPSE_HOME&gt;</em>
from now on.  Make sure that the JDK in the PATH is Sun JDK 6.0.  Launch Eclipse by running
<tt>&lt;ECLIPSE_HOME&gt;/eclipse</tt>.</p>

<p>To install the Geronimo server, download the Geronimo 2.2 server from <a href="http://geronimo.apache.org/downloads.html"
class="external-link" rel="nofollow">Apache Geronimo downloads</a> and extract the
archive to a directory of your choice (for e.g. C:\g).  The archive will be extracted to a
directory <b>geronimo-tomcat6-javaee5-2.2</b> (for e.g. C:\g\geronimo-tomcat6-javaee5-2.2)
or <b>geronimo-jetty6-javaee5-2.2</b> depending on whether you downloaded Geronimo
2.2 distribution with Tomcat or Jetty as the web container.  We will refer to this directory
as <em>&lt;GERONIMO_HOME&gt;</em> from now on.</p>

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

<ol>
	<li>Once you have all the <a href="#InstallingGeronimoEclipsePlugin-Prerequisites">Prerequisites</a>
installed, launch Eclipse from <tt>&lt;ECLIPSE_HOME&gt;/eclipse</tt>.By
default Eclipse will be launched with Java EE perspective.</li>
	<li>Select the <em>Servers</em> tab as shown in the figure and select <b>New-&gt;Server</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/new_server.PNG?version=1&amp;modificationDate=1248846338000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>On the next screen select <b>Download Additional Server Adapters</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/define_new_server.PNG?version=1&amp;modificationDate=1248846338000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Select <b>Geronimo V2.2 Server Adapter</b> and select <b>Next</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style="float: left"><img
src="/confluence/download/attachments/97790/additional_adapters.JPG?version=1&amp;modificationDate=1262295783000"
height="367" width="443" style="border: 0px solid black" /></span><br class="atl-forced-newline"
/>
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Accept the license agreement and select Finish.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/figure4.png?version=1&amp;modificationDate=1222042612000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Next screen will ask for confirmation. Select <b>OK</b>. Once done
Geronimo V2.2 server adapter will be downloaded and installed.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/figure5.png?version=1&amp;modificationDate=1222042612000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Once the adapter is installed you will be prompted to restart the server. Select
Yes.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/figure6.png?version=1&amp;modificationDate=1222042612000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></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>From version 3.4, Eclipse adopted
a new update manager called P2. The update manager can't uninstall plug-ins 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 Bug245469 for details.</td></tr></table></div>

<h1><a name="InstallingGeronimoEclipsePlugin-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="/confluence/display/GMOxDOC22/Video+of+Installing+GEP+with+Eclipse+Update+Manager"
title="Video of Installing GEP with Eclipse Update Manager">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 <tt>&lt;ECLIPSE_HOME&gt;/eclipse</tt>.
By default Eclipse will be launched with Java EE perspective.</li>
	<li>Select <b>Help-&gt;Software Updates..</b> from the menu.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style="float: left"><img
src="/confluence/download/attachments/97790/help_updatesite.JPG?version=1&amp;modificationDate=1262295967000"
height="218" width="457" style="border: 0px solid black" /></span><br class="atl-forced-newline"
/>
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>On the next screen click <b>Add</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/add.PNG?version=1&amp;modificationDate=1248845420000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Copy and paste the following site to <b>Add Site</b> window and Select
<b>OK</b>.
<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></li>
	<li>Expand <a href="http://apache.org/dist/geronimo/eclipse/updates/" class="external-link"
rel="nofollow">http://apache.org/dist/geronimo/eclipse/updates/</a>. Select <b>Geronimo
v2.2 Server Adapter</b> v2.2 and click <b>Next</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style="float: left"><img
src="/confluence/download/attachments/97790/22_updateList.JPG?version=1&amp;modificationDate=1262296053000"
height="421" width="588" style="border: 0px solid black" /></span><br class="atl-forced-newline"
/>
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Wait until Eclipse finish resovling the requirements and dependencies. Review the
details and click <b>Finish</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/install_details.PNG?version=1&amp;modificationDate=1248845420000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Review the license and accept the agreement.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/review_license.PNG?version=1&amp;modificationDate=1248848868000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>You have to wait a few seconds while Eclipse resolves dependencies.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/background_work.PNG?version=1&amp;modificationDate=1248845420000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Select the items that you trust and select <b>OK</b>. You can review
the details of these certificates by clicking on <b>details</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/trust_certificate.PNG?version=1&amp;modificationDate=1248845420000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Once GEP is installed you will be prompted to restart. Select <b>Yes</b>.<br/>
<span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/figure15.PNG?version=1&amp;modificationDate=1248849060000"
style="border: 0px solid black" /></span></li>
</ol>


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


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

<ol>
	<li>Download the package <b>geronimo-eclipse-plugin-2.2-updatesite.zip</b>
from <a href="http://apache.org/dist/geronimo/eclipse/2.2.0/" class="external-link" rel="nofollow">http://apache.org/dist/geronimo/eclipse/2.2.0/</a>.</li>
	<li>Once done, extract the package into a directory on your machine.</li>
	<li>Follow the instructions in <a href="#InstallingGeronimoEclipsePlugin-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="InstallingGeronimoEclipsePlugin-Usingdeployable.zip"></a>Using
deployable.zip</h2>

<ol>
	<li>Download the package <b>geronimo-eclipse-plugin-2.2-deployable.zip</b>
from <a href="http://apache.org/dist/geronimo/eclipse/2.2.0/" class="external-link" rel="nofollow">http://apache.org/dist/geronimo/eclipse/2.2.0/</a>.</li>
	<li>Once done, extract the package into your eclipse installation directory.  For Ganymede
and Galileo, extract to 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="InstallingGeronimoEclipsePlugin-VerifyGEPinstallation"></a>Verify
GEP installation</h1>

<ol>
	<li>Select Help-&gt;About Eclipse Platform.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style="float: left"><img
src="/confluence/download/attachments/97790/Help_About.JPG?version=1&amp;modificationDate=1262296237000"
height="344" width="504" style="border: 0px solid black" /></span><br class="atl-forced-newline"
/>
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></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 class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style="float: left"><img
src="/confluence/download/attachments/97790/about.JPG?version=1&amp;modificationDate=1262296334000"
height="302" width="464" style="border: 0px solid black" /></span><br class="atl-forced-newline"
/>
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></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 class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/97790/About-features.PNG?version=1&amp;modificationDate=1249444452000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" /></li>
</ol>


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

<p>You can cleanly uninstalled GEP only if you have installed it cleanly. To do so,
install your GEP by using <a href="#InstallingGeronimoEclipsePlugin-InstallingGEPusingEclipseupdatemanager"
title="Installing GEP using Eclipse update manager">Eclipse update manager</a>. If
your GEP was <a href="#InstallingGeronimoEclipsePlugin-InstallingGEPwithinWTP" title="Installing
GEP within WTP">installed within WTP</a>, reinstall it with <a href="#InstallingGeronimoEclipsePlugin-InstallingGEPusingEclipseupdatemanager"
title="Installing GEP using Eclipse update manager">Eclipse update manager</a> to
update some meta information so that a clean uninstallation can be preformed.</p>

<p>You can uninstall GEP by selecting either of the followings:</p>
<ul>
	<li>Help-&gt;Install New Software-&gt; What is already installed?</li>
	<li>Help-&gt;AboutEclipse-&gt;Instalation Details</li>
</ul>



<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>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"
class="external-link" rel="nofollow">Eclipse Bugzilla 244935</a> for details, and
hopefully a fix soon&#33;</td></tr></table></div>
    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC22/Installing+Geronimo+Eclipse+Plugin">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=97790&revisedVersion=32&originalVersion=31">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC22/Installing+Geronimo+Eclipse+Plugin?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message