[hornetq-commits] JBoss hornetq SVN: r9214 - in branches/HnetQ_323_cn/docs/quickstart-guide: zh and 1 other directories.

Author: gaohoward Date: 2010-05-10 02:09:57 -0400 (Mon, 10 May 2010) New Revision: 9214 Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/ branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/images/ branches/HnetQ_323_cn/docs/quickstart-guide/zh/images/hornetQ_logo_600px.png branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/master.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml Log: added zh docs Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -0,0 +1,79 @@ +<?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>About HornetQ</title> + <para>What is HornetQ?</para> + <itemizedlist> + <listitem> + <para>HornetQ is an open source project to build a multi-protocol, embeddable, very high + performance, clustered, asynchronous messaging system.</para> + </listitem> + <listitem> + <para>For answers to more questions about what HornetQ is and what it isn't please visit + the <ulink url="http://www.jboss.org/community/wiki/HornetQGeneralFAQs">... wiki + page</ulink>.</para> + </listitem> + </itemizedlist> + <para>Why use HornetQ? Here are just a few of the reasons:</para> + <itemizedlist> + <listitem> + <para>100% open source software. HornetQ is licenced using the Apache Software License v2.0 + to minimise barriers to adoption.</para> + </listitem> + <listitem> + <para>HornetQ is designed with usability in mind.</para> + </listitem> + <listitem> + <para>Written in Java. Runs on any platform with a Java 6+ runtime, that's everything + from Windows desktops to IBM mainframes.</para> + </listitem> + <listitem> + <para>Amazing performance. Our class beating high performance journal provides persistent + messaging performance at rates normally seen for non persistent messaging, our non + persistent messaging performance rocks the boat too.</para> + </listitem> + <listitem> + <para>Full feature set. All the features you'd expect in any serious messaging system, + and others you won't find anywhere else.</para> + </listitem> + <listitem> + <para>Elegant, clean-cut design with minimal third party dependencies. Run HornetQ + stand-alone, run it in integrated in your favourite JEE application server, or run + it embedded inside your own product. It's up to you.</para> + </listitem> + <listitem> + <para>Seamless high availability. We provide a HA solution with automatic client + failover so you can guarantee zero message loss or duplication in event of server + failure.</para> + </listitem> + <listitem> + <para>Hugely flexible clustering. Create clusters of servers that know how to load + balance messages. Link geographically distributed clusters over unreliable + connections to form a global network. Configure routing of messages in a highly + flexible way.</para> + </listitem> + <listitem> + <para>For a full list of features, please see the <ulink + url="http://www.jboss.org/community/wiki/HornetQFeatures">fe... wiki + page</ulink> .</para> + </listitem> + </itemizedlist> +</chapter> \ No newline at end of file Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -0,0 +1,70 @@ +<?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>Download</title> + <para>The official HornetQ project page is <ulink url="http://hornetq.org/" + >http://hornetq.org/</ulink>.</para> + <section id="download.software"> + <title>Software Download</title> + <para>The software can be download from the Download page:<ulink + url="http://hornetq.org/downloads.html/" + >http://hornetq.org/downloads.html</ulink></para> + </section> + <section id="download.svn"> + <title>Project Information</title> + <para> + <itemizedlist> + <listitem> + <para>Please take a look at our project <ulink + url="http://www.jboss.org/community/wiki/HornetQ">wiki</u... + </listitem> + <listitem> + <para>If you have any user questions please use our <ulink + url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... + forum</ulink></para> + </listitem> + <listitem> + <para>If you have development related questions, please use our <ulink + url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... + >developer forum</ulink></para> + </listitem> + <listitem> + <para>Pop in and chat to us in our <ulink url="irc://irc.freenode.net:6667/hornetq" + >IRC channel</ulink></para> + </listitem> + <listitem> + <para>Our project <ulink url="http://hornetq.blogspot.com/">blog</ulink></pa... + </listitem> + <listitem> + <para>Follow us on <ulink url="http://twitter.com/hornetq">twitter</ulink></p... + </listitem> + <listitem> + <para>HornetQ Subversion trunk is <ulink + url="http://anonsvn.jboss.org/repos/hornetq/trunk" + >http://anonsvn.jboss.org/repos/hornetq/trunk</ulink></para> + </listitem> + <listitem> + <para>All release tags are availble from <ulink + url="http://anonsvn.jboss.org/repos/hornetq/tags" + >http://anonsvn.jboss.org/repos/hornetq/tags</ulink></para> + </listitem> + </itemizedlist> + </para> + </section> +</chapter> Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -0,0 +1,234 @@ +<?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>Running the Examples</title> + <para>In the directory <literal>examples</literal> there are 2 sets of examples, these are </para> + <itemizedlist> + <listitem> + <para>JMS Examples - these demonstrate functionality while sending and consumng JMS + messages.</para> + </listitem> + <listitem> + <para>Java EE Examples - these demonstrate application server integration, e.g. MDBs, EJBs, + Servlets, etc.</para> + </listitem> + </itemizedlist> + <section id="examples.jms"> + <title>The JMS examples</title> + <para>The JMS Examples all follow the same format. Each examples is contained in its own + directory which contains the following.</para> + <itemizedlist> + <listitem> + <para><literal>build.xml</literal></para> + <para>This is the ant build file used to run the example</para> + </listitem> + <listitem> + <para><literal>src</literal> directory</para> + <para>This contains the source code for the example</para> + </listitem> + <listitem> + <para><literal>server0</literal> configuration directory</para> + <para>This contains the configuration files needed to run the server for the example. + There may be multiple configuration directories <literal>server0</literal>, <literal + >server1</literal> etc for clustered examples etc.</para> + </listitem> + </itemizedlist> + <para>Each example will start one or more stand-alone servers and stop them after the example + has completed.</para> + <para>As a quick start we'll run the queue example. For all other examples refer to the main + user manual.</para> + <para>Firstly open a Shell or a Command prompt and navigate to the <literal + >examples/jms/queue</literal> directory.</para> + <para>Type the command <literal>./build.sh</literal> (or <literal>build.bat</literal> if you + are running on Windows), and you should see the following output:</para> + <programlisting>Buildfile: build.xml + +run: + +init: + +compile: + [echo] src.example.dir=/home/andy/projects/hornetq/trunk/examples/jms/queue/src + [javac] Compiling 5 source files to /home/andy/projects/hornetq/trunk/examples/jms/queue +/build/classes + +runExample: + [java] 10:41:04,149 INFO @main [JMSExample] hornetq.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/hornetq/trunk/examples/jms/common/../../../src/config/stand-alone/no +n-clustered/logging.properties + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:08,437 INFO @main [Journal +StorageManager] AIO journal selected + [java] org.hornetq.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.hornetq.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 HornetQ user guide for instructions o +n how to do this. + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [HornetQCo +nnectionFactory] read only is false + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [HornetQCo +nnectionFactory] read only is false + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [HornetQCo +nnectionFactory] read only is false + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:10,991 WARN @main [JMSServ +erManagerImpl] Binding for java:/ConnectionFactory already exists + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:10,991 WARN @main [JMSServ +erManagerImpl] Binding for java:/XAConnectionFactory already exists + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:11,241 INFO @main [Messagi +ngServerImpl] HornetQ Server version 2.0.0.BETA5 (buzz-buzz, 107) started + [java] org.hornetq.jms.example.SpawnedJMSServer out:10:41:11,241 INFO @main [HornetQBoot +strapServer] HornetQ server started + [java] org.hornetq.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>Congratulations! You have successfully run your first HornetQ example. Try some of the + others.</para> + </section> + <section id="examples.messaging"> + <title>The Java EE Examples</title> + <para>The Java EE Examples are examples that require a JEE application server to run. They + include MDB, Servlet, EJB examples etc. For this you will need the JBoss Application Server + installed. How to do this is explained in the previous chapters.</para> + <para>We'll use the MDB example for the purposes of this guide. For the other examples refer + to the user guide. Before going any further ensure that the JBoss Application Server is + running.</para> + <para>Like the other Java EE examples the MDB example is a JEE Application which first needs + deploying in the JBoss Application Server. The first thing we need to do is set the + <literal>JBOSS_HOME</literal> environment property to the location of the JBoss + Application Server, in a Linux shell this would be something like:</para> + <programlisting>export JBOSS_HOME=/home/jbossas5.1/build/output/jboss-5.1.0.GA</programlisting> + <para>Once set we can then deploy the application, from inside the <literal + >examples/javaee/mdb</literal> directory run the command:</para> + <programlisting>./build.sh deploy</programlisting> + <para>This will make a copy of the messaging profile in the JBoss Application server and start + the server.</para> + <para>In the shell window you should see something like the following output:</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-hornetq/deploy/hornetq.sar + [copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA + /server/default-with-hornetq/deploy/hornetq.sar + +init: + +compile: + +jar: + [jar] Building jar: /home/andy/projects/hornetq/trunk/examples/javaee/mdb/build/mdb-exa + mple.jar + +ear: + [jar] Building jar: /home/andy/projects/hornetq/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.hornetq.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>We can now run the example, do this by running the following command from within the + <literal>mdb</literal> directory.</para> + <programlisting>./build.sh</programlisting> + <para>You should see some output similar to the following:</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>You may also see some output from the JBoss Application Server, in this instance it + is:</para> + <programlisting>16:27:54,703 INFO [STDOUT] message This is a text message received</programlisting> + <para>The application can then be undeployed by running the following command from within the + <literal>mdb</literal> directory.</para> + <programlisting>./build.sh undeploy</programlisting> + <para>This should so some output similar to the following:</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-hornetq/deploy/mdb-example.ear + [delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA + /server/default-with-hornetq/deploy/hornetq.sar/hornetq-queues.xml + [delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA + /server/default-with-hornetq/deploy/hornetq.sar/hornetq-jms.xml + +BUILD SUCCESSFUL +Total time: 1 second +</programlisting> + <para>You can verify that the application has been undeployed by checking the output from the + JBoss Application Server, in this instance it will be something like:</para> + <programlisting>16:36:45,277 INFO [EJBContainer] STOPPED EJB: org.jboss.javaee.example.server.MDBExample + ejbName: MessageMDBExample +</programlisting> + <para>Congratulations! you have successfully deployed and run a Java EE example.</para> + </section> +</chapter> Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/images/hornetQ_logo_600px.png =================================================================== (Binary files differ) Property changes on: branches/HnetQ_323_cn/docs/quickstart-guide/zh/images/hornetQ_logo_600px.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -0,0 +1,168 @@ +<?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>Installation</title> + <para>This section describes how to install HornetQ. </para> + <section id="installation.prerequisites"> + <title>Prerequisites</title> + <note> + <para>HornetQ only runs on Java 6 or later.</para> + </note> + <para>By default, HornetQ server runs with 1GiB of memory. If your computer has less memory, + or you want to run it with more available RAM, modify the value in <literal + >bin/run.sh</literal> accordingly.</para> + <para>For persistence, HornetQ uses its own fast journal, which you can configure to use + libaio (which is the default when running on Linux) or Java NIO. In order to use the libaio + module on Linux, you'll need to install libaio, if it's not already installed.</para> + <para>If you're not running on Linux then you don't need to worry about this.</para> + <para>You can install libaio using the following steps as the root user:</para> + <para>Using yum, (e.g. on Fedora or Red Hat Enterprise Linux):</para> + <programlisting>yum install libaio</programlisting> + <para>Using aptitude, (e.g. on Ubuntu or Debian system):</para> + <programlisting>apt-get install libaio</programlisting> + </section> + <section id="installation.standalone"> + <title>Stand-alone HornetQ Server</title> + <para>After downloading the distribution, unzip it into your chosen directory. At this point + it should be possible to <link linkend="running.standalone">run straight out of the + box</link>, the following describes the directory structure: </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> -- binaries and scripts needed to run HornetQ.</para> + </listitem> + <listitem> + <para><literal>config</literal> -- configuration files needed to configure HornetQ. This + contains configurations to run HornetQ either in stand-alone or inside JBoss AS 4 and 5. + Please refer to the reference guide for details on configuration. </para> + </listitem> + <listitem> + <para><literal>docs</literal> -- guides and javadocs for HornetQ </para> + </listitem> + <listitem> + <para><literal>examples</literal> -- JMS and Java EE examples. Please refer to the + 'running examples' chapter for details on how to run them. </para> + </listitem> + <listitem> + <para><literal>lib</literal> -- jars and libraries needed to run HornetQ </para> + </listitem> + <listitem> + <para><literal>licenses</literal> -- licenses for HornetQ </para> + </listitem> + <listitem> + <para><literal>schemas</literal> -- XML Schemas used to validate HornetQ configuration + files</para> + </listitem> + </itemizedlist> + </section> + <section id="installation.jboss.as5"> + <title>HornetQ In JBoss Application Server 5.x</title> + <para>HornetQ can also be deployed in <ulink url="http://www.jboss.org/jbossas/">JBoss AS + 5</ulink>. It is not currently shipped by default with the application server (it is + scheduled to be shipped as default JMS provider in JBoss Application Server 6.0), so you + will need to create new AS 5 profiles to run AS 5 with HornetQ.</para> + <para>To create AS 5 profiles:</para> + <orderedlist> + <listitem> + <para>Download JBoss AS 5</para> + </listitem> + <listitem> + <para>Set the environment property <literal>JBOSS_HOME</literal> to point to the + directory where you installed JBoss AS 5</para> + </listitem> + <listitem> + <para>run <literal>./build.sh</literal> (or <literal>build.bat</literal> if you are on + Windows) in HornetQ <literal>config/jboss-as-5</literal> directory</para> + </listitem> + </orderedlist> + <para>This will create 2 new profiles in <literal>$JBOSS_HOME/server</literal>:</para> + <itemizedlist> + <listitem> + <para><literal>default-with-hornetq</literal> -- it corresponds to AS 5 <literal + >default</literal> profile with HornetQ as its JMS provider. In this profile, + HornetQ is <emphasis>non-clustered</emphasis></para> + </listitem> + <listitem> + <para><literal>all-with-hornetq</literal> -- it corresponds to AS 5 <literal + >all</literal> profile with HornetQ as its JMS provider. In this profile, HornetQ + is <emphasis>clustered</emphasis></para> + </listitem> + </itemizedlist> + <para>You can then start JBoss AS 5 using one of these profiles, e.g. :</para> + <programlisting>$JBOSS_HOME/bin/run.sh -c default-with-hornetq</programlisting> + </section> + <section id="installation.jboss.as4"> + <title>HornetQ In JBoss Application Server 4.x</title> + <para>As in AS 4, it is not shipped by default with the application server, so you will need + to create new AS 4 profiles to run AS 4 with HornetQ.</para> + <para>To create AS 4 profiles:</para> + <orderedlist> + <listitem> + <para>Download JBoss AS 4</para> + </listitem> + <listitem> + <para>Set the environment property <literal>JBOSS_HOME</literal> to point to the + directory where you installed JBoss AS 4</para> + </listitem> + <listitem> + <para>run <literal>./build.sh</literal> (or <literal>build.bat as4</literal> if you + are on Windows) in HornetQ <literal>config/jboss-as-4</literal> + directory</para> + </listitem> + </orderedlist> + <para>This will create 2 new profiles in <literal>$JBOSS_HOME/server</literal>:</para> + <itemizedlist> + <listitem> + <para><literal>default-with-hornetq</literal> -- it corresponds to AS 4 <literal + >default</literal> profile with HornetQ as its JMS provider. In this profile, + HornetQ is <emphasis>non-clustered</emphasis></para> + </listitem> + <listitem> + <para><literal>all-with-hornetq</literal> -- it corresponds to AS 4 <literal + >all</literal> profile with HornetQ as its JMS provider. In this profile, HornetQ + is <emphasis>clustered</emphasis></para> + </listitem> + </itemizedlist> + <para>You can then start JBoss AS 4 using one of these profiles:</para> + <programlisting>$JBOSS_HOME/bin/run.sh -c default-with-hornetq</programlisting> + </section> +</chapter> Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -0,0 +1,28 @@ +<?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>Getting Started</title> + <para>This short guide explains how to download, install and quickly get started with + HornetQ.</para> + <para>After downloading and installing we highly recommend you run the examples to get + acquainted with HornetQ. We ship with over 70 examples demonstrating most of the + features.</para> + <para>This guide is not intended to be a replacement for the user manual. The user manual goes + into much more depth, so please consult that for further information.</para> +</chapter> Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/master.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/master.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/master.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -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 Quickstart Guide</title> + <subtitle>Putting the buzz in messaging</subtitle> + </bookinfo> + + <toc></toc> + + &notice; + &about; + &introduction; + &download; + &installation; + &running; + &examples; +</book> Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -0,0 +1,32 @@ +<!-- ============================================================================= --> +<!-- 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>Legal Notice</title> + + <para>Copyright © 2010 Red Hat, Inc. and others.</para> + <para>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").</para> + <para>An explanation of CC-BY-SA is available at + <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">http://...;. + 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.</para> + <para>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.</para> +</chapter> \ No newline at end of file Added: branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml (rev 0) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml 2010-05-10 06:09:57 UTC (rev 9214) @@ -0,0 +1,71 @@ +<?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>Standalone HornetQ</title> + <para>To run a stand-alone server, open up a shell or command prompt and navigate into the + <literal>bin</literal> directory. Then execute <literal>./run.sh</literal> (or <literal + >run.bat</literal> on Windows) and you should see the following output </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 is now running.</para> + <para>Both the run and the stop scripts use the config under <literal + >config/stand-alone/non-clustered</literal> by default. The configuration can be changed + by running <literal>./run.sh ../config/stand-alone/clustered</literal> or another config of + your choosing. This is the same for the stop script and the windows bat files.</para> + </section> + <section id="running.jboss.as5"> + <title>HornetQ In JBoss AS 5.x</title> + <para>To run HornetQ in JBoss AS 5, you need to create the <link + linkend="installation.jboss.as5">AS 5 profiles for HornetQ</link> first. Then run JBoss + AS 5 with one these profiles. For example, to run JBoss AS 5 with a + <emphasis>non-clustered</emphasis> HornetQ server, got to <literal + >$JBOSS_HOME/bin</literal> directory and type:</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 In JBoss AS 4.x</title> + <para>To run HornetQ in JBoss AS 4 you must follow the same steps described for AS5 without + forgetting to create the <link linkend="installation.jboss.as4">AS 4 profiles for + HornetQ</link> first. </para> + </section> + <section id="running.jboss.as6"> + <title>HornetQ In JBoss AS 6.0</title> + <para>From JBoss AS 6.0 M3 onwards, HornetQ is the default (built-in) JMS provider in JBoss AS, so there's no need to install it - it's already there.</para> + </section> +</chapter>