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 @@ +<?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>æ¬ç« 讲述å¦ä½å®è£ HornetQã</para> + <section id="installation.prerequisites"> + <title>åå¤</title> + <note> + <para>HornetQåªè½å¨Java 6æ以ä¸çæ¬ä¸è¿è¡</para> + </note> + <para>é»è®¤æ åµä¸HornetQè¿è¡çå åæ¯1GiBãå¦æä½ ççµèå åå°äº1GiBï¼æè ä½ å¸ææ´å¤çå åç»HornetQï¼ä½ + å¯ä»¥ä¿®æ¹ <literal>bin/run.sh</literal>èæ¬æ件ã</para> + <para>HornetQæèªå·±çå¿«éæ¥å¿ç³»ç»ï¼å®è½å¤ä½¿ç¨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>åç¬çHornetQæå¡å¨</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> -- è¿è¡HornetQçäºè¿å¶æ件åèæ¬æ件ã</para> + </listitem> + <listitem> + <para><literal>config</literal> -- HornetQçé ç½®æ件ãå®å æ¬äºåç¬æ¨¡å¼æè è¿è¡å¨ + JBoss AS 4 æ 5ä¸çé ç½®ã请åèé 置索å¼æ¥äºè§£é ç½®æ详ç»ä¿¡æ¯ã</para> + </listitem> + <listitem> + <para><literal>docs</literal> -- HornetQçææ¡£åJavadocã </para> + </listitem> + <listitem> + <para><literal>examples</literal> -- JMS and Java EEä¾åãæå ³è¯¦ç»ä¿¡æ¯è¯·åè§ + 'running examples'ä¸ç« ã </para> + </listitem> + <listitem> + <para><literal>lib</literal> -- è¿è¡HornetQæéè¦çjaræ件ååºæ件 </para> + </listitem> + <listitem> + <para><literal>licenses</literal> -- HornetQç软件åè®®</para> + </listitem> + <listitem> + <para><literal>schemas</literal> -- HornetQé ç½®æ件çXML Schema</para> + </listitem> + </itemizedlist> + </section> + <section id="installation.jboss.as5"> + <title>HornetQè¿è¡äºJBossåºç¨æå¡å¨5.x</title> + <para>HornetQå¯ä»¥é¨ç½²å¨<ulink url="http://www.jboss.org/jbossas/";>JBoss AS + 5</ulink>ä¸ãç®åé»è®¤çåºç¨æå¡å¨æ²¡æå®è£ HornetQï¼HornetQå°æ¯JBoss 6çé»è®¤JMSæä¾è ï¼ï¼å æ¤ + ä½ éè¦ä¸ºHornetQå建æ°ç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>è¿è¡HornetQç<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-hornetq</literal> -- è¿ä¸ªç¸å½äºAS 5ç<literal + >default</literal>é ç½®ä½å ¶JMSæä¾è æ¿æ¢æ为HornetQãå¨è¿ä¸ªé ç½®ä¸çHornetQ + æ¯<emphasis>éé群</emphasis>çã</para> + </listitem> + <listitem> + <para><literal>all-with-hornetq</literal> -- è¿ä¸ªç¸å½äºAS 5ç<literal + >all</literal>é ç½®ä½å ¶JMSæä¾è æ¿æ¢æ为HornetQãè¿ä¸ªé ç½®ä¸çHornetQ + æ¯<emphasis>é群</emphasis>çã</para> + </listitem> + </itemizedlist> + <para>è¿æ¶ï¼ä½ å°±å¯ä»¥å¯å¨ä¸é¢å ¶ä¸ä»»ä½ä¸ä¸ªé ç½®çJBoss AS 5æå¡å¨äºï¼ä¾å¦ï¼</para> + <programlisting>$JBOSS_HOME/bin/run.sh -c default-with-hornetq</programlisting> + </section> + <section id="installation.jboss.as4"> + <title>HornetQè¿è¡äºJBossåºç¨æå¡å¨4.x</title> + <para>为äºå¨AS 4ä¸å®è£ HornetQï¼ä½ éè¦å建æ°çé ç½®ï¼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>è¿è¡HornetQç<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-hornetq</literal> -- è¿ä¸ªç¸å½äºAS 4ç<literal + >default</literal>é ç½®ä½å ¶JMSæä¾è æ¿æ¢æ为HornetQãå¨è¿ä¸ªé ç½®ä¸çHornetQ + æ¯<emphasis>éé群</emphasis>çã</para> + </listitem> + <listitem> + <para><literal>all-with-hornetq</literal> -- è¿ä¸ªç¸å½äºAS 4ç<literal + >all</literal>é ç½®ä½å ¶JMSæä¾è æ¿æ¢æ为HornetQãè¿ä¸ªé ç½®ä¸çHornetQ + æ¯<emphasis>é群</emphasis>çã</para> + </listitem> + </itemizedlist> + <para>è¿æ¶ï¼ä½ å°±å¯ä»¥å¯å¨ä¸é¢å ¶ä¸ä»»ä½ä¸ä¸ªé ç½®çJBoss AS 4æå¡å¨äºï¼ä¾å¦ï¼</para> + <programlisting>$JBOSS_HOME/bin/run.sh -c default-with-hornetq</programlisting> + </section> +</chapter>
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 @@ +<?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>æ¬ç®ççæåç»åºäºå¦ä½ä¸è½½ãå®è£ HornetQï¼ä»¥å尽快å¼å§ä½¿ç¨HornetQã</para> + <para>æ们强ç建议å½ä¸è½½å®è£ å®æåï¼è¿è¡HornetQçä¾åæ¥äºè§£HornetQãæ们æ70å¤ä¸ªä¾åæ¥å±ç¤ºå ä¹ + ææHornetQçåè½ã</para> + <para>æ¬æåä¸è½ä»£æ¿ç¨æ·æåãç¨æ·æåå æ¬æ´å å®æ´åæ·±å ¥çä¿¡æ¯ï¼ä¾ç¨æ·è¿ä¸æ¥å ¨é¢ææ¡HornetQã</para> +</chapter> 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 @@ +<?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>HornetQå¿«éæå</title> + <subtitle>Putting the buzz in messaging</subtitle> + </bookinfo> + + <toc></toc> + + ¬ice; + &about; + &introduction; + &download; + &installation; + &running; + &examples; +</book> 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 @@ +<!-- ============================================================================= --> +<!-- 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> + 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 @@ +<?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>åç¬HornetQ</title> + <para>è¦è¿è¡åç¬çHornetQæå¡ï¼æå¼ä¸ä¸ªå½ä»¤è¡çªå£ï¼è¿å ¥å°HornetQç<literal>bin</literal> + ç®å½ä¸ï¼æ§è¡<literal>./run.sh</literal> (æè å¨Windowsä¸ <literal + >run.bat</literal>ï¼ãä½ å°çå°å¦ä¸çè¾åºï¼</para> + <programlisting> + 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 + </programlisting> + <para>è¿è¡¨æHornetQå·²ç»å¯å¨å¹¶è¿è¡äºã</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>HornetQå¨JBoss AS 5.xä¸è¿è¡</title> + <para>è¦å¨JBoss AS 5è¿è¡HornetQï¼ä½ éè¦å建<link + linkend="installation.jboss.as5">å®è£ æHornetQçAS 5çé ç½®</link>ãç¶åç¨è¿ä¸ªé ç½®å¯å¨AS 5ã + ä¾å¦ï¼è¦è¿è¡ä¸ä¸ªå¸¦æ<emphasis>éé群</emphasis>çHornetQæå¡çAS 5ï¼è¿å ¥<literal + >$JBOSS_HOME/bin</literal>ç®å½ï¼ç¶åé®å ¥ï¼</para> + <programlisting> + 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 + </programlisting> + </section> + <section id="running.jboss.as4"> + <title>HornetQå¨JBoss AS 4ä¸è¿è¡</title> + <para>é¦å æç §ä¸JBoss AS 5ç¸åçæ¥éª¤å建<link linkend="installation.jboss.as4">å®è£ æHornetQçAS 4é ç½® + </link>ç¶å以ç¸åçæ¹å¼å¯å¨ASã</para> + </section> + <section id="running.jboss.as6"> + <title>HornetQå¨JBoss AS 6.0ä¸è¿è¡</title> + <para>ä»JBoss AS 6.0 M3å¼å§ï¼HornetQå·²ç»æ¯é»è®¤çï¼å 建ï¼JMSæä¾è ãæ以æ éå®è£ å³å¯è¿è¡ã</para> + </section> +</chapter> 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 @@ +<?xml version='1.0' encoding='UTF-8'?> +<!-- + ~ Copyright 2009 Red Hat, Inc. + ~ Red Hat 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. + --> + +<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ +<!ENTITY % BOOK_ENTITIES SYSTEM "HornetQ_User_Manual.ent"> +%BOOK_ENTITIES; +]> +<authorgroup> + <author> + <firstname>Clebert</firstname> + <surname>Suconic</surname> + <affiliation> + <shortaffil>Red Hat, Inc.</shortaffil> + <jobtitle>Project Lead</jobtitle> + <orgdiv>JBoss</orgdiv> + </affiliation> + <email>[email protected]</email> + </author> + <author> + <firstname>Andy</firstname> + <surname>Taylor</surname> + <affiliation> + <shortaffil>Red Hat, Inc.</shortaffil> + <jobtitle>Core Developer</jobtitle> + <orgdiv>JBoss</orgdiv> + </affiliation> + <email>[email protected]</email> + </author> + <author> + <firstname>Tim</firstname> + <surname>Fox</surname> + <affiliation> + <shortaffil>Red Hat, Inc.</shortaffil> + <jobtitle>Core Developer</jobtitle> + <orgdiv>JBoss</orgdiv> + </affiliation> + </author> + <author> + <firstname>Jeff</firstname> + <surname>Mesnil</surname> + <affiliation> + <shortaffil>Red Hat, Inc.</shortaffil> + <jobtitle>Core Developer</jobtitle> + <orgdiv>JBoss</orgdiv> + </affiliation> + </author> + <author> + <firstname>Howard</firstname> + <surname>Gao</surname> + <affiliation> + <shortaffil>Red Hat, Inc.</shortaffil> + <jobtitle>Core Developer</jobtitle> + <orgdiv>JBoss</orgdiv> + </affiliation> + <email>[email protected]</email> + </author> + <author> + <firstname>Francisco</firstname> + <surname>Borges</surname> + </author> + <author> + <firstname>Justin</firstname> + <surname>Bertram</surname> + <affiliation> + <shortaffil>Red Hat, Inc.</shortaffil> + <jobtitle>Core Developer</jobtitle> + <orgdiv>JBoss</orgdiv> + </affiliation> + <email>[email protected]</email> + </author> +</authorgroup> 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 @@ +<?xml version='1.0' encoding='UTF-8'?> +<!-- + ~ Copyright 2009 Red Hat, Inc. + ~ Red Hat 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. + --> + +<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ +<!ENTITY % BOOK_ENTITIES SYSTEM "HornetQ_User_Manual.ent"> +%BOOK_ENTITIES; +]> +<bookinfo id="HornetQ_User_Manual"> + <title>HornetQ User Manual</title> + <subtitle>Putting the buzz in messaging</subtitle> + <productname>HornetQ</productname> + <productnumber>2</productnumber> + <edition>2.1.0</edition> + <pubsnumber>1</pubsnumber> + <abstract> + <para>The User manual is an in depth manual on all aspects of HornetQ</para> + </abstract> + <corpauthor> + <inlinemediaobject> + <imageobject> + <imagedata fileref="images/hornetQ_logo_600px.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>HornetQ Logo</phrase> + </textobject> + </inlinemediaobject> + </corpauthor> + <copyright> + <year>&YEAR;</year> + <holder>&HOLDER;</holder> + </copyright> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="Author_Group.xml"/> +</bookinfo> 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 @@ +<!ENTITY PRODUCT "HornetQ"> +<!ENTITY BOOKID "HornetQ_QuickStart_Guide"> +<!ENTITY YEAR "2011"> +<!ENTITY HOLDER "Red Hat Inc."> +<!ENTITY semi ";"><!-- + ~ Copyright 2009 Red Hat, Inc. + ~ Red Hat 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. + --> + + 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 @@ +<?xml version='1.0' encoding='UTF-8'?> +<!-- + ~ Copyright 2009 Red Hat, Inc. + ~ Red Hat 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. + --> + +<!-- This document was created with Syntext Serna Free. --><!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ +<!ENTITY % BOOK_ENTITIES SYSTEM "HornetQ_User_Manual.ent"> +%BOOK_ENTITIES; + +]> +<book> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="Book_Info.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="notice.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="preface.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="project-info.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="messaging-concepts.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="architecture.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="using-server.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="using-jms.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="using-core.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="jms-core-mapping.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="client-classpath.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="examples.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="wildcard-routing.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="wildcard-syntax.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="filter-expressions.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="persistence.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="configuring-transports.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="connection-ttl.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="transaction-config.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="flow-control.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="send-guarantees.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="undelivered-messages.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="message-expiry.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="large-messages.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="paging.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="queue-attributes.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="scheduled-messages.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="last-value-queues.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="message-grouping.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="pre-acknowledge.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="management.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="security.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="appserver-integration.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="jms-bridge.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="client-reconnection.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="diverts.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="core-bridges.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="duplicate-detection.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="clusters.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="ha.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="libaio.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="thread-pooling.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="logging.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="rest.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="embedding-hornetq.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="spring-integration.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="aerogear-integration.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="vertx-integration.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="intercepting-operations.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="interoperability.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="tools.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="perf-tuning.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="configuration-index.xml"/> +</book> 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 @@ +<?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 chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ + <!ENTITY % BOOK_ENTITIES SYSTEM "HornetQ_User_Manual.ent"> + %BOOK_ENTITIES; + ]> +<chapter id="aerogear-integration"> + <title>AeroGear Integration</title> + <para>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.</para> + <section> + <title>Configuring an AeroGear Connector Service</title> + <para>AeroGear Connector services are configured in the connector-services configuration:</para> + <programlisting> + <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> + </programlisting> + <para>Shown are the required params for the connector service and are:</para> + + <itemizedlist> + <listitem> + <para><literal>endpoint</literal>. The endpoint or URL of you AeroGear application.</para> + </listitem> + <listitem> + <para><literal>queue</literal>. The name of the queue to consume from.</para> + </listitem> + <listitem> + <para><literal>application-id</literal>. The application id of your mobile application in AeroGear.</para> + </listitem> + <listitem> + <para><literal>master-secret</literal>. The secret of your mobile application in AeroGear.</para> + </listitem> + </itemizedlist> + <para>As well as these required paramaters there are the following optional parameters</para> + <itemizedlist> + <listitem> + <para><literal>ttl</literal>. The time to live for the message once AeroGear receives it.</para> + </listitem> + <listitem> + <para><literal>badge</literal>. The badge the mobile app should use for the notification.</para> + </listitem> + <listitem> + <para><literal>sound</literal>. The sound the mobile app should use for the notification.</para> + </listitem> + <listitem> + <para><literal>filter</literal>. A message filter(selector) to use on the connector.</para> + </listitem> + <listitem> + <para><literal>retry-interval</literal>. If an error occurs on send, how long before we try again to connect.</para> + </listitem> + <listitem> + <para><literal>retry-attempts</literal>. How many times we should try to reconnect after an error.</para> + </listitem> + <listitem> + <para><literal>variants</literal>. A comma separated list of variants that should get the message.</para> + </listitem> + <listitem> + <para><literal>aliases</literal>. A list of aliases that should get the message.</para> + </listitem> + <listitem> + <para><literal>device-types</literal>. A list of device types that should get the messag.</para> + </listitem> + </itemizedlist> + <para>More in depth explanations of the AeroGear related parameters can be found in the <ulink + url="http://aerogear.org/push/";>AeroGear Push docs</ulink></para> + </section> + <section> + <title>How to send a message for AeroGear</title> + <para>To send a message intended for AeroGear simply send a JMS Message and set the appropriate headers, like so</para> + <programlisting> + Message message = session.createMessage(); + + message.setStringProperty("AEROGEAR_ALERT", "Hello this is a notification from HornetQ"); + + producer.send(message); + </programlisting> + <para>The 'AEROGEAR_ALERT' property will be the alert sent to the mobile device.</para> + <note><para>If the message does not contain this property then it will be simply ignored and left on the queue</para></note> + <para>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:</para> + <programlisting> + message.setIntProperty("AEROGEAR_TTL", 1234); + </programlisting> + <para>or if you wanted to set the list of variants you would use:</para> + <programlisting> + message.setStringProperty("AEROGEAR_VARIANTS", "variant1,variant2,variant3"); + </programlisting> + <para>Again refer to the AeroGear documentation for a more in depth view on how to use these settings</para> + </section> +</chapter> \ No newline at end of file
