-
Notifications
You must be signed in to change notification settings - Fork 34
/
README
106 lines (73 loc) · 2.97 KB
/
README
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
Build Requirements
------------------
To build this Message Queue source bundle, you will need:
1. Maven 3.6.3 (http://maven.apache.org/download.html)
2. JDK 21 or newer (e.g. https://www.oracle.com/java/technologies/javase-downloads.html)
Message Queue Build Instructions
--------------------------------
1. Set up your settings.xml file in <user.home>/.m2/settings.xml so that
you can proxy to Maven Central at https://repo1.maven.org/maven2/
Build artifacts are downloaded from Maven Central.
If you are not behind a firewall, you will not need to set up a proxy.
<settings>
<!-- Example proxies setup. Use your proxy setting if you need to proxy to maven-central -->
<proxies>
<proxy>
<active>true</active>
<protocol>http</protocol>
<host>proxy-host</host>
<port>80</port>
</proxy>
</proxies>
</settings>
2. Unzip the source bundle and set JAVA_HOME
unzip mq5.1.1-source.zip
and set JAVA_HOME.
3. Build the source and distribution.
cd mq5.1.1-source/
mvn clean install
4. If you get a java OutOfMemory Error while running the mvn command,
set MAVEN_OPTS to "-Xmx512m -Xms256m -XX:MaxPermSize=512m".
Message Queue Build Output
--------------------------
1. After the build, a runnable build image of Message Queue is at:
$TOP/mq/dist/mq
2. A zip bundle of that image is at:
$TOP/mq/dist/bundles/mq<version>*.zip
. A tar bundle of that image is at:
$TOP/mq/dist/bundles/mq<version>*.tar
Running Message Queue
--------------------
1. From this point, MQ_HOME is considered to be $TOP/mq/dist/mq
2. To run the Message Queue broker:
cd MQ_HOME/bin
./imqbrokerd -tty [-javahome "<javahome>"] (unix)
.\imqbrokerd -tty [-javahome "<javahome>"] (windows)
3. To run a Message Queue client:
(In the mq/examples directory, run the HelloWorldMessage sample program
to verify the build was successful.)
cd MQ_HOME/mq/examples/helloworld/helloworldmessage
set CLASSPATH to include
$MQ_HOME/lib/jms.jar
$MQ_HOME/lib/imq.jar
$MQ_HOME/examples/helloworld/helloworldmessage
java HelloWorldMessage
Sending Message: Hello World
Read Message: Hello World
Troubleshooting the Build
-------------------------
1. If executing mvn returns "java.lang.OutOfMemoryError: Java heap space",
you should set MAVEN_OPTS to "-Xmx512m -Xms256m -XX:MaxPermSize=512m".
2. If you build on Windows, your distribution will only run on
Windows. If you build on Unix, your distribution will only run on
Unix or in a shell emulator on Windows.
Documentation
-------------
The latest documentation for Message Queue can be found at
https://eclipse-ee4j.github.io/openmq/
Appendix: Message Queue Build Instructions for C-API Client Library
-------------------------------------------------------------------
1. Fill in necessary info for your platform in
$TOP/src/buildant/default.properties
2. cd $TOP/main/packager-opensource
ant buildcclient