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 > Managing OSGi Bundles
Date Tue, 25 Jan 2011 07:55: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/Managing+OSGi+Bundles">Managing
OSGi Bundles</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~maojia508">maojia</a>
    </h4>
        <br/>
                         <h4>Changes (10)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{excerpt}The
OSGI Bundles portlet enables users to install and manage existing bundles.{excerpt} Select
the *OSGI Bundles* portlet in the *Resources* folder from the left navigation panel to access
the portlet. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">{excerpt}You
can use the OSGI Bundles portlet to install and manage bundles.{excerpt} On the administration
console, select the *OSGI Bundles* portlet in the *Resources* folder from the left navigation
panel to access the portlet. <br></td></tr>
            <tr><td class="diff-unchanged" > <br>This document is organized
into the following sections: <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >h1. Installing an OSGi Bundle <br>
<br></td></tr>
            <tr><td class="diff-changed-lines" >You can install an OSGi Bundle
<span class="diff-added-words"style="background-color: #dfd;">by</span> using
the *OSGI Bundles* portlet on the <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Administration
Console</span> <span class="diff-added-words"style="background-color: #dfd;">administration
console</span> with the following <span class="diff-changed-words">steps:<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">.</span></span>
<br></td></tr>
            <tr><td class="diff-changed-lines" ># <span class="diff-changed-words"><span
class="diff-added-chars"style="background-color: #dfd;">Click *</span>Browse<span
class="diff-added-chars"style="background-color: #dfd;">*</span></span> to
<span class="diff-added-words"style="background-color: #dfd;">specify</span> the
location of the bundle you want to install. <br></td></tr>
            <tr><td class="diff-unchanged" ># (Optional) Input a non-negative
integer into the *Start Level* field to set a start level for your bundle. By default, the
start level of a bundle is set to 60. <br></td></tr>
            <tr><td class="diff-changed-lines" ># (Optional) <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Click</span>
<span class="diff-added-words"style="background-color: #dfd;">Select</span> the
*Start* <span class="diff-added-words"style="background-color: #dfd;">check</span>
box if you want to start the bundle after installation. <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> *Install*.
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-changed-lines" >Each OSGi Bundle is associated
with a start level <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">which</span>
<span class="diff-added-words"style="background-color: #dfd;">that</span> enable
the server to control the relative starting and stopping order of bundles. Only bundles that
have a start level less or equal to the active start level of the server framework must be
active. Usually, a bundle with a smaller start level tend to be started earlier. <br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br>Step for managing the installed
bundles in the table: <br></td></tr>
            <tr><td class="diff-changed-lines" ># <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Click</span>
<span class="diff-added-words"style="background-color: #dfd;">Select</span> the
<span class="diff-added-words"style="background-color: #dfd;">check</span> box
of the bundle <span class="diff-added-words"style="background-color: #dfd;">that</span>
you want to take action on. <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> *Start*,
<span class="diff-changed-words">*Stop*<span class="diff-added-chars"style="background-color:
#dfd;">,</span></span> or *Uninstall* according to your specific action. <br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br>h1. Bundle information
<br> <br></td></tr>
            <tr><td class="diff-changed-lines" >Double click one bundle in the
table, you will see the content of the *MANIFEST.MF* file of the bundle. This file contains
headers that specify information that the server Framework needs to install correctly and
activate a bundle. Such information includes: Import-Package, Export-Packages, Bundle-SymbolicName,
Bundle-Version, and so on. For more information about the OSGi Bundles, see <span class="diff-added-words"style="background-color:
#dfd;">the</span> [OSGi Specifications|http://www.osgi.org/Specifications/HomePage|OSGi
Specification]. <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/Deploying+and+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/Deploying+and+administering+plugins">Deploying
and administering plugins</a>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDOC30/Deploying+and+administering+assets+in+Geronimo"><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+assets+in+Geronimo">Deploying
and administering assets in Geronimo</a></td><td width='33%' class='ScrollbarNextName'>&nbsp;</td></tr></table></div>


<p>You can use the OSGI Bundles portlet to install and manage bundles. On the administration
console, select the <b>OSGI Bundles</b> portlet in the <b>Resources</b>
folder from the left navigation panel to access the portlet.</p>

<p>This document is organized into the following sections:</p>

<div>
<ul>
    <li><a href='#ManagingOSGiBundles-InstallinganOSGiBundle'>Installing an OSGi
Bundle</a></li>
    <li><a href='#ManagingOSGiBundles-ManagingthestatusofOSGiBundles'>Managing
the status of OSGi Bundles</a></li>
    <li><a href='#ManagingOSGiBundles-Bundleinformation'>Bundle information</a></li>
</ul></div>

<h1><a name="ManagingOSGiBundles-InstallinganOSGiBundle"></a>Installing
an OSGi Bundle</h1>

<p>You can install an OSGi Bundle by using the <b>OSGI Bundles</b> portlet
on the administration console with the following steps:</p>
<ol>
	<li>Click <b>Browse</b> to specify the location of the bundle you want
to install.</li>
	<li>(Optional) Input a non-negative integer into the <b>Start Level</b>
field to set a start level for your bundle. By default, the start level of a bundle is set
to 60.</li>
	<li>(Optional) Select the <b>Start</b> check box if you want to start the
bundle after installation.</li>
	<li>Click <b>Install</b>.</li>
</ol>


<p>Each OSGi Bundle is associated with a start level that enable the server to control
the relative starting and stopping order of bundles. Only bundles that have a start level
less or equal to the active start level of the server framework must be active. Usually, a
bundle with a smaller start level tend to be started earlier.</p>


<h1><a name="ManagingOSGiBundles-ManagingthestatusofOSGiBundles"></a>Managing
the status of OSGi Bundles</h1>

<p>The <b>OSGI Bundles</b> portlet displays the installed OSGi Bundles and
their status in the table under the installation area. You can start, stop and uninstall the
bundles in this table.</p>

<p>The table includes four main sections:</p>
<ol>
	<li><b>Id</b>: This column displays the bundle Id which is unique for each
bundle. The bundles in the table are sorted according to the ascending order of their Ids.
This listing order complies with the starting order of the bundles. The bundles with smaller
start levels tend to have smaller Id numbers.</li>
	<li><b>Symbolic Name</b>: This column displays the Symbolic Name of each
bundle. This attribute is set by the <b>Bundle-SymbolicName</b> header in the
<b>MANIFEST.MF</b> file in the bundle.</li>
	<li><b>Version</b>: This column displays the version of each bundle, which
is set by the <b>Bundle-Version</b> header in the <b>MANIFEST.MF</b>
file in the bundle.</li>
	<li><b>State</b>: This column displays the state of each bundle.
	<ul>
		<li>Bundles that are started are shown as <b>Active</b>. You can stop
the bundle with the following steps using the <b>Stop</b> button:</li>
		<li>Bundles that are stopped are shown as <b>Resolved</b>. You can start
the bundle with the following steps using the <b>Start</b> button:</li>
	</ul>
	</li>
</ol>


<p>Step for managing the installed bundles in the table:</p>
<ol>
	<li>Select the check box of the bundle that you want to take action on.</li>
	<li>Click <b>Start</b>, <b>Stop</b>, or <b>Uninstall</b>
according to your specific action.</li>
</ol>



<h1><a name="ManagingOSGiBundles-Bundleinformation"></a>Bundle information</h1>

<p>Double click one bundle in the table, you will see the content of the <b>MANIFEST.MF</b>
file of the bundle. This file contains headers that specify information that the server Framework
needs to install correctly and activate a bundle. Such information includes: Import-Package,
Export-Packages, Bundle-SymbolicName, Bundle-Version, and so on. For more information about
the OSGi Bundles, see the <a href="http://www.osgi.org/Specifications/HomePage" title="OSGi
Specification" class="external-link" rel="nofollow">OSGi Specifications</a>.</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/Managing+OSGi+Bundles">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=24188958&revisedVersion=3&originalVersion=2">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Managing+OSGi+Bundles?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message