[jboss-cvs] JBossAS SVN: r86265 - in projects/jboss-osgi/trunk/build/docbook/en: modules and 1 other directory.

[jboss-cvs-commits at lists.jboss.org]

Author: thomas.diesler at jboss.com
Date: 2009-03-24 12:26:28 -0400 (Tue, 24 Mar 2009)
New Revision: 86265

Added:
   projects/jboss-osgi/trunk/build/docbook/en/images/webconsole.jpg
Modified:
   projects/jboss-osgi/trunk/build/docbook/en/modules/frameworkintegration.xml
   projects/jboss-osgi/trunk/build/docbook/en/modules/gettingstarted.xml
Log:
Userguide - Framework integration

Added: projects/jboss-osgi/trunk/build/docbook/en/images/webconsole.jpg
===================================================================
(Binary files differ)


Property changes on: projects/jboss-osgi/trunk/build/docbook/en/images/webconsole.jpg
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Modified: projects/jboss-osgi/trunk/build/docbook/en/modules/frameworkintegration.xml
===================================================================
--- projects/jboss-osgi/trunk/build/docbook/en/modules/frameworkintegration.xml	2009-03-24 16:21:29 UTC (rev 86264)
+++ projects/jboss-osgi/trunk/build/docbook/en/modules/frameworkintegration.xml	2009-03-24 16:26:28 UTC (rev 86265)
@@ -2,19 +2,91 @@
 
   <title>Framework Integration</title>
   
-  <section id="Sec_Integration_Felix">  
+  <sect1>  
     <title>Apache Felix Integration</title>
-    <para>TODO</para>
-  </section>
+    
+    <para>JBossOSGi provides integration for the <ulink url="http://felix.apache.org">Apache Felix</ulink> OSGi Framework and some
+    of its core services</para>
+
+    <itemizedlist>
+      <listitem><ulink url="http://felix.apache.org/site/subprojects.html">Log Service</ulink> - General purpose message logger</listitem>
+      <listitem><ulink url="http://felix.apache.org/site/apache-felix-http-service.html">HTTP Service</ulink> - Http access to servlets and resources</listitem>
+      <listitem><ulink url="http://felix.apache.org/site/apache-felix-configuration-admin-service.html">Config Admin Service</ulink> - Management of configuration data for configurable components</listitem>
+    </itemizedlist>
+
+    <para>The <ulink url="http://felix.apache.org">Apache Felix</ulink> integration can be configured through a JBoss Microcontainer beans 
+    configuration</para>
+    
+    <programlisting><![CDATA[
+    cat server/default/deployers/osgi.deployer/META-INF/osgi-deployers-jboss-beans.xml 
+    
+    <deployment xmlns="urn:jboss:bean-deployer:2.0">
+    
+      <!-- The OSGiFramework -->
+      <bean name="jboss.osgi:service=Framework" class="org.jboss.osgi.felix.framework.FelixIntegration">
+        <property name="felixProperties">
+           ...
+        </property>
+        <property name="autoStart">
+         <list elementClass="java.net.URI">
+          ...
+         </list>
+        </property>
+      </bean>
+      ...
+    </deployment>
+    ]]></programlisting>
+
+    <table>
+      <tr><th>Key</th><th>Value</th><th>Description</th></tr>
+      <tr valign="top">
+        <td>org.osgi.framework.storage</td>
+        <td>.../osgi-store</td>
+        <td>OSGi Framework storage area</td>
+      </tr>
+      <tr valign="top">
+        <td>org.osgi.framework.storage.clean</td>
+        <td>onFirstInit</td>
+        <td>Clean the storage area on first init</td>
+      </tr>
+      <tr valign="top">
+        <td>org.osgi.service.http.port</td>
+        <td>8090</td>
+        <td>The default Http Service port</td>
+      </tr>
+      <tr valign="top">
+        <td>felix.cm.dir</td>
+        <td>.../osgi-configadmin</td>
+        <td>Config Admin Service storage area</td>
+      </tr>
+      <tr valign="top">
+        <td>org.osgi.framework.system.packages</td>
+        <td>javax.management, javax.xml...</td>
+        <td>Packages provided by the OSGi System ClassLoader</td>
+      </tr>
+      <tr valign="top">
+        <td>org.jboss.osgi.deferred.start</td>
+        <td>true</td>
+        <td>Bundles can be deployed in any order</td>
+      </tr>
+    </table>
+
+  </sect1>
   
-  <section id="Sec_Integration_Equinox">  
+  <sect1>  
     <title>Equinox Integration</title>
-    <para>TODO</para>
-  </section>
+    
+    <note>
+      <para>TODO: Provide and document Equinox Integration</para>
+    </note>
+  </sect1>
   
-  <section id="Sec_Integration_Knopflerfish">  
+  <sect1>  
     <title>Knopflerfish Integration</title>
-    <para>TODO</para>
-  </section>
+    
+    <note>
+      <para>TODO: Provide and document Knopflerfish Integration</para>
+    </note>
+  </sect1>
   
 </chapter>

Modified: projects/jboss-osgi/trunk/build/docbook/en/modules/gettingstarted.xml
===================================================================
--- projects/jboss-osgi/trunk/build/docbook/en/modules/gettingstarted.xml	2009-03-24 16:21:29 UTC (rev 86264)
+++ projects/jboss-osgi/trunk/build/docbook/en/modules/gettingstarted.xml	2009-03-24 16:26:28 UTC (rev 86265)
@@ -158,9 +158,19 @@
     <sect2>
       <title>Managing installed Bundles</title>
       
-      <para>JBossOSGi comes with a simple Web Console 
-      integrates the <ulink url="http://felix.apache.org/site/apache-felix-web-console.html">Apache Felix Web Console</ulink>
-      project.</para>
+      <para>JBossOSGi comes with a simple Web Console, which is currently based on the 
+      <ulink url="http://felix.apache.org/site/apache-felix-web-console.html">Apache Felix Web Console</ulink> project. 
+      By default the JBossOSGi Web Console is available at <ulink url="http://localhost:8090/jboss-osgi">http://localhost:8090/jboss-osgi</ulink></para> 
+
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/webconsole.jpg" contentwidth="120%"/> 
+        </imageobject>
+      </mediaobject>
+    
+      <note>
+        <para>TODO: Cleanup and document console provided functionality</para>
+      </note>
     </sect2>
   </sect1>