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 Wed, 29 Jul 2009 08:30:00 GMT
<html>
<head>
    <base href="http://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1519/1/1/_/styles/combined.css?spaceKey=GMOxDOC22&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/GMOxDOC22/Installing+Geronimo+Eclipse+Plugin">Installing
Geronimo Eclipse Plugin</a></h2>
     <h4>Page <b>edited</b> by             <a href="http://cwiki.apache.org/confluence/display/~sophia">Ying
Tang</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/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>

<p>We will be using Eclipse Ganymede 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</p>
<ul><li><a href="/confluence/display/GMOxDOC22/Video+of+Installing+GEP+with+Eclipse+Update+Manager"
title="Video of Installing GEP with Eclipse Update Manager">Video of Installing GEP with
Eclipse Update Manager</a></li><li><a href="/confluence/display/GMOxDOC22/How+to+install+Geronimo+Eclipse+Plugin+v2.1.3"
title="How to install Geronimo Eclipse Plugin v2.1.3">How to install Geronimo Eclipse Plugin
v2.1.3</a></li><li><a href="/confluence/display/GMOxDOC22/How+to+install+Geronimo+Eclipse+Plugin+v2.1.2"
title="How to install Geronimo Eclipse Plugin v2.1.2">How to install Geronimo Eclipse Plugin
v2.1.2</a></li></ul>
<p>or <a href="http://geronimo.apache.org/development-tools.html#DevelopmentTools-PreviousReleases"
rel="nofollow">this page</a> for other releases.</p>

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

<ul>
	<li>Java J2SE 1.6.0</li>
	<li>Eclipse IDE for Java EE Developers (Ganymede (Eclipse 3.4) or Europa (Eclipse 3.3
Winter))
	<ul>
		<li><a href="http://www.eclipse.org/downloads/packages/" rel="nofollow">Eclipse
Ganymede Download</a></li>
		<li><a href="http://www.eclipse.org/downloads/packages/release/europa/winter" rel="nofollow">Eclipse
Europa Download</a></li>
	</ul>
	</li>
	<li>Apache Geronimo 2.2 server
	<ul>
		<li><a href="http://geronimo.apache.org/downloads.html" 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"
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/" 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://www.apache.org/dist/geronimo/"
rel="nofollow">http://www.apache.org/dist/geronimo/</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 clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/97790/New-server.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>.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/97790/New-server-define.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Select <b>Geronimo V2.2 Server Adapter</b> and select <b>Next</b>.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/97790/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/97790/figure4.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></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 clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/97790/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/97790/figure6.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
</ol>


<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 clear="all" />
<br clear="all" />
<br clear="all" />  <span class="error">Unable to render embedded object: File
(install_new_soft.png) not found.</span><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>On the next screen click <b>Add</b>.
<br clear="all" />
<br clear="all" /> <span class="error">Unable to render embedded object: File
(add.png) not found.</span><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>.
<style type="text/css">
@import url(/confluence/download/resources/confluence.ext.code:code/shStyles.css);
</style>
<!--[if IE]>
<style type="text/css">
    .code textarea, .code input { padding: 0 !important; }
</style>
<![endif]-->
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shCore.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushCSharp.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushPhp.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushJScript.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushVb.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushSql.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushXml.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushShell.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushDelphi.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushPython.js"></script>
<script class="javascript" src="/confluence/download/resources/confluence.ext.code:code/shBrushJava.js"></script>
<div class="code">
<textarea name="newcodemacro" class="html:nocontrols:nogutter" rows="10" readonly="readonly">http://apache.org/dist/geronimo/eclipse/updates/</textarea>
<script class="javascript">
    if(!window.newcodemacro_initialised)
    {
        window.newcodemacro_initialised = true;
        window.oldonloadmethod = window.onload;
        window.onload = function(){
            dp.SyntaxHighlighter.HighlightAll('newcodemacro');
            if(window.oldonloadmethod)
            {
                window.oldonloadmethod();
            }
        }
    }

</script>
</div>
</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.2 Server Adapter</b> v2.2.
<br clear="all" />
<br clear="all" />
<br clear="all" />  <img src="/confluence/download/attachments/97790/EclipseUpdateMgrScreen.png"
align="absmiddle" border="0" /><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Review the details and click <b>Finish</b>.
<br clear="all" />
<br clear="all" />   <span class="error">Unable to render embedded object: File
(install_details.png) not found.</span><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" />  <span class="error">Unable to render embedded object: File
(background_work.png) not found.</span><br clear="all" />
<br clear="all" />
<br clear="all" /></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 clear="all" />
<br clear="all" />
<br clear="all" />  <span class="error">Unable to render embedded object: File
(trust_certificate.png) not found.</span><br clear="all" />
<br clear="all" />
<br clear="all" /></li>
	<li>Once GEP is installed you will be prompted to restart. Select <b>Yes</b>.<br/>
<img src="/confluence/download/attachments/97790/figure15.png" align="absmiddle" border="0"
/></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/" rel="nofollow">http://apache.org/dist/geronimo/eclipse/2.2/</a>.</li>
	<li>Once done, unzip the package to 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/" rel="nofollow">http://apache.org/dist/geronimo/eclipse/2.2/</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="InstallingGeronimoEclipsePlugin-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/97790/Help-about.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/97790/About.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" />  <img src="/confluence/download/attachments/97790/About-features.png"
align="absmiddle" border="0" />
<br clear="all" /> </li>
</ol>


<h1><a name="InstallingGeronimoEclipsePlugin-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/GMOxDOC22/Installing+Geronimo+Eclipse+Plugin">View
Online</a>
       |
       <a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=97790&revisedVersion=19&originalVersion=18">View
Change</a>
              |
       <a href="http://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