blob: 3042e53a3fb6aec7685d4b638e11066be30ea7a5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
<?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><title>
Qpid Java Broker Management CLI
</title>
<section role="h2" id="QpidJavaBrokerManagementCLI-HowtobuildApacheQpidCLI"><title>
How to
build Apache Qpid CLI
</title>
<section role="h3" id="QpidJavaBrokerManagementCLI-BuildInstructionsGeneral"><title>
Build
Instructions - General
</title>
<para>
At the very beginning please build Apache Qpid by refering this
installation guide from here <xref linkend="qpid_qpid-java-build-how-to"/>.
</para><para>
After successfully build Apache Qpid you'll be able to start
Apache Qpid Java broker,then only you are in a position to use
Qpid CLI.
</para>
<!--h3--></section>
<section role="h3" id="QpidJavaBrokerManagementCLI-CheckouttheSource"><title>
Check
out the Source
</title>
<para>
First check out the source from subversion repository. Please
visit the following link for more information about different
versions of Qpid CLI.
</para><para>
<xref linkend="qpid_list"/>
</para>
<!--h3--></section>
<section role="h3" id="QpidJavaBrokerManagementCLI-Prerequisites"><title>
Prerequisites
</title>
<para>
For the broker code you need JDK 1.5.0_15 or later. You should
set JAVA_HOME and include the bin directory in your PATH.
</para><para>
Check it's ok by executing java -v !
</para>
<!--h3--></section>
<section role="h3" id="QpidJavaBrokerManagementCLI-BuildingApacheQpidCLI"><title>
Building
Apache Qpid CLI
</title>
<para>
This project is currently having only an ant build system.Please
install ant build system before trying to install Qpid CLI.
</para>
<!--h3--></section>
<section role="h3" id="QpidJavaBrokerManagementCLI-Compiling"><title>
Compiling
</title>
<para>
To compile the source please run following command
</para>
<programlisting>
ant compile
</programlisting>
<para>
To compile the test source run the following command
</para>
<programlisting>
ant compile-tests
</programlisting>
<!--h3--></section>
<section role="h3" id="QpidJavaBrokerManagementCLI-RunningCLI"><title>
Running CLI
</title>
<para>
After successful compilation set QPID_CLI environment variable to
the main source directory.(set the environment variable to the
directory where ant build script stored in the SVN
checkout).Please check whether the Qpid Java broker is up an
running in the appropriate location and run the following command
to start the Qpid CLI by running the qpid-cli script in the bin
directory.
</para><para>
$QPID_CLI/bin/qpid-cli -h <hostname of the broker> -p
<broker running port>
For more details please have a look in to README file which ships
with source package of Qpid CLI.
</para>
<!--h3--></section>
<section role="h3" id="QpidJavaBrokerManagementCLI-Otheranttargets"><title>
Other
ant targets
</title>
<para>For now we are supporting those ant targets.</para>
<variablelist>
<varlistentry>
<term>ant clean</term>
<listitem><para>Clean the complete build including CLI build and test build.</para></listitem>
</varlistentry>
<varlistentry>
<term>ant jar</term>
<listitem><para>Create the jar file for the project without test cases.</para></listitem>
</varlistentry>
<varlistentry>
<term>ant init</term>
<listitem><para>Create the directory structure for build.</para></listitem>
</varlistentry>
<varlistentry>
<term>ant compile-tests </term>
<listitem><para>This compiles all the test source.</para></listitem>
</varlistentry>
<varlistentry>
<term>ant test </term>
<listitem><para>Run all the test cases.</para></listitem>
</varlistentry>
</variablelist>
<!--h3--></section>
<!--h2--></section>
</section>
|
