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 command line
Date Fri, 28 Jan 2011 06:13: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+command+line">Assembling
a server via command line</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~maojia508">maojia</a>
    </h4>
        <br/>
                         <h4>Changes (12)</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 section we will illustrate how to assemble a custom server from the command line.{excerpt}
<br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">{excerpt}This
section illustrates how to assemble a custom server from the command line.{excerpt} <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Similarly
you can use the GShell *deploy/assemble* command specifying the same information on the command
line interactively. For more information about how to use deploy/assemble, please use *--help*
as followed. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">You
can use the GShell {{deploy/assemble}} command to assemble a custom server. You can type the
command with the {{--help}} option for instructions about how to use this {{deploy/assemble}}
command, displayed as follows: <br></td></tr>
            <tr><td class="diff-unchanged" > <br>{noformat:borderStyle=solid}
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">By
default, target location of newly assembled server is directory {{/var/temp/assembly}},  target
packge format is *tar.gz* and version number is *1.0*. User will have to input groupId and
artifactId. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">By
default, the target location of a newly assembled server is the {{/var/temp/assembly}} directory,
the target package format is *tar.gz* and the version number is *1.0*. You will have to input
a groupId and an artifactId. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>{noformat:borderStyle=solid}
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Then
GShell will ask you with a list of assembly modes.  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">Then
GShell will provide you with a list of assembly modes options as follows.  <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat:borderStyle=solid} <br>Available
custom assembly modes: <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">Choose
one of the custom assembly modes according to your own cases: <br></td></tr>
            <tr><td class="diff-unchanged" >* Choose 1 or 2 then you have to select
the framework plugin group (*Geronimo Plugin Group :: Framework*) which includes several plugins
used to start the server. <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >*Note:* look into [Plugin Group] for
more details about differences between framework plugin group and boilerplate plugin. <br>
<br></td></tr>
            <tr><td class="diff-changed-lines" >After you input your choice, you
will have to select <span class="diff-added-words"style="background-color: #dfd;">the</span>
plugin or plugins group <span class="diff-added-words"style="background-color: #dfd;">that</span>
you intend to <span class="diff-changed-words">install<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">
and click *Enter*</span>.</span> A few seconds later, your assembly will be ready
for use. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>{noformat:borderStyle=solid}
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><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 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> By copying and extracting the package to any places you like,
you can start the assembly as an independent server. Startup duration and system modules loaded
are greatly reduced. Here is a snapshot of an assembly only with framework plugin group selected
after startup. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>{noformat:borderStyle=solid}
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Refer
to</span> <span class="diff-added-words"style="background-color: #dfd;">See</span>
[Plugin Group] if you want to learn more. <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+using+Maven"><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+using+Maven">Assembling
a server using Maven</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;<a href="/confluence/display/GMOxDOC30/Assembling+a+server+via+Console">Assembling
a server via Console</a></td><td class='ScrollbarNextIcon'><a href="/confluence/display/GMOxDOC30/Assembling+a+server+via+Console"><img
border='0' align='middle' src='/confluence/images/icons/forwd_16.gif' width='16' height='16'></a></td></tr></table></div>

<p>This section illustrates how to assemble a custom server from the command line.</p>

<p>You can use the GShell <tt>deploy/assemble</tt> command to assemble a
custom server. You can type the command with the <tt>--help</tt> option for instructions
about how to use this <tt>deploy/assemble</tt> command, displayed as follows:</p>

<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div
class="preformattedContent panelContent">
<pre>User@server:/&gt;deploy/assemble -help
assemble
 --

  --secure                         Use secure channel
  -a (--artifact) VAL              server artifact name
  -f (--format) VAL                zip or tar.gz
  -g (--groupId) VAL               server groupId
  -h (--help)                      Display this help message
  -l (--list)                      refresh plugin list
  -m (--mode) VAL                  custom assembly mode
  -p (--port) N                    Port, default 1099
  -s (--hostname, --server) VAL    Hostname, default localhost
  -t (--path) VAL                  assembly location
  -u (--username) VAL              Username
  -v (--version) VAL               server version
  -w (--password) VAL              Password
</pre>
</div></div>

<p>By default, the target location of a newly assembled server is the <tt>/var/temp/assembly</tt>
directory, the target package format is <b>tar.gz</b> and the version number is
<b>1.0</b>. You will have to input a groupId and an artifactId.</p>

<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div
class="preformattedContent panelContent">
<pre># run using ./bin/gsh
User@server:/&gt;deploy/assemble -g org.apache.geronimo.asseblies -a testServer -v 1.0
-u system -w manager
</pre>
</div></div>

<p>Then GShell will provide you with a list of assembly modes options as follows. </p>

<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div
class="preformattedContent panelContent">
<pre>Available custom assembly modes:
 1:    Function Centric
 2:    Application Centric
 3:    Expert Users
Please select a custom assembly mode [1,2,3]
</pre>
</div></div>

<p>Choose one of the custom assembly modes according to your own cases:</p>
<ul>
	<li>Choose 1 or 2 then you have to select the framework plugin group (<b>Geronimo
Plugin Group :: Framework</b>) which includes several plugins used to start the server.</li>
</ul>


<ul>
	<li>Choose 3 to assemble a server using plugins as an experienced user. In order to
get a working server you must include the plugin (<b>Geronimo Assemblies :: Boilerplate</b>)
which includes several files used to start the server.</li>
</ul>


<p><b>Note:</b> look into <a href="/confluence/display/GMOxDOC30/Plugin+Group"
title="Plugin Group">Plugin Group</a> for more details about differences between
framework plugin group and boilerplate plugin.</p>

<p>After you input your choice, you will have to select the plugin or plugins group
that you intend to install. A few seconds later, your assembly will be ready for use.</p>

<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div
class="preformattedContent panelContent">
<pre>**** Installation Complete!
Used existing: cglib/cglib-nodep/2.1_3/jar
...
Installed new: org.apache.geronimo.framework/jsr88-cli/2.2-SNAPSHOT/car

Downloaded 23085 kB in 25s (923 kB/s)
</pre>
</div></div>

<p>In the <tt>&lt;GERONIMO_HOME&gt;/var/temp</tt> directory, you
will find the package of newly assembled server with minimizing footprint and the fewest components
you need. By copying and extracting the package to any places you like, you can start the
assembly as an independent server. Startup duration and system modules loaded are greatly
reduced. Here is a snapshot of an assembly only with framework plugin group selected after
startup.</p>

<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div
class="preformattedContent panelContent">
<pre>Booting Geronimo Kernel (in Java 1.6.0)...
Module  1/11 org.apache.geronimo.framework/j2ee-system/2.2-SNAPSHOT/car
                              started in   .000s
Module  2/11 org.apache.geronimo.framework/transformer-agent/2.2-SNAPSHOT/car
                              started in   .000s
Module  3/11 org.apache.geronimo.framework/gshell-framework/2.2-SNAPSHOT/car
                              started in   .000s
Module  4/11 org.apache.geronimo.framework/gshell-geronimo/2.2-SNAPSHOT/car
                              started in   .000s
Module  5/11 org.apache.geronimo.framework/gshell-remote/2.2-SNAPSHOT/car
                              started in   .000s
Module  6/11 org.apache.geronimo.framework/jee-specs/2.2-SNAPSHOT/car
                              started in   .000s
Module  7/11 org.apache.geronimo.framework/rmi-naming/2.2-SNAPSHOT/car
                              started in   .453s
Module  8/11 org.apache.geronimo.plugins.classloaders/geronimo-javaee-deployment
_1.1MR3_spec/2.2-SNAPSHOT/car started in   .000s
Module  9/11 org.apache.geronimo.framework/plugin/2.2-SNAPSHOT/car
                              started in   .516s
Module 10/11 org.apache.geronimo.framework/j2ee-security/2.2-SNAPSHOT/car
                              started in   .140s
Module 11/11 org.apache.geronimo.framework/server-security-config/2.2-SNAPSHOT/c
ar                            started in   .047s
Startup completed in 1.969s seconds
  Listening on Ports:
    1099 0.0.0.0 RMI Naming
    9999 0.0.0.0 JMX Remoting Connector

Geronimo Application Server started
</pre>
</div></div>

<p>See <a href="/confluence/display/GMOxDOC30/Plugin+Group" title="Plugin Group">Plugin
Group</a> if you want to learn more.</p>
    </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+command+line">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=20645450&revisedVersion=3&originalVersion=2">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Assembling+a+server+via+command+line?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message