[hornetq-commits] JBoss hornetq SVN: r9214 - in branches/HnetQ_323_cn/docs/quickstart-guide: zh and 1 other directories.
do-not-reply at jboss.org
do-not-reply at jboss.org
Mon May 10 02:09:57 EDT 2010
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">FAQs 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">features 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</ulink></para>
+ </listitem>
+ <listitem>
+ <para>If you have any user questions please use our <ulink
+ url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=312">user
+ 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&op=viewforum&f=313"
+ >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></para>
+ </listitem>
+ <listitem>
+ <para>Follow us on <ulink url="http://twitter.com/hornetq">twitter</ulink></para>
+ </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>
+
+ ¬ice;
+ &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://creativecommons.org/licenses/by-sa/3.0/</ulink>.
+ 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>
More information about the hornetq-commits
mailing list