[jboss-cvs] JBoss Messaging SVN: r7953 - in projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide: en-US and 1 other directory.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Mon Feb 22 02:26:13 EST 2010
Author: laubai
Date: 2010-02-22 02:26:12 -0500 (Mon, 22 Feb 2010)
New Revision: 7953
Added:
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/Makefile
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/About_JBM.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Author_Group.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Book_Info.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Download.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Examples.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Installation.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Introduction.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Running_JBM.xml
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/images/
projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/publican.cfg
Log:
Added JBM 2.0 quickstart guide.
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/Makefile
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/Makefile (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/Makefile 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,13 @@
+#Makefile for JBoss_Messaging_Quickstart_Guide
+
+XML_LANG = en-US
+BRAND = JBoss
+
+#OTHER_LANGS = as-IN bn-IN de-DE es-ES fr-FR gu-IN hi-IN it-IT ja-JP kn-IN ko-KR ml-IN mr-IN or-IN pa-IN pt-BR ru-RU si-LK ta-IN te-IN zh-CN zh-TW
+
+# Extra Parameters start here
+
+# Extra Parameters stop here
+COMMON_CONFIG = /usr/share/publican
+include $(COMMON_CONFIG)/make/Makefile.common
+
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/Makefile
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/About_JBM.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/About_JBM.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/About_JBM.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="about">
+ <title>About JBoss Messaging</title>
+ <para>
+ JBoss Messaging aims to bring unrivaled levels of performance and reliability to messaging, and to be the fastest, most scalable multi-protocol messaging system with the best range of features.
+ </para>
+ <para>
+ There are a number of reasons to use JBoss Messaging:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>JBoss Messaging is 100% open source software.</para>
+ </listitem>
+ <listitem>
+ <para>
+ JBoss Messaging is written in Java, so it runs on any platform with the Java 2 Platform Standard Edition Java Development Kit — everything from Windows desktops to IBM mainframes.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Superb performance. JBoss Messaging's class-beating performance journal provides persistent messaging performance at rates normally seen in non-persistent messaging.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ JBoss Messaging has a full feature set — all the features expected in any serious messaging system, and others you will not find elsewhere.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Elegant POJO-based design with minimal third-party dependencies. Run JBoss Messaging as a standalone, integrated with your Java EE Application Server, or Inversion of Control container, or embedded in your own product.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Seamless high availability. JBoss Messaging provides server replication and completely transparent client failover so that you do not need to code your client explicitly for a high availability environment.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Flexible clustering. JBoss Messaging lets you create server clusters that can load-balance messages. You can link geographically distributed clusters to form a global network, and flexibly configure message routing.
+ </para>
+ </listitem>
+ </itemizedlist>
+</chapter>
\ No newline at end of file
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/About_JBM.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Author_Group.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Author_Group.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Author_Group.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,10 @@
+<?xml version='1.0'?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<authorgroup>
+<author>
+ <firstname>Red Hat Documentation Group</firstname>
+ <surname></surname>
+ </author>
+</authorgroup>
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Author_Group.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Book_Info.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Book_Info.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Book_Info.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,35 @@
+<?xml version='1.0'?>
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<bookinfo>
+ <title>JBoss Messaging Quickstart Guide</title>
+ <subtitle>for Use with JBoss Enterprise Application Platform 5.0</subtitle>
+ <edition>1</edition>
+ <pubsnumber>0</pubsnumber>
+ <productname>JBoss Enterprise Application Platform</productname>
+ <productnumber>5.0</productnumber>
+ <pubdate>September, 2009</pubdate>
+ <abstract>
+ <para>
+ The JBoss Enterprise Application Platform Edition of the JBoss Messaging version 2.0.0 Quickstart Guide.
+ </para>
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata format='SVG' fileref="Common_Content/images/title_logo.svg" />
+ </imageobject>
+ <textobject><phrase>Logo</phrase></textobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <copyright>
+ <year>&YEAR;</year>
+ <holder>&HOLDER;</holder>
+ </copyright>
+ <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+
+
+
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Book_Info.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Download.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Download.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Download.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="download">
+ <title>Download</title>
+ <para>
+ The official JBoss Messaging project page can be found at <ulink url="http://www.jboss.org/jbossmessaging/">http://www.jboss.org/jbossmessaging/</ulink>.
+ </para>
+
+ <section id="download.software">
+ <title>Software Download</title>
+ <para>
+ You can download JBoss Messaging from the JBoss Labs Messaging Project Download Zone: <ulink url="http://www.jboss.org/jbossmessaging/downloads/">http://www.jboss.org/jbossmessaging/downloads/</ulink>.
+ </para>
+ </section>
+
+ <section id="download.svn">
+ <title>Project Information</title>
+ <para>
+ If you have questions related to the use of JBoss Messaging, please ask in the <ulink url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=238">User Forum</ulink>.
+ </para>
+ <para>
+ If you have questions related to development with JBoss Messaging, please ask in the <ulink url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=153">Development Forum</ulink>.
+ </para>
+ <para>
+ You can also chat to us in our <ulink url="irc://irc.freenode.net:6667/jbossmessaging">IRC Channel</ulink>.
+ </para>
+ <para>
+ The JBoss Messaging Subversion Trunk is <ulink url="http://anonsvn.jboss.org/repos/messaging/trunk">here</ulink>.
+ </para>
+ <para>
+ All release tags are listed <ulink url="http://anonsvn.jboss.org/repos/messaging/tags">here</ulink>.
+ </para>
+ </section>
+</chapter>
\ No newline at end of file
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Download.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Examples.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Examples.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Examples.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,253 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="examples">
+ <title>Running the Examples</title>
+ <para>
+ There are two sets of examples in the <filename>example</filename> directory:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <emphasis>JMS Examples</emphasis>, which demonstrate functionality by sending and consuming JMS messages.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>Java EE Examples</emphasis>, which demonstrate aspects of application server integration, such as MDBs, Enterprise JavaBeans, Servlets, etc.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ All examples are run with <application>Apache Ant</application>. Ant must be installed on your system and the Ant <filename>bin</filename> directory must be included in your filepath.
+ </para>
+ <section id="examples.jms">
+ <title>The JMS Examples</title>
+ <para>
+ The JMS Examples follow the same format. Each example has its own directory, which contains the following:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><filename>build.xml</filename></term>
+ <listitem>
+ <para>
+ The Ant build file used to run the example.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><filename>src</filename> directory</term>
+ <listitem>
+ <para>
+ Contains the source code for the example.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><filename>server0</filename> configuration directory</term>
+ <listitem>
+ <para>
+ Contains the configuration files required to run the example server. There may be multiple configuration directories (<filename>server0</filename>, <filename>server1</filename>, etc.) for clustered examples.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ Each example starts one or more standalone servers, and stops them after the example has completed.
+ </para>
+ <para>
+ For this Quickstart Guide, we will run the Queue Example. For all other examples, refer to the JBoss Messaging User Guide.
+ </para>
+ <section id="examples.jms.queue">
+ <title>Running the Queue Example</title>
+ <para>
+ Use the command line interface to navigate to the <filename>examples/jms/queue</filename> directory.
+ </para>
+ <para>
+ Type the <command>ant</command> command. You should see the following output:
+ </para>
+ <programlisting>Buildfile: build.xml
+
+run:
+
+init:
+
+compile:
+ [echo] src.example.dir=/home/andy/projects/JBMTrunk/examples/jms/queue/src
+ [javac] Compiling 5 source files to /home/andy/projects/JBMTrunk/examples/jms/queue
+/build/classes
+
+runExample:
+ [java] 10:41:04,149 INFO @main [JMSExample] jbm.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/JBMTrunk/examples/jms/common/../../../src/config/stand-alone/no
+n-clustered/logging.properties
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:08,437 INFO @main [Journal
+StorageManager] AIO journal selected
+ [java] org.jboss.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.jboss.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 JBoss Messaging user guide for instructions o
+n how to do this.
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [JBossCo
+nnectionFactory] read only is false
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [JBossCo
+nnectionFactory] read only is false
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:10,941 INFO @main [JBossCo
+nnectionFactory] read only is false
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:10,991 WARN @main [JMSServ
+erManagerImpl] Binding for java:/ConnectionFactory already exists
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:10,991 WARN @main [JMSServ
+erManagerImpl] Binding for java:/XAConnectionFactory already exists
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:11,241 INFO @main [Messagi
+ngServerImpl] JBoss Messaging Server version 2.0.0.BETA1-SNAPSHOT (Stilton, 101) started
+ [java] org.jboss.jms.example.SpawnedJMSServer out:10:41:11,241 INFO @main [JBMBoot
+strapServer] JBoss Messaging server started
+ [java] org.jboss.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>
+ You have just successfully run your first JBoss Messaging example. We highly recommend trying the rest, to familiarize yourself with JBoss Messaging operations.
+ </para>
+ </section>
+ </section>
+ <section id="examples.messaging">
+ <title>The Java EE Examples</title>
+ <para>
+ The Java EE Examples require an application server. Follow the instructions in the previous chapters to install your application server, if you have not already done so.
+ </para>
+ <para>
+ For this Quickstart Guide, we will take you through the MDB Example. For all other examples, refer to the JBoss Messaging User Guide.
+ </para>
+ <important>
+ <title>Start your server</title>
+ <para>
+ Before you go any further, make sure that the JBoss Application Server (JBoss AS) instance is running, or the example will not run correctly.
+ </para>
+ </important>
+ <para>
+ The MDB Example is a J2EE application, so it must be deployed in JBoss AS. First, set the <literal>JBOSS_HOME</literal> environment property to the location of your JBoss AS installation. In a Linux shell, this would be:
+ </para>
+ <programlisting>
+export JBOSS_HOME=/home/jbossas5.1/build/output/jboss-5.1.0.GA
+ </programlisting>
+ <para>
+ Once this variable is set, deploy the application by moving to the <filename>examples/javaee/mdb</filename> directory and running <command>ant deploy</command>. This copies the messaging profile to the JBoss AS instance and starts the server.
+ </para>
+ <para>
+ You should see output similar to the following in the shell window:
+ </para>
+ <screen>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-jbm2/deploy/messaging.sar
+ [copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
+ /server/default-with-jbm2/deploy/messaging.sar
+
+init:
+
+compile:
+
+jar:
+ [jar] Building jar: /home/andy/projects/JBMTrunk/examples/javaee/mdb/build/mdb-exa
+ mple.jar
+
+ear:
+ [jar] Building jar: /home/andy/projects/JBMTrunk/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.jboss.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
+
+</screen>
+ <para>
+ Next, run the example from within the <filename>mdb</filename> directory with the <command>ant</command> command. You should see the following output:
+ </para>
+ <screen>Buildfile: build.xml
+
+run:
+
+init:
+
+compile:
+
+runExample:
+ [java] Sent message: This is a text message
+
+BUILD SUCCESSFUL
+Total time: 7 seconds
+ </screen>
+ <para>
+ You may see some additional output from your JBoss AS instance.
+ </para>
+ <screen>16:27:54,703 INFO [STDOUT] message This is a text message received</screen>
+ <para>
+ You can then undeploy the application by running <command>ant undeploy</command> from within the <filename>mdb</filename> directory. You should see the following output:
+ </para>
+ <screen>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-jbm2/deploy/mdb-example.ear
+ [delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
+ /server/default-with-jbm2/deploy/messaging.sar/jbm-queues.xml
+ [delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
+ /server/default-with-jbm2/deploy/messaging.sar/jbm-jms.xml
+
+BUILD SUCCESSFUL
+Total time: 1 second
+ </screen>
+ <para>
+ You can verify that the application has been undeployed by checking the output from the JBoss AS instance. In this case, it will be similar to the following:
+ </para>
+ <screen>16:36:45,277 INFO [EJBContainer] STOPPED EJB: org.jboss.javaee.example.server.MDBExample
+ ejbName: MessageMDBExample
+ </screen>
+ <para>
+ You have now successfully deployed and run a Java EE example. We strongly recommend running other examples to familiarize yourself with JBoss Messaging operations.
+ </para>
+ </section>
+</chapter>
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Examples.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Installation.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Installation.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Installation.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="installation">
+ <title>Installation</title>
+ <para>
+ This chapter shows you how to install JBoss Messaging 2.0.
+ </para>
+ <section id="installation.prerequisites">
+ <title>Prerequisites</title>
+ <note>
+ <para>
+ JBoss Messaging 2.0 runs on Java 5 or later. We highly recommend using Java 6.
+ </para>
+ </note>
+ <para>
+ By default, the JBoss Messaging server runs with 1 gigabyte of memory. If this amount of memory is not available, modify the value in <filename>bin/run.sh</filename> accordingly.
+ </para>
+ <para>
+ JBoss Messaging uses its own fast journal file for persistence. You can configure this file to use <literal>libaio</literal> (the Linux default) or Java NIO (Non-blocking Input/Output). The <literal>libaio</literal> module must be installed separately before you can use it with JBoss Messaging.
+ </para>
+ <para>
+ To install <literal>libaio</literal> using <application>yum</application>, run:
+ </para>
+ <programlisting>
+sudo yum install libaio
+ </programlisting>
+ <para>
+ To install <literal>libaio</literal> using <application>aptitude</application>, run:
+ </para>
+ <programlisting>sudo apt-get install libaio</programlisting>
+ <para>
+ You will require <ulink url="http://ant.apache.org/">Apache Ant</ulink> to create profiles for JBoss Application Server 5.0 and to run the JBoss Messaging examples.
+ </para>
+ </section>
+ <section id="installation.standalone">
+ <title>Standalone JBoss Messaging Server</title>
+ <para>
+ When you have downloaded the distribution, unzip it into your chosen directory. You should be able to run the distribution immediately (see <xref linkend="running.standalone" />). The directory structure is as follows:
+ </para>
+
+ <programlisting>
+ |-- bin
+ |-- config
+ | |-- jboss-as
+ | `-- stand-alone
+ |-- docs
+ | |-- api
+ | |-- quickstart-guide
+ | `-- user-manual
+ |-- examples
+ | |-- core
+ | |-- javaee
+ | `-- jms
+ |-- lib
+ |-- licenses
+ `-- schemas
+ </programlisting>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>bin</filename> — contains the binaries and scripts required to run JBoss Messaging.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>config</filename> — contains the configuration files required to run JBoss Messaging as a standalone, or within JBoss AS 5. Refer to the User Guide for details about configuring JBoss Messaging.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>docs</filename> — contains guides and Java Docs for JBoss Messaging.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>examples</filename> — contains example applications demonstrating the use of Java Message Service and Java Enterprise Edition. For details on running these examples, refer to the Running Examples chapter.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>lib</filename> — contains the JARs and libraries required to run JBoss Messaging.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>licenses</filename> — contains the licenses for JBoss Messaging.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>schemas</filename> — contains the XML Schemas used to validate JBoss Messaging configuration files.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="installation.jboss">
+ <title>JBoss Messaging in JBoss Application Server 5.0</title>
+ <para>
+ You can deploy JBoss Messaging 2.0 in <ulink url="http://www.jboss.org/jbossas/">JBoss Application Server 5.0</ulink> (JBoss AS 5). Since JBoss Messaging is not shipped with JBoss AS by default, you must first create new JBoss AS profiles. To do so:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Download JBoss AS 5.0.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Set the <literal>JBOSS_HOME</literal> environment property to point to the directory in which you installed JBoss AS 5.0.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Run <command>ant</command> in the <filename>config/jboss-as</filename> directory of your JBoss Messaging installation.
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ This creates two new profiles in the <filename>$JBOSS_HOME/server</filename> directory.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>default-with-jbm2</literal> — corresponds to the JBoss AS <literal>default</literal> profile, and uses JBoss Messaging 2.0 as its JMS provider. In this profile, JBoss Messaging is not clustered.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>all-with-jbm2</literal> — corresponds to the JBoss AS <literal>all</literal> profile, and uses JBoss Messaging 2.0 as its JMS provider. In this profile, JBoss Messaging is clustered.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ You can then start JBoss AS 5.0 using either of these profiles, like so:
+ </para>
+ <programlisting>
+$JBOSS_HOME/bin/run.sh -c default-with-jbm2
+ </programlisting>
+ </section>
+</chapter>
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Installation.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Introduction.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Introduction.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Introduction.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="introduction">
+ <title>Getting Started</title>
+ <para>
+ This book is a brief guide to downloading, installing and getting started with JBoss Messaging.
+ </para>
+ <para>
+ After you have downloaded and installed JBoss Messaging, we highly recommend running the examples to acquaint yourself with JBoss Messaging and its features.
+ </para>
+ <para>
+ This guide is not intended as a replacement for the JBoss Messaging User Guide. The User Guide contains far greater detail, and should be consulted for further information.
+ </para>
+</chapter>
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Introduction.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Running_JBM.xml
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Running_JBM.xml (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Running_JBM.xml 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="running">
+ <title>Starting The Server</title>
+ <section id="running.standalone">
+ <title>Standalone JBoss Messaging</title>
+ <para>
+ To run a standalone server, navigate to the <filename>bin</filename> directory via the command line interface. Execute <command>./run.sh</command> (or <command>run.bat</command> on Windows). You should see the following output:
+ </para>
+ <screen>
+bin$ ./run.sh
+
+15:05:54,108 INFO @main [JBMBootstrapServer] Starting JBoss Messaging server
+...
+15:06:02,566 INFO @main [MessagingServerImpl] JBoss Messaging Server version
+2.0.0.BETA1-SNAPSHOT (Stilton, 101) started
+ </screen>
+ <para>
+ If so, JBoss Messaging is now running. If any errors are displayed, or if the server was not started properly, refer to the Troubleshooting section for assistance.
+ </para>
+ <para>
+ Both the run and stop scripts use the configuration listed in <filename>config/stand-alone/non-clustered</filename> by default. You can change the configuration by running <command>./run.sh ../config/stand-alone/non-clustered</command> (or another preferred configuration). The same applies to the stop script and the Windows <filename>bat</filename> files.
+ </para>
+ </section>
+ <section id="running.jboss.as">
+ <title>JBoss Messaging in JBoss Application Server 5</title>
+ <para>
+ To run JBoss Messaging in JBoss AS 5, you must first create JBoss AS profiles for JBoss Messaging, as described in <xref linkend="installation.jboss" />. To run JBoss AS 5 with a non-clustered JBoss Messaging server, go to your <filename>$JBOSS_HOME/bin</filename> directory and type <command>./run.sh -c default-with-jbm2</command>.
+ </para>
+ <screen>
+bin$ ./run.sh -c default-with-jbm2
+
+15:18:35,460 INFO [ServerImpl] Starting JBoss (Microcontainer)...
+15:18:35,462 INFO [ServerImpl] Release ID: JBoss [The Oracle] 5.1.0.CR1 (build:
+SVNTag=JBoss_5_1_0_CR1 date=200904091504)
+...
+15:19:30,305 INFO [MessagingServerImpl] JBoss Messaging Server version
+2.0.0.BETA1-SNAPSHOT (Stilton, 101) started
+...
+15:19:43,601 INFO [ServerImpl] JBoss (Microcontainer) [5.1.0.CR1 (build:
+SVNTag=JBoss_5_1_0_CR1 date=200904091504)] Started in 1m:8s:121ms
+ </screen>
+ </section>
+</chapter>
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/en-US/Running_JBM.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/publican.cfg
===================================================================
--- projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/publican.cfg (rev 0)
+++ projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/publican.cfg 2010-02-22 07:26:12 UTC (rev 7953)
@@ -0,0 +1,7 @@
+# Config::Simple 4.59
+# Wed Nov 25 15:02:20 2009
+
+debug: 1
+xml_lang: en-US
+brand: JBoss
+
Property changes on: projects/eap-docs/tags/JBoss_Messaging_User_Guide_EAP_5_0_1/HornetQ/HornetQ_Quick_Start_Guide/publican.cfg
___________________________________________________________________
Name: svn:executable
+ *
More information about the jboss-cvs-commits
mailing list