Chapter 3. Running the JBoss Enterprise SOA Platform in a Testing Environment

Procedure 3.1. Start the JBoss Enterprise SOA Platform

• Start the SOA server in a server window

  • Red Hat Enterprise Linux

    1. Open a terminal and navigate to the bin directory by entering the command cd SOA_ROOT/jboss-as/bin.
    2. Enter ./run.sh to start the SOA server. (Because you are not specifying a server profile, "default" will be used.)

  • Microsoft Windows

    1. Open a terminal and navigate to the bin directory by entering the command chdir SOA_ROOT\jboss-as\bin.
    2. Enter run.bat to start the SOA server. (Because you are not specifying a server profile, "default" will be used.)

Procedure 3.2. Deploy the "Hello World" Quickstart

1. Check that the server has fully launched.
2. Open a second terminal window and navigate to the directory containing the quick start: cd SOA_ROOT/jboss-as/samples/quickstarts/helloworld (or chdir SOA_ROOT\jboss-as\samples\quickstarts\helloworld in Microsoft Windows).
3. Run ant deploy to deploy the quickstart. Look for messages such as this to confirm if the deployment was successful:

   deploy-esb:
        [copy] Copying 1 file to
   /jboss/local/53_DEV2/jboss-soa-p-5/jboss-as/server/default/deploy
   
   deploy-exploded-esb:
   
   quickstart-specific-deploys:
        [echo] No Quickstart specific deployments being made.
   
   display-instructions:
        [echo] 
        [echo] ******************
        [echo] Quickstart deployed to target JBoss ESB/App Server at
   '/jboss/local/53_DEV2/jboss-soa-p-5/jboss-as/server/default/deploy'.
        [echo] 1.  Check your ESB Server console to make sure the deployment was
   executed without errors.
        [echo] 2.  Run 'ant runtest' to run the Quickstart.
        [echo] 3.  Check your ESB Server console again.  The Quickstart should
   have produced some output.
        [echo] ******************
   
   deploy:
   
   BUILD SUCCESSFUL
   

   Also, check for this in the SOA_ROOT/jboss-as/server/default/log/server.log:

   10:58:52,998 INFO  [NamingHelper] JNDI InitialContext properties:{}
   11:00:58,154 INFO  [QueueService]
   Queue[/queue/quickstart_helloworld_Request_esb] started, fullSize=200000,
   pageSize=2000, downCacheSize=2000
   11:00:58,186 INFO  [QueueService]
   Queue[/queue/quickstart_helloworld_Request_gw] started, fullSize=200000,
   pageSize=2000, downCacheSize=2000
   11:00:58,427 INFO  [EsbDeployment] Starting ESB Deployment
   'Quickstart_helloworld.esb'
   

4. Run the quickstart by issuing this command: ant runtest. When the quickstart is run, messages such as this are written to the SOA_ROOT/jboss-as/server/default/log/server.log:

   11:03:02,190 INFO  [STDOUT] &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
   11:03:02,191 INFO  [STDOUT] Body: Hello World
   11:03:02,191 INFO  [STDOUT] &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
   11:03:02,192 INFO  [STDOUT] Message structure: 
   11:03:02,192 INFO  [STDOUT] [Hello World].
   

Procedure 3.3. Task

1. Navigate to the quickstart's directory: cd SOA_ROOT/jboss-as/samples/quickstarts/helloworld (or chdir SOA_ROOT\jboss-as\samples\quickstarts\helloworld if you are running Microsoft Windows).
2. Run the ant undeploy command. You should see messages such as this displayed:

   undeploy:
   [delete] Deleting:
   /jboss/local/53_DEV2/jboss-soa-p-5/jboss-as/server/default/deploy/Quickstart_helloworld.esb
   
   BUILD SUCCESSFUL
   

   And messages such as this written to the server.log:

   11:10:08,205 INFO  [EsbDeployment] Stopping 'Quickstart_helloworld.esb'
   11:10:08,577 INFO  [EsbDeployment] Destroying 'Quickstart_helloworld.esb'
   

Procedure 3.4. Stop the JBoss Enterprise SOA Platform Server

• Stop the SOA server

  Press ctrl-c in the server window (the terminal window where the SOA server was started).