ACTIVEMQ6-49 removing chinese quickstart doc
https://issues.apache.org/jira/browse/ACTIVEMQ6-49 Some left over from the chinese docs
This commit is contained in:
parent
4e8edab4f6
commit
cb7774cfea
|
@ -1,67 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
|
|
||||||
<chapter id="about">
|
|
||||||
<title>关于ActiveMQ</title>
|
|
||||||
<para>什么是ActiveMQ?</para>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>ActiveMQ是一个开源项目。它的目标是一个多协议、可嵌入、高性能、可集群的异步的消息系统。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>有关ActiveMQ是什么及不是什么的更多的问题,请访问
|
|
||||||
<ulink url="http://www.jboss.org/community/wiki/ActiveMQGeneralFAQs">FAQs wiki
|
|
||||||
页</ulink>。</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
<para>为什么要使用ActiveMQ? 以下给出了几个理由:</para>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>ActiveMQ是100%的开源软件。 ActiveMQ 采用 Apache v 2.0开源协议,对用户的限制最小。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>ActiveMQ的设计强调可用性。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>采用Java语言编写。可以在任何Java 6+ 的平台上运行。这几乎包括了从Windows到IBM mainframes的每个平台。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>性能出众。不但对非持久化消息的处理性能达到了非常高的性能。独特高效的日志(journal)使持久消息处理接近非持久消息的性能。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>功能全面。不仅拥有其它成熟消息产品所具有的全部功能,而且还有很多独特的功能。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>ActiveMQ的设计遵从了简约的原则。对第三方软件的依赖极少。根据不同的需要,
|
|
||||||
ActiveMQ可以单独运行,也可以运行于JEE应用服务器中。它还可以嵌入到你自己的应用程序中。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>完美的可获得性。ActiveMQ提供自动客户端失效备援(automatic client failover)功能,能保证在服务器故障时没有消息丢失或消息重复。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>超级灵活的集群方案。可以控制集群进行消息负载均衡的方式。分布在不同地理位置的各个集群间可以通过非可靠的网络连接形成一个全球网络。
|
|
||||||
还可以非常灵活地配置消息路由。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>请访问 <ulink
|
|
||||||
url="http://www.jboss.org/community/wiki/ActiveMQFeatures">wiki</ulink>来全面了解ActiveMQ的所有功能介绍。</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
</chapter>
|
|
|
@ -1,70 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<chapter id="download">
|
|
||||||
<title>下载</title>
|
|
||||||
<para>ActiveMQ项目的官方地址是 <ulink url="http://activemq.org/"
|
|
||||||
>http://activemq.org/</ulink>。</para>
|
|
||||||
<section id="download.software">
|
|
||||||
<title>软件下载</title>
|
|
||||||
<para>ActiveMQ的下载地址是<ulink
|
|
||||||
url="http://activemq.org/downloads.html/"
|
|
||||||
>http://activemq.org/downloads.html</ulink></para>
|
|
||||||
</section>
|
|
||||||
<section id="download.git">
|
|
||||||
<title>项目信息</title>
|
|
||||||
<para>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>ActiveMQ的 <ulink
|
|
||||||
url="http://www.jboss.org/community/wiki/ActiveMQ">wiki</ulink></para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>如果在使用ActiveMQ中发生任何问题,可以去我们的 <ulink
|
|
||||||
url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=312">用户论坛
|
|
||||||
</ulink></para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>如果你有开发方面的问题与想法,请访问我们的 <ulink
|
|
||||||
url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=313"
|
|
||||||
>开发论坛</ulink></para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>请加入我们的<ulink url="irc://irc.freenode.net:6667/activemq"
|
|
||||||
>IRC频道</ulink>与我们的核心开发工程师交流。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>我们项目有自己的 <ulink url="http://activemq.blogspot.com/">博客</ulink></para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>还可以跟踪我们的<ulink url="http://twitter.com/activemq">twitter</ulink></para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>ActiveMQ的Git代码库地址 <ulink
|
|
||||||
url="https://github.com/activemq/activemq"
|
|
||||||
>https://github.com/activemq/activemq</ulink></para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>每次发布的版本标签都在<ulink
|
|
||||||
url="https://github.com/activemq/activemq/tags"
|
|
||||||
>https://github.com/activemq/activemq/tags</ulink>下能找到。</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
</para>
|
|
||||||
</section>
|
|
||||||
</chapter>
|
|
|
@ -1,216 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<chapter id="examples">
|
|
||||||
<title>运行ActiveMQ例子</title>
|
|
||||||
<para>在ActiveMQ的<literal>examples</literal>目录下有两组例子,它们是:</para>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>JMS例子 - 这些例子展示的是使用JMS发送与接收消息的功能。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>Java EE 例子 - 这些例子展示的是与应用服务器的集成,例如MDB,EJB,Servlet等。</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
<section id="examples.jms">
|
|
||||||
<title>JMS例子</title>
|
|
||||||
<para>所有JMS都有统一的格式。每个例子都有自己的目录,它的内容包括:</para>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>build.xml</literal></para>
|
|
||||||
<para>ant的build文件,用来运行例子。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>src</literal> 目录</para>
|
|
||||||
<para>例子的代码。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>server0</literal>配置目录</para>
|
|
||||||
<para>它包含了运行服务器所需要的配置文件。有的集群的例子可能有多个这样的目录,如<literal>server0</literal>,
|
|
||||||
<literal>server1</literal>等。</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
<para>在运行每个例子时,都要先启动一个或多个单独的服务器。当例子运行完毕,再将它们停止。</para>
|
|
||||||
<para>做为演示我们这里运行queue例子。其它的例子可以参见用户手册。</para>
|
|
||||||
<para>首先打开一个命令行窗口(shell),进入到ActiveMQ的 <literal
|
|
||||||
>examples/jms/queue</literal>目录。</para>
|
|
||||||
<para>敲入命令<literal>./build.sh</literal> (或者在Windows上<literal>build.bat</literal>),你
|
|
||||||
将看到如下的输出:</para>
|
|
||||||
<programlisting>Buildfile: build.xml
|
|
||||||
|
|
||||||
run:
|
|
||||||
|
|
||||||
init:
|
|
||||||
|
|
||||||
compile:
|
|
||||||
[echo] src.example.dir=/home/andy/projects/activemq/trunk/examples/jms/queue/src
|
|
||||||
[javac] Compiling 5 source files to /home/andy/projects/activemq/trunk/examples/jms/queue
|
|
||||||
/build/classes
|
|
||||||
|
|
||||||
runExample:
|
|
||||||
[java] 10:41:04,149 INFO @main [JMSExample] activemq.example.runServer is true
|
|
||||||
[java] 10:41:04,149 INFO @main [JMSExample] starting server with config 'server0'
|
|
||||||
logServerOutput true
|
|
||||||
[java] 10:41:04,149 INFO @main [JMSExample] and vm args: -Xms512M,-Xmx512M,-XX:+U
|
|
||||||
seParallelGC,-XX:+AggressiveOpts,-XX:+UseFastAccessorMethods,-Djava.util.logging.config.
|
|
||||||
file=/home/andy/projects/activemq/trunk/examples/jms/common/../../../src/config/stand-alone/no
|
|
||||||
n-clustered/logging.properties
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:08,437 INFO @main [Journal
|
|
||||||
StorageManager] AIO journal selected
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:08,437 WARN @main [Journal
|
|
||||||
StorageManager] AIO wasn't located on this platform, it will fall back to using pure Jav
|
|
||||||
a NIO. If your platform is Linux, install LibAIO to enable the AIO journal
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:08,437 WARN @main [Securit
|
|
||||||
yStoreImpl] It has been detected that the cluster admin password which is used to replic
|
|
||||||
ate management operation from one node to the other has not had its password changed fro
|
|
||||||
m the installation default. Please see the ActiveMQ user guide for instructions o
|
|
||||||
n how to do this.
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [ActiveMQCo
|
|
||||||
nnectionFactory] read only is false
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [ActiveMQCo
|
|
||||||
nnectionFactory] read only is false
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [ActiveMQCo
|
|
||||||
nnectionFactory] read only is false
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,991 WARN @main [JMSServ
|
|
||||||
erManagerImpl] Binding for java:/ConnectionFactory already exists
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,991 WARN @main [JMSServ
|
|
||||||
erManagerImpl] Binding for java:/XAConnectionFactory already exists
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:11,241 INFO @main [Messagi
|
|
||||||
ngServerImpl] ActiveMQ Server version 2.0.0.BETA5 (buzz-buzz, 107) started
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:11,241 INFO @main [ActiveMQBoot
|
|
||||||
strapServer] ActiveMQ server started
|
|
||||||
[java] org.apache.activemq.jms.example.SpawnedJMSServer out:STARTED::
|
|
||||||
[java] 10:41:11,276 INFO @main [JMSExample] using server0/client-jndi.properties f
|
|
||||||
or jndi
|
|
||||||
[java] Sent message: This is a text message
|
|
||||||
[java] Received message: This is a text message
|
|
||||||
[java]
|
|
||||||
[java] #####################
|
|
||||||
[java] ### SUCCESS! ###
|
|
||||||
[java] #####################
|
|
||||||
|
|
||||||
BUILD SUCCESSFUL
|
|
||||||
Total time: 13 seconds
|
|
||||||
</programlisting>
|
|
||||||
<para>恭喜!你已经成功地运行了你的第一个ActiveMQ例子。试着运行其它的例子。</para>
|
|
||||||
</section>
|
|
||||||
<section id="examples.messaging">
|
|
||||||
<title>Java EE例子</title>
|
|
||||||
<para>Java EE的例子需要首先运行一个JEE应用服务器。这些例子包括MDB,Servlet,EJB等等。你首先要安装JBoss应用服务
|
|
||||||
器。参见前面的章节进行安装。</para>
|
|
||||||
<para>这里我们将用MDB例子来说明。有关其它例子的详细信息参见用户手册。首先确认JBoss应用服务器已经启动。</para>
|
|
||||||
<para>如同其它Java EE例子一样,MDB需要部署到应用服务器。第一,将<literal>JBOSS_HOME</literal>环境变量
|
|
||||||
指向你的应用服务器安装目录。如在Linux下:</para>
|
|
||||||
<programlisting>export JBOSS_HOME=/home/jbossas5.1/build/output/jboss-5.1.0.GA</programlisting>
|
|
||||||
<para>然后就可以进行部署了。在<literal>examples/javaee/mdb</literal>目录下运行:</para>
|
|
||||||
<programlisting>./build.sh deploy</programlisting>
|
|
||||||
<para>它将创建一个“messaging"的AS配置,并用它来启动AS服务器。</para>
|
|
||||||
<para>在命令行窗口你会看到如下的输出:</para>
|
|
||||||
<programlisting>Buildfile: build.xml
|
|
||||||
|
|
||||||
validate-jboss:
|
|
||||||
|
|
||||||
deploy:
|
|
||||||
|
|
||||||
deploy-resources:
|
|
||||||
[copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
|
|
||||||
/server/default-with-activemq/deploy/activemq.sar
|
|
||||||
[copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
|
|
||||||
/server/default-with-activemq/deploy/activemq.sar
|
|
||||||
|
|
||||||
init:
|
|
||||||
|
|
||||||
compile:
|
|
||||||
|
|
||||||
jar:
|
|
||||||
[jar] Building jar: /home/andy/projects/activemq/trunk/examples/javaee/mdb/build/mdb-exa
|
|
||||||
mple.jar
|
|
||||||
|
|
||||||
ear:
|
|
||||||
[jar] Building jar: /home/andy/projects/activemq/trunk/examples/javaee/mdb/build/mdb-exa
|
|
||||||
mple.ear
|
|
||||||
|
|
||||||
deploy-ear:
|
|
||||||
[copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
|
|
||||||
|
|
||||||
.......
|
|
||||||
|
|
||||||
|
|
||||||
[exec] 16:01:04,607 INFO [JBossASKernel] Class:javax.jms.MessageListener
|
|
||||||
[exec] 16:01:04,607 INFO [JBossASKernel] Added bean(jboss.j2ee:ear=mdb-example.ear,
|
|
||||||
jar=mdb-example.jar,name=MessageMDBExample,service=EJB3) to KernelDeployment of:
|
|
||||||
mdb-example.jar
|
|
||||||
[exec] 16:01:04,702 INFO [EJBContainer] STARTED EJB: org.apache.activemq.javaee.example.server
|
|
||||||
.MDBExample ejbName: MessageMDBExample
|
|
||||||
[exec] 16:01:09,496 INFO [TomcatDeployment] deploy, ctxPath=/mdb-example
|
|
||||||
[exec] 16:01:09,812 WARNING [config] Unable to process deployment descriptor for cont
|
|
||||||
ext '/mdb-example'
|
|
||||||
[exec] 16:01:09,812 INFO [config] Initializing Mojarra (1.2_12-b01-FCS) for context
|
|
||||||
'/mdb-example'
|
|
||||||
[exec] 16:01:09,958 INFO [Http11Protocol] Starting Coyote HTTP/1.1 on http-127.0.0.1-
|
|
||||||
8080
|
|
||||||
[exec] 16:01:09,990 INFO [AjpProtocol] Starting Coyote AJP/1.3 on ajp-127.0.0.1-8009
|
|
||||||
[exec] 16:01:10,001 INFO [ServerImpl] JBoss (Microcontainer) [5.1.0.GA (build: SVNTag
|
|
||||||
=JBoss_5_1_0_GA date=200905151005)] Started in 6m:21s:797ms
|
|
||||||
|
|
||||||
</programlisting>
|
|
||||||
<para>现在我们可以运行例子了。在<literal>mdb</literal>目录下运行下列命令:</para>
|
|
||||||
<programlisting>./build.sh</programlisting>
|
|
||||||
<para>你将看到如下输出:</para>
|
|
||||||
<programlisting>Buildfile: build.xml
|
|
||||||
|
|
||||||
run:
|
|
||||||
|
|
||||||
init:
|
|
||||||
|
|
||||||
compile:
|
|
||||||
|
|
||||||
runExample:
|
|
||||||
[java] Sent message: This is a text message
|
|
||||||
|
|
||||||
BUILD SUCCESSFUL
|
|
||||||
Total time: 7 seconds</programlisting>
|
|
||||||
<para>在JBoss应用服务器端你还会看到如下的输出:</para>
|
|
||||||
<programlisting>16:27:54,703 INFO [STDOUT] message This is a text message received</programlisting>
|
|
||||||
<para>然后在<literal>mdb</literal>目录下运行下面的命令可以将这个例子卸载。</para>
|
|
||||||
<programlisting>./build.sh undeploy</programlisting>
|
|
||||||
<para>你将会看到如下的输出:</para>
|
|
||||||
<programlisting>Buildfile: build.xml
|
|
||||||
|
|
||||||
validate-jboss:
|
|
||||||
|
|
||||||
undeploy:
|
|
||||||
|
|
||||||
undeploy-misc:
|
|
||||||
[delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
|
|
||||||
/server/default-with-activemq/deploy/mdb-example.ear
|
|
||||||
[delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
|
|
||||||
/server/default-with-activemq/deploy/activemq.sar/activemq-queues.xml
|
|
||||||
[delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
|
|
||||||
/server/default-with-activemq/deploy/activemq.sar/activemq-jms.xml
|
|
||||||
|
|
||||||
BUILD SUCCESSFUL
|
|
||||||
Total time: 1 second
|
|
||||||
</programlisting>
|
|
||||||
<para>你还会在窗口输出中看到MDB的应用最終被删除了,如:</para>
|
|
||||||
<programlisting>16:36:45,277 INFO [EJBContainer] STOPPED EJB: org.jboss.javaee.example.server.MDBExample
|
|
||||||
ejbName: MessageMDBExample
|
|
||||||
</programlisting>
|
|
||||||
<para>恭喜!你已经成功地部署并运行了一个Java EE的例子。</para>
|
|
||||||
</section>
|
|
||||||
</chapter>
|
|
Binary file not shown.
Before Width: | Height: | Size: 23 KiB |
|
@ -1,158 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<chapter id="installation">
|
|
||||||
<title>安装</title>
|
|
||||||
<para>本章讲述如何安装ActiveMQ。</para>
|
|
||||||
<section id="installation.prerequisites">
|
|
||||||
<title>准备</title>
|
|
||||||
<note>
|
|
||||||
<para>ActiveMQ只能在Java 6或以上版本中运行</para>
|
|
||||||
</note>
|
|
||||||
<para>默认情况下ActiveMQ运行的内存是1GiB。如果你的电脑内存少于1GiB,或者你希望更多的内存给ActiveMQ,你
|
|
||||||
可以修改 <literal>bin/run.sh</literal>脚本文件。</para>
|
|
||||||
<para>ActiveMQ有自己的快速日志系统,它能够使用libaio(在Linux上它是默认的)或Java的NIO。
|
|
||||||
如果要使用libaio,你需要首先在你的Linux上安装它。</para>
|
|
||||||
<para>如果你不在使用Linux,则不需要考虑这个问题。</para>
|
|
||||||
<para>要安装libaio,你可以使用root用户完成以下步骤:</para>
|
|
||||||
<para>使用yum(例如在Fedora 或 Red Hat Enterprise Linux上):</para>
|
|
||||||
<programlisting>yum install libaio</programlisting>
|
|
||||||
<para>使用aptitude, (例如在Ubuntu或Debian系统上):</para>
|
|
||||||
<programlisting>apt-get install libaio</programlisting>
|
|
||||||
</section>
|
|
||||||
<section id="installation.standalone">
|
|
||||||
<title>单独的ActiveMQ服务器</title>
|
|
||||||
<para>将软件包下载后,将其解压到你选定的目录下。这里你就可以<link linkend="running.standalone">直接运行了</link>。
|
|
||||||
下面给出了它的目录结构: </para>
|
|
||||||
<programlisting>
|
|
||||||
|___ bin
|
|
||||||
|
|
|
||||||
|___ config
|
|
||||||
| |___ jboss-as-4
|
|
||||||
| |___ jboss-as-5
|
|
||||||
| |___ stand-alone
|
|
||||||
|
|
|
||||||
|___ docs
|
|
||||||
| |___ api
|
|
||||||
| |___ quickstart-guide
|
|
||||||
| |___ user-manual
|
|
||||||
|
|
|
||||||
|___ examples
|
|
||||||
| |___ core
|
|
||||||
| |___ javaee
|
|
||||||
| |___ jms
|
|
||||||
|
|
|
||||||
|___ lib
|
|
||||||
|
|
|
||||||
|___ licenses
|
|
||||||
|
|
|
||||||
|___ schemas
|
|
||||||
</programlisting>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>bin</literal> -- 运行ActiveMQ的二进制文件和脚本文件。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>config</literal> -- ActiveMQ的配置文件。它包括了单独模式或者运行在
|
|
||||||
JBoss AS 4 或 5中的配置。请参考配置索引来了解配置有详细信息。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>docs</literal> -- ActiveMQ的文档及Javadoc。 </para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>examples</literal> -- JMS and Java EE例子。有关详细信息请参见
|
|
||||||
'running examples'一章。 </para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>lib</literal> -- 运行ActiveMQ所需要的jar文件和库文件 </para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>licenses</literal> -- ActiveMQ的软件协议</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>schemas</literal> -- ActiveMQ配置文件的XML Schema</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
</section>
|
|
||||||
<section id="installation.jboss.as5">
|
|
||||||
<title>ActiveMQ运行于JBoss应用服务器5.x</title>
|
|
||||||
<para>ActiveMQ可以部署在<ulink url="http://www.jboss.org/jbossas/">JBoss AS
|
|
||||||
5</ulink>中。目前默认的应用服务器没有安装ActiveMQ(ActiveMQ将是JBoss 6的默认JMS提供者),因此
|
|
||||||
你需要为ActiveMQ创建新的AS 5的配置(profile)。</para>
|
|
||||||
<para>创建AS 5新配置的步骤:</para>
|
|
||||||
<orderedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>下载并安装JBoss AS 5</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>设置环境变量<literal>JBOSS_HOME</literal>指向JBoss AS 5的安装目录。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>运行ActiveMQ的<literal>config/jboss-as-5</literal>下的<literal>./build.sh</literal> (或
|
|
||||||
者如果在Windows下运行<literal>build.bat</literal>)。</para>
|
|
||||||
</listitem>
|
|
||||||
</orderedlist>
|
|
||||||
<para>这将会在<literal>$JBOSS_HOME/server</literal>创建两个服务器配置:</para>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>default-with-activemq</literal> -- 这个相当于AS 5的<literal
|
|
||||||
>default</literal>配置但其JMS提供者替换成为ActiveMQ。在这个配置中的ActiveMQ
|
|
||||||
是<emphasis>非集群</emphasis>的。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>all-with-activemq</literal> -- 这个相当于AS 5的<literal
|
|
||||||
>all</literal>配置但其JMS提供者替换成为ActiveMQ。这个配置中的ActiveMQ
|
|
||||||
是<emphasis>集群</emphasis>的。</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
<para>这时,你就可以启动上面其中任何一个配置的JBoss AS 5服务器了,例如:</para>
|
|
||||||
<programlisting>$JBOSS_HOME/bin/run.sh -c default-with-activemq</programlisting>
|
|
||||||
</section>
|
|
||||||
<section id="installation.jboss.as4">
|
|
||||||
<title>ActiveMQ运行于JBoss应用服务器4.x</title>
|
|
||||||
<para>为了在AS 4中安装ActiveMQ,你需要创建新的配置(profile)。</para>
|
|
||||||
<para>步骤如下:</para>
|
|
||||||
<orderedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>下载并安装JBoss AS 4</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>设置环境变量<literal>JBOSS_HOME</literal>指向JBoss AS 4的安装目录。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>运行ActiveMQ的<literal>config/jboss-as-4</literal>下的<literal>./build.sh</literal> (或
|
|
||||||
者如果在Windows下运行<literal>build.bat</literal>)。</para>
|
|
||||||
</listitem>
|
|
||||||
</orderedlist>
|
|
||||||
<para>这将会在<literal>$JBOSS_HOME/server</literal>创建两个服务器配置:</para>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>default-with-activemq</literal> -- 这个相当于AS 4的<literal
|
|
||||||
>default</literal>配置但其JMS提供者替换成为ActiveMQ。在这个配置中的ActiveMQ
|
|
||||||
是<emphasis>非集群</emphasis>的。</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para><literal>all-with-activemq</literal> -- 这个相当于AS 4的<literal
|
|
||||||
>all</literal>配置但其JMS提供者替换成为ActiveMQ。这个配置中的ActiveMQ
|
|
||||||
是<emphasis>集群</emphasis>的。</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
<para>这时,你就可以启动上面其中任何一个配置的JBoss AS 4服务器了,例如:</para>
|
|
||||||
<programlisting>$JBOSS_HOME/bin/run.sh -c default-with-activemq</programlisting>
|
|
||||||
</section>
|
|
||||||
</chapter>
|
|
|
@ -1,25 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<chapter id="introduction">
|
|
||||||
<title>快速入手</title>
|
|
||||||
<para>本简短的指南给出了如何下载、安装ActiveMQ,以及尽快开始使用ActiveMQ。</para>
|
|
||||||
<para>我们强烈建议当下载安装完成后,运行ActiveMQ的例子来了解ActiveMQ。我们有70多个例子来展示几乎
|
|
||||||
所有ActiveMQ的功能。</para>
|
|
||||||
<para>本指南不能代替用户手册。用户手册包括更加完整和深入的信息,供用户进一步全面掌握ActiveMQ。</para>
|
|
||||||
</chapter>
|
|
|
@ -1,46 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
|
|
||||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
|
|
||||||
"../../../lib/docbook-support/support/docbook-dtd/docbookx.dtd" [
|
|
||||||
<!ENTITY about SYSTEM "about.xml">
|
|
||||||
<!ENTITY download SYSTEM "download.xml">
|
|
||||||
<!ENTITY examples SYSTEM "examples.xml">
|
|
||||||
<!ENTITY installation SYSTEM "installation.xml">
|
|
||||||
<!ENTITY introduction SYSTEM "introduction.xml">
|
|
||||||
<!ENTITY notice SYSTEM "notice.xml">
|
|
||||||
<!ENTITY running SYSTEM "running.xml">
|
|
||||||
]>
|
|
||||||
<book lang="en">
|
|
||||||
<bookinfo>
|
|
||||||
<title>ActiveMQ快速指南</title>
|
|
||||||
<subtitle>Putting the buzz in messaging</subtitle>
|
|
||||||
</bookinfo>
|
|
||||||
|
|
||||||
<toc></toc>
|
|
||||||
|
|
||||||
¬ice;
|
|
||||||
&about;
|
|
||||||
&introduction;
|
|
||||||
&download;
|
|
||||||
&installation;
|
|
||||||
&running;
|
|
||||||
&examples;
|
|
||||||
</book>
|
|
|
@ -1,29 +0,0 @@
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
|
|
||||||
|
|
||||||
<chapter id="notice">
|
|
||||||
<title>法律声明</title>
|
|
||||||
|
|
||||||
<para>Red Hat, Inc. 以及其他公司2010年版权所有。</para>
|
|
||||||
<para>Red Hat公司依照 CC-BY-SA 3.0 Unported(Creative Commons
|
|
||||||
Attribution-Share Alike)条款之规定授权用戶是用本手册中的文字和插图。</para>
|
|
||||||
<para>有关 CC-BY-SA 的解释请访问<ulink url="http://creativecommons.org/licenses/by-sa/3.0/">http://creativecommons.org/licenses/by-sa/3.0/</ulink>。根据CC-BY-SA的规定,如果要发布本文档或任何本文档的修改版本,都必须给出原始版本文档的URL。</para>
|
|
||||||
<para>Red Hat 作为本文档的授权方声明在相关法律允许的最大范围内放弃CC-BY-SA第4d节所规定的权利。</para>
|
|
||||||
</chapter>
|
|
||||||
|
|
|
@ -1,68 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<!-- Copyright © 2009 Red Hat, Inc. and others. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- The text of and illustrations in this document are licensed by Red Hat under -->
|
|
||||||
<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- An explanation of CC-BY-SA is available at -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- http://creativecommons.org/licenses/by-sa/3.0/. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- In accordance with CC-BY-SA, if you distribute this document or an adaptation -->
|
|
||||||
<!-- of it, you must provide the URL for the original version. -->
|
|
||||||
<!-- -->
|
|
||||||
<!-- Red Hat, as the licensor of this document, waives the right to enforce, -->
|
|
||||||
<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent -->
|
|
||||||
<!-- permitted by applicable law. -->
|
|
||||||
<!-- ============================================================================= -->
|
|
||||||
<chapter id="running">
|
|
||||||
<title>Starting The Server</title>
|
|
||||||
<section id="running.standalone">
|
|
||||||
<title>单独ActiveMQ</title>
|
|
||||||
<para>要运行单独的ActiveMQ服务,打开一个命令行窗口,进入到ActiveMQ的<literal>bin</literal>
|
|
||||||
目录下,执行<literal>./run.sh</literal> (或者在Windows下 <literal
|
|
||||||
>run.bat</literal>)。你将看到如下的输出:</para>
|
|
||||||
<programlisting>
|
|
||||||
bin$ ./run.sh
|
|
||||||
|
|
||||||
15:05:54,108 INFO @main [ActiveMQBootstrapServer] Starting ActiveMQ server
|
|
||||||
...
|
|
||||||
15:06:02,566 INFO @main [ActiveMQServerImpl] ActiveMQ Server version
|
|
||||||
2.0.0.CR3 (yellowjacket, 111) started
|
|
||||||
</programlisting>
|
|
||||||
<para>这表明ActiveMQ已经启动并运行了。</para>
|
|
||||||
<para>默认情况下,不论是启动还是停止脚本都使用<literal>config/stand-alone/non-clustered</literal>
|
|
||||||
下的配置文件。要使用不同的配置目录,可运行<literal>./run.sh ../config/stand-alone/clustered</literal>
|
|
||||||
或者其它选定的目录。同样方法适用于停止脚本。</para>
|
|
||||||
</section>
|
|
||||||
<section id="running.jboss.as5">
|
|
||||||
<title>ActiveMQ在JBoss AS 5.x中运行</title>
|
|
||||||
<para>要在JBoss AS 5运行ActiveMQ,你需要创建<link
|
|
||||||
linkend="installation.jboss.as5">安装有ActiveMQ的AS 5的配置</link>。然后用这个配置启动AS 5。
|
|
||||||
例如,要运行一个带有<emphasis>非集群</emphasis>的ActiveMQ服务的AS 5,进入<literal
|
|
||||||
>$JBOSS_HOME/bin</literal>目录,然后键入:</para>
|
|
||||||
<programlisting>
|
|
||||||
bin$ ./run.sh -c default-with-activemq
|
|
||||||
|
|
||||||
15:18:35,460 INFO [ServerImpl] Starting JBoss (Microcontainer)...
|
|
||||||
15:18:35,462 INFO [ServerImpl] Release ID: JBoss (Microcontainer) [5.1.0.GA (build: SVNTag=
|
|
||||||
JBoss_5_1_0_GA date=200905221053)
|
|
||||||
...
|
|
||||||
15:19:30,305 INFO [ActiveMQServerImpl] ActiveMQ Server version
|
|
||||||
2.0.0.CR3 (yellowjacket, 111) started
|
|
||||||
...
|
|
||||||
15:19:43,601 INFO [ServerImpl] JBoss (Microcontainer) [5.1.0.GA (build: SVNTag=
|
|
||||||
JBoss_5_1_0_GA date=200905221053)]Started in 1m:14s:556ms
|
|
||||||
</programlisting>
|
|
||||||
</section>
|
|
||||||
<section id="running.jboss.as4">
|
|
||||||
<title>ActiveMQ在JBoss AS 4中运行</title>
|
|
||||||
<para>首先按照与JBoss AS 5相同的步骤创建<link linkend="installation.jboss.as4">安装有ActiveMQ的AS 4配置
|
|
||||||
</link>然后以相同的方式启动AS。</para>
|
|
||||||
</section>
|
|
||||||
<section id="running.jboss.as6">
|
|
||||||
<title>ActiveMQ在JBoss AS 6.0中运行</title>
|
|
||||||
<para>从JBoss AS 6.0 M3开始,ActiveMQ已经是默认的(内建)JMS提供者。所以无需安装即可运行。</para>
|
|
||||||
</section>
|
|
||||||
</chapter>
|
|
Loading…
Reference in New Issue