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 > Converting applications into plugins using the Administration Console
Date Tue, 25 Jan 2011 07:37: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/Converting+applications+into+plugins+using+the+Administration+Console">Converting applications into plugins using the Administration Console</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~maojia508">maojia</a>
    </h4>
        <br/>
                         <h4>Changes (36)</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-changed-lines" >{excerpt}This topic will take you through plugin <span class="diff-changed-words">transform,<span class="diff-added-chars"style="background-color: #dfd;"> </span>export</span> and import <span class="diff-added-words"style="background-color: #dfd;">by</span> using Apache Geronimo administration console.{excerpt} We have used an existing tutorial from <span class="diff-added-words"style="background-color: #dfd;">the</span> tutorial section. <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> [Stateless Session Bean] tutorial for application development and deployment. <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Once done refer</span> <span class="diff-added-words"style="background-color: #dfd;">Then use</span> the illustration in this tutorial to export and import Java EE artifacts from Apache Geronimo administration console. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>{info:title=Clarification} <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-added-words"style="background-color: #dfd;">The</span> Application 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></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br>h1. Converting the application into a plugin via console <br></td></tr>
            <tr><td class="diff-changed-lines" >In this section, we will convert an existing applications into a plugin directly <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">via</span> <span class="diff-added-words"style="background-color: #dfd;">by using the administration</span> console. <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Launch the Administrative console and Select *Plugin* portlet under *Applications*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># Launch the administrative console and select *Plugin* under *Applications* on the navigation panel.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!export1.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># Under *Create Geronimo <span class="diff-changed-words">Plugin*<span class="diff-added-chars"style="background-color: #dfd;">,</span></span> select *jdbc/userds* database pool from the drop-down menu. <br></td></tr>
            <tr><td class="diff-unchanged" >!export2.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 select</span> <span class="diff-added-words"style="background-color: #dfd;">Then, click</span> *Export Plugin*. <br></td></tr>
            <tr><td class="diff-unchanged" >!export3.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># On the next <span class="diff-changed-words">page<span class="diff-added-chars"style="background-color: #dfd;">,</span></span> keep all the values default and <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> *Saving Plugin Data*. <br></td></tr>
            <tr><td class="diff-unchanged" >!export4.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># On the next <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">screen select</span> <span class="diff-added-words"style="background-color: #dfd;">screen, click</span> *Done* to convert the resource pool archive into a plugin directly. <br></td></tr>
            <tr><td class="diff-unchanged" >!export5.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># <span class="diff-changed-words">Similarly<span class="diff-added-chars"style="background-color: #dfd;">,</span></span> convert *ApplicationClient* and *StatelessSessionEJB* into plugins. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>h1. Exporting and importing plugins via console <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br>h2. Exporting the application as a plugin <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Launch the Administration console and Select *Plugin* portlet under *Applications*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># Launch the administration console and select *Plugin* under *Applications* on the navigation panel.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!export1.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># Under *Create Geronimo <span class="diff-changed-words">Plugin*<span class="diff-added-chars"style="background-color: #dfd;">,</span></span> select *jdbc/userds* database pool from the <span class="diff-changed-words">drop<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;"> </span><span class="diff-added-chars"style="background-color: #dfd;">-</span>down</span> menu as shown in the figure. <br></td></tr>
            <tr><td class="diff-unchanged" >!export2.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 select</span> <span class="diff-added-words"style="background-color: #dfd;">Then click</span> *Export Plugin*. <br></td></tr>
            <tr><td class="diff-unchanged" >!export3.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># On the next <span class="diff-changed-words">page<span class="diff-added-chars"style="background-color: #dfd;">,</span></span> keep all the values default and <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> *Saving Plugin Data*. <br></td></tr>
            <tr><td class="diff-unchanged" >!export4.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># On the next <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">screen select</span> <span class="diff-added-words"style="background-color: #dfd;">screen, click</span> *Export Plugin*. <br></td></tr>
            <tr><td class="diff-unchanged" >!export5.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># A window <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">will pop-up</span> <span class="diff-added-words"style="background-color: #dfd;">pops up</span> suggesting to save the plugin. <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> *OK*. <br></td></tr>
            <tr><td class="diff-unchanged" >!export6.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Similarly export *ApplicationClient* and *StatelessSessionEJB* as a plugin.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># Similarly, export *ApplicationClient* and *StatelessSessionEJB* as plugins.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!export7.png!\\ \\ \\ <br>!export8.png!\\ \\ \\ <br> <br>h2. Create a custom repository from Geronimo Administrative Console <br></td></tr>
            <tr><td class="diff-changed-lines" ># Create a <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">folder say {{myplugins}}</span> <span class="diff-added-words"style="background-color: #dfd;">folder, for example {{myplugins}},</span> in your hard drive. <br></td></tr>
            <tr><td class="diff-unchanged" ># Copy the exported plugins to this directory. <br># Next create a geronimo-plugins.xml which will enlist all the plugins in our repository. <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >&lt;/geronimo-plugin-list&gt; <br>{code} <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Once this is done place the plugins in the *myplugins* repository similar to geronimo repository. For example place *jdbc%2Fuserds-1.0.rar* in C:\myplugins\console\dbpool\jdbc%2Fuserds\1.0, *ApplicationClient-1.0.car* in C:\myplugins\default\ApplicationClient\1.0 and StatelessSessionEJB-1.0.car in C:\myplugins\default\StatelessSessionEJB\1.0 <br># This completes our initial set up to create a custom repository using Geronimo Administrative console. Next Select the *Plugin* portlet and Select *Add Repository* as shown in the figure.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># After this is done, place the plugins in the *myplugins* repository similar to the way that plugins are placed in the Geronimo repository. For example place *jdbc%2Fuserds-1.0.rar* in C:\myplugins\console\dbpool\jdbc%2Fuserds\1.0, *ApplicationClient-1.0.car* in C:\myplugins\default\ApplicationClient\1.0, and StatelessSessionEJB-1.0.car in C:\myplugins\default\StatelessSessionEJB\1.0 <br># This completes our initial setup to create a custom repository by using Geronimo administration console. Next, select the *Plugin* portlet and then click *Add Repository* as shown in the figure.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!import1.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" ># Name the repository as <span class="diff-changed-words"><span class="diff-added-chars"style="background-color: #dfd;">*</span>myplugins<span class="diff-added-chars"style="background-color: #dfd;">*</span></span> and give the complete name as *file:/C:/myplugins/*. <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> *Add Repository*. <br></td></tr>
            <tr><td class="diff-unchanged" >!import2.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-changed-lines" >This completes the addition of repository in <span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">g</span><span class="diff-added-chars"style="background-color: #dfd;">G</span>eronimo.</span> <br></td></tr>
            <tr><td class="diff-unchanged" > <br>h2. Importing the plugin  <br></td></tr>
            <tr><td class="diff-changed-lines" ># Before we start importing our exported <span class="diff-changed-words">plugins<span class="diff-added-chars"style="background-color: #dfd;">,</span></span> we should <span class="diff-changed-words">un<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">-</span>install</span> the EJB jar, Application Client <span class="diff-changed-words">WAR<span class="diff-added-chars"style="background-color: #dfd;">,</span></span> and database pool from <span class="diff-added-words"style="background-color: #dfd;">the</span> server. This can be <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">down</span> <span class="diff-added-words"style="background-color: #dfd;">done</span> as shown in the subsequent figures. <br></td></tr>
            <tr><td class="diff-unchanged" >!import5.png!\\ \\ \\ <br>!import6.png!\\ \\ \\ <br>!import7.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Once done select *myplugins* repository from the drop down list.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># After this is done, select *myplugins* repository from the drop-down list.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!import3.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;">Select</span> <span class="diff-added-words"style="background-color: #dfd;">Click</span> *Show plugins in selected repository*. <br></td></tr>
            <tr><td class="diff-unchanged" >!import4.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Now if we have observerd earlier that Application Client has StatelessSessionEJB as a dependency which in turn has a dependency on the database pool. So if we import our *Application Client* plugin. All the plugins should be imported automatically. Check the *Application Client* plugin and Select *Install*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># Now, from the previous steps, we see that Application Client has StatelessSessionEJB as a dependency, which in turn has a dependency on the database pool. Therefore, if we import our *Application Client* plugin, the other two plugins should be imported automatically. Select the *Application Client* plugin and click *Install*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!import9.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Next screen will suggest the various artifacts associated with our Application Client plugin. Select *Install*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># The next screen displays the various artifacts associated with our Application Client plugin. Click *Install*.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!import10.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;"># Once done the acknowledgement suggests that Databasepool as well as Stateless session EJB has been successfully installed.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;"># After this is done, the acknowledgement suggests that the Databasepool and the Stateless session EJB have been installed successfully.\\ \\ \\ <br></td></tr>
            <tr><td class="diff-unchanged" >!import12.png!\\ \\ \\ <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Once this is done you can re-test the application functionality as suggested in *Deploy and Run* section. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">After this is done, you can retest the functionality of the application functionality. <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/Administering+plugins"><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/Administering+plugins">Administering plugins</a>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a href="/confluence/display/GMOxDOC30/Deploying+and+administering+plugins"><img border='0' align='middle' src='/confluence/images/icons/up_16.gif' width='8' height='8'></a></sup><a href="/confluence/display/GMOxDOC30/Deploying+and+administering+plugins">Deploying and administering plugins</a></td><td width='33%' class='ScrollbarNextName'>&nbsp;</td></tr></table></div>

