安装

In-Reply-To: <8b738e60a5d74a9c9614de4f578bb10f@git.apache.org> References: <8b738e60a5d74a9c9614de4f578bb10f@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [45/51] [partial] activemq-6 git commit: ACTIVEMQ6-1 - Initial HornetQ Donation Commit http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/quickstart-guide/zh/installation.xml ---------------------------------------------------------------------- diff --git a/docs/quickstart-guide/zh/installation.xml b/docs/quickstart-guide/zh/installation.xml new file mode 100644 index 0000000..dc89fd4 --- /dev/null +++ b/docs/quickstart-guide/zh/installation.xml @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + + + + + + + 安装 + 本章讲述如何安装HornetQ。 +

+ 准备 + + HornetQ只能在Java 6或以上版本中运行 + + 默认情况下HornetQ运行的内存是1GiB。如果你的电脑内存少于1GiB，或者你希望更多的内存给HornetQ，你 + 可以修改 bin/run.sh脚本文件。 + HornetQ有自己的快速日志系统，它能够使用libaio（在Linux上它是默认的）或Java的NIO。 + 如果要使用libaio，你需要首先在你的Linux上安装它。 + 如果你不在使用Linux，则不需要考虑这个问题。 + 要安装libaio，你可以使用root用户完成以下步骤： + 使用yum（例如在Fedora 或 Red Hat Enterprise Linux上）： + yum install libaio + 使用aptitude, (例如在Ubuntu或Debian系统上）： + apt-get install libaio +

+ 单独的HornetQ服务器 + 将软件包下载后，将其解压到你选定的目录下。这里你就可以直接运行了。 + 下面给出了它的目录结构： + + |___ bin + | + |___ config + | |___ jboss-as-4 + | |___ jboss-as-5 + | |___ stand-alone + | + |___ docs + | |___ api + | |___ quickstart-guide + | |___ user-manual + | + |___ examples + | |___ core + | |___ javaee + | |___ jms + | + |___ lib + | + |___ licenses + | + |___ schemas + + + + bin -- 运行HornetQ的二进制文件和脚本文件。 + + + config -- HornetQ的配置文件。它包括了单独模式或者运行在 + JBoss AS 4 或 5中的配置。请参考配置索引来了解配置有详细信息。 + + + docs -- HornetQ的文档及Javadoc。 + + + examples -- JMS and Java EE例子。有关详细信息请参见 + 'running examples'一章。 + + + lib -- 运行HornetQ所需要的jar文件和库文件 + + + licenses -- HornetQ的软件协议 + + + schemas -- HornetQ配置文件的XML Schema + + +

+ HornetQ运行于JBoss应用服务器5.x + HornetQ可以部署在JBoss AS + 5中。目前默认的应用服务器没有安装HornetQ（HornetQ将是JBoss 6的默认JMS提供者），因此 + 你需要为HornetQ创建新的AS 5的配置（profile）。 + 创建AS 5新配置的步骤： + + + 下载并安装JBoss AS 5 + + + 设置环境变量JBOSS_HOME指向JBoss AS 5的安装目录。 + + + 运行HornetQ的config/jboss-as-5下的./build.sh （或 + 者如果在Windows下运行build.bat）。 + + + 这将会在$JBOSS_HOME/server创建两个服务器配置： + + + default-with-hornetq -- 这个相当于AS 5的default配置但其JMS提供者替换成为HornetQ。在这个配置中的HornetQ + 是非集群的。 + + + all-with-hornetq -- 这个相当于AS 5的all配置但其JMS提供者替换成为HornetQ。这个配置中的HornetQ + 是集群的。 + + + 这时，你就可以启动上面其中任何一个配置的JBoss AS 5服务器了，例如： + $JBOSS_HOME/bin/run.sh -c default-with-hornetq +

+ HornetQ运行于JBoss应用服务器4.x + 为了在AS 4中安装HornetQ，你需要创建新的配置（profile）。 + 步骤如下： + + + 下载并安装JBoss AS 4 + + + 设置环境变量JBOSS_HOME指向JBoss AS 4的安装目录。 + + + 运行HornetQ的config/jboss-as-4下的./build.sh （或 + 者如果在Windows下运行build.bat）。 + + + 这将会在$JBOSS_HOME/server创建两个服务器配置： + + + default-with-hornetq -- 这个相当于AS 4的default配置但其JMS提供者替换成为HornetQ。在这个配置中的HornetQ + 是非集群的。 + + + all-with-hornetq -- 这个相当于AS 4的all配置但其JMS提供者替换成为HornetQ。这个配置中的HornetQ + 是集群的。 + + + 这时，你就可以启动上面其中任何一个配置的JBoss AS 4服务器了，例如： + $JBOSS_HOME/bin/run.sh -c default-with-hornetq +

+ http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/quickstart-guide/zh/introduction.xml ---------------------------------------------------------------------- diff --git a/docs/quickstart-guide/zh/introduction.xml b/docs/quickstart-guide/zh/introduction.xml new file mode 100644 index 0000000..e29f4fc --- /dev/null +++ b/docs/quickstart-guide/zh/introduction.xml @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + 快速入手 + 本简短的指南给出了如何下载、安装HornetQ，以及尽快开始使用HornetQ。 + 我们强烈建议当下载安装完成后，运行HornetQ的例子来了解HornetQ。我们有70多个例子来展示几乎 + 所有HornetQ的功能。 + 本指南不能代替用户手册。用户手册包括更加完整和深入的信息，供用户进一步全面掌握HornetQ。 + http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/quickstart-guide/zh/master.xml ---------------------------------------------------------------------- diff --git a/docs/quickstart-guide/zh/master.xml b/docs/quickstart-guide/zh/master.xml new file mode 100644 index 0000000..3971baf --- /dev/null +++ b/docs/quickstart-guide/zh/master.xml @@ -0,0 +1,46 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + ]> + + + HornetQ快速指南 + Putting the buzz in messaging + + + + + ¬ice; + &about; + &introduction; + &download; + &installation; + &running; + &examples; + http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/quickstart-guide/zh/notice.xml ---------------------------------------------------------------------- diff --git a/docs/quickstart-guide/zh/notice.xml b/docs/quickstart-guide/zh/notice.xml new file mode 100644 index 0000000..a9db5e5 --- /dev/null +++ b/docs/quickstart-guide/zh/notice.xml @@ -0,0 +1,29 @@ + + + + + + + + + + + + + + + + + + + + + 法律声明 + + Red Hat, Inc. 以及其他公司2010年版权所有。 + Red Hat公司依照 CC-BY-SA 3.0 Unported(Creative Commons + Attribution-Share Alike)条款之规定授权用戶是用本手册中的文字和插图。 + 有关 CC-BY-SA 的解释请访问http://creativecommons.org/licenses/by-sa/3.0/。根据CC－BY－SA的规定，如果要发布本文档或任何本文档的修改版本，都必须给出原始版本文档的URL。 + Red Hat 作为本文档的授权方声明在相关法律允许的最大范围内放弃CC-BY-SA第4d节所规定的权利。 + + http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/quickstart-guide/zh/running.xml ---------------------------------------------------------------------- diff --git a/docs/quickstart-guide/zh/running.xml b/docs/quickstart-guide/zh/running.xml new file mode 100644 index 0000000..7833af8 --- /dev/null +++ b/docs/quickstart-guide/zh/running.xml @@ -0,0 +1,68 @@ + + + + + + + + + + + + + + + + + + + + Starting The Server +

