Author: antelder
Date: Thu Feb 14 08:51:14 2008
New Revision: 627799
URL: http://svn.apache.org/viewvc?rev=627799&view=rev
Log:
add readme
Added:
incubator/tuscany/java/sca/samples/helloworld-jms-webapp/README (with
props)
Modified:
incubator/tuscany/java/sca/samples/helloworld-jms-webapp/ (props changed)
Propchange: incubator/tuscany/java/sca/samples/helloworld-jms-webapp/
------------------------------------------------------------------------------
--- svn:ignore (added)
+++ svn:ignore Thu Feb 14 08:51:14 2008
@@ -0,0 +1,18 @@
+target
+work
+dojo
+*.iws
+*.ipr
+*.iml
+.project
+.classpath
+derby.log
+maven.log
+velocity.log*
+junit*.properties
+surefire*.properties
+.settings
+.deployables
+.wtpmodules
+.externalToolBuilders
+activemq-data
Added: incubator/tuscany/java/sca/samples/helloworld-jms-webapp/README
URL:
http://svn.apache.org/viewvc/incubator/tuscany/java/sca/samples/helloworld-jms-webapp/README?rev=627799&view=auto
==============================================================================
--- incubator/tuscany/java/sca/samples/helloworld-jms-webapp/README (added)
+++ incubator/tuscany/java/sca/samples/helloworld-jms-webapp/README Thu Feb 14
08:51:14 2008
@@ -0,0 +1,136 @@
+JMS HelloWorld Sample
+=====================
+This sample uses the same code as the calculator sample but deploys the
+sample wrapped in a web app.
+
+The README in the samples directory (the directory above this) provides
+general instructions about building and running samples. Take a look there
+first.
+
+As this sample provides a web app there is a manual step where the WAR file
+that contains the sample is copied to your web app container. If you just want
+to give this sample a go deploy the WAR file (target/
sample-helloworld-jms-webapp.war )
+to you web application server.
+
+Once the web app is deployed use your browser to visit the following URL;
+
+http://localhost:8080/sample-helloworld-jms-webapp/
+
+The port and hostname will of course vary depending on your local
installation.
+
+
+Configuring the JMS resources
+-----------------------------
+
+The sample requires JMS resources be manually configured in the server
environment, these are:
+
+- a JMS connection factory named "ConnectionFactory"
+- a JMS queue named "RequestQueue"
+- a JMS queue named "ResponseQueue"
+
+See the following for how to define these resources depending on the
application server being used:
+
+Tuscany with embedded ActiveMQ broker
+-------------------------------------
+
+
+Apache Tomcat
+-------------
+
+Tomcat doesn't by default include a JMS broker so first install Apache
ActiveMQ into Tomcat:
+
+
+
+Apache Geronimo
+---------------
+
+For Apache Geronimo 2.0.1 (2.0.2 fails to define JMS resources for me)
+
+Logon to the Geronimo Server Console (http://localhost:8080/console, uid
system, pswd manager)
+
+In the Console Navigation on the left under Services click JMS Resources
+
+At the bottom of the JMS Resources panel click under Create a new JMS Resource
Group click For ActiveMQ
+
+In Resource Group Name enter "MyRGN" and click next
+
+At JMS Resource Group click Add Connection Factory
+
+For JMS Factory Type choose javax.jms.ConnectionFactory and click Next
+
+In Connection Factory Name enter "ConnectionFactory" and click Next
+
+Click Add destination
+
+For JMS Destination Type choose javax.jms.Queue and click Next
+
+Enter "RequestQueue" for both Message Destination Name and PhysicalName and
click Next
+
+Click Add destination to add another queue as above this time named
"ResponseQueue"
+
+Click Deploy Now
+
+Thats it, you're done.
+
+
+WebSphere
+---------
+
+To define the JMS resources in a new WebSphere Application Server 6.1
installation:
+
+1) First define a Service integration bus:
+
+Logon to the WebSphere Integrated Solutions Console
(http://localhost:9060/ibm/console)
+
+On the Left hand menu expand Service integration, and click on Buses.
+
+In the Buses panel click on New
+
+Enter a name for the bus, eg MyBus, and click Next, and then click Finish and
Save the changes.
+
+In the Buses panel click on MyBus
+
+Find the Topology secion and click on Bus members
+
+Click on Add, leave the defaults and click Next, Next, Next, Finish, and Save
the changes.
+
+Restart WebSphere and when back up logon back on to the Integrated Solutions
Console
+
+2) Now define the JMS rescources
+
+On the Left hand menu expand Resources, and JMS and click on Connection
Facotories.
+
+In the Connection factories panel click New.
+
+Leave the Default messaging provider and click OK
+
+Enter "ConnectionFactory" in the Name and JNDI name and in the Bus name in the
Connection pane choose MyBus and click OK
+
+On the Left hand menu in JMS click on Queues
+
+In the Queues panel click New, accept the defaults and click OK
+
+Enter "RequestQueue" for the Name and JNDI name and in the Bus name in the
Connection pane choose MyBus,
+and then in the Queue name drop down list choose "Create SIB destination"
+
+In the Set queue attributes panel enter "RequestQueue" for the Identifier and
click Next, Next, and Finish
+
+That should take you back to the Queues panel where you can click OK to create
the new JMS queue.
+
+Back at the Queues front panel repeat the procedure to create a queue named
"ResponseQueue"
+
+Save the changes
+
+Restart WebSphere and you're done.
+
+
+
+Others...
+---------
+
+
+
+
+
+
+
\ No newline at end of file
Propchange: incubator/tuscany/java/sca/samples/helloworld-jms-webapp/README
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: incubator/tuscany/java/sca/samples/helloworld-jms-webapp/README
------------------------------------------------------------------------------
svn:mime-type = text/plain
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
