geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo v3.0 > Defining Geronimo server runtimes and servers
Date Fri, 01 Apr 2011 03:12:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2042/9/4/_/styles/combined.css?spaceKey=GMOxDOC30&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><s>Defining Geronimo server runtimes and servers</s></h2>
     <h4>Page <b>removed</b> by             <a href="https://cwiki.apache.org/confluence/display/~chirunhua@gmail.com">Runhua
Chi</a>
    </h4>
     <br/>
     <div class="notificationGreySide">
         
<p>A Geronimo Server Runtime in GEP associates a Geronimo 3.0 Server installation with
a Java Runtime Environment(JRE) to be used to run that server. A <b>Geronimo Server</b>
in GEP associates a Geronimo Server Runtime with a profile consisting of Security settings,
Publish Settings, Port Configuration, JVM settings to be used with that Geronimo Server Runtime.
</p>

<p>Before defining a Geronimo server runtime, you have to install a <a href="/confluence/display/GMOxDOC30/Installing+Geronimo+Eclipse+Plugin"
title="Installing Geronimo Eclipse Plugin">Geronimo Eclipse Plugin</a>.</p>

<h1><a name="DefiningGeronimoserverruntimesandservers-DefiningaGeronimoserverruntime"></a>Defining
a Geronimo server runtime</h1>
<p>In order to define a new Geronimo Server v3.0 Runtime, follow the steps below:</p>
<ol>
	<li>Click <b>Window</b> &#45;&gt; <b>Preferences</b>
&#45;&gt; <b>Server</b> &#45;&gt; <b>Runtime Environments</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Runtime-env.PNG?version=1&amp;modificationDate=1249950869000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Click <b>Add</b> to launch <em>New Server Runtime Environment</em>
dialog.</li>
	<li>Select <b>Apache Geronimo v3.0</b>, uncheck <b>Create a new local
server</b> (we will discuss about the use of this option later) and click <b>Next</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Runtime-new.PNG?version=1&amp;modificationDate=1249950869000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Select <b>Workbench default JRE</b> (Click <b>Installed JREs</b>
to add any new JREs and return to this dialog once done). See <a href="/confluence/display/GMOxDOC30/Installing+prerequisite+softwares"
title="Installing prerequisite softwares">Installing prerequisite softwares</a> for
more information about the JRE.</li>
	<li>You must already have a Geronimo v3.0 installation that you want to use with GEP;
enter the directory name or browse to <b>&lt;GERONIMO_HOME&gt;</b> and
click <b>Next</b>.  <br class="atl-forced-newline" /></li>
	<li>Select the location of the archive containing Geronimo source.  This is required
only if you intend to debug into Geronimo source code.</li>
	<li>Click <b>Finish</b> to return to <em>Server Runtime Environments</em>
dialog.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Runtime-done.PNG?version=1&amp;modificationDate=1249950869000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
</ol>


<p>Additional Server Runtimes to use a different Geronimo server installation or a different
JRE can be added in a similar manner.</p>

<h1><a name="DefiningGeronimoserverruntimesandservers-DefiningaGeronimoserver"></a>Defining
a Geronimo server</h1>

<p>Follow the steps below to define a new Geronimo v3.0 Server:</p>
<ol>
	<li>Launch the <b>Define a New Server</b> dialog using one of the following:
	<ul>
		<li>From the <em>Servers</em> view in the Java EE Perspective: Right-click,
and <b>New</b> &#45;&gt; <b>Server</b>.</li>
		<li>From any Perspective: Select <b>File</b> &#45;&gt; <b>New</b>
&#45;&gt; <b>Other</b> &#45;&gt; <b>Server</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Server-new.PNG?version=1&amp;modificationDate=1249950869000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	</ul>
	</li>
	<li>Select <b>Apache Geronimo v3.0 Server</b>, specify the server name
(by default <em>Apache Geronimo v3.0 Server at localhost</em>), and select an
<b>Apache Geronimo v3.0</b> from the <em>Server runtime environment</em>
dropdown and click <b>Next</b>.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Server-runtime.PNG?version=1&amp;modificationDate=1249950883000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<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>Additional Server Runtimes can
be installed by clicking on <b>Configure runtime environments...</b> button and
return to this step once done to select the newly added server runtime. Or you can add another
Geronimo 3.0 runtime environment by clicking "Add...".</td></tr></table></div></li>
	<li>Modify <em>Hostname</em>, <em>Administrator Id</em>, <em>Administrator
password</em>, <em>Web Connector port</em> and <em>RMI Naming port</em>
if necessary and click <b>Finish</b>.  Normally you will not have to change the
default values for these fields for a newly installed Geronimo 3.0server.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Server-config.PNG?version=1&amp;modificationDate=1249950869000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
</ol>


<p>This completes defining a new Geronimo 3.0 server.  The newly added server will appear
in the <em>Servers</em> view.  The server can be started by selecting the server
and clicking on the <b>Start server</b> button.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Server-stopped.PNG?version=1&amp;modificationDate=1249950883000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /></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>A Geronimo Server can also be
defined while creating a Geronimo Server Runtime by checking the option <b>Create a
new local server</b>.  This will present an additional dialog to configure the hostname,
ports, etc.</td></tr></table></div>

<h1><a name="DefiningGeronimoserverruntimesandservers-Administeringtheserver"></a>Administering
the server</h1>
<p>To view the server status in the Java EE perspective, open the <em>Servers</em>
view.  GEP monitors the server's status and sets the stopped, starting, and started indicators
appropriately.  This information is accurate even if you do not start or stop the server using
Eclipse.</p>

