You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by ra...@apache.org on 2008/11/21 04:44:21 UTC

svn commit: r719462 - in /incubator/qpid/trunk/qpid/java/management/client: bin/ doc/ doc/man/ etc/ src/main/java/org/apache/qpid/management/ src/main/java/org/apache/qpid/management/configuration/

Author: rajith
Date: Thu Nov 20 19:44:20 2008
New Revision: 719462

URL: http://svn.apache.org/viewvc?rev=719462&view=rev
Log:
Added a script to startup QMan in standalone mode.
Added a man page, and a log4j file.
Modified the Configurator.java to throw an exception if it is unable to load the config file.

Added:
    incubator/qpid/trunk/qpid/java/management/client/bin/
    incubator/qpid/trunk/qpid/java/management/client/bin/qman   (with props)
    incubator/qpid/trunk/qpid/java/management/client/doc/
    incubator/qpid/trunk/qpid/java/management/client/doc/man/
    incubator/qpid/trunk/qpid/java/management/client/doc/man/qman
    incubator/qpid/trunk/qpid/java/management/client/etc/qman.log4j
Modified:
    incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/Messages.java
    incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/ConfigurationException.java
    incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/Configurator.java

Added: incubator/qpid/trunk/qpid/java/management/client/bin/qman
URL: http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid/java/management/client/bin/qman?rev=719462&view=auto
==============================================================================
--- incubator/qpid/trunk/qpid/java/management/client/bin/qman (added)
+++ incubator/qpid/trunk/qpid/java/management/client/bin/qman Thu Nov 20 19:44:20 2008
@@ -0,0 +1,13 @@
+#!/bin/sh
+
+if [ "$QPID_LIB_PATH" = "" ] ; then
+    QPID_LIB_PATH=/usr/share/java
+fi
+
+if [ "$QPID_CONFIG_PATH" = "" ] ; then
+    QPID_CONFIG_PATH=/etc
+fi
+
+QMAN_CLASSPATH=`find $QPID_LIB_PATH | tr '\n' ":"`
+
+java -cp $QMAN_CLASSPATH -Dcom.sun.management.jmxremote -Dlog4j.configuration=qman.log4j -Dqman-config=$QPID_CONFIG_PATH/qman-config.xml org.apache.qpid.management.domain.services.QMan

Propchange: incubator/qpid/trunk/qpid/java/management/client/bin/qman
------------------------------------------------------------------------------
    svn:executable = *

Added: incubator/qpid/trunk/qpid/java/management/client/doc/man/qman
URL: http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid/java/management/client/doc/man/qman?rev=719462&view=auto
==============================================================================
--- incubator/qpid/trunk/qpid/java/management/client/doc/man/qman (added)
+++ incubator/qpid/trunk/qpid/java/management/client/doc/man/qman Thu Nov 20 19:44:20 2008
@@ -0,0 +1,17 @@
+.TH qman
+.SH NAME
+qman is a Management bridge that exposes one (or several) Qpid broker domain model as MBeans that are accessible through the Java Management Extensions (JMX). Once you run qman you need to start a JMX Console such as JConsole to browse the MBeans exposed by Q-Man.
+.SH SYNOPSIS
+qman
+.SH DESCRIPTION
+For more information on customizing QMan for your own environment please read http://cwiki.apache.org/confluence/display/qpid/Qman+Tool
+.SH Configuration
+.SS Classpath
+By default qman jars will be loaded from /usr/share/java. If you want to load from an alternative location you could specify it using QPID_LIB_PATH var.
+.SS Config file
+qman can be configured to connect to one or more brokers at startup by adding brokers in 
+.I /etc/qman-config.xml
+If you want to load qman with qma-config.xml from a different location, you can specify it using QPID_CONFIG_PATH var.
+.SS log4j configuration
+qman expects qman.log4j file to be in the classpath. By default it will be put in 
+.I /usr/share/java