+ 单独HornetQ + 要运行单独的HornetQ服务，打开一个命令行窗口，进入到HornetQ的bin + 目录下，执行./run.sh (或者在Windows下 run.bat）。你将看到如下的输出： + + bin$ ./run.sh + + 15:05:54,108 INFO @main [HornetQBootstrapServer] Starting HornetQ server + ... + 15:06:02,566 INFO @main [HornetQServerImpl] HornetQ Server version + 2.0.0.CR3 (yellowjacket, 111) started + + 这表明HornetQ已经启动并运行了。 + 默认情况下，不论是启动还是停止脚本都使用config/stand-alone/non-clustered + 下的配置文件。要使用不同的配置目录，可运行./run.sh ../config/stand-alone/clustered + 或者其它选定的目录。同样方法适用于停止脚本。 +

+ HornetQ在JBoss AS 5.x中运行 + 要在JBoss AS 5运行HornetQ，你需要创建安装有HornetQ的AS 5的配置。然后用这个配置启动AS 5。 + 例如，要运行一个带有非集群的HornetQ服务的AS 5，进入$JBOSS_HOME/bin目录，然后键入： + + bin$ ./run.sh -c default-with-hornetq + + 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 [HornetQServerImpl] HornetQ 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 + +

+ HornetQ在JBoss AS 4中运行 + 首先按照与JBoss AS 5相同的步骤创建安装有HornetQ的AS 4配置 + 然后以相同的方式启动AS。 +

+ HornetQ在JBoss AS 6.0中运行 + 从JBoss AS 6.0 M3开始，HornetQ已经是默认的（内建）JMS提供者。所以无需安装即可运行。 +

+ http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/user-manual/en/Author_Group.xml ---------------------------------------------------------------------- diff --git a/docs/user-manual/en/Author_Group.xml b/docs/user-manual/en/Author_Group.xml new file mode 100644 index 0000000..42b4ffc --- /dev/null +++ b/docs/user-manual/en/Author_Group.xml @@ -0,0 +1,82 @@ + + + + +%BOOK_ENTITIES; +]> + + + Clebert + Suconic + + Red Hat, Inc. + Project Lead + JBoss + + csuconic@redhat.com + + + Andy + Taylor + + Red Hat, Inc. + Core Developer + JBoss + + ataylor@redhat.com + + + Tim + Fox + + Red Hat, Inc. + Core Developer + JBoss + + + + Jeff + Mesnil + + Red Hat, Inc. + Core Developer + JBoss + + + + Howard + Gao + + Red Hat, Inc. + Core Developer + JBoss + + ghoward@redhat.com + + + Francisco + Borges + + + Justin + Bertram + + Red Hat, Inc. + Core Developer + JBoss + + jbertram@redhat.com + + http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/user-manual/en/Book_Info.xml ---------------------------------------------------------------------- diff --git a/docs/user-manual/en/Book_Info.xml b/docs/user-manual/en/Book_Info.xml new file mode 100644 index 0000000..f646ef6 --- /dev/null +++ b/docs/user-manual/en/Book_Info.xml @@ -0,0 +1,44 @@ + + + + +%BOOK_ENTITIES; +]> + + HornetQ User Manual + Putting the buzz in messaging + HornetQ + 2 + 2.1.0 + 1 + + The User manual is an in depth manual on all aspects of HornetQ + + + + + + + + HornetQ Logo + + + + + &YEAR; + &HOLDER; + + + http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/user-manual/en/HornetQ_User_Manual.ent ---------------------------------------------------------------------- diff --git a/docs/user-manual/en/HornetQ_User_Manual.ent b/docs/user-manual/en/HornetQ_User_Manual.ent new file mode 100644 index 0000000..dd225e3 --- /dev/null +++ b/docs/user-manual/en/HornetQ_User_Manual.ent @@ -0,0 +1,18 @@ + + + + + + + http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/user-manual/en/HornetQ_User_Manual.xml ---------------------------------------------------------------------- diff --git a/docs/user-manual/en/HornetQ_User_Manual.xml b/docs/user-manual/en/HornetQ_User_Manual.xml new file mode 100644 index 0000000..3ddf954 --- /dev/null +++ b/docs/user-manual/en/HornetQ_User_Manual.xml @@ -0,0 +1,74 @@ + + + + +%BOOK_ENTITIES; + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + http://git-wip-us.apache.org/repos/asf/activemq-6/blob/8ecd255f/docs/user-manual/en/aerogear-integration.xml ---------------------------------------------------------------------- diff --git a/docs/user-manual/en/aerogear-integration.xml b/docs/user-manual/en/aerogear-integration.xml new file mode 100644 index 0000000..44e3e23 --- /dev/null +++ b/docs/user-manual/en/aerogear-integration.xml @@ -0,0 +1,116 @@ + + + + + + + + + + + + + + + + + + + + + %BOOK_ENTITIES; + ]> + + AeroGear Integration + AeroGears push technology provides support for different push notification technologies like Google Cloud Messaging, + Apple's APNs or Mozilla's SimplePush. HornetQ allows you to configure a Connector Service that will consume messages + from a queue and forward them to an AeroGear push server and subsequently sent as notifications to mobile devices. +

