Installing the Quote Streamer Sample application for WebSphere® Application Server Version 6.0.X

This section describes the procedure for installing the QuoteStreamer Sample application into Version 6.0.X of the application server.  It is assumed that you are familiar with application installation and administration for the application server.

Before you begin:

Locate the QuoteStreamer Sample enterprise application archive (EAR) file that is provided with this documentation.  Depending on how you obtained this Sample application, you can find the EAR in one of two places:

Verify that IBM WebSphere Application Server Version 6.0 Feature Pack for Web 2.0, Version 1.0.1 is installed:

The feature pack includes the Web messaging service runtime library and must be installed for the QuoteStreamer sample app to function. Refer to the Feature Pack for Web 2.0 installation instructions for more information on installing the Feature Pack for Web 2.0.

Enable the Web messaging service:

  1. Log into the administrative console for the application server.
  2. Navigate to Servers > Application Servers.
  3. Select the current application server.
  4. Expand Web Container Settings and select Web container transport chains.
  5. Select WCInboudDefault transport chain or select the transport chain that corresponds to the virtual host that you select during application installation.
  6. Select Web Container Inbound Channel.
  7. Select Custom Properties.
  8. Click New.
  9. Enter webmsgenabled for the name property and true for the value.
  10. Click Apply.
  11. Click Save to save the repository information.
  12. You can restart the application server now or wait until you configure the service integration bus.

Configure a service integration bus

Installation instructions assume stand-alone server installation, instructions might differ in Network Deployment environment.
  1. Log into the administrative console for the application server.
  2. Navigate to Service integration > Buses in the left menu.
  3. Click New.
  4. Enter the name "thebus". Uncheck the checkbox labeled 'secure' if it is checked. Click Next
  5. Click Apply.
  6. Click the Bus members link under Topology on the "thebus" detail page.
  7. Click Add.
  8. Select the server where you want the application installed, and click Next.
  9. Click finish.
  10. Click Save to save the repository information.
  11. Restart the application server.
Create a topic connection factory
  1. Log into the administrative console for the application server.
  2. Navigate to Resources > JMS Providers > Default messaging in the left menu.
  3. Select the JMS topic connection factory link under Connection Factories.
  4. Click New.
  5. Enter QuoteStreamer for name, jms/QuotePublish for JNDI name, and thebus for Bus name.
  6. Keep the defaults for the rest of the fields.
  7. Click Apply.
  8. Click Save to save the repository information. 
Installation through the administrative console:
  1. Log into the administrative console for the application server.
  2. Navigate to Applications > Install New Application in the left menu.
  3. Browse your file system and select the IBM_QuoteStreamer.ear file that you located earlier, and click next
  4. Click Next (Preparing for the application installation).
  5. Click Continue (Application Security Warnings)
  6. Click Next. Take the defaults for installation options.
  7. Click Next. Take the defaults for map modules to servers.
  8. Input the JNDI name for the exsisting CommonJ timer in JNDI name field. Use tm/default, or input preexisting commonj timer.
  9. Select authentication method, none, for jms/QuotePublish reference.
  10. Click Next.
  11. Click Continue if warning ADMA8019E is displayed.
  12. Click Next. Take the defaults for map virtual hosts for Web modules.
  13. Review the summary of the installation options.
  14. Click Finish.
  15. Click Save to the master configuration.
  16. Select Save.
  17. Naviate to Applications > Enterprise Applications.
  18. Select the QuoteStreamer_Sample and hit start.
  19. Access the installed application
    Point your Web browser to your application server installation: http://<application server hostname>:<port>/quotestreamer.
    The application server host name and port is specific to your application server installation. An application server default installation Web container port is 9080. If you are running your browser on the same workstation as your application server installation and have taken all the default values, then use the following URL:
    http://localhost:9080/quotestreamer.
  20. Simulated quotes are delivered to the browser immediately when you load the page. Click Stop stock quotes to stop incoming quotes. Click the Resume stock quotes to resume the quotes.