Installing the Quote Streamer Sample application for WebSphere® Application Server Version 7.0
This section describes the procedure for installing
the QuoteStreamer sample application into WebSphere® Application Server Version 7.0. 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.
- If you have installed the Feature Pack for Web 2.0, then 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/web2mobilefep_1.1/samples/QuoteStreamer/IBM_QuoteStreamer.ear.
|
z/OS: <WAS_HOME>/web2mobilefep_1.1/samples/QuoteStreamer/IBM_QuoteStreamer.ear
|
Windows:
c:\WebSphere\AppServer\web2mobilefep_1.1\samples\QuoteStreamer\IBM_QuoteStreamer.ear.
|
Verify that the
Feature Pack for Web 2.0 and Mobile is installed:
The Feature Pack for Web 2.0 and Mobile 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 and Mobile installation instructions for more information on installing the Feature Pack for Web 2.0 and Mobile.
Enable the Web messaging
service:
- Log into the administrative console of WebSphere Application
Server.
- Navigate to Servers->Server Types->WebSphere 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 installation.
- 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 defaults for Configure file store panel and click Next.
- Keep defaults for Tune performance parameters 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 > New Applications.
- Select New Enterprise Application.
- Browse your file system and select the IBM_QuoteStreamer.ear file
that
you located earlier and click next.
- Select Fast Path option 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 > Application Types > WebSphere enterprise applications.
- Select the QuoteStreamer application and click 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 are 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. Clicking Stop stock quotes stops incoming quotes. Clicking Resume stock quotes button resuming the quotes.