summaryrefslogtreecommitdiff
path: root/doc/book/src/java-broker/Qpid-Troubleshooting-Guide.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/book/src/java-broker/Qpid-Troubleshooting-Guide.xml')
-rw-r--r--doc/book/src/java-broker/Qpid-Troubleshooting-Guide.xml156
1 files changed, 0 insertions, 156 deletions
diff --git a/doc/book/src/java-broker/Qpid-Troubleshooting-Guide.xml b/doc/book/src/java-broker/Qpid-Troubleshooting-Guide.xml
deleted file mode 100644
index 0920f18798..0000000000
--- a/doc/book/src/java-broker/Qpid-Troubleshooting-Guide.xml
+++ /dev/null
@@ -1,156 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-
- 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.
-
--->
-
-<section id="Qpid-Troubleshooting-Guide">
-
- <title>
- Qpid Troubleshooting Guide
- </title>
-
- <section role="h2" id="QpidTroubleshootingGuide-I-27mgettingajava.lang.UnsupportedClassVersionErrorwhenItrytostartthebroker.Whatdoesthismean-3F"><title>
- I'm getting a java.lang.UnsupportedClassVersionError when I
- try to start the broker. What does this mean ?
- </title>
-
- <para>
- The QPID broker requires JDK 1.5 or later. If you're seeing this
- exception you don't have that version in your path. Set JAVA_HOME
- to the correct version and ensure the bin directory is on your
- path.
- </para><para>
- java.lang.UnsupportedClassVersionError:
- org/apache/qpid/server/Main (Unsupported major.minor version
- 49.0)
- at
- java.lang.ClassLoader.defineClass(Ljava.lang.String;[BIILjava.security.ProtectionDomain;)Ljava.lang.Class;(Unknown
- Source)
- at
- java.security.SecureClassLoader.defineClass(Ljava.lang.String;[BIILjava.security.CodeSource;)Ljava.lang.Class;(SecureClassLoader.java:123)
-
- at
- java.net.URLClassLoader.defineClass(Ljava.lang.String;Lsun.misc.Resource;)Ljava.lang.Class;(URLClassLoader.java:251)
-
- at
- java.net.URLClassLoader.access$100(Ljava.net.URLClassLoader;Ljava.lang.String;Lsun.misc.Resource;)Ljava.lang.Class;(URLClassLoader.java:55)
-
- at java.net.URLClassLoader$1.run()Ljava.lang.Object;
- (URLClassLoader.java:194)
- at
- jrockit.vm.AccessController.do_privileged_exc(Ljava.security.PrivilegedExceptionAction;Ljava.security.AccessControlContext;I)Ljava.lang.Object;(Unknown
- Source)
- at
- jrockit.vm.AccessController.doPrivileged(Ljava.security.PrivilegedExceptionAction;Ljava.security.AccessControlContext;)Ljava.lang.Object;(Unknown
- Source)
- at
- java.net.URLClassLoader.findClass(Ljava.lang.String;)Ljava.lang.Class;(URLClassLoader.java:187)
-
- at
- java.lang.ClassLoader.loadClass(Ljava.lang.String;Z)Ljava.lang.Class;
- (Unknown Source)
- at
- sun.misc.Launcher$AppClassLoader.loadClass(Ljava.lang.String;Z)Ljava.lang.Class;(Launcher.java:274)
-
- at
- java.lang.ClassLoader.loadClass(Ljava.lang.String;)Ljava.lang.Class;
-
- (Unknown Source)
- at
- java.lang.ClassLoader.loadClassFromNative(II)Ljava.lang.Class;
-
- (Unknown Source)
- </para>
-
-<!--h2--></section>
-
- <section role="h2" id="QpidTroubleshootingGuide-I-27mhavingaproblembindingtotherequiredhost-3Aportatbrokerstartup-3F"><title>
- I'm having a problem binding to the required host:port at
- broker startup ?
- </title>
- <para>
- This error probably indicates that another process is using the
- port you the broker is trying to listen on. If you haven't
- amended the default configuration this will be 5672. To check
- what process is using the port you can use 'netstat -an |grep
- 5672'.
- </para><para>
- To change the port your broker uses, either edit the config.xml
- you are using. You can specify an alternative config.xml from the
- one provided in /etc by using the -c flag i.e. qpid-server -c
- &lt;my config file path&gt;.
- </para><para>
- You can also amend the port more simply using the -p option to
- qpid-server i.e. qpid-server -p &lt;my port number'
- </para>
-<!--h2--></section>
-
- <section role="h2" id="QpidTroubleshootingGuide-I-27mhavingproblemswithmyclasspath.HowcanIensurethatmyclasspathisok-3F"><title>
- I'm having problems with my classpath. How can I ensure that
- my classpath is ok ?
- </title>
- <para>
- When you are running the broker the classpath is taken care of
- for you, via the manifest entries in the launch jars that the
- qpid-server configuration file adds to the classpath.
- </para><para>
- However, if you are running your own client code and experiencing
- classspath errors you need to ensure that the client-launch.jar
- from the installed Qpid lib directory is on your classpath. The
- manifest for this jar includes the common-launch.jar, and thus
- all the code you need to run a client application.
- </para>
- </section>
-
- <section role="h2" id="QpidTroubleshootingGuide-Ican-27tgetthebrokertostart.HowcanIdiagnosetheproblem-3F"><title>
- I can't get the broker to start. How can I diagnose the
- problem ?
- </title>
- <para>
- Firstly have a look at the broker log file - either on stdout or
- in $QPID_WORK/log/qpid.log or in $HOME/log/qpid.log if you
- haven't set QPID_WORK.
- </para><para>
- You should see the problem logged in here via log4j and a stack
- trace. Have a look at the other entries on this page for common
- problems. If the log file includes a line like:
- </para><para>
- "2006-10-13 09:58:14,672 INFO [main] server.Main (Main.java:343)
- - Qpid.AMQP listening on non-SSL address 0.0.0.0/0.0.0.0:5672"
- </para><para>
- ... then you know the broker started up. If not, then it didn't.
- </para>
-<!--h2--></section>
-
- <section role="h2" id="QpidTroubleshootingGuide-WhenItrytosendmessagestoaqueueI-27mgettingaerrorasthequeuedoesnotexist.WhatcanIdo-3F"><title>
- When I try to send messages to a queue I'm getting a error as
- the queue does not exist. What can I do ?
- </title>
- <para>
- In Qpid queues need a consumer before they really exist, unless
- you have used the virtualhosts.xml file to specify queues which
- should always be created at broker startup. If you don't want to
- use this config, then simply ensure that you consume first from
- queue before staring to publish to it. See the entry on our
- <xref linkend="qpid_Qpid-Java-FAQ"/> for more details of using the virtualhosts.xml route.
- </para>
-<!--h2--></section>
-
-</section>