You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2012/11/04 16:47:58 UTC
svn commit: r837236 - in /websites/production/cxf/content:
cache/main.pageCache distributed-osgi.html
Author: buildbot
Date: Sun Nov 4 15:47:58 2012
New Revision: 837236
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/main.pageCache
websites/production/cxf/content/distributed-osgi.html
Modified: websites/production/cxf/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/distributed-osgi.html
==============================================================================
--- websites/production/cxf/content/distributed-osgi.html (original)
+++ websites/production/cxf/content/distributed-osgi.html Sun Nov 4 15:47:58 2012
@@ -137,90 +137,21 @@ Apache CXF -- Distributed OSGi
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><p>The Apache CXF Distributed OSGi subproject provides the Reference Implementation of the Distribution Provider component of the OSGi Remote Services Specification (Chapter 13 in the <a shape="rect" class="external-link" href="http://www.osgi.org/Download/Release4V42" rel="nofollow">OSGi 4.2 Compendium Specification</a>).<br clear="none">
-It implements the Remote Services functionality using Web Services, leveraging SOAP over HTTP and exposing the Service over a WSDL contract. Starting from version 1.1, Java interfaces can also be exposed and consumed as RESTful JAX-RS services.</p>
-
-<p>The 1.2 version of this project is also the Reference Implementation of the OSGi Remote Service Admin specification, chapter 122 in the <a shape="rect" class="external-link" href="http://www.osgi.org/Download/Release4V42" rel="nofollow">OSGi 4.2 Enterprise Specification</a>).</p>
+It implements the Remote Services functionality using Web Services, leveraging SOAP over HTTP and exposing the Service over a WSDL contract. Starting from version 1.1, Java interfaces can also be exposed and consumed as RESTful JAX-RS services. The 1.2 version of this project is also the Reference Implementation of the OSGi Remote Service Admin specification, chapter 122 in the <a shape="rect" class="external-link" href="http://www.osgi.org/Download/Release4V42" rel="nofollow">OSGi 4.2 Enterprise Specification</a>).</p>
<p>This page is about getting started and the demos, <b>further links</b>:</p>
-<ul><li><a shape="rect" href="distributed-osgi-reference.html" title="Distributed OSGi Reference">Distributed OSGi Reference</a> guide</li><li><a shape="rect" href="dosgi-presentations-and-articles.html" title="DOSGi Presentations and Articles">DOSGi Presentations and Articles</a></li><li><a shape="rect" href="dosgi-releases.html" title="DOSGi Releases">DOSGi Releases</a></li><li><a shape="rect" href="dosgi-build.html" title="DOSGi Build">DOSGi Build</a> page</li><li><a shape="rect" href="dosgi-faq.html" title="DOSGi FAQ">DOSGi FAQ</a> page</li></ul>
+<ul><li><a shape="rect" href="distributed-osgi-reference.html" title="Distributed OSGi Reference">Distributed OSGi Reference</a> guide</li><li><a shape="rect" href="dosgi-architecture.html" title="DOSGi Architecture">DOSGi Architecture</a></li><li><a shape="rect" href="dosgi-presentations-and-articles.html" title="DOSGi Presentations and Articles">DOSGi Presentations and Articles</a></li><li><a shape="rect" href="dosgi-releases.html" title="DOSGi Releases">DOSGi Releases</a></li><li><a shape="rect" href="dosgi-build.html" title="DOSGi Build">DOSGi Build</a> page</li><li><a shape="rect" href="dosgi-faq.html" title="DOSGi FAQ">DOSGi FAQ</a> page</li></ul>
<h2><a shape="rect" name="DistributedOSGi-GettingStarted"></a>Getting Started</h2>
<p>To get started, get yourself a CXF-DOSGi distribution. The following distributions are available:</p>
-<ul><li><b>Multi Bundle Distribution</b>: This distribution is a zip file containing the Distributed OSGi bundles, as well as all their dependencies.</li><li><b>Single Bundle Distribution</b>: This is a convenience distribution of a single bundle that embeds all the dependencies.</li></ul>
+<ul><li><span class="error">[Apache Karaf Feature]</span> : Allows installation in Apache Karaf using the feature commands (Available as of CXF-DOSGi 1.4.0)</li><li><span class="error">[Multi Bundle Distribution]</span>: Zip file containing the Distributed OSGi bundles, as well as all their dependencies</li><li><span class="error">[Single Bundle Distribution]</span>: Convenience distribution of a single bundle that embeds all the dependencies</li></ul>
<p>Which distribution to take? That depends on what you are doing. The single-bundle distribution is a really convenient way of getting started as it provides all of Distributed OSGi plus its dependencies in one. <br clear="none">
The multi-bundle distribution is obviously a little more work to install, but the fine-grained bundles do have an extra benefit: they allow sharing. So if your application depends on one or more of the library bundles, it can use them from the multi-bundle distribution. Similarly, the multi-bundle distribution makes it possible to update the dependency bundles - if compatible - without having to replace the Distributed OSGi bundles.</p>
-<p>Get a distribution by:</p>
-<ul><li>Downloading a built distribution. See the <a shape="rect" href="dosgi-releases.html" title="DOSGi Releases">DOSGi Releases</a> page.</li><li>Alternatively, built the distribution yourself. See the <a shape="rect" href="dosgi-build.html" title="DOSGi Build">DOSGi Build</a> page.</li></ul>
-
-
-<h3><a shape="rect" name="DistributedOSGi-SettingupyourOSGicontainer"></a>Setting up your OSGi container</h3>
-<p>Setting up the single-bundle distribution is really simple, see below. For instructions on setting up the multi-bundle distribution see the <a shape="rect" href="dosgi-multi-bundle-setup.html" title="DOSGi Multi Bundle Setup">Multi Bundle Setup</a> page.</p>
-
-<p><b>Prerequisites for the single-bundle distribution:</b></p>
-
-<p>The single-bundle distribution requires some of the interfaces of the OSGi compendium specification. These are provided with the Equinox and Felix OSGi distributions, but not installed by default.</p>
-
-<h4><a shape="rect" name="DistributedOSGi-SettingupFelix"></a>Setting up Felix</h4>
-
-<p>The compendium interfaces can be downloaded from the following various places, the easiest is probably from Maven Central, for example: <br clear="none">
-"g! install <a shape="rect" class="external-link" href="http://repo1.maven.org/maven2/org/osgi/org.osgi.compendium/4.2.0/org.osgi.compendium-4.2.0.jar" rel="nofollow">http://repo1.maven.org/maven2/org/osgi/org.osgi.compendium/4.2.0/org.osgi.compendium-4.2.0.jar</a>".<br clear="none">
-(<b>Note</b>: this step is not required for DOSGI RI 1.3)</p>
-
-
-<p>To set up Felix you can follow these steps:<br clear="none">
-<em>Verified with: Felix 4.0.2 and DOSGI RI 1.3</em></p>
-<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
-<pre class="code-java">../felix-4.0.2> java -jar bin/felix.jar
-
-Welcome to Apache Felix Gogo
-g! start http:<span class="code-comment">//www.apache.org/dist/cxf/dosgi/1.3/cxf-dosgi-ri-singlebundle-distribution-1.3.jar
-</span>... some log messages may appear...
-g! lb
- 0|Active | 0|org.apache.felix.framework (4.0.2)
- 1|Active | 1|org.apache.felix.bundlerepository (1.6.6)
- 2|Active | 1|org.apache.felix.gogo.command (0.12.0)
- 3|Active | 1|org.apache.felix.gogo.runtime (0.10.0)
- 4|Active | 1|org.apache.felix.gogo.shell (0.10.0)
- 5|Active | 1|cxf-dosgi-ri-singlebundle-distribution (1.3.0)</pre>
-</div></div>
-
-<p>However, you can also change the <tt>conf/config.properties</tt> file to automatically load these bundles. This approach is described in the <a shape="rect" href="dosgi-multi-bundle-setup.html" title="DOSGi Multi Bundle Setup">Multi Bundle Setup</a> page.</p>
-
-<h4><a shape="rect" name="DistributedOSGi-SettingupEquinox"></a>Setting up Equinox</h4>
-<p>The compendium interfaces are part of the Equinox/Eclipse distribution and can be found in a file called plugins/org.eclipse.osgi.services_3.2.0.v20090520-1800.jar (the timestamp could vary), for example:<br clear="none">
-"osgi> install <a shape="rect" class="external-link" href="file:plugins/org.eclipse.osgi.services_3.2.100.v20100503.jar" rel="nofollow">file:plugins/org.eclipse.osgi.services_3.2.100.v20100503.jar</a>"<br clear="none">
-(<b>Note</b>: this step is not required for DOSGI RI 1.3)</p>
-
-<p>To set up Equinox you can follow these steps:<br clear="none">
-<em>Verified with: Eclipse 3.6.2</em></p>
-<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
-<pre class="code-java">.../eclipse> java -jar plugins/org.eclipse.osgi_3.6.2.R36x_v20110210.jar -console
-
-osgi> install http:<span class="code-comment">//www.apache.org/dist/cxf/dosgi/1.3/cxf-dosgi-ri-singlebundle-distribution-1.3.jar
-</span>Bundle id is 1
-
-osgi> start 1
-... some log messages may appear...
-osgi> ss
-
-Framework is launched.
-
-id State Bundle
-0 ACTIVE org.eclipse.osgi_3.6.2.R36x_v20110210
-1 ACTIVE cxf-dosgi-ri-singlebundle-distribution_1.3.0</pre>
-</div></div>
-
-<p>However, you can also create a <tt>config.ini</tt> file to automatically load these bundles. This approach is described in the <a shape="rect" href="dosgi-multi-bundle-setup.html" title="DOSGi Multi Bundle Setup">Multi Bundle Setup</a> page.</p>
-
-<h4><a shape="rect" name="DistributedOSGi-UsingEquinoxfromwithintheEclipseIDE"></a>Using Equinox from within the Eclipse IDE</h4>
-<p><em>This option is really handy for debugging. Verified with: Eclipse 3.5M4</em><br clear="none">
-<a shape="rect" href="setting-up-eclipse-for-running-and-debugging-distributed-osgi.html" title="Setting up Eclipse for Running and Debugging Distributed OSGi">Setting up Eclipse for Running and Debugging Distributed OSGi</a></p>
-
<h3><a shape="rect" name="DistributedOSGi-SettingupCXF%2FDOSGiDiscovery"></a>Setting up CXF/DOSGi Discovery</h3>
<p>See the <a shape="rect" href="dosgi-discovery.html" title="DOSGi Discovery">DOSGi Discovery</a> page and the <a shape="rect" href="dosgi-discovery-demo-page.html" title="DOSGi Discovery Demo page">DOSGi Discovery Demo page</a>.</p>