felix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From santil...@apache.org
Subject svn commit: r450621 - /incubator/felix/trunk/org.apache.felix.jmood/QUICKSTART.txt
Date Wed, 27 Sep 2006 22:59:34 GMT
Author: santillan
Date: Wed Sep 27 15:59:34 2006
New Revision: 450621

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


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 @@
+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
+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.
+- 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
+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.

View raw message