Installing the Quote Streamer Sample application for WebSphere® Application Server Version 6.1.x
It is assumed you are familiar
with application installation and administration into WebSphere®
Application Server.
Before you begin:
Locate the QuoteStreamer sample enterprise
application archive (EAR) that is provided with this
documentation. Depending on how you obtained this sample
application, you can find the EAR in one of two places:
- If you are reading these
instructions from within Eclipse help because
you installed this file as an Eclipse feature, then you can locate the EAR file in the following directory:
Linux® and UNIX®: <ECLIPSE_HOME>/plugins/com.ibm.websphere.webmsg.quotestreamer_1.5.0/IBM_QuoteStreamer.ear.
|
Windows(TM):
<ECLIPSE_HOME>\plugins\com.ibm.websphere.webmsg.quotestreamer_1.5.0\IBM_QuoteStreamer.ear.
|
- If you have installed the Feature Pack for Web 2.0, you
can find the EAR in your installation tree. For
example, if you installed the feature pack to:
Linux and UNIX:
/opt/WebSphere/AppServer |
z/OS mount point: <WAS_HOME>
|
Windows:
c:\WebSphere\AppServer
|
Then you can find the EAR and library files at:
Linux and UNIX:
/opt/WebSphere/AppServer/web2fep/samples/QuoteStreamer/IBM_QuoteStreamer.ear.
|
z/OS: <WAS_HOME>/web2fep/samples/QuoteStreamer/IBM_QuoteStreamer.ear
|
Windows:
c:\WebSphere\AppServer\web2fep\samples\QuoteStreamer\IBM_QuoteStreamer.ear.
|
Verify that the
Feature Pack for Web 2.0 is installed:
The Feature Pack for Web 2.0 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:
- Log into the administrative console of WebSphere Application
Server.
- Navigate to Servers >Application Servers
- Select current application server.
- Expand Web Container Settings and select Web container
transport chains.
- Select WCInboudDefault transport chain or select transport
chain that corresponds to the Virtual Host you will select during
application install.
- Select Web Container Inbound Channel.
- Select Custom Properties.
- Click New.
- Enter webmsgenabled for the name property and true for the
value.
- Click Apply.
- Click Save to save the repository information.
- You can restart the application server now or wait until after
the Configure Service Integration Bus step.
Configure a service integration bus:
Installation instructions assume stand-alone server installation, instructions might differ in Network Deployment environment.
- Log into the administrative console of
WebSphere Application Server.
- Navigate
to Service integration > Buses.
- Click New.
- Enter the name "thebus". Uncheck the Bus security checkbox option if possible. Click Next.
- Click Finish on Confirm create bus panel.
- Click Bus members link under Topology on the "thebus" detail page.
- Click Add.
- Select the server where you want the application installed and click Next.
- Keep default for Select type of Message Store panel and click Next.
- Keep default for Provide the Message Store properties panel and click Next.
- Click Finish.
- Save changes to repository.
- Restart the application server.
Create a topic connection
factory:
- Log into the administrative console of WebSphere Application
Server.
- Navigate to Resources > JMS > Topic connection factories.
- Select scope. A server level scope is sufficient.
- Click New.
- Select Default messaging provider and click OK.
- Enter QuoteStreamer for name, jms/QuotePublish for JNDI name,
and thebus for Bus name.
- Keep defaults for the rest of the fields.
- Click Apply
- Click Save to save the repository information.
Install through the administrative console:
- Log into the administrative console of
WebSphere Application Server.
- Navigate
to Applications > Install New Application.
- Browse your file system and select the IBM_QuoteStreamer.ear file
that
you located earlier and click Next.
- Keep defaults and click Next (Select installation options).
- Click Next (Map modules to servers).
- Click Finish.
- Click Save to the master configuration.
- Select Save.
- Naviate to Applications > Enterprise Applications.
- Select the QuoteStreamer_Sample and hit start.
- Accessing the installed application:
Point your Web browser to your WebSphere application installation:
http://<application server hostname>:<port>/quotestreamer
NOTE: The application server host name and port is specific to your WebSphere Application Server installation. A WebSphere Application Server
default installation Web container port is 9080. So, if you are running your
browser on the same machine as your WebSphere installation and have taken all
the defaults, a URL that should work is:
http://localhost:9080/quotestreamer
- Simulated quotes will be delivered to the browser immediately upon page load. Click Stop stock quotes to stop incoming quotes. Click Resume stock quotes to resume the quotes.