+ Configuring an AeroGear Connector Service + AeroGear Connector services are configured in the connector-services configuration: + + <connector-service name="aerogear-connector"> + <factory-class>org.hornetq.integration.aerogear.AeroGearConnectorServiceFactory</factory-class> + <param key="endpoint" value="endpoint"/> + <param key="queue" value="jms.queue.aerogearQueue"/> + <param key="application-id" value="an applicationid"/> + <param key="master-secret" value="a mastersecret"/> + </connector-service> + <address-setting match="jms.queue.lastValueQueue"> + <last-value-queue>true</last-value-queue> + </address-setting> + + Shown are the required params for the connector service and are: + + + + endpoint. The endpoint or URL of you AeroGear application. + + + queue. The name of the queue to consume from. + + + application-id. The application id of your mobile application in AeroGear. + + + master-secret. The secret of your mobile application in AeroGear. + + + As well as these required paramaters there are the following optional parameters + + + ttl. The time to live for the message once AeroGear receives it. + + + badge. The badge the mobile app should use for the notification. + + + sound. The sound the mobile app should use for the notification. + + + filter. A message filter(selector) to use on the connector. + + + retry-interval. If an error occurs on send, how long before we try again to connect. + + + retry-attempts. How many times we should try to reconnect after an error. + + + variants. A comma separated list of variants that should get the message. + + + aliases. A list of aliases that should get the message. + + + device-types. A list of device types that should get the messag. + + + More in depth explanations of the AeroGear related parameters can be found in the AeroGear Push docs +

+ How to send a message for AeroGear + To send a message intended for AeroGear simply send a JMS Message and set the appropriate headers, like so + + Message message = session.createMessage(); + + message.setStringProperty("AEROGEAR_ALERT", "Hello this is a notification from HornetQ"); + + producer.send(message); + + The 'AEROGEAR_ALERT' property will be the alert sent to the mobile device. + If the message does not contain this property then it will be simply ignored and left on the queue + Its also possible to override any of the other AeroGear parameters by simply setting them on the message, + for instance if you wanted to set ttl of a message you would: + + message.setIntProperty("AEROGEAR_TTL", 1234); + + or if you wanted to set the list of variants you would use: + + message.setStringProperty("AEROGEAR_VARIANTS", "variant1,variant2,variant3"); + + Again refer to the AeroGear documentation for a more in depth view on how to use these settings +

+ \ No newline at end of file