Mailing-List: contact felix-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: felix-dev@incubator.apache.org
Received-SPF: error (idunn.apache.osuosl.org: domain apache.org from
 140.211.166.113 cause and error)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r450621 -
 /incubator/felix/trunk/org.apache.felix.jmood/QUICKSTART.txt
Date: Wed, 27 Sep 2006 22:59:34 -0000
To: felix-commits@incubator.apache.org
From: santillan@apache.org
Message-Id: <20060927225934.E12FB1A981A@eris.apache.org>

Author: santillan
Date: Wed Sep 27 15:59:34 2006
New Revision: 450621

URL: http://svn.apache.org/viewvc?view=rev&rev=450621
Log:
Small quickstart guide

Added:
    incubator/felix/trunk/org.apache.felix.jmood/QUICKSTART.txt

Added: incubator/felix/trunk/org.apache.felix.jmood/QUICKSTART.txt
URL: http://svn.apache.org/viewvc/incubator/felix/trunk/org.apache.felix.jmood/QUICKSTART.txt?view=auto&rev=450621
==============================================================================
--- incubator/felix/trunk/org.apache.felix.jmood/QUICKSTART.txt (added)
+++ incubator/felix/trunk/org.apache.felix.jmood/QUICKSTART.txt Wed Sep 27 15:59:34 2006
@@ -0,0 +1,31 @@
+WITH ECLIPSE
+If you are using eclipse: 
+1. Init a workspace to be maven-compatible (see maven site)
+2. Run maven eclipse:eclipse to create the .project file
+FOR ALL
+3. Run maven install to add jmood to your M2_REPO 
+or just mvn package to generate the bundle in target/
+4. To test it you can just run the FelixLauncher class under
+src/test/java. This creates a temporary './cache' directory for Felix.
+Note that no shell is available so you can only interact with felix
+remotely through JMood
+5. Connect to JMood using your favorite general purpose JMX console 
+(for example, jconsole, bundled with java 5) or help us building one ;-)
+The url is printed in the console but it should be:
+-> service:jmx:rmi:///jndi/rmi://${host}:1199/server
+where ${host}=your_hostname or 'localhost' if no non-loopback interface is found.
+
+ISSUES
+- If you are using java1.4 the framework won't find the javax.management and
+javax.management.remote packages so it will not resolve JMood. You can choose between Sun's reference 
+or mx4j (http://mx4j.sourceforge.net) implementations. Just bundle them and export those
+two packages and everything should work fine. 
+- If running on Java 5+, JMood uses the java.lang.management PlatformMBeanServer
+else (java.version<1.5.0) it creates an independent MBeanServer and 
+JVM MBeans are not available any more. 
+- MBeans for some compendium services are created if those services are available
+but no static dependency is needed. 
+- JMood creates an RMIRegistry on port 1199, this value is hard-coded for the moment, so be sure it is free
+- JMood automatically creates a policy manager with a dummy policy if none found. Note that it has not been 
+very much tested with *real* security, and that many management operations need AdminPermission to work fine.
+