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:
- 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.4.0/IBM_QuoteStreamer.ear
|
Windows(TM):
<ECLIPSE_HOME>\plugins\com.ibm.websphere.webmsg.quotestreamer_1.4.0\IBM_QuoteStreamer.ear
|
- If you have installed the IBM WebSphere Application Server Version 6.0 Feature Pack for Web 2.0, Version 1.0, then you
can find the EAR file in your installation tree. For
example, if you installed the feature pack in the following location:
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 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:
- Log into the administrative console for the application server.
- Navigate to Servers > Application Servers.
- Select the current application server.
- Expand Web Container Settings and select Web container transport chains.
- Select WCInboudDefault transport chain or select the transport chain that corresponds to the virtual host that you 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 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.
- Log into the administrative console for the application server.
- Navigate
to Service integration > Buses in the left menu.
- Click New.
- Enter the name "thebus". Uncheck the checkbox labeled 'secure' if it is checked. Click Next
- Click Apply.
- Click the Bus members link under Topology on the "thebus" detail page.
- Click Add.
- Select the server where you want the application installed, and click Next.
- Click finish.
- Click Save to save the repository information.
- Restart the application server.
Create a topic connection factory
- Log into the administrative console for the application server.
- Navigate
to Resources > JMS Providers > Default messaging in the left menu.
- Select the JMS topic connection factory link under Connection Factories.
- Click New.
- Enter QuoteStreamer for name, jms/QuotePublish for JNDI name, and thebus for Bus name.
- Keep the defaults for the rest of the fields.
- Click Apply.
- Click Save to save the repository information.
Installation through the administrative console:
- Log into the administrative console for the application server.
- Navigate
to Applications > Install New Application in the left menu.
- Browse your file system and select the IBM_QuoteStreamer.ear file
that
you located earlier, and click next.
- Click Next (Preparing for the application installation).
- Click Continue (Application Security Warnings)
- Click Next. Take the defaults for installation options.
- Click Next. Take the defaults for map modules to servers.
- Input the JNDI name for the exsisting CommonJ timer in JNDI name field. Use tm/default, or input preexisting commonj timer.
- Select authentication method, none, for jms/QuotePublish reference.
- Click Next.
- Click Continue if warning ADMA8019E is displayed.
- Click Next. Take the defaults for map virtual hosts for Web modules.
- Review the summary of the installation options.
- Click Finish.
- Click Save to the master configuration.
- Select Save.
- Naviate to Applications > Enterprise Applications.
- Select the QuoteStreamer_Sample and hit start.
- 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.
- 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.