Author: thomas.diesler(a)jboss.com Date: 2009-06-02 13:28:29 -0400 (Tue, 02 Jun 2009) New Revision: 89685 Added: projects/jboss-osgi/trunk/docbook/en/modules/ch05-husky-testing.xml projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-bundles.xml projects/jboss-osgi/trunk/docbook/en/modules/ch07-provided-examples.xml projects/jboss-osgi/trunk/docbook/en/modules/ch08-references.xml projects/jboss-osgi/trunk/docbook/en/modules/ch09-getting-support.xml Removed: projects/jboss-osgi/trunk/docbook/en/modules/ch05-provided-bundles.xml projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-examples.xml projects/jboss-osgi/trunk/docbook/en/modules/ch07-references.xml projects/jboss-osgi/trunk/docbook/en/modules/ch08-getting-support.xml Modified: projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-equinox.properties projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-felix.properties projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-knopflerfish.properties projects/jboss-osgi/trunk/distribution/src/main/resources/installer/install-definition.xml projects/jboss-osgi/trunk/docbook/en/master.xml projects/jboss-osgi/trunk/docbook/en/modules/ch02-getting-started.xml Log: More userguide - WIP Modified: projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-equinox.properties =================================================================== --- projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-equinox.properties 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-equinox.properties 2009-06-02 17:28:29 UTC (rev 89685) @@ -12,7 +12,7 @@ org.osgi.framework.storage.clean=onFirstInit # Hot Deployement -org.jboss.osgi.hotdeploy.scandir=${osgi.server.home}/bundles +org.jboss.osgi.hotdeploy.scandir=${osgi.server.home}/deploy # HTTP Service Port org.osgi.service.http.port=8090 @@ -89,10 +89,10 @@ # Bundles that need to be installed with the Framework automatically org.jboss.osgi.spi.framework.autoInstall=\ - file://${osgi.home}/server/minimal/bundles/org.eclipse.osgi.services.jar + file://${osgi.home}/server/minimal/deploy/org.eclipse.osgi.services.jar # Bundles that need to be started automatically org.jboss.osgi.spi.framework.autoStart=\ - file://${osgi.home}/server/minimal/bundles/org.apache.felix.log.jar \ - file://${osgi.home}/server/minimal/bundles/jboss-osgi-common.jar \ - file://${osgi.home}/server/minimal/bundles/jboss-osgi-hotdeploy.jar \ No newline at end of file + file://${osgi.home}/server/minimal/deploy/org.apache.felix.log.jar \ + file://${osgi.home}/server/minimal/deploy/jboss-osgi-common.jar \ + file://${osgi.home}/server/minimal/deploy/jboss-osgi-hotdeploy.jar \ No newline at end of file Modified: projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-felix.properties =================================================================== --- projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-felix.properties 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-felix.properties 2009-06-02 17:28:29 UTC (rev 89685) @@ -12,7 +12,7 @@ org.osgi.framework.storage.clean=onFirstInit # Hot Deployement -org.jboss.osgi.hotdeploy.scandir=${osgi.server.home}/bundles +org.jboss.osgi.hotdeploy.scandir=${osgi.server.home}/deploy # HTTP Service Port org.osgi.service.http.port=8090 @@ -56,10 +56,10 @@ # Bundles that need to be installed with the Framework automatically org.jboss.osgi.spi.framework.autoInstall=\ - file://${osgi.home}/server/minimal/bundles/org.osgi.compendium.jar + file://${osgi.home}/server/minimal/deploy/org.osgi.compendium.jar # Bundles that need to be started automatically org.jboss.osgi.spi.framework.autoStart=\ - file://${osgi.home}/server/minimal/bundles/org.apache.felix.log.jar \ - file://${osgi.home}/server/minimal/bundles/jboss-osgi-common.jar \ - file://${osgi.home}/server/minimal/bundles/jboss-osgi-hotdeploy.jar \ No newline at end of file + file://${osgi.home}/server/minimal/deploy/org.apache.felix.log.jar \ + file://${osgi.home}/server/minimal/deploy/jboss-osgi-common.jar \ + file://${osgi.home}/server/minimal/deploy/jboss-osgi-hotdeploy.jar \ No newline at end of file Modified: projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-knopflerfish.properties =================================================================== --- projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-knopflerfish.properties 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/distribution/runtime/conf/jboss-osgi-knopflerfish.properties 2009-06-02 17:28:29 UTC (rev 89685) @@ -12,7 +12,7 @@ org.osgi.framework.storage.clean=onFirstInit # Hot Deployement -org.jboss.osgi.hotdeploy.scandir=${osgi.server.home}/bundles +org.jboss.osgi.hotdeploy.scandir=${osgi.server.home}/deploy # HTTP Service Port org.osgi.service.http.port=8090 @@ -86,10 +86,10 @@ # Bundles that need to be installed with the Framework automatically org.jboss.osgi.spi.framework.autoInstall=\ - file://${osgi.home}/server/minimal/bundles/org.osgi.compendium.jar + file://${osgi.home}/server/minimal/deploy/org.osgi.compendium.jar # Bundles that need to be started automatically org.jboss.osgi.spi.framework.autoStart=\ - file://${osgi.home}/server/minimal/bundles/org.apache.felix.log.jar \ - file://${osgi.home}/server/minimal/bundles/jboss-osgi-common.jar \ - file://${osgi.home}/server/minimal/bundles/jboss-osgi-hotdeploy.jar \ No newline at end of file + file://${osgi.home}/server/minimal/deploy/org.apache.felix.log.jar \ + file://${osgi.home}/server/minimal/deploy/jboss-osgi-common.jar \ + file://${osgi.home}/server/minimal/deploy/jboss-osgi-hotdeploy.jar \ No newline at end of file Modified: projects/jboss-osgi/trunk/distribution/src/main/resources/installer/install-definition.xml =================================================================== --- projects/jboss-osgi/trunk/distribution/src/main/resources/installer/install-definition.xml 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/distribution/src/main/resources/installer/install-definition.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -176,14 +176,14 @@ </fileset> <!-- Server Minimal --> - <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/bundles" override="true"> + <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/deploy" override="true"> <include name="org.apache.felix.log.jar" /> <include name="jboss-osgi-common.jar" /> <include name="jboss-osgi-hotdeploy.jar" /> </fileset> <!-- Server Default --> - <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/default/bundles" override="true"> + <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/default/deploy" override="true"> <!-- default --> <include name="jboss-osgi-common-core.jar" /> <include name="jboss-osgi-jmx.jar" /> @@ -191,7 +191,7 @@ </fileset> <!-- Server Web --> - <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/web/bundles" override="true"> + <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/web/deploy" override="true"> <!-- default --> <include name="jboss-osgi-common-core.jar" /> <include name="jboss-osgi-jmx.jar" /> @@ -204,7 +204,7 @@ </fileset> <!-- Server All --> - <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/all/bundles" override="true"> + <fileset dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/all/deploy" override="true"> <!-- default --> <include name="jboss-osgi-common-core.jar" /> <include name="jboss-osgi-jmx.jar" /> @@ -228,7 +228,7 @@ <include name="jboss-osgi-runtime-felix.jar" /> <include name="org.apache.felix.framework.jar" /> </fileset> - <fileset condition="isFelix" dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/bundles" override="true"> + <fileset condition="isFelix" dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/deploy" override="true"> <include name="org.osgi.compendium.jar" /> </fileset> @@ -239,7 +239,7 @@ <include name="jboss-osgi-runtime-equinox.jar" /> <include name="org.eclipse.osgi.jar" /> </fileset> - <fileset condition="isEquinox" dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/bundles" override="true"> + <fileset condition="isEquinox" dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/deploy" override="true"> <include name="org.eclipse.osgi.services.jar" /> </fileset> @@ -250,7 +250,7 @@ <include name="jboss-osgi-runtime-knopflerfish.jar" /> <include name="org.knopflerfish.framework.jar" /> </fileset> - <fileset condition="isKnopflerfish" dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/bundles" override="true"> + <fileset condition="isKnopflerfish" dir=&quot;(a){deploy.artifacts.dir}/lib&quot; targetdir="$INSTALL_PATH/runtime/server/minimal/deploy" override="true"> <include name="org.osgi.compendium.jar" /> </fileset> Modified: projects/jboss-osgi/trunk/docbook/en/master.xml =================================================================== --- projects/jboss-osgi/trunk/docbook/en/master.xml 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/docbook/en/master.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -14,9 +14,10 @@ <xi:include href="modules/ch02-getting-started.xml"/> <xi:include href="modules/ch03-framework-integration.xml"/> <xi:include href="modules/ch04-developer-guide.xml"/> - <xi:include href="modules/ch05-provided-bundles.xml"/> - <xi:include href="modules/ch06-provided-examples.xml"/> - <xi:include href="modules/ch07-references.xml"/> - <xi:include href="modules/ch08-getting-support.xml"/> + <xi:include href="modules/ch05-husky-testing.xml"/> + <xi:include href="modules/ch06-provided-bundles.xml"/> + <xi:include href="modules/ch07-provided-examples.xml"/> + <xi:include href="modules/ch08-references.xml"/> + <xi:include href="modules/ch09-getting-support.xml"/> </book> \ No newline at end of file Modified: projects/jboss-osgi/trunk/docbook/en/modules/ch02-getting-started.xml =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch02-getting-started.xml 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch02-getting-started.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -105,9 +105,27 @@ </imageobject> </mediaobject> - <!-- [TODO] document the runtime --> - <para>The JBossOSGi Runtime is ... [TODO]</para> + <para>The JBossOSGi Runtime has now evolved into a pure OSGi container onto which services and applications can be deployed.</para> + <para>The current JBossOSGi Runtime feature set includes</para> + + <itemizedlist> + <listitem><emphasis role="bold">Embedded and Standalone usage</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Hot Deployement</emphasis> - </listitem> + <listitem><emphasis role="bold">Multiple OSGi Frameworks</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Various Runtime Profiles</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Local and Remote JMX Support</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">JNDI Support</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">SAX/DOM Parser Support</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">JAXB Support</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Http Service Support</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Config Admin Support</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Provisioning</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Logging System</emphasis> - [TODO]</listitem> + <listitem><emphasis role="bold">Microcontainer Support</emphasis> - [TODO]</listitem> + </itemizedlist> + + <programlisting> [tdiesler@tddell runtime]$ bin/run.sh ========================================================================= @@ -140,6 +158,25 @@ 16:18:34,544 INFO [OSGiBootstrap] JBossOSGi Runtime started in 1.57sec </programlisting> + <sect2 xml:id="SecRuntimeProfileMinimum"> + <title>Minimum Profile</title> + </sect2> + + <sect2 xml:id="SecRuntimeProfileDefault"> + <title>Default Profile</title> + <para>[TODO]</para> + </sect2> + + <sect2 xml:id="SecRuntimeProfileWeb"> + <title>Web Profile</title> + <para>[TODO]</para> + </sect2> + + <sect2 xml:id="SecRuntimeProfileAll"> + <title>All Profile</title> + <para>[TODO]</para> + </sect2> + <emphasis role="bold">Provided Examples</emphasis> <para>JBossOSGi comes with a number of examples that you can build and deploy. Each example @@ -148,8 +185,8 @@ <itemizedlist> <listitem><emphasis role="bold">HTTP Service</emphasis> - Register servlets and resources with the HTTP Service</listitem> <listitem><emphasis role="bold">Log Service</emphasis> - Interact with a local and remote Log Service</listitem> - <listitem><emphasis role="bold">JMX Service</emphasis> - Register an MBean through the MBeanServer service</listitem> - <listitem><emphasis role="bold">JNDI Service</emphasis> - Bind/Unbind objects to/from JNDI</listitem> + <listitem><emphasis role="bold">JMX Service</emphasis> - Register an MBean through the JMX Service</listitem> + <listitem><emphasis role="bold">JNDI Service</emphasis> - Bind objects to the Naming Service</listitem> <listitem><emphasis role="bold">Microcontainer Service</emphasis> - Call a service from an MC bean</listitem> </itemizedlist> @@ -183,10 +220,10 @@ <emphasis role="bold">Bundle Deployment</emphasis> <para>Bundle deployment works, as you would probably expect, by dropping your OSGi Bundle into the - JBossOSGi Runtime <emphasis role="bold">bundles</emphasis> folder.</para> + JBossOSGi Runtime <emphasis role="bold">deploy</emphasis> folder.</para> <programlisting> - [tdiesler@tdvaio testsuite]$ cp .../test-libs/example/example-http.jar .../runtime/server/web/bundles + [tdiesler@tdvaio testsuite]$ cp .../test-libs/example/example-http.jar .../runtime/server/web/deploy ... 13:59:38,284 INFO [BundleRealDeployer] Installed: example-http [9] 13:59:38,289 INFO [example-http] BundleEvent INSTALLED Added: projects/jboss-osgi/trunk/docbook/en/modules/ch05-husky-testing.xml =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch05-husky-testing.xml (rev 0) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch05-husky-testing.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -0,0 +1,29 @@ +<!-- + $Id$ +--> +<chapter xml:id="ChapHuskyTesting"> + + <title>Husky OSGi Test Framework</title> + + <sect1 xml:id="SecHuskyOverview"> + <title>Overview</title> + + <para>[TODO]</para> + + </sect1> + + <sect1 xml:id="SecHuskyConfiguration"> + <title>Configuration</title> + + <para>[TODO]</para> + + </sect1> + + <sect1 xml:id="SecHuskyWritingTests"> + <title>Writing Husky Tests</title> + + <para>[TODO]</para> + + </sect1> + +</chapter> Property changes on: projects/jboss-osgi/trunk/docbook/en/modules/ch05-husky-testing.xml ___________________________________________________________________ Name: svn:keywords + Id Revision Name: svn:eol-style + LF Deleted: projects/jboss-osgi/trunk/docbook/en/modules/ch05-provided-bundles.xml =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch05-provided-bundles.xml 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch05-provided-bundles.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -1,141 +0,0 @@ -<!-- - $Id$ ---> -<chapter xml:id="ChapProvidedBundles"> - - <title>Provided Bundles and Services</title> - - <sect1 xml:id="SecLoggingService"> - <title>Logging Bridge Service</title> - - <para>The JBossOSGi <emphasis role="bold">jboss-osgi-logging.jar</emphasis> bundle contains a simple Logging Bridge Service to - <ulink url="http://www.jboss.org/community/docs/DOC-11280">JBoss Logging</ulink>. It registers a trivial LogListener with the - LogReaderService in case that service is registered with the Framework.</para> - - <itemizedlist> - <listitem><ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogListe... - Subscribes to LogEntry objects from the LogReaderService</listitem> - <listitem><ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogReade... - Provides methods to retrieve LogEntry objects from the log</listitem> - </itemizedlist> - - <para>The LogReaderService is part of the standard <ulink url="http://www.osgi.org/Download/File?url=/download/r4v41/r4.cmpn.p... - Compendium Services</ulink>. JBossOSGi currently uses the <ulink url="http://felix.apache.org/site/apache-felix-log-service.html"... Service</ulink> - from <ulink url="http://felix.apache.org">Apache Felix</ulink>, which gets deployed as Bundle <emphasis role="bold">org.apache.felix.log.jar</emphasis> - </para> - - <para>The LogListener itself logs messages under the Bundle's symbolic name.</para> - - <programlisting role="JAVA"> - public class JBossLoggingLogListener implements LogListener - { - public void logged(LogEntry entry) - { - Bundle bundle = entry.getBundle(); - int level = entry.getLevel(); - Throwable throwable = entry.getException(); - - String loggerName = bundle.getSymbolicName(); - Logger log = Logger.getLogger(loggerName); - - if (level == LogService.LOG_DEBUG) - log.debug(entry.getMessage(), throwable); - - else if (level == LogService.LOG_INFO) - log.info(entry.getMessage(), throwable); - - else if (level == LogService.LOG_WARNING) - log.warn(entry.getMessage(), throwable); - - else if (level == LogService.LOG_ERROR) - log.error(entry.getMessage(), throwable); - } - } - </programlisting> - - <para>You can therefore change the logging for specific Bundles by - <ulink url="http://www.jboss.org/community/docs/DOC-12490">setting the respective logging level</ulink>.</para> - </sect1> - - <sect1 xml:id="SecRemoteLogService"> - <title>Remote Log Service</title> - - <para>The JBossOSGi <emphasis role="bold">jboss-osgi-remotelog.jar</emphasis> bundle contains a client side - <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogReade... that remotely - communicates with a server side <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogListe...;. - </para> - - <para>The Remote Log Service is configured with these properties.</para> - - <table> - <tr><th>Key</th><th>Value</th><th>Description</th></tr> - <tr valign="top"> - <td>org.jboss.osgi.service.remote.log.sender</td> - <td>true/false</td> - <td>Enable the server side LogListener</td> - </tr> - <tr valign="top"> - <td>org.jboss.osgi.service.remote.log.reader</td> - <td>true/false</td> - <td>Enable the client side LogReaderService</td> - </tr> - <tr valign="top"> - <td>org.jboss.osgi.service.remote.log.host</td> - <td>localhost</td> - <td>The remote host that log messages are sent to</td> - </tr> - <tr valign="top"> - <td>org.jboss.osgi.service.remote.log.port</td> - <td>5400</td> - <td>The remote port that log messages are sent to</td> - </tr> - </table> - - <para>On the client side you can install an arbitrary <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogListe... - with the <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogReade...;. The testsuite typically - installs an <ulink url="http://jbmuc.dyndns.org:8280/hudson/job/jbossosgi-jdk16/ws/jboss-osgi/spi/target/apidocs/org/jboss/osgi/spi/logging/LogEntryCache.html">LogEntryCache</ulink> - that filters the received log messages.</para> - - <programlisting role="JAVA"> - LogEntryCache logEntryCache = new LogEntryCache(); - logEntryCache.addFilter(new LogEntryFilter("example-log(.*)", LogService.LOG_INFO, "\\[ServiceA\\](.*)")); - - // Track the RemoteLogReaderService to add the LogEntryCache as LogListener - ServiceTracker tracker = new ServiceTracker(sysContext, RemoteLogReaderService.class.getName(), null) - { - @Override - public Object addingService(ServiceReference sref) - { - LogReaderService service = (LogReaderService)super.addingService(sref); - service.addLogListener(logEntryCache); - return service; - } - }; - tracker.open(); - </programlisting> - </sect1> - - <sect1 xml:id="SecMicrocontainerService"> - <title>Microcontainer Service</title> - - <para>JBossOSGi SPI comes with a service that give access to the <ulink url="http://www.jboss.org/jbossmc">JBoss Microcontainer</ulink> Kernel - and the JMX <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/javax/management/MBeanS...;. The service is - registered with the Framework under the name</para> - - <itemizedlist> - <listitem><emphasis role="bold">org.jboss.osgi.service.MicrocontainerService</emphasis></listitem> - </itemizedlist> - - <para>Here is an example of how an OSGi component can register an arbitrary MBean with the - <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/javax/management/MBeanS... - - <programlisting role="JAVA"> - ServiceReference sref = context.getServiceReference(MicrocontainerService.class.getName()); - if (sref == null) - throw new IllegalStateException("MicrocontainerService not registered"); - - MicrocontainerService mcService = (MicrocontainerService)context.getService(sref); - MBeanServer mbeanServer = mcService.getMbeanServer(); - mbeanServer.registerMBean(new Foo(), OBJECT_NAME); - </programlisting> - </sect1> - -</chapter> Copied: projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-bundles.xml (from rev 89672, projects/jboss-osgi/trunk/docbook/en/modules/ch05-provided-bundles.xml) =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-bundles.xml (rev 0) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-bundles.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -0,0 +1,141 @@ +<!-- + $Id$ +--> +<chapter xml:id="ChapProvidedBundles"> + + <title>Provided Bundles and Services</title> + + <sect1 xml:id="SecLoggingService"> + <title>Logging Bridge Service</title> + + <para>The JBossOSGi <emphasis role="bold">jboss-osgi-logging.jar</emphasis> bundle contains a simple Logging Bridge Service to + <ulink url="http://www.jboss.org/community/docs/DOC-11280">JBoss Logging</ulink>. It registers a trivial LogListener with the + LogReaderService in case that service is registered with the Framework.</para> + + <itemizedlist> + <listitem><ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogListe... - Subscribes to LogEntry objects from the LogReaderService</listitem> + <listitem><ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogReade... - Provides methods to retrieve LogEntry objects from the log</listitem> + </itemizedlist> + + <para>The LogReaderService is part of the standard <ulink url="http://www.osgi.org/Download/File?url=/download/r4v41/r4.cmpn.p... + Compendium Services</ulink>. JBossOSGi currently uses the <ulink url="http://felix.apache.org/site/apache-felix-log-service.html"... Service</ulink> + from <ulink url="http://felix.apache.org">Apache Felix</ulink>, which gets deployed as Bundle <emphasis role="bold">org.apache.felix.log.jar</emphasis> + </para> + + <para>The LogListener itself logs messages under the Bundle's symbolic name.</para> + + <programlisting role="JAVA"> + public class JBossLoggingLogListener implements LogListener + { + public void logged(LogEntry entry) + { + Bundle bundle = entry.getBundle(); + int level = entry.getLevel(); + Throwable throwable = entry.getException(); + + String loggerName = bundle.getSymbolicName(); + Logger log = Logger.getLogger(loggerName); + + if (level == LogService.LOG_DEBUG) + log.debug(entry.getMessage(), throwable); + + else if (level == LogService.LOG_INFO) + log.info(entry.getMessage(), throwable); + + else if (level == LogService.LOG_WARNING) + log.warn(entry.getMessage(), throwable); + + else if (level == LogService.LOG_ERROR) + log.error(entry.getMessage(), throwable); + } + } + </programlisting> + + <para>You can therefore change the logging for specific Bundles by + <ulink url="http://www.jboss.org/community/docs/DOC-12490">setting the respective logging level</ulink>.</para> + </sect1> + + <sect1 xml:id="SecRemoteLogService"> + <title>Remote Log Service</title> + + <para>The JBossOSGi <emphasis role="bold">jboss-osgi-remotelog.jar</emphasis> bundle contains a client side + <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogReade... that remotely + communicates with a server side <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogListe...;. + </para> + + <para>The Remote Log Service is configured with these properties.</para> + + <table> + <tr><th>Key</th><th>Value</th><th>Description</th></tr> + <tr valign="top"> + <td>org.jboss.osgi.service.remote.log.sender</td> + <td>true/false</td> + <td>Enable the server side LogListener</td> + </tr> + <tr valign="top"> + <td>org.jboss.osgi.service.remote.log.reader</td> + <td>true/false</td> + <td>Enable the client side LogReaderService</td> + </tr> + <tr valign="top"> + <td>org.jboss.osgi.service.remote.log.host</td> + <td>localhost</td> + <td>The remote host that log messages are sent to</td> + </tr> + <tr valign="top"> + <td>org.jboss.osgi.service.remote.log.port</td> + <td>5400</td> + <td>The remote port that log messages are sent to</td> + </tr> + </table> + + <para>On the client side you can install an arbitrary <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogListe... + with the <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogReade...;. The testsuite typically + installs an <ulink url="http://jbmuc.dyndns.org:8280/hudson/job/jbossosgi-jdk16/ws/jboss-osgi/spi/target/apidocs/org/jboss/osgi/spi/logging/LogEntryCache.html">LogEntryCache</ulink> + that filters the received log messages.</para> + + <programlisting role="JAVA"> + LogEntryCache logEntryCache = new LogEntryCache(); + logEntryCache.addFilter(new LogEntryFilter("example-log(.*)", LogService.LOG_INFO, "\\[ServiceA\\](.*)")); + + // Track the RemoteLogReaderService to add the LogEntryCache as LogListener + ServiceTracker tracker = new ServiceTracker(sysContext, RemoteLogReaderService.class.getName(), null) + { + @Override + public Object addingService(ServiceReference sref) + { + LogReaderService service = (LogReaderService)super.addingService(sref); + service.addLogListener(logEntryCache); + return service; + } + }; + tracker.open(); + </programlisting> + </sect1> + + <sect1 xml:id="SecMicrocontainerService"> + <title>Microcontainer Service</title> + + <para>JBossOSGi SPI comes with a service that give access to the <ulink url="http://www.jboss.org/jbossmc">JBoss Microcontainer</ulink> Kernel + and the JMX <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/javax/management/MBeanS...;. The service is + registered with the Framework under the name</para> + + <itemizedlist> + <listitem><emphasis role="bold">org.jboss.osgi.service.MicrocontainerService</emphasis></listitem> + </itemizedlist> + + <para>Here is an example of how an OSGi component can register an arbitrary MBean with the + <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/javax/management/MBeanS... + + <programlisting role="JAVA"> + ServiceReference sref = context.getServiceReference(MicrocontainerService.class.getName()); + if (sref == null) + throw new IllegalStateException("MicrocontainerService not registered"); + + MicrocontainerService mcService = (MicrocontainerService)context.getService(sref); + MBeanServer mbeanServer = mcService.getMbeanServer(); + mbeanServer.registerMBean(new Foo(), OBJECT_NAME); + </programlisting> + </sect1> + +</chapter> Deleted: projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-examples.xml =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-examples.xml 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-examples.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -1,165 +0,0 @@ -<!-- - $Id$ ---> -<chapter xml:id="ChapProvidedExamples"> - - <title>Provided Examples</title> - - <sect1 xml:id="SecBuildAndRunExamples"> - <title>Building the Examples</title> - - <para>JBossOSGi comes with a number of examples that demonstrate supported functionality - and show best practices. All examples are part of the binary distribution and tightly - integrated in our <ulink url="http://www.jboss.org/community/docs/DOC-13275">Maven Build Process</ulink> - and <ulink url="http://www.jboss.org/community/docs/DOC-13420">Hudson QA Environment</ulink>.</para> - - <para>The examples can be either run against a local embedded OSGi Framework or against - a remote OSGi Runtime instance. Here is how you build and run the against the embedded OSGi Framework.</para> - - <programlisting> - /home/yourname/jboss-osgi-1.0.0.Beta1/example - [tdiesler@tddell example]$ mvn test - ... - [INFO] ------------------------------------------------------------------------ - [INFO] Building JBossOSGi - Testsuite Examples - [INFO] task-segment: [test] - [INFO] ------------------------------------------------------------------------ - ... - build-example-jars: - # example-log (example-log.jar) 2 - # example-http (example-http.jar) 4 - # example-microcontainer (example-microcontainer.jar) 4 - ... - ------------------------------------------------------- - T E S T S - ------------------------------------------------------- - Running org.jboss.test.osgi.example.log.LogServiceTestCase - Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 3.876 sec - ... - [INFO] ------------------------------------------------------------------------ - [INFO] BUILD SUCCESSFUL - [INFO] ------------------------------------------------------------------------ - [INFO] Total time: 17 seconds - [INFO] Finished at: Tue Apr 21 14:32:31 CEST 2009 - [INFO] Final Memory: 21M/51M - [INFO] ------------------------------------------------------------------------ - </programlisting> - - <para>To run the examples against a remote OSGi Runtime, you need to provide the - host theat the runtime binds to. This can be done with the - <emphasis role="bold">-Djboss.bind.address=localhost</emphasis> property.</para> - - <programlisting> - /home/yourname/jboss-osgi-1.0.0.Beta1/example - [tdiesler@tddell example]$ mvn -Djboss.bind.address=localhost test - ... - [INFO] ------------------------------------------------------------------------ - [INFO] Building JBossOSGi - Testsuite Examples - [INFO] task-segment: [test] - [INFO] ------------------------------------------------------------------------ - ... - build-example-jars: - # example-log (example-log.jar) 2 - # example-http (example-http.jar) 4 - # example-microcontainer (example-microcontainer.jar) 4 - ... - ------------------------------------------------------- - T E S T S - ------------------------------------------------------- - Running org.jboss.test.osgi.example.http.HttpServiceRemoteTestCase - Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.435 sec - Running org.jboss.test.osgi.example.log.LogServiceTestCase - Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 3.06 sec - Running org.jboss.test.osgi.example.microcontainer.MBeanServiceRemoteTestCase - Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.177 sec - Running org.jboss.test.osgi.example.log.LogServiceRemoteTestCase - Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.632 sec - ... - [INFO] ------------------------------------------------------------------------ - [INFO] BUILD SUCCESSFUL - [INFO] ------------------------------------------------------------------------ - [INFO] Total time: 29 seconds - [INFO] Finished at: Tue Apr 21 14:47:33 CEST 2009 - [INFO] Final Memory: 44M/82M - [INFO] ------------------------------------------------------------------------ - </programlisting> - </sect1> - - <sect1 xml:id="SecHTTPServiceExample"> - <title>HTTP Service Example</title> - - <para>The <emphasis role="bold">example-http.jar</emphasis> bundle contains a Service - that registeres a servlet and a resource with the <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/http/HttpSer...;. - </para> - - <programlisting role="JAVA"> - ServiceTracker tracker = new ServiceTracker(context, HttpService.class.getName(), null); - tracker.open(); - - HttpService httpService = (HttpService)tracker.getService(); - if (httpService == null) - throw new IllegalStateException("HttpService not registered"); - - Properties initParams = new Properties(); - initParams.setProperty("initProp", "SomeValue"); - httpService.registerServlet("/servlet", new EndpointServlet(context), initParams, null); - httpService.registerResources("/file", "/res", null); - </programlisting> - - <para>The test then verifies that the registered servlet context and the registered resource can be accessed.</para> - </sect1> - - <sect1 xml:id="SecLogServiceExample"> - <title>Log Service Example</title> - - <para>The <emphasis role="bold">example-log.jar</emphasis> bundle contains a Service - that logs messages to the <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogServi...;. - - </para> - - <programlisting role="JAVA"> - public ServiceA(BundleContext context) - { - log = new LogServiceTracker(context); - log.log(LOG_INFO, "[ServiceA] new Service"); - } - </programlisting> - - <para>The test then filters and verifies the log messages.</para> - - <programlisting role="JAVA"> - LogEntryCache logEntryCache = new LogEntryCache(); - logEntryCache.addFilter(new LogEntryFilter(null, 0, "\\[ServiceA\\](.*)")); - startLogEntryTracking(logEntryCache); - - // Verify the received log entries - List entries = logEntryCache.getLog(); - assertEquals("Number of entries", 1, entries.size()); - assertEquals("[ServiceA] new Service", entries.get(0).getMessage()); - </programlisting> - - <para>The test is available both for embedded and remote LogService testing.</para> - </sect1> - - <sect1 xml:id="SecMicrocontainerServiceExample"> - <title>MC Service Example</title> - - <para>The <emphasis role="bold">example-microcontainer.jar</emphasis> bundle contains a Service - that registers an MBean with the <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/javax/management/MBeanS...;. - </para> - - <programlisting role="JAVA"> - MicrocontainerService service = (MicrocontainerService)tracker.getService(); - mbeanServer = mcService.getMbeanServer(); - mbeanServer.registerMBean(new Foo(), OBJECT_NAME); - </programlisting> - - <para>The test then accesses the registered MBean.</para> - - <programlisting role="JAVA"> - FooMBean foo = (FooMBean)MBeanProxy.get(FooMBean.class, OBJECT_NAME, getServer()); - assertEquals("hello", foo.echo("hello")); - </programlisting> - </sect1> - -</chapter> Copied: projects/jboss-osgi/trunk/docbook/en/modules/ch07-provided-examples.xml (from rev 89672, projects/jboss-osgi/trunk/docbook/en/modules/ch06-provided-examples.xml) =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch07-provided-examples.xml (rev 0) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch07-provided-examples.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -0,0 +1,165 @@ +<!-- + $Id$ +--> +<chapter xml:id="ChapProvidedExamples"> + + <title>Provided Examples</title> + + <sect1 xml:id="SecBuildAndRunExamples"> + <title>Building the Examples</title> + + <para>JBossOSGi comes with a number of examples that demonstrate supported functionality + and show best practices. All examples are part of the binary distribution and tightly + integrated in our <ulink url="http://www.jboss.org/community/docs/DOC-13275">Maven Build Process</ulink> + and <ulink url="http://www.jboss.org/community/docs/DOC-13420">Hudson QA Environment</ulink>.</para> + + <para>The examples can be either run against a local embedded OSGi Framework or against + a remote OSGi Runtime instance. Here is how you build and run the against the embedded OSGi Framework.</para> + + <programlisting> + /home/yourname/jboss-osgi-1.0.0.Beta1/example + [tdiesler@tddell example]$ mvn test + ... + [INFO] ------------------------------------------------------------------------ + [INFO] Building JBossOSGi - Testsuite Examples + [INFO] task-segment: [test] + [INFO] ------------------------------------------------------------------------ + ... + build-example-jars: + # example-log (example-log.jar) 2 + # example-http (example-http.jar) 4 + # example-microcontainer (example-microcontainer.jar) 4 + ... + ------------------------------------------------------- + T E S T S + ------------------------------------------------------- + Running org.jboss.test.osgi.example.log.LogServiceTestCase + Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 3.876 sec + ... + [INFO] ------------------------------------------------------------------------ + [INFO] BUILD SUCCESSFUL + [INFO] ------------------------------------------------------------------------ + [INFO] Total time: 17 seconds + [INFO] Finished at: Tue Apr 21 14:32:31 CEST 2009 + [INFO] Final Memory: 21M/51M + [INFO] ------------------------------------------------------------------------ + </programlisting> + + <para>To run the examples against a remote OSGi Runtime, you need to provide the + host theat the runtime binds to. This can be done with the + <emphasis role="bold">-Djboss.bind.address=localhost</emphasis> property.</para> + + <programlisting> + /home/yourname/jboss-osgi-1.0.0.Beta1/example + [tdiesler@tddell example]$ mvn -Djboss.bind.address=localhost test + ... + [INFO] ------------------------------------------------------------------------ + [INFO] Building JBossOSGi - Testsuite Examples + [INFO] task-segment: [test] + [INFO] ------------------------------------------------------------------------ + ... + build-example-jars: + # example-log (example-log.jar) 2 + # example-http (example-http.jar) 4 + # example-microcontainer (example-microcontainer.jar) 4 + ... + ------------------------------------------------------- + T E S T S + ------------------------------------------------------- + Running org.jboss.test.osgi.example.http.HttpServiceRemoteTestCase + Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.435 sec + Running org.jboss.test.osgi.example.log.LogServiceTestCase + Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 3.06 sec + Running org.jboss.test.osgi.example.microcontainer.MBeanServiceRemoteTestCase + Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.177 sec + Running org.jboss.test.osgi.example.log.LogServiceRemoteTestCase + Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.632 sec + ... + [INFO] ------------------------------------------------------------------------ + [INFO] BUILD SUCCESSFUL + [INFO] ------------------------------------------------------------------------ + [INFO] Total time: 29 seconds + [INFO] Finished at: Tue Apr 21 14:47:33 CEST 2009 + [INFO] Final Memory: 44M/82M + [INFO] ------------------------------------------------------------------------ + </programlisting> + </sect1> + + <sect1 xml:id="SecHTTPServiceExample"> + <title>HTTP Service Example</title> + + <para>The <emphasis role="bold">example-http.jar</emphasis> bundle contains a Service + that registeres a servlet and a resource with the <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/http/HttpSer...;. + </para> + + <programlisting role="JAVA"> + ServiceTracker tracker = new ServiceTracker(context, HttpService.class.getName(), null); + tracker.open(); + + HttpService httpService = (HttpService)tracker.getService(); + if (httpService == null) + throw new IllegalStateException("HttpService not registered"); + + Properties initParams = new Properties(); + initParams.setProperty("initProp", "SomeValue"); + httpService.registerServlet("/servlet", new EndpointServlet(context), initParams, null); + httpService.registerResources("/file", "/res", null); + </programlisting> + + <para>The test then verifies that the registered servlet context and the registered resource can be accessed.</para> + </sect1> + + <sect1 xml:id="SecLogServiceExample"> + <title>Log Service Example</title> + + <para>The <emphasis role="bold">example-log.jar</emphasis> bundle contains a Service + that logs messages to the <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/log/LogServi...;. + + </para> + + <programlisting role="JAVA"> + public ServiceA(BundleContext context) + { + log = new LogServiceTracker(context); + log.log(LOG_INFO, "[ServiceA] new Service"); + } + </programlisting> + + <para>The test then filters and verifies the log messages.</para> + + <programlisting role="JAVA"> + LogEntryCache logEntryCache = new LogEntryCache(); + logEntryCache.addFilter(new LogEntryFilter(null, 0, "\\[ServiceA\\](.*)")); + startLogEntryTracking(logEntryCache); + + // Verify the received log entries + List entries = logEntryCache.getLog(); + assertEquals("Number of entries", 1, entries.size()); + assertEquals("[ServiceA] new Service", entries.get(0).getMessage()); + </programlisting> + + <para>The test is available both for embedded and remote LogService testing.</para> + </sect1> + + <sect1 xml:id="SecMicrocontainerServiceExample"> + <title>MC Service Example</title> + + <para>The <emphasis role="bold">example-microcontainer.jar</emphasis> bundle contains a Service + that registers an MBean with the <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/javax/management/MBeanS...;. + </para> + + <programlisting role="JAVA"> + MicrocontainerService service = (MicrocontainerService)tracker.getService(); + mbeanServer = mcService.getMbeanServer(); + mbeanServer.registerMBean(new Foo(), OBJECT_NAME); + </programlisting> + + <para>The test then accesses the registered MBean.</para> + + <programlisting role="JAVA"> + FooMBean foo = (FooMBean)MBeanProxy.get(FooMBean.class, OBJECT_NAME, getServer()); + assertEquals("hello", foo.echo("hello")); + </programlisting> + </sect1> + +</chapter> Deleted: projects/jboss-osgi/trunk/docbook/en/modules/ch07-references.xml =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch07-references.xml 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch07-references.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -1,27 +0,0 @@ -<!-- - $Id$ ---> -<chapter xml:id="ChapReferences"> - - <title>References</title> - - <para><emphasis role="bold">Resources</emphasis></para> - - <itemizedlist> - <listitem><ulink url="http://www.jboss.org/community/wiki/JBossOSGi">JBossOSGi Wiki</ulink></listitem> - <listitem><ulink url="http://jbossosgi.blogspot.com">JBossOSGi Diary (Blog)</ulink></listitem> - <listitem><ulink url="https://jira.jboss.org/jira/browse/JBOSGI">Issue Tracking</ulink></listitem> - <listitem><ulink url="http://jbmuc.dyndns.org:8280/hudson">Hudson QA</ulink></listitem> - <listitem><ulink url="https://anonsvn.jboss.org/repos/jbossas/projects/jboss-osgi&quo... - <listitem><ulink url="http://fisheye.jboss.com/browse/JBossOSGi">Fisheye</... - <listitem><ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... Forum</ulink></listitem> - <listitem><ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... Forum</ulink></listitem> - </itemizedlist> - - <para><emphasis role="bold">Authors</emphasis></para> - - <itemizedlist> - <listitem><ulink url="email:thomas.diesler@jboss.com">Thomas Diesler</ulink></listitem> - </itemizedlist> - -</chapter> Deleted: projects/jboss-osgi/trunk/docbook/en/modules/ch08-getting-support.xml =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch08-getting-support.xml 2009-06-02 17:15:45 UTC (rev 89684) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch08-getting-support.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -1,16 +0,0 @@ -<!-- - $Id$ ---> -<chapter xml:id="ChapGettingSupport"> - - <title>Getting Support</title> - - <para>We offer free support through the <ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... User Forum</ulink>.</para> - - <para>Please note, that posts to this forum will be dealt with at the community's leisure. - If your business is such that you need to rely on qualified answers within a known time frame, - this forum might not be your preferred support channel.</para> - - <para>For professional support please go to <ulink url="http://www.jboss.com/services">JBoss Support Services</ulink>.</para> - -</chapter> Copied: projects/jboss-osgi/trunk/docbook/en/modules/ch08-references.xml (from rev 89672, projects/jboss-osgi/trunk/docbook/en/modules/ch07-references.xml) =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch08-references.xml (rev 0) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch08-references.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -0,0 +1,27 @@ +<!-- + $Id$ +--> +<chapter xml:id="ChapReferences"> + + <title>References</title> + + <para><emphasis role="bold">Resources</emphasis></para> + + <itemizedlist> + <listitem><ulink url="http://www.jboss.org/community/wiki/JBossOSGi">JBossOSGi Wiki</ulink></listitem> + <listitem><ulink url="http://jbossosgi.blogspot.com">JBossOSGi Diary (Blog)</ulink></listitem> + <listitem><ulink url="https://jira.jboss.org/jira/browse/JBOSGI">Issue Tracking</ulink></listitem> + <listitem><ulink url="http://jbmuc.dyndns.org:8280/hudson">Hudson QA</ulink></listitem> + <listitem><ulink url="https://anonsvn.jboss.org/repos/jbossas/projects/jboss-osgi&quo... + <listitem><ulink url="http://fisheye.jboss.com/browse/JBossOSGi">Fisheye</... + <listitem><ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... Forum</ulink></listitem> + <listitem><ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... Forum</ulink></listitem> + </itemizedlist> + + <para><emphasis role="bold">Authors</emphasis></para> + + <itemizedlist> + <listitem><ulink url="email:thomas.diesler@jboss.com">Thomas Diesler</ulink></listitem> + </itemizedlist> + +</chapter> Copied: projects/jboss-osgi/trunk/docbook/en/modules/ch09-getting-support.xml (from rev 89672, projects/jboss-osgi/trunk/docbook/en/modules/ch08-getting-support.xml) =================================================================== --- projects/jboss-osgi/trunk/docbook/en/modules/ch09-getting-support.xml (rev 0) +++ projects/jboss-osgi/trunk/docbook/en/modules/ch09-getting-support.xml 2009-06-02 17:28:29 UTC (rev 89685) @@ -0,0 +1,16 @@ +<!-- + $Id$ +--> +<chapter xml:id="ChapGettingSupport"> + + <title>Getting Support</title> + + <para>We offer free support through the <ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... User Forum</ulink>.</para> + + <para>Please note, that posts to this forum will be dealt with at the community's leisure. + If your business is such that you need to rely on qualified answers within a known time frame, + this forum might not be your preferred support channel.</para> + + <para>For professional support please go to <ulink url="http://www.jboss.com/services">JBoss Support Services</ulink>.</para> + +</chapter>