Red Hat Bugzilla – Bug 490963
Java Tutorial and example README file are wrong
Last modified: 2013-08-05 20:53:43 EDT
Description of problem:
The Tutorial never mentions setting QPID_HOME and QPID_SAMPLE and the example java directory's README.txt is out of date and not detailed enough.
The Steps to get the Java code running are:
1. Copy the examples java directory to somewhere you have write permissions (as per documentation).
2. Make sure to chmod the java directory for 'w'.
3. Set the following:
QPID_SAMPLE=<exmaple java directory> e.g. /home/whenry/java
4. Then run the examples
$ ./runSample.sh org.apache.qpid.example.jmsexample.direct.Producer
Version-Release number of selected component (if applicable):
Steps to Reproduce:
The README is way out of date, and should be replaced with something like the README.txt that we have for the Python or C++ examples. I'll write one and replace the current Java examples README.
The tutorial has a section called "running the examples" for each Java example, which shows the values of these veriables:
$ ./runSample.sh org.apache.qpid.example.jmsexample.direct.Consumer
Using QPID_HOME: /usr/share/java/
Using QPID_SAMPLE: /usr/share/doc/rhm-0.3
Consumer: Setting an ExceptionListener on the connection as sample uses a MessageConsumer
Consumer: Creating a non-transacted, auto-acknowledged session
Consumer: Creating a MessageConsumer
Consumer: Starting connection so MessageConsumer can receive messages
I'll fix this to state explicitly that you have to set them before running the script.
Modified tutorial, also modified README.txt in the Qpid project.
Changes will be visible in 1.3, there is no 1.2 tutorial.
This is not valid anymore. as examples are changed, readme dissapeared, Tutorial is not Tutorial anymore and does not mention that script at all...