[hornetq-commits] JBoss hornetq SVN: r9216 - branches/HnetQ_323_cn/docs/quickstart-guide/zh.

Author: gaohoward Date: 2010-05-10 09:12:38 -0400 (Mon, 10 May 2010) New Revision: 9216 Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml Log: done Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml 2010-05-10 08:50:33 UTC (rev 9215) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/examples.xml 2010-05-10 13:12:38 UTC (rev 9216) @@ -17,46 +17,40 @@ <!-- 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> + <title>运行HornetQ例子</title> + <para>在HornetQ的<literal>examples</literal>目录下有两组例子，它们是：</para> <itemizedlist> <listitem> - <para>JMS Examples - these demonstrate functionality while sending and consumng JMS - messages.</para> + <para>JMS例子 - 这些例子展示的是使用JMS发送与接收消息的功能。</para> </listitem> <listitem> - <para>Java EE Examples - these demonstrate application server integration, e.g. MDBs, EJBs, - Servlets, etc.</para> + <para>Java EE 例子 - 这些例子展示的是与应用服务器的集成，例如MDB，EJB，Servlet等。</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> + <title>JMS例子</title> + <para>所有JMS都有统一的格式。每个例子都有自己的目录，它的内容包括：</para> <itemizedlist> <listitem> <para><literal>build.xml</literal></para> - <para>This is the ant build file used to run the example</para> + <para>ant的build文件，用来运行例子。</para> </listitem> <listitem> - <para><literal>src</literal> directory</para> - <para>This contains the source code for the example</para> + <para><literal>src</literal> 目录</para> + <para>例子的代码。</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> + <para><literal>server0</literal>配置目录</para> + <para>它包含了运行服务器所需要的配置文件。有的集群的例子可能有多个这样的目录，如<literal>server0</literal>, + <literal>server1</literal>等。</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> + <para>在运行每个例子时，都要先启动一个或多个单独的服务器。当例子运行完毕，再将它们停止。</para> + <para>做为演示我们这里运行queue例子。其它的例子可以参见用户手册。</para> + <para>首先打开一个命令行窗口（shell），进入到HornetQ的 <literal + >examples/jms/queue</literal>目录。</para> + <para>敲入命令<literal>./build.sh</literal> (或者在Windows上<literal>build.bat</literal>），你 + 将看到如下的输出：</para> <programlisting>Buildfile: build.xml run: @@ -113,28 +107,20 @@ BUILD SUCCESSFUL Total time: 13 seconds </programlisting> - <para>Congratulations! You have successfully run your first HornetQ example. Try some of the - others.</para> + <para>恭喜！你已经成功地运行了你的第一个HornetQ例子。试着运行其它的例子。</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> + <title>Java EE例子</title> + <para>Java EE的例子需要首先运行一个JEE应用服务器。这些例子包括MDB，Servlet，EJB等等。你首先要安装JBoss应用服务 + 器。参见前面的章节进行安装。</para> + <para>这里我们将用MDB例子来说明。有关其它例子的详细信息参见用户手册。首先确认JBoss应用服务器已经启动。</para> + <para>如同其它Java EE例子一样，MDB需要部署到应用服务器。第一，将<literal>JBOSS_HOME</literal>环境变量 + 指向你的应用服务器安装目录。如在Linux下：</para> <programlisting>export JBOSS_HOME=/home/jbossas5.1/build/output/jboss-5.1.0.GA</programlisting> - <para>Once set we can then deploy the application, from inside the <literal - >examples/javaee/mdb</literal> directory run the command:</para> + <para>然后就可以进行部署了。在<literal>examples/javaee/mdb</literal>目录下运行：</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> + <para>它将创建一个“messaging"的AS配置，并用它来启动AS服务器。</para> + <para>在命令行窗口你会看到如下的输出：</para> <programlisting>Buildfile: build.xml validate-jboss: @@ -183,10 +169,9 @@ =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> + <para>现在我们可以运行例子了。在<literal>mdb</literal>目录下运行下列命令：</para> <programlisting>./build.sh</programlisting> - <para>You should see some output similar to the following:</para> + <para>你将看到如下输出：</para> <programlisting>Buildfile: build.xml run: @@ -224,11 +209,10 @@ 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> + <para>你还会在窗口输出中看到MDB的应用最終被删除了，如：</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> + <para>恭喜！你已经成功地部署并运行了一个Java EE的例子。</para> </section> </chapter> Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml 2010-05-10 08:50:33 UTC (rev 9215) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml 2010-05-10 13:12:38 UTC (rev 9216) @@ -104,59 +104,56 @@ </listitem> <listitem> <para>运行HornetQ的<literal>config/jboss-as-5</literal>下的<literal>./build.sh</literal> （或 - 者如果在Windows下运行<literal>build.bat</literal>）。 if you are on - Windows) in HornetQ <literal>config/jboss-as-5</literal> directory</para> + 者如果在Windows下运行<literal>build.bat</literal>）。</para> </listitem> </orderedlist> - <para>This will create 2 new profiles in <literal>$JBOSS_HOME/server</literal>:</para> + <para>这将会在<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> + <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> -- it corresponds to AS 5 <literal - >all</literal> profile with HornetQ as its JMS provider. In this profile, HornetQ - is <emphasis>clustered</emphasis></para> + <para><literal>all-with-hornetq</literal> -- 这个相当于AS 5的<literal + >all</literal>配置但其JMS提供者替换成为HornetQ。这个配置中的HornetQ + 是<emphasis>集群</emphasis>的。</para> </listitem> </itemizedlist> - <para>You can then start JBoss AS 5 using one of these profiles, e.g. :</para> + <para>这时，你就可以启动上面其中任何一个配置的JBoss AS 5服务器了，例如：</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> + <title>HornetQ运行于JBoss应用服务器4.x</title> + <para>为了在AS 4中安装HornetQ，你需要创建新的配置（profile）。</para> + <para>步骤如下：</para> <orderedlist> <listitem> - <para>Download JBoss AS 4</para> + <para>下载并安装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> + <para>设置环境变量<literal>JBOSS_HOME</literal>指向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> + <para>运行HornetQ的<literal>config/jboss-as-4</literal>下的<literal>./build.sh</literal> （或 + 者如果在Windows下运行<literal>build.bat</literal>）。</literal> directory</para> </listitem> </orderedlist> - <para>This will create 2 new profiles in <literal>$JBOSS_HOME/server</literal>:</para> + <para>这将会在<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> + <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> -- it corresponds to AS 4 <literal - >all</literal> profile with HornetQ as its JMS provider. In this profile, HornetQ - is <emphasis>clustered</emphasis></para> + <para><literal>all-with-hornetq</literal> -- 这个相当于AS 4的<literal + >all</literal>配置但其JMS提供者替换成为HornetQ。这个配置中的HornetQ + 是<emphasis>集群</emphasis>的。</para> </listitem> </itemizedlist> - <para>You can then start JBoss AS 4 using one of these profiles:</para> + <para>这时，你就可以启动上面其中任何一个配置的JBoss AS 4服务器了，例如：</para> <programlisting>$JBOSS_HOME/bin/run.sh -c default-with-hornetq</programlisting> </section> </chapter> Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml 2010-05-10 08:50:33 UTC (rev 9215) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/running.xml 2010-05-10 13:12:38 UTC (rev 9216) @@ -19,10 +19,10 @@ <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> + <title>单独HornetQ</title> + <para>要运行单独的HornetQ服务，打开一个命令行窗口，进入到HornetQ的<literal>bin</literal> + 目录下，执行<literal>./run.sh</literal> (或者在Windows下 <literal + >run.bat</literal>）。你将看到如下的输出：</para> <programlisting> bin$ ./run.sh @@ -31,19 +31,17 @@ 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> + <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 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> + <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 @@ -59,13 +57,12 @@ </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> + <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 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> + <title>HornetQ在JBoss AS 6.0中运行</title> + <para>从JBoss AS 6.0 M3开始，HornetQ已经是默认的（内建）JMS提供者。所以无需安装即可运行。</para> </section> </chapter>