<h2><a name="DefiningGeronimoserverruntimesandservers-Startingtheserver"></a>Starting
the server</h2>

<p>Use this procedure to start a server using the Eclipse framework.</p>
<ol>
	<li>In the Java EE perspective, open the <em>Servers</em> view.</li>
	<li>On the <em>Server</em> panel, right click on the server to be started.</li>
	<li>On the resulting context menu, click <b>Start</b>.</li>
</ol>


<p>Note that you can start the server in debug or profiling mode if you installed <a
href="http://www.eclipse.org/tptp" title="TPTP" class="external-link" rel="nofollow">Test
and Performance Tools Platform (TPTP)</a> eclipse plugin.</p>

<h2><a name="DefiningGeronimoserverruntimesandservers-Stoppingtheserver"></a>Stopping
the server</h2>

<p>Use this procedure to stop a server using the Eclipse framework.</p>
<ol>
	<li>In the Java EE perspective, open the <em>Servers</em> view.</li>
	<li>On the <em>Server</em> panel, right click on the server to be stopped.</li>
	<li>On the resulting context menu, click <b>Stop</b>.</li>
</ol>


<h2><a name="DefiningGeronimoserverruntimesandservers-Launchingtheadministrativeconsole"></a>Launching
the administrative console</h2>

<p>Use this procedure to launch the server's administrative console in Eclipse.</p>
<ol>
	<li>In the Java EE perspective, open the <em>Servers</em> view.</li>
	<li>On the <em>Server</em> panel, right click on the server to be managed.</li>
	<li>On the resulting context menu, click <b>Launch WASCE Console</b>.</li>
</ol>


<p><b>Note</b>: The server must be started for this option to be available
and for it to work.</p>

<h2><a name="DefiningGeronimoserverruntimesandservers-Launchingthesupport"></a>Launching
the support </h2>
<p>Use this procedure to launch the server's support page in Eclipse.</p>
<ol>
	<li>In the Java EE perspective, open the <em>Servers</em> view.</li>
	<li>On the <em>Server</em> panel, right click on the server to be managed.</li>
	<li>On the resulting context menu, click <b>Launch WASCE Support</b>.</li>
</ol>



<h2><a name="DefiningGeronimoserverruntimesandservers-Debuggingtheserver"></a>Debugging
the server</h2>

<p>Use this procedure to start a server in debug mode using the Eclipse framework.</p>
<ol>
	<li>In the Java EE perspective, open the <em>Servers</em> view.</li>
	<li>On the <em>Server</em> panel, right click on the server to be started.</li>
	<li>On the resulting context menu, click <b>Debug</b>.</li>
</ol>


<h2><a name="DefiningGeronimoserverruntimesandservers-Creatingcustomserverassemblies"></a>Creating
custom server assemblies</h2>
<p>You can customize server assemblies with GEP in Eclipse just like what you can do
from the Geronimo console. See <a href="/confluence/display/GMOxDOC30/Assembling+a+server+using+GEP"
title="Assembling a server using GEP">Assembling a server using GEP</a> for more
details about creating server assemblies using GEP.</p>

<h2><a name="DefiningGeronimoserverruntimesandservers-Deployinganddebuggingapplications"></a>Deploying
and debugging applications</h2>
<p>You can deploy or test your assets using GEP. See <a href="/confluence/display/GMOxDOC30/Deploying+and+debugging+applications+using+GEP"
title="Deploying and debugging applications using GEP">Deploying and debugging applications
using GEP</a> for more information about how to deploy or test applications in Eclipse.</p>

<h1><a name="DefiningGeronimoserverruntimesandservers-Creatinganewproject"></a>Creating
a new project</h1>

<p>Once Geronimo Server Runtimes are defined, Eclipse provides these runtime for selecting
as a target runtime while creating an EJB, Web and Java EE projects.  Notice the <em>Target
Runtime</em> field in the <em>Dynamic Web Project</em> dialog shown in the
figure below.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />  <span class="image-wrap" style=""><img src="/confluence/download/attachments/20645225/Project-new.PNG?version=1&amp;modificationDate=1249950917000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
Upon adding the Geronimo 3.0 server runtime as the target runtime, the Geronimo server libraries
and Java EE specification libraries get automatically added to the build path of the project.
 GEP will also create Geronimo specific deployment plans.</p>

<p>In order to run an application on Geronimo, follow the steps below:</p>
<ol>
	<li>Right click on the project and click <b>Run As</b> &#45;&gt;
<b>Run on Server</b>.</li>
	<li>Click <b>Choose and existing server</b>, select <b>Apache Geronimo
v3.0 Server at localhost</b> and click <b>Finish</b>.</li>
</ol>


<p>The application can also be run on Geronimo by adding the project to the Geronimo
server explicitly as given below:</p>
<ol>
	<li>In the <em>Servers</em> view, right click on <b>Apache Geronimo
v3.0 Server at localhost</b> and select <b>Add and Remove Projects</b>.</li>
	<li>In the <em>Add and Remove Projects</em> dialog, select the project
under <em>Available projects</em> and click on <b>Add</b> button.
 The project will now be listed under <em>Configured projects</em>.</li>
	<li>Click <b>Finish</b>.</li>
	<li>If the server status is shown as Republish, right click on the server and select
<b>Publish</b>.</li>
</ol>


     </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message