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>