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 Wed, 02 Mar 2011 02:43: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/~chirunhua@gmail.com">Runhua
Chi</a>
    </h4>
        <br/>
                         <h4>Changes (4)</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;">h1.
Bundle information <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h1.
Viewing the information of OSGi Bundles <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Double
click</span> <span class="diff-added-words"style="background-color: #dfd;">Select</span>
one bundle in the table, <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">you
will</span> <span class="diff-added-words"style="background-color: #dfd;">and
click *View Manifest* to</span> 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 the [OSGi Specifications|http://www.osgi.org/Specifications/HomePage|OSGi Specification].
<br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">Or
click *View wired bundles* to see which bundles those imported packages are from and which
bundles are using exported packages from the current one. <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-ViewingtheinformationofOSGiBundles'>Viewing
the information of OSGi Bundles</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>Steps 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-ViewingtheinformationofOSGiBundles"></a>Viewing
the information of OSGi Bundles</h1>

<p>Select one bundle in the table, and click <b>View Manifest</b> to 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>.
<br/>
Or click <b>View wired bundles</b> to see which bundles those imported packages
are from and which bundles are using exported packages from the current one.</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=5&originalVersion=4">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