Deploying XBikes on WebSphere Application Server 5.0 on Multiple Computers | Application Interoperability: Microsoft .NET and J2EE: Microsoft(r) .Net and J2ee (Patterns & Practices)

To install XBikes in a multi-computer configuration, you need three computers for the Presentation tier, Business tier, and Data tier respectively. All three computers need the following setup:

Windows 2000 Server with Service Pack 3 or later in Workgroup mode
A default installation of GLUE 4.1.2 Professional

Note

You must install a valid GLUE license file into Glue.jar. See the GLUE documentation for help.

Data Tier Computer Setup

The Data tier computer requires the following components to be installed:

Microsoft SQL Server 2000 with mixed mode security and Service Pack 3
Microsoft JDBC Driver for Microsoft SQL Server 2000
A custom installation of IBM WebSphere MQ 5.3, as described in the “Configuring IBM WebSphere MQ 5.3” section earlier in this appendix.
The XBikesQ message queue, as described in the “Creating the XBikesQ Queue” section earlier in this appendix.
A custom installation of IBM WebSphere Application Server 5.0, as described in the “Installing WebSphere Application Server 5.0” section earlier in this appendix, including the messaging client installation in steps 3 and 4.

Installing XBikes into the Data Tier

To install the XBikes sample code and XBikes database for the J2EE platform, complete the following steps.

Note

Check again that your system meets the prerequisites listed at the beginning of this section.

To install the XBikes application into the Data tier

Open Windows Explorer, and then double-click xbikesj2ee.msi.
On the Welcome to the XBikes J2EE Setup Wizard page, click Next.
In the Installation Options dialog box, make sure Data Access Layer Only is selected, and then click Next.
In the second Installation Options dialog box, make sure the Install Source Code, Install Database, and Install to WebSphere Application Server 5.0 (uncheck for single tier WSAD only) check boxes are selected.

Note
You do not need to install the source code unless you want to look at the code.

Click Next to continue.
In the Confirm Installation dialog box, click Next to begin the installation.
In the MQ Configuration dialog box, enter the correct queue manager name, and then click OK. Note that this name is case sensitive. You should have made a note of this when installing WebSphere MQ. If not, you can find the name of the queue manager in WebSphere MQ Explorer.
The installation copies the XBikes sample code, installs the XBikes database, and configures the application server.
When the installation is complete, click Close.

Business Tier Computer Setup

The Business tier computer requires a custom installation of IBM WebSphere Application Server 5.0. Follow the instructions in the “Installing WebSphere Application Server 5.0” section earlier in this appendix, except instead of choosing Client Only, choose Server and Client for the Embedded Messaging.

To install the XBikes sample code for the J2EE platform, complete the following steps.

Note

Check again that your system meets the prerequisites listed at the beginning of this section.

To install the XBikes application into the Business tier

Open Windows Explorer, and then double-click xbikesj2ee.msi.
On the Welcome to the XBikes J2EE Setup Wizard page, click Next.
In the Installation Options dialog box, make sure Business Logic Layer Only is selected, and then click Next.
In the second Installation Options dialog box, make sure the Install Source Code check box is selected, the Install Database check box is not selected, and the Install to WebSphere Application Server 5.0 (uncheck for single tier WSAD only) check box is selected.

Note
You do not need to install the source code unless you want to look at the code.

Click Next to continue.
In the Confirm Installation dialog box, click Next.
In the MQ Configuration dialog box, enter the correct queue manager name, and click OK. Note that this the name of the queue manager installed on the Data tier and the name is case sensitive. You should have made a note of this when installing WebSphere MQ on the Data tier. If not, you can find the name of the queue manager in WebSphere MQ Explorer.
In the next MQ Configuration dialog box, enter the host name of the computer running WebSphere MQ. This should be the name of the Data tier computer. The installation routine makes a best guess based upon the queue manager name you entered earlier.
The installation copies the XBikes sample code and configures the application server.
When the installation is complete, click Close.

Presentation Tier Computer Setup

The Presentation tier computer requires a custom installation of IBM WebSphere Application Server 5.0. Follow the instructions in the “Installing WebSphere Application Server 5.0” section earlier in this appendix, excluding the messaging client installation in steps 3 and 4.

To install the XBikes sample code for the J2EE platform, complete the following steps.

Note

Check again that your system meets the prerequisites listed at the beginning of this section.

To install the XBikes application into the Presentation tier

Open Windows Explorer, and then double-click xbikesj2ee.msi.
On the Welcome to the XBikes J2EE Setup Wizard page, click Next.
In the Installation Options dialog box, make sure Web Tier is selected, and then click Next.
In the second Installation Options dialog box, make sure the Install Source Code check box is selected, the Install Database check box is not selected, and the Install to WebSphere Application Server 5.0 (uncheck for single tier WSAD only) check box is selected.

Note
You do not need to install the source code unless you want to look at the code.

Click Next to continue.
In the Confirm Installation dialog box, click Next. The installation copies the XBikes sample code and configures the application server.
When the installation is complete, click Close.

Configuring the XBikes Application

Now that you have installed XBikes, you must configure the Web tier and the Business tier to use the correct JNDI servers.

To configure the Web tier for JNDI lookups

On the Web tier computer, open the C:\Xbikes\Config\Webconfig.xml configuration file in Notepad.
Locate the <iiop> tag.
Change localhost in the iiop entry to the IP address of the server containing the business tier.
Save the file.

To configure the Business tier for JNDI lookups

On the Business tier computer, open the C:\Xbikes\Config\Bllconfig.xml configuration file in Notepad.
Locate the <iiop> tag.
Change localhost in the iiop entry to the IP address of the server containing the data tier.
Save the file.

Running the XBikes Application

You are now ready to run the XBikes application. Make sure you start the computers in the following order: Data tier, Business tier, and then Presentation tier. After all the computers start, open a browser window on the Presentation tier computer, and then enter http://localhost:9080/XBikesWeb.

Note

XBikesWeb is case sensitive.