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 > Assembling a server via Console
Date Fri, 28 Jan 2011 07:35:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2036/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><a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Assembling+a+server+via+Console">Assembling
a server via Console</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~maojia508">maojia</a>
    </h4>
        <br/>
                         <h4>Changes (23)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-unchanged" >{scrollbar} <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{excerpt}In
this tutorial we will illustrate how to assemble a custom server using a application-centric
approach from console.{excerpt} Using this approach our application will define on the contents
of server. Custom server will be built around our application and will include only the components
required by our application. For the application we have used an existing tutorial from tutorial
section. Refer [Stateless Session Bean] tutorial for application development and deployment.
Later we will assemble a custom server which will only include functional components required
by our application. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">{excerpt}This
tutorial illustrates how to assemble a custom server by using an application-centric approach
from console.{excerpt} By using this approach, our application will define the contents of
the server. Custom server will be built around our application and will include only the components
required by our application. You can use an existing tutorial from the tutorial section to
develop a sample application. See the [Stateless Session Bean] tutorial for application development
and deployment. This topic will assemble a custom server which will only include functional
components required by the application. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>{info:title=Clarification}
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Application</span>
<span class="diff-added-words"style="background-color: #dfd;">The application</span>
client referred <span class="diff-added-words"style="background-color: #dfd;">to</span>
in this tutorial is actually a Web Application Client. <br></td></tr>
            <tr><td class="diff-unchanged" >{info} <br> <br>{toc}
<br>h1. Identifying the functional components required by our server <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">This
step is required to identify the various dependencies required by our application. Since we
are following an application centric approach we need to find out the various dependencies
required by our application.  <br>This is the major work required for our custom server
which has been simplified by geronimo administrative console. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">To
use an application-centric approach, you need to find out the various dependencies required
by your application.  This is the major work required for assembling a custom server, which
has been simplified by the Geronimo administration console. <br></td></tr>
            <tr><td class="diff-changed-lines" ># To assemble a server from existing
instance of <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">geronimo
we</span> <span class="diff-added-words"style="background-color: #dfd;">Geronimo,
you</span> need to include <span class="diff-added-words"style="background-color:
#dfd;">the</span> *Geronimo Plugin Group :: Framework* plugin <span class="diff-changed-words">group<span
class="diff-added-chars"style="background-color: #dfd;">,</span></span> which
is the framework of a functional server and pre-selected by default . <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Refer</span>
<span class="diff-added-words"style="background-color: #dfd;">See the</span> [Plugin
Group] section for more information <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">on</span>
<span class="diff-added-words"style="background-color: #dfd;">about</span> *Geronimo
Plugin Group :: Framework*. <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">#
To identify the application plugins to be included, in this tutorial they are: <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">#
To identify the application plugins to be included, find out the various dependencies required
by your application. For example, for the sample application developed from the [Stateless
Session Bean] tutorial, include the following plugins: <br></td></tr>
            <tr><td class="diff-unchanged" >## Web archive plugin  _default/ApplicationClient/1.0/car_
<br>## StatelessSessionEJB plugin  _default/StatelessSessionEJB/1.0/car_ <br>##
Datasource pool plugin  _console/dbpool/jdbc_userds/1.0/car_ <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Information</span>
<span class="diff-added-words"style="background-color: #dfd;">For information</span>
about how to get these plugins, <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">please
look into</span> <span class="diff-added-words"style="background-color: #dfd;">See</span>
[Converting applications into plugins using the Administration Console]. <br></td></tr>
            <tr><td class="diff-changed-lines" ># To create a new database from
<span class="diff-added-words"style="background-color: #dfd;">the administration</span>
console, <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">we</span>
<span class="diff-added-words"style="background-color: #dfd;">you</span> need
to include the plugin group *Geronimo Plugins, Console :: System Database(Tomcat)*, which
includes console interface <span class="diff-changed-words">plugin,<span class="diff-added-chars"style="background-color:
#dfd;"> </span>embeded</span> Derby database <span class="diff-changed-words">plugin<span
class="diff-added-chars"style="background-color: #dfd;">,</span></span> and
required resource adapter plugins. <br></td></tr>
            <tr><td class="diff-unchanged" >This completes the identification
of all the functional component(dependencies) required by our application centric custom server.
<br> <br>h1. Assembling a custom server <br></td></tr>
            <tr><td class="diff-changed-lines" ># Launch the <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">administrative</span>
<span class="diff-added-words"style="background-color: #dfd;">administration</span>
console and select *Plugins* under *Applications*. <br></td></tr>
            <tr><td class="diff-unchanged" >!Image2.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">#
Select Assemble a server by choosing Application Centric mode.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">#
Select *Application Centric* as the *Custom Assembly Mode* and then click *Assemble a server*.\\
\\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!Image3.png!\\ \\ \\ <br># Name
the artifacts as suggested: groupId as test, artifactId as TestServer and format as zip or
so. \\ \\ \\ <br>!Image4.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Next</span>
<span class="diff-added-words"style="background-color: #dfd;">The next</span>
step is to select the functional components <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">we</span>
<span class="diff-added-words"style="background-color: #dfd;">that you</span>
identified. Select *Geronimo Plugin Group :: Framework*, WAR, EJB and database pool plugins.
You also have to select *Geronimo Plugins, Console :: System Database(Tomcat)* <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">since</span>
<span class="diff-added-words"style="background-color: #dfd;">because</span> our
application uses derby database and you have to create the database from console. Because
application WAR, EJB and database pool plugins are dependent with each other, you are free
to choose just one of them and therefore <span class="diff-added-words"style="background-color:
#dfd;">the</span> rest of its dependencies will be assembled automatically. <br></td></tr>
            <tr><td class="diff-changed-lines" >You can also choose the Expert
mode to select <span class="diff-changed-words">indivi<span class="diff-added-chars"style="background-color:
#dfd;">du</span>al</span> plugins instead of plugin groups. <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">#
Final list of plugins/plugin groups we have selected are as follows <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">#
The final list of plugins/plugin groups you select should be follows: <br></td></tr>
            <tr><td class="diff-unchanged" >#* org.apache.geronimo.plugingroups/framework/2.2-SNAPSHOT/car
<br>#* org.apache.geronimo.plugins/sysdb-console-tomcat/2.2-SNAPSHOT/car <br>#*
default/StatelessSessionEJB/1.0/car <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">#
Once done select *Assemble*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">#
After this is done, click *Assemble*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!Image5.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># On the next <span class="diff-changed-words">screen<span
class="diff-added-chars"style="background-color: #dfd;">,</span></span> each
artifact and its associated properties will be displayed. <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Select</span>
<span class="diff-added-words"style="background-color: #dfd;">Click</span> *Install*.
<br></td></tr>
            <tr><td class="diff-unchanged" >!Image6.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Once
done</span> <span class="diff-added-words"style="background-color: #dfd;">After
this is done,</span> you will receive a confirmation message suggesting the success
or failure of <span class="diff-added-words"style="background-color: #dfd;">the</span>
server assembly. It will also enlist the location of the custom server <span class="diff-changed-words">assembly<span
class="diff-added-chars"style="background-color: #dfd;">,</span></span> which
by default is &lt;GERONIMO_HOME&gt;/var/temp/assembly. <br></td></tr>
            <tr><td class="diff-unchanged" >!Image7.png! <br></td></tr>
            <tr><td class="diff-changed-lines" ># The server will be named as
{{TestServer-1.0-bin.zip}}. <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Go
to {{&lt;GERONIMO_HOME&gt;/var/temp}},</span> <span class="diff-added-words"style="background-color:
#dfd;">In the {{&lt;GERONIMO_HOME&gt;/var/temp}} directory,</span> you will
find the package of <span class="diff-added-words"style="background-color: #dfd;">the</span>
newly assembled server with minimizing footprint and the fewest components you <span class="diff-changed-words">need<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">
only</span>.</span> Unzip it and start the server. <br></td></tr>
            <tr><td class="diff-changed-lines" ># Since our [Stateless Session
Bean] uses <span class="diff-changed-words">*userdbs*<span class="diff-added-chars"style="background-color:
#dfd;">,</span></span> you need to create database and tables as suggested
in the tutorial. <br></td></tr>
            <tr><td class="diff-unchanged" >This completes our illustration for
custom server assembly. <br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <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/GMOxDOC30/Assembling+a+server+via+command+line"><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/GMOxDOC30/Assembling+a+server+via+command+line">Assembling
a server via command line</a>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDOC30/Customizing+server+assemblies"><img border='0' align='middle'
src='/confluence/images/icons/up_16.gif' width='8' height='8'></a></sup><a
href="/confluence/display/GMOxDOC30/Customizing+server+assemblies">Customizing server assemblies</a></td><td
width='33%' class='ScrollbarNextName'>&nbsp;</td></tr></table></div>

<p>This tutorial illustrates how to assemble a custom server by using an application-centric
approach from console. By using this approach, our application will define the contents of
the server. Custom server will be built around our application and will include only the components
required by our application. You can use an existing tutorial from the tutorial section to
develop a sample application. See the <a href="/confluence/display/GMOxDOC30/Stateless+Session+Bean"
title="Stateless Session Bean">Stateless Session Bean</a> tutorial for application
development and deployment. This topic will assemble a custom server which will only include
functional components required by the application.</p>

<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/information.gif" width="16"
height="16" align="absmiddle" alt="" border="0"></td><td><b>Clarification</b><br
/>The application client referred to in this tutorial is actually a Web Application Client.</td></tr></table></div>

<div>
<ul>
    <li><a href='#AssemblingaserverviaConsole-Identifyingthefunctionalcomponentsrequiredbyourserver'>Identifying
the functional components required by our server</a></li>
    <li><a href='#AssemblingaserverviaConsole-Assemblingacustomserver'>Assembling
a custom server</a></li>
</ul></div>
<h1><a name="AssemblingaserverviaConsole-Identifyingthefunctionalcomponentsrequiredbyourserver"></a>Identifying
the functional components required by our server</h1>
<p>To use an application-centric approach, you need to find out the various dependencies
required by your application.  This is the major work required for assembling a custom server,
which has been simplified by the Geronimo administration console.</p>
<ol>
	<li>To assemble a server from existing instance of Geronimo, you need to include the
<b>Geronimo Plugin Group :: Framework</b> plugin group, which is the framework
of a functional server and pre-selected by default . See the <a href="/confluence/display/GMOxDOC30/Plugin+Group"
title="Plugin Group">Plugin Group</a> section for more information about <b>Geronimo
Plugin Group :: Framework</b>.</li>
	<li>To identify the application plugins to be included, find out the various dependencies
required by your application. For example, for the sample application developed from the <a
href="/confluence/display/GMOxDOC30/Stateless+Session+Bean" title="Stateless Session Bean">Stateless
Session Bean</a> tutorial, include the following plugins:
	<ol>
		<li>Web archive plugin  <em>default/ApplicationClient/1.0/car</em></li>
		<li>StatelessSessionEJB plugin  <em>default/StatelessSessionEJB/1.0/car</em></li>
		<li>Datasource pool plugin  <em>console/dbpool/jdbc_userds/1.0/car</em><br/>
For information about how to get these plugins, See <a href="/confluence/display/GMOxDOC30/Converting+applications+into+plugins+using+the+Administration+Console"
title="Converting applications into plugins using the Administration Console">Converting
applications into plugins using the Administration Console</a>. </li>
	</ol>
	</li>
	<li>To create a new database from the administration console, you need to include the
plugin group <b>Geronimo Plugins, Console :: System Database(Tomcat)</b>, which
includes console interface plugin, embeded Derby database plugin, and required resource adapter
plugins.<br/>
This completes the identification of all the functional component(dependencies) required by
our application centric custom server.</li>
</ol>


<h1><a name="AssemblingaserverviaConsole-Assemblingacustomserver"></a>Assembling
a custom server</h1>
<ol>
	<li>Launch the administration console and select <b>Plugins</b> under <b>Applications</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/20645309/Image2.png?version=1&amp;modificationDate=1213610402000"
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>Application Centric</b> as the <b>Custom Assembly Mode</b>
and then click <b>Assemble a 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/20645309/Image3.png?version=1&amp;modificationDate=1231034537000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Name the artifacts as suggested: groupId as test, artifactId as TestServer and
format as zip or so. <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/20645309/Image4.png?version=1&amp;modificationDate=1231032941000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>The next step is to select the functional components that you identified. Select
<b>Geronimo Plugin Group :: Framework</b>, WAR, EJB and database pool plugins.
You also have to select <b>Geronimo Plugins, Console :: System Database(Tomcat)</b>
because our application uses derby database and you have to create the database from console.
Because application WAR, EJB and database pool plugins are dependent with each other, you
are free to choose just one of them and therefore the rest of its dependencies will be assembled
automatically.<br/>
You can also choose the Expert mode to select individual plugins instead of plugin groups.</li>
	<li>The final list of plugins/plugin groups you select should be follows:
	<ul>
		<li>org.apache.geronimo.plugingroups/framework/2.2-SNAPSHOT/car</li>
		<li>org.apache.geronimo.plugins/sysdb-console-tomcat/2.2-SNAPSHOT/car</li>
		<li>default/StatelessSessionEJB/1.0/car</li>
	</ul>
	</li>
	<li>After this is done, click <b>Assemble</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/20645309/Image5.png?version=1&amp;modificationDate=1231136182000"
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, each artifact and its associated properties will be displayed.
Click <b>Install</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/20645309/Image6.png?version=1&amp;modificationDate=1231136160000"
style="border: 0px solid black" /></span><br class="atl-forced-newline" />
<br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>After this is done, you will receive a confirmation message suggesting the success
or failure of the server assembly. It will also enlist the location of the custom server assembly,
which by default is &lt;GERONIMO_HOME&gt;/var/temp/assembly.<br/>
<span class="image-wrap" style=""><img src="/confluence/download/attachments/20645309/Image7.png?version=1&amp;modificationDate=1231136132000"
style="border: 0px solid black" /></span></li>
	<li>The server will be named as <tt>TestServer-1.0-bin.zip</tt>. In the
<tt>&lt;GERONIMO_HOME&gt;/var/temp</tt> directory, you will find the package
of the newly assembled server with minimizing footprint and the fewest components you need.
Unzip it and start the server.</li>
	<li>Since our <a href="/confluence/display/GMOxDOC30/Stateless+Session+Bean" title="Stateless
Session Bean">Stateless Session Bean</a> uses <b>userdbs</b>, you need
to create database and tables as suggested in the tutorial.<br/>
This completes our illustration for custom server assembly.</li>
</ol>

    </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/GMOxDOC30/Assembling+a+server+via+Console">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=20645309&revisedVersion=3&originalVersion=2">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Assembling+a+server+via+Console?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message