| <html><head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |
| <title>3.2 Configuring the OSGi Framework</title><link rel="stylesheet" href="css/stylesheet.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="index.html" title="Gemini Web User Guide"><link rel="up" href="ch03.html" title="3. Configuration"><link rel="prev" href="ch03.html" title="3. Configuration"><!--Begin Google Analytics code--><script type="text/javascript"> | |
| var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www."); | |
| document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); | |
| </script><script type="text/javascript"> | |
| var pageTracker = _gat._getTracker("UA-2728886-3"); | |
| pageTracker._setDomainName("none"); | |
| pageTracker._setAllowLinker(true); | |
| pageTracker._trackPageview(); | |
| </script><!--End Google Analytics code--></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.2 Configuring the OSGi Framework</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><th width="60%" align="center">3. Configuration</th><td width="20%" align="right"> </td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuring-osgi-framework"></a>3.2 Configuring the OSGi Framework</h2></div></div></div><p> | |
| This section provides information about configuring the OSGi framework by updating the following files in the | |
| <code class="literal">$GW_HOME/configuration</code> directory: | |
| </p><div class="table"><a name="configuring-osgi-framework-table"></a><p class="title"><b>Table 3.1. OSGi Framework Configuration Files </b></p><div class="table-contents"><table summary="OSGi Framework Configuration Files " style="border-collapse: collapse;border-top: 1.0pt solid ; border-bottom: 1.0pt solid ; border-left: 1.0pt solid ; border-right: 1.0pt solid ; "><colgroup><col><col></colgroup><thead><tr><th style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; ">Property File</th><th style="border-bottom: 1.0pt solid ; ">Description</th></tr></thead><tbody><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "> | |
| <code class="literal">config.ini</code> | |
| </td><td style="border-bottom: 1.0pt solid ; ">Configures the <a class="link" href="ch03s02.html#configuring-framework-properties" title="Configuring OSGi Framework Properties">OSGi framework properties</a>.</td></tr><tr><td style="border-right: 1.0pt solid ; "> | |
| <code class="literal">java6-server.profile</code> | |
| </td><td style="">Configures the <a class="link" href="ch03s02.html#configuring-framework-profile" title="Configuring OSGi Framework Profile">OSGi framework profile</a>.</td></tr></tbody></table></div></div><br class="table-break"><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="configuring-framework-properties"></a>Configuring OSGi Framework Properties</h3></div></div></div><p> | |
| You specify the framework properties in the <code class="literal">$GW_HOME/configuration/config.ini</code> file. | |
| The properties relevant to users are described in the following table. | |
| </p><div class="table"><a name="configuring-framework-properties-table"></a><p class="title"><b>Table 3.2. Framework Properties</b></p><div class="table-contents"><table summary="Framework Properties" style="border-collapse: collapse;border-top: 1.0pt solid ; border-bottom: 1.0pt solid ; border-left: 1.0pt solid ; border-right: 1.0pt solid ; "><colgroup><col><col></colgroup><thead><tr><th style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; ">Property</th><th style="border-bottom: 1.0pt solid ; ">Description</th></tr></thead><tbody><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "> | |
| <code class="literal">osgi.bundles</code> | |
| </td><td style="border-bottom: 1.0pt solid ; "> | |
| The comma-separated list of bundles which are automatically installed and optionally started once the system is up and running. | |
| </td></tr><tr><td style="border-right: 1.0pt solid ; "> | |
| <code class="literal">osgi.java.profile</code> | |
| </td><td style=""> | |
| Specifies the profile to use using a <code class="literal">file:</code> URI with default value | |
| <code class="literal">file:configuration/java6-server.profile</code>. | |
| </td></tr></tbody></table></div></div><br class="table-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="configuring-framework-profile"></a>Configuring OSGi Framework Profile</h3></div></div></div><p> | |
| You specify the framework profile in the <code class="literal">$GW_HOME/configuration/java6-server.profile</code> file. | |
| The properties relevant to users are described in the following table. | |
| </p><p> | |
| <span class="bold"><strong>WARNING:</strong></span> We advise you not to change the framework profile unless you are sure you know exactly what | |
| you are doing; updating the profile could cause GW to fail. | |
| </p><div class="table"><a name="configuring-framework-profile-table"></a><p class="title"><b>Table 3.3. Framework Profile Properties</b></p><div class="table-contents"><table summary="Framework Profile Properties" style="border-collapse: collapse;border-top: 1.0pt solid ; border-bottom: 1.0pt solid ; border-left: 1.0pt solid ; border-right: 1.0pt solid ; "><colgroup><col><col></colgroup><thead><tr><th style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; ">Property</th><th style="border-bottom: 1.0pt solid ; ">Description</th></tr></thead><tbody><tr><td style="border-right: 1.0pt solid ; border-bottom: 1.0pt solid ; "> | |
| <code class="literal">org.osgi.framework.bootdelegation</code> | |
| </td><td style="border-bottom: 1.0pt solid ; "> | |
| <p> | |
| This property specifies the packages which are loaded by delegation to the application class loader. | |
| Bundles can load classes belonging to these packages without importing the packages. | |
| The <code class="literal">.*</code> wildcard matches any package suffix. | |
| <code class="literal">java.*</code> is always boot delegated and must not be specified in this property. | |
| Note that the ordering of the packages does not matter. | |
| </p> | |
| </td></tr><tr><td style="border-right: 1.0pt solid ; "> | |
| <code class="literal">org.osgi.framework.system.packages</code> | |
| </td><td style=""> | |
| <p> | |
| This property specifies the packages which are exported by the system bundle. | |
| </p> | |
| <p> | |
| It is very occasionally necessary to extend the set, for example when configuring email logging appenders since the implementation of <code class="literal">javax.mail</code> is intimately related to the implementation of <code class="literal">javax.activation</code>. | |
| </p> | |
| </td></tr></tbody></table></div></div><br class="table-break"></div></div><!--Begin LoopFuse code--><script src="http://loopfuse.net/webrecorder/js/listen.js" type="text/javascript"></script><script type="text/javascript"> | |
| _lf_cid = "LF_48be82fa"; | |
| _lf_remora(); | |
| </script><!--End LoopFuse code--><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">3. Configuration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html> |