Added: incubator/qpid/trunk/qpid/java/management/client/etc/qman.log4j
URL: http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid/java/management/client/etc/qman.log4j?rev=719462&view=auto
==============================================================================
--- incubator/qpid/trunk/qpid/java/management/client/etc/qman.log4j (added)
+++ incubator/qpid/trunk/qpid/java/management/client/etc/qman.log4j Thu Nov 20 19:44:20 2008
@@ -0,0 +1,30 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+log4j.rootLogger=${root.logging.level}
+
+log4j.logger.org.apache.qpid=ERROR, console
+log4j.additivity.org.apache.qpid=false
+
+log4j.logger.org.apache.qpid.management.client=DEBUG, console
+
+log4j.appender.console=org.apache.log4j.ConsoleAppender
+log4j.appender.console.Threshold=all
+log4j.appender.console.layout=org.apache.log4j.PatternLayout
+log4j.appender.console.layout.ConversionPattern=%t %d %p [%c{4}] %m%n
+

Modified: incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/Messages.java
URL: http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/Messages.java?rev=719462&r1=719461&r2=719462&view=diff
==============================================================================
--- incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/Messages.java (original)
+++ incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/Messages.java Thu Nov 20 19:44:20 2008
@@ -70,7 +70,7 @@
     String QMAN_300001_MESSAGE_DISCARDED = "<QMAN-300001> : No handler has been configured for processing messages with \"%s\" as opcode. Message will be discarded.";
 	String QMAN_300002_UNKNOWN_SEQUENCE_NUMBER = "<QMAN-300002> : Unable to deal with incoming message because it contains a unknown sequence number (%s).";
     String QMAN_300003_BROKER_ALREADY_CONNECTED = "<QMAN-300003> : Unable to enlist given broker connection data : QMan is already connected with broker %s";
-    String QMAN_300004_UNVALID_CONFIGURATION_FILE = "<QMAN-300004> : The given configuration file (%s) is not valid (it doesn't exist or cannot be read)";
+    String QMAN_300004_INVALID_CONFIGURATION_FILE = "<QMAN-300004> : The given configuration file (%s) is not valid (it doesn't exist or cannot be read)";
 	
 	// ERROR
 	String QMAN_100001_BAD_MAGIC_NUMBER_FAILURE = "<QMAN-100001> : Message processing failure : incoming message contains a bad magic number (%s) and therefore will be discaded.";

Modified: incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/ConfigurationException.java
URL: http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/ConfigurationException.java?rev=719462&r1=719461&r2=719462&view=diff
==============================================================================
--- incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/ConfigurationException.java (original)
+++ incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/ConfigurationException.java Thu Nov 20 19:44:20 2008
@@ -29,6 +29,11 @@
 {
     private static final long serialVersionUID = 8238481177714286259L;
 
+    public ConfigurationException(String msg)
+    {
+        super(msg);
+    }
+    
     /**
      * Builds a new ConfigurationException with the given cause.
      * 
@@ -38,4 +43,9 @@
     {
         super(exception);
     }
+    
+    public ConfigurationException(String msg,Exception exception)
+    {
+        super(msg,exception);
+    }
 }
\ No newline at end of file

Modified: incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/Configurator.java
URL: http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/Configurator.java?rev=719462&r1=719461&r2=719462&view=diff
==============================================================================
--- incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/Configurator.java (original)
+++ incubator/qpid/trunk/qpid/java/management/client/src/main/java/org/apache/qpid/management/configuration/Configurator.java Thu Nov 20 19:44:20 2008
@@ -139,7 +139,8 @@
 	                InputSource source = new InputSource(reader);
 	                parser.parse(source, this);        		
         		} else {
-        			LOGGER.warn(Messages.QMAN_300004_UNVALID_CONFIGURATION_FILE, initialConfigFileName);
+        			LOGGER.warn(Messages.QMAN_300004_INVALID_CONFIGURATION_FILE, initialConfigFileName);
+        			throw new ConfigurationException(String.format(Messages.QMAN_300004_INVALID_CONFIGURATION_FILE, initialConfigFileName));
         		}
         	}