Deploying XBikes on WebSphere Application Server 5.0 on a Single Computer

Before you begin, install and configure the following software on a single computer in the following order:

1. Windows 2000 Server with Service Pack 3 or higher in Workgroup mode

2. Microsoft SQL Server 2000 with mixed mode security and Service Pack 3

3. Microsoft JDBC Driver for Microsoft SQL Server 2000

4. A custom installation of WebSphere Application Server 5.0 (described in the following section)

5. IBM WebSphere MQ 5.3

6. A default installation of GLUE 4.1.2 Professional

Note

You must install a valid license file into Glue.jar. For information about how to do this, see the GLUE documentation.

Installing WebSphere Application Server 5.0

To install IBM WebSphere Application Server 5.0, make sure you have downloaded the following files from the IBM Web site (http://www7b.software.ibm.com/wsdd/downloads/):

• Ibmwas5_trial_for_nt.zip

• Messaging_trial_for_nt.zip

Note

You must add the messaging component from the Messaging_trial_for_nt.zip file as described in steps 3 and 4 in the following procedure.

After you download these components, complete the following steps.

To install IBM WebSphere Application Server 5.0

1. Expand the Ibmwas5_trial_for_nt.zip archive into the C:\Ibmwas5_trial_for_nt folder.

2. After the IBM WebSphere Application Server 5.0 installation files extract, unzip Messaging_trial_for_nt.zip to a folder of your choice.

3. Copy the Messaging folder from where you unzipped Messaging_trial_for_nt.zip and make it a subdirectory of the WebSphere installation folder, C:\Ibmwas5_trial_for_nt. (The Ibmwas5_trial_for_nt folder now contains seven subdirectories, one of which is Messaging.)

4. In the Ibmwas5_trial_for_nt folder, double-click Install.exe.

5. In the Installation Wizard dialog box, click English, and then click OK.

6. In the Installation Wizard introduction screen, click Next.

7. Click Custom setup, and then click Next.

8. On the Select the features for “IBM WebSphere Application Server for Developers, Version 5” you would like to install screen, make sure the check boxes for the following components are selected or not selected, as specified:

   • Application Server — Selected

   • Application Server Samples — Not selected

   • Administration — Selected (including all subcomponents)

   • Application Assembly and Deployment Tools — Selected (including all subcomponents)

   • Embedded Messaging — Selected

     • Server and Client — Not selected

     • Client Only — Selected

     • Message-driven Bean Samples — Not selected

   • Web Server Plugins — Selected

     • IBM HTTP Server — Not selected

     • Apache, Microsoft IIS and IPlanet — Not selected

     • Lotus Domino Web Server — Not selected

   • Performance and Analysis Tools — Not selected

   • Javadocs — Not selected

9. Click Next.

10. Do not install to the default location. In the target path for the program files, enter C:\WAS\WebSphere\AppServer, and then click Next.

11. Accept the default settings for Node Name, enter your computer’s IP address in the Host Name or IP Address field, click Next.

12. Clear the Run WebSphere Application Server as a service check box, and then click Next.

13. In the installation summary screen, make sure the details are correct, and then click Next.

14. When the installation is complete, click Finish.

15. If a WebSphere Application Server First Steps Version 5.0 page appears, click Exit.

Installing and Configuring IBM WebSphere MQ 5.3

To install and configure IBM WebSphere MQ 5.3, you have to do a custom installation of IBM WebSphere MQ, adding support for Java messaging. To do this, complete the following steps.

To install IBM WebSphere MQ

1. Open Windows Explorer, and then double-click WebSphereMQ_t_en_us.exe.

2. In the WebSphere MQ (Evaluation Copy) dialog box, click Next.

3. The Location to Save Files page prompts you for a folder that you want to extract the installation files to. Note that this is not the directory into which you install IBM WebSphere MQ. The default folder is C:\Program Files\IBM\Source\WebSphere MQ t_en_us. Either accept the default value, enter a new directory, or click the Change button to browse for a directory, and then click Next to continue. The installation process extracts the WebSphere MQ installation files into the directory you specified.

4. After the installation files extract, the WebSphere MQ Installation dialog box appears. Click Yes. The WebSphere MQ Installation Launchpad dialog box appears.

5. On the WebSphere MQ Installation Launchpad page, click Software Prerequisites in the list of steps on the left.

6. The Launchpad checks your system for prerequisite software. On the Software Prerequisites page, make sure that the check boxes for all required components are selected. However, note that the installation routine can fail to detect the presence of a supported Java Runtime Environment 1.3 or later.

7. Click Network Prerequisites from the list of steps on the left. The Preparing for installation on networks that include Windows 2000 Servers page appears. Make sure your computer meets the requirements displayed. If the computer is in Workgroup mode, you can click No under Do both conditions apply?.

8. On the list of steps on the left, click WebSphere MQ Installation. The WebSphere MQ Installation page appears. Check the pre-installation status. If you are certain you have already installed a Java Runtime Environment v 1.3 or later, you can ignore any warnings about that component.

9. Click the Launch WebSphere MQ Installer button.

10. On the first page of the WebSphere MQ Installation Wizard, click Next.

11. On the Program Maintenance page, select Modify, and then click Next.

12. Accept the default installation folder of C:\was\IBM\WebSphere MQ\log\ for the log files, and then click Next.

13. On the Features page, click the red cross next to Server, click Install this feature, and then click Next.

14. On the Ready to Modify WebSphere MQ page, make sure the settings are correct, and then click Modify.

15. The IBM WebSphere MQ dialog box appears. If you are using the evaluation version of WebSphere MQ, click Yes; otherwise ensure you have sufficient licenses to run the product.

16. After the installation process completes, click Finish.

17. On the first page of the Prepare WebSphere MQ Wizard, click Next.

18. On the WebSphere MQ Network Configuration page, click No. This assumes that your computer is a member of a Workgroup. Click Next. The WebSphere MQ Service starts.

19. On the Prepare WebSphere MQ page, click Setup the Default Configuration.

20. On the first page of the Default Configuration Wizard, click Next.

21. On the Set up Default Configuration page, click Next.

22. On the Select Options page, leave the Allow remote administration of the queue manager and Join the queue manager to the default cluster check boxes selected. Make a note of what the Queue Manager is named because you will need this when installing the XBikes application, and then click Next.

23. On the Join Default Cluster page, select the Yes, make it the repository for the cluster radio button, and then click Next.

    Note

    If you are using a computer that gets its IP address dynamically, a message may appear that asks if another computer with a fixed IP address is available to hold the repository. If this message appears, click No.

24. On the Repository Location page, click Next.

25. On the Default Configuration Summary page, make sure the settings are correct, and then click Finish.

26. WebSphere MQ then sets up the default configuration. The WebSphere MQ Default Configuration dialog box appears, showing the Queue Manager and Default Cluster Membership details. Click Close.

27. On the Prepare WebSphere MQ Wizard page, click Next.

28. On the Completing the Prepare WebSphere MQ Wizard page, clear all the check boxes, and then click Finish. This completes the installation and configuration of IBM WebSphere MQ.

29. Restart your computer before continuing.

Creating the XBikesQ Queue

To create the message queue that XBikes uses, complete the following steps.

To create the XBikes message queue

1. Start WebSphere MQ Explorer by clicking Start, pointing to All Programs, pointing to IBM WebSphere MQ, and then clicking WebSphere MQ Explorer.

2. Expand WebSphere MQ, expand Queue Managers, and then expand QM_<machine name> (where <machine name> is the name of your computer).

3. Right-click Queues, point to New, and then click Local Queue.

4. In the Queue Name box, enter XBikesQ, and then click OK.

5. In the WebSphere MQ dialog box, click Don’t Share in Cluster. The dialog box closes.

6. Close WebSphere MQ Explorer.

Installing the XBikes Sample Code

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. For example, failure to install a component such as Microsoft SQL Server results in the database tables not installing.

To install the XBikes application and the XBikes database

1. Open Windows Explorer, and then double-click xbikesj2ee.msi.

2. On the Welcome to the XBikes J2EE Setup Wizard page, click Next.

3. In the Installation Options dialog box, make sure Single Tier is selected, and then click Next.

4. 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.

5. In the Confirm Installation dialog box, click Next to begin the installation.

6. 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.

7. The installation copies the XBikes sample code, configures the application server, and installs the XBikes database.

8. When the installation is complete, click Close.

Running the XBikes Application

You are now ready to run the XBikes application. To do this, open a browser window and enter http://localhost:9080/XBikesWeb.

Note

XBikesWeb is case sensitive.

The XBikes Web application allows you to browse bikes by type, order bikes, change quantities, and check out your order.