<p>This topic will take you through plugin transform, export and import by using Apache Geronimo administration console. We have used an existing tutorial from the tutorial section. See the <a href="/confluence/display/GMOxDOC30/Stateless+Session+Bean" title="Stateless Session Bean">Stateless Session Bean</a> tutorial for application development and deployment. Then use the illustration in this tutorial to export and import Java EE artifacts from Apache Geronimo administration console. </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='#ConvertingapplicationsintopluginsusingtheAdministrationConsole-Convertingtheapplicationintoapluginviaconsole'>Converting the application into a plugin via console</a></li>
    <li><a href='#ConvertingapplicationsintopluginsusingtheAdministrationConsole-Exportingandimportingpluginsviaconsole'>Exporting and importing plugins via console</a></li>
<ul>
    <li><a href='#ConvertingapplicationsintopluginsusingtheAdministrationConsole-Exportingtheapplicationasaplugin'>Exporting the application as a plugin</a></li>
    <li><a href='#ConvertingapplicationsintopluginsusingtheAdministrationConsole-CreateacustomrepositoryfromGeronimoAdministrativeConsole'>Create a custom repository from Geronimo Administrative Console</a></li>
    <li><a href='#ConvertingapplicationsintopluginsusingtheAdministrationConsole-Importingtheplugin'>Importing the plugin</a></li>
</ul>
</ul></div>

<h1><a name="ConvertingapplicationsintopluginsusingtheAdministrationConsole-Convertingtheapplicationintoapluginviaconsole"></a>Converting the application into a plugin via console</h1>
<p>In this section, we will convert an existing applications into a plugin directly by using the administration console.</p>
<ol>
	<li>Launch the administrative console and select <b>Plugin</b> under <b>Applications</b> on the navigation panel.<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/20645346/export1.png?version=1&amp;modificationDate=1212989166000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Under <b>Create Geronimo Plugin</b>, select <b>jdbc/userds</b> database pool from the drop-down menu.<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/20645346/export2.png?version=1&amp;modificationDate=1212989166000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Then, click <b>Export Plugin</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/20645346/export3.png?version=1&amp;modificationDate=1212989166000" 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 page, keep all the values default and click <b>Saving Plugin Data</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/20645346/export4.png?version=1&amp;modificationDate=1212989166000" 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>Done</b> to convert the resource pool archive into a plugin directly.<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/20645346/export5.png?version=1&amp;modificationDate=1231028916000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Similarly, convert <b>ApplicationClient</b> and <b>StatelessSessionEJB</b> into plugins.<br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
</ol>


<h1><a name="ConvertingapplicationsintopluginsusingtheAdministrationConsole-Exportingandimportingpluginsviaconsole"></a>Exporting and importing plugins via console</h1>

<p>We are using Apache Geronimo V2.2 for this tutorial.</p>

<h2><a name="ConvertingapplicationsintopluginsusingtheAdministrationConsole-Exportingtheapplicationasaplugin"></a>Exporting the application as a plugin</h2>
<ol>
	<li>Launch the administration console and select <b>Plugin</b> under <b>Applications</b> on the navigation panel.<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/20645346/export1.png?version=1&amp;modificationDate=1212989166000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Under <b>Create Geronimo Plugin</b>, select <b>jdbc/userds</b> database pool from the drop-down menu as shown in the figure.<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/20645346/export2.png?version=1&amp;modificationDate=1212989166000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Then click <b>Export Plugin</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/20645346/export3.png?version=1&amp;modificationDate=1212989166000" 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 page, keep all the values default and click <b>Saving Plugin Data</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/20645346/export4.png?version=1&amp;modificationDate=1212989166000" 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>Export Plugin</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/20645346/export5.png?version=1&amp;modificationDate=1231028916000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>A window pops up suggesting to save the plugin. click <b>OK</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/20645346/export6.png?version=1&amp;modificationDate=1212989188000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Similarly, export <b>ApplicationClient</b> and <b>StatelessSessionEJB</b> as plugins.<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/20645346/export7.png?version=1&amp;modificationDate=1212989188000" style="border: 0px solid black" /></span><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/20645346/export8.png?version=1&amp;modificationDate=1212989188000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
</ol>


<h2><a name="ConvertingapplicationsintopluginsusingtheAdministrationConsole-CreateacustomrepositoryfromGeronimoAdministrativeConsole"></a>Create a custom repository from Geronimo Administrative Console</h2>
<ol>
	<li>Create a folder, for example <tt>myplugins</tt>, in your hard drive.</li>
	<li>Copy the exported plugins to this directory.</li>
	<li>Next create a geronimo-plugins.xml which will enlist all the plugins in our repository.
<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>geronimo-plugins.xml</b></div><div class="codeContent panelContent">
<pre class="code-java">
&lt;?xml version=<span class="code-quote">"1.0"</span> encoding=<span class="code-quote">"UTF-8"</span> standalone=<span class="code-quote">"yes"</span>?&gt;
&lt;!--
    Licensed to the Apache Software Foundation (ASF) under one or more
    contributor license agreements.  See the NOTICE file distributed with
    <span class="code-keyword">this</span> work <span class="code-keyword">for</span> additional information regarding copyright ownership.
    The ASF licenses <span class="code-keyword">this</span> file to You under the Apache License, Version 2.0
    (the <span class="code-quote">"License"</span>); you may not use <span class="code-keyword">this</span> file except in compliance with
    the License.  You may obtain a copy of the License at

       http:<span class="code-comment">//www.apache.org/licenses/LICENSE-2.0
</span>
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an <span class="code-quote">"AS IS"</span> BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License <span class="code-keyword">for</span> the specific language governing permissions and
    limitations under the License.
--&gt;
&lt;geronimo-plugin-list xmlns:ns2=<span class="code-quote">"http:<span class="code-comment">//geronimo.apache.org/xml/ns/attributes-1.2"</span> xmlns=<span class="code-quote">"http://geronimo.apache.org/xml/ns/plugins-1.3"</span>&gt;
</span>            &lt;plugin&gt;
        &lt;name&gt;DBPool Database Plugin&lt;/name&gt;
        &lt;category&gt;Sample&lt;/category&gt;
        &lt;description&gt;This plugin sets up a Derby database pool&lt;/description&gt;
        &lt;url&gt;http:<span class="code-comment">//www.apache.org&lt;/url&gt;
</span>        &lt;author&gt;Ashish Jain&lt;/author&gt;
        &lt;license osi-approved=<span class="code-quote">"<span class="code-keyword">true</span>"</span>&gt;The Apache Software License, Version 2.0&lt;/license&gt;

        &lt;plugin-artifact&gt;
            &lt;module-id&gt;
                &lt;groupId&gt;console.dbpool&lt;/groupId&gt;
                &lt;artifactId&gt;jdbc%2Fuserds&lt;/artifactId&gt;
                &lt;version&gt;1.0&lt;/version&gt;
                &lt;type&gt;rar&lt;/type&gt;
            &lt;/module-id&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;system-database&lt;/artifactId&gt;
            &lt;version&gt;2.1.1&lt;/version&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;transaction&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;j2ee-server&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;source-repository&gt;http:<span class="code-comment">//repo1.maven.org/maven2/&lt;/source-repository&gt;
</span>	&lt;source-repository&gt;file:/C:/myplugins&lt;/source-repository&gt;
        &lt;obsoletes&gt;
            &lt;groupId&gt;console.dbpool&lt;/groupId&gt;
            &lt;artifactId&gt;jdbc%2Fuserds&lt;/artifactId&gt;
            &lt;type&gt;rar&lt;/type&gt;
        &lt;/obsoletes&gt;
        &lt;/plugin-artifact&gt;
    &lt;/plugin&gt;
&lt;plugin&gt;
        &lt;name&gt;Stateless EJB Sample Plugin&lt;/name&gt;
        &lt;category&gt;Sample&lt;/category&gt;
        &lt;description&gt;This plugin installs an EJB Sample&lt;/description&gt;
        &lt;url&gt;http:<span class="code-comment">//www.apache.org&lt;/url&gt;
</span>        &lt;author&gt;Ashish Jain&lt;/author&gt;
        &lt;license osi-approved=<span class="code-quote">"<span class="code-keyword">true</span>"</span>&gt;The Apache Software License, Version 2.0&lt;/license&gt;
    &lt;plugin-artifact&gt;
        &lt;module-id&gt;
            &lt;groupId&gt;<span class="code-keyword">default</span>&lt;/groupId&gt;
            &lt;artifactId&gt;StatelessSessionEJB&lt;/artifactId&gt;
            &lt;version&gt;1.0&lt;/version&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/module-id&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;console.dbpool&lt;/groupId&gt;
            &lt;artifactId&gt;jdbc%2Fuserds&lt;/artifactId&gt;
	    &lt;type&gt;rar&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;openejb&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;system-database&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;tomcat6&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;axis&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;axis2&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;j2ee-corba-yoko&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;openjpa&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
	&lt;source-repository&gt;file:/C:/myplugins&lt;/source-repository&gt;
	&lt;source-repository&gt;http:<span class="code-comment">//repo1.maven.org/maven2/&lt;/source-repository&gt;
</span>        &lt;obsoletes&gt;
            &lt;groupId&gt;<span class="code-keyword">default</span>&lt;/groupId&gt;
            &lt;artifactId&gt;StatelessSessionEJB&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/obsoletes&gt;
    &lt;/plugin-artifact&gt;
    &lt;/plugin&gt;
&lt;plugin&gt;
        &lt;name&gt;Application Client&lt;/name&gt;
        &lt;category&gt;Sample&lt;/category&gt;
        &lt;description&gt;This plugin installs an App Client Sample&lt;/description&gt;
        &lt;url&gt;http:<span class="code-comment">//www.apache.org&lt;/url&gt;
</span>        &lt;author&gt;Ashish Jain&lt;/author&gt;
        &lt;license osi-approved=<span class="code-quote">"<span class="code-keyword">true</span>"</span>&gt;The Apache Software License, Version 2.0&lt;/license&gt;
	&lt;plugin-artifact&gt;
        &lt;module-id&gt;
            &lt;groupId&gt;<span class="code-keyword">default</span>&lt;/groupId&gt;
            &lt;artifactId&gt;ApplicationClient&lt;/artifactId&gt;
            &lt;version&gt;1.0&lt;/version&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/module-id&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;<span class="code-keyword">default</span>&lt;/groupId&gt;
            &lt;artifactId&gt;StatelessSessionEJB&lt;/artifactId&gt;
            &lt;version&gt;1.0&lt;/version&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;tomcat6&lt;/artifactId&gt;
            &lt;version&gt;2.1.1&lt;/version&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;axis&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;axis2&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;openejb&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;j2ee-corba-yoko&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;openjpa&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.apache.geronimo.configs&lt;/groupId&gt;
            &lt;artifactId&gt;jasper&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/dependency&gt;
	&lt;source-repository&gt;file:/C:/myplugins&lt;/source-repository&gt;
	&lt;source-repository&gt;http:<span class="code-comment">//repo1.maven.org/maven2/&lt;/source-repository&gt;
</span>        &lt;obsoletes&gt;
            &lt;groupId&gt;<span class="code-keyword">default</span>&lt;/groupId&gt;
            &lt;artifactId&gt;ApplicationClient&lt;/artifactId&gt;
            &lt;type&gt;car&lt;/type&gt;
        &lt;/obsoletes&gt;
     &lt;/plugin-artifact&gt;
&lt;/plugin&gt;
    &lt;<span class="code-keyword">default</span>-repository&gt;http:<span class="code-comment">//geronimo.apache.org/plugins/geronimo-2.1/&lt;/<span class="code-keyword">default</span>-repository&gt;
</span>&lt;/geronimo-plugin-list&gt;
</pre>
</div></div></li>
	<li>After this is done, place the plugins in the <b>myplugins</b> repository similar to the way that plugins are placed in the Geronimo repository. For example place <b>jdbc%2Fuserds-1.0.rar</b> in C:\myplugins\console\dbpool\jdbc%2Fuserds\1.0, <b>ApplicationClient-1.0.car</b> in C:\myplugins\default\ApplicationClient\1.0, and StatelessSessionEJB-1.0.car in C:\myplugins\default\StatelessSessionEJB\1.0</li>
	<li>This completes our initial setup to create a custom repository by using Geronimo administration console. Next, select the <b>Plugin</b> portlet and then click <b>Add Repository</b> as shown in the figure.<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/20645346/import1.png?version=1&amp;modificationDate=1212994275000" 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 repository as <b>myplugins</b> and give the complete name as <b><a href="file:/C:/myplugins/*" class="external-link" rel="nofollow">file:/C:/myplugins/*</a>. click *Add Repository</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/20645346/import2.png?version=1&amp;modificationDate=1212994275000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
This completes the addition of repository in Geronimo.</li>
</ol>


<h2><a name="ConvertingapplicationsintopluginsusingtheAdministrationConsole-Importingtheplugin"></a>Importing the plugin </h2>
<ol>
	<li>Before we start importing our exported plugins, we should uninstall the EJB jar, Application Client WAR, and database pool from the server. This can be done as shown in the subsequent figures.<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/20645346/import5.png?version=1&amp;modificationDate=1212994275000" style="border: 0px solid black" /></span><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/20645346/import6.png?version=1&amp;modificationDate=1212994320000" style="border: 0px solid black" /></span><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/20645346/import7.png?version=1&amp;modificationDate=1212994320000" 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, select <b>myplugins</b> repository from the drop-down list.<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/20645346/import3.png?version=1&amp;modificationDate=1212994275000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Click <b>Show plugins in selected repository</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/20645346/import4.png?version=1&amp;modificationDate=1212994275000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" /></li>
	<li>Now, from the previous steps, we see that Application Client has StatelessSessionEJB as a dependency, which in turn has a dependency on the database pool. Therefore, if we import our <b>Application Client</b> plugin, the other two plugins should be imported automatically. Select the <b>Application Client</b> plugin and 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/20645346/import9.png?version=1&amp;modificationDate=1212994320000" 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 screen displays the various artifacts associated with our Application Client plugin. 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/20645346/import10.png?version=1&amp;modificationDate=1212994320000" 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, the acknowledgement suggests that the Databasepool and the Stateless session EJB have been installed successfully.<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/20645346/import12.png?version=1&amp;modificationDate=1212994337000" style="border: 0px solid black" /></span><br class="atl-forced-newline" /> <br class="atl-forced-newline" /> <br class="atl-forced-newline" />
After this is done, you can retest the functionality of the application functionality.</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/Converting+applications+into+plugins+using+the+Administration+Console">View Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=20645346&revisedVersion=2&originalVersion=1">View Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Converting+applications+into+plugins+using+the+Administration+Console?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message