Manual Installation Instructions


The following section describes how to deploy the J2EE version of XBikes without using the automated setup.

Manually Configuring XBikes on IBM Application Server

After IBM WebSphere Application Server and WebSphere MQ are installed, you can configure XBikes.

To manually configure XBikes on WebSphere application server

  1. Create the XBikes Enterprise Archive (EAR) file.

  2. Configure WebSphere Application Server:

    1. Configure the SQL Server login.

    2. Configure the XBikes data source.

    3. Add the licensed Glue.jar file.

    4. Add the EJB bindings.

  3. Install the XBikes EAR file.

  4. Configure WebSphere MQ support.

  5. Restart WebSphere Application Server.

After you complete these procedures, you can test that you have successfully deployed the XBikes Web site.

Note

Make sure you install the XBikes sample code by following the instructions in the “Installing the XBikes Sample Code” section.

The XBikes EAR file contains the components, assemblies, and configuration information to run XBikes on a single computer.

To create the single computer XBikes EAR file

  1. Start WebSphere Application Developer Studio 5.0 by clicking Start, pointing to All Programs, pointing to IBM WebSphere Studio, and then clicking Application Developer 5.0.

  2. In the WebSphere Studio dialog box, change the workspace to C:\Xbikes\J2ee-Ibm, and then click OK. The J2EE – IBM WebSphere Studio Application Developer window appears.

  3. Switch to the J2EE Perspective view by clicking the Window menu, pointing to Open Perspective, and then clicking J2EE.

  4. In the lower left pane, click the J2EE Hierarchy tab.

  5. Expand Enterprise Applications, right-click SingleTierXBikes, and then click Export EAR File. The Export dialog box appears.

  6. Under Where do you want to export resources to, enter c:\xbikes\SingleTierXBikes.ear.

  7. Under Options, ensure that all three check boxes are selected, and then click Finish.

  8. After the export process takes place, exit WebSphere Application Developer Studio 5.0.

To configure WebSphere Application Server

  1. Open a command prompt and navigate to the C:\Was\WebSphere\AppServer\Bin folder.

  2. Type startserver server1, and then press Enter.

  3. After a few seconds a message displays, indicating that server1 is open for e business.

  4. Open a Web browser window and navigate to http://localhost:9090/admin. For convenience, add this URL to your favorites.

  5. In the User ID field, enter admin, and then click OK.

To configure the SQL Server login

  1. In the left pane, expand Security, expand JAAS Configuration, and then click J2C Authentication Data.

  2. The right pane changes to J2C Authentication Data Entries. Click the New button.

  3. Click the Configuration tab, enter dhb in the alias field, dhb in the User ID field, bikes in the password field, and then click OK.

  4. The Messages section appears at the top of the right pane. Click the Save link.

  5. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure the XBikes data source

  1. In the left pane, expand Environment, and then click the Manage WebSphere Variables link. The WebSphere Variables window appears in the right pane.

  2. Click the MSSQLSERVER_JDBC_DRIVER_PATH link. The MSSQLSERVER_JDBC_DRIVER_PATH window appears in the right pane.

  3. In the Value field, enter C:\Program Files\Microsoft SQL Server 2000 Driver for JDBC\lib, and then click OK.

  4. The Messages section appears at the top of the right pane. Click the Save link.

  5. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  6. In the left pane, expand Resources, and then click JDBC Providers. The right pane changes to JDBC Providers.

  7. Under Scope, select the Server option, and then click Apply.

  8. Click New.

  9. In the JDBC Providers list, click Microsoft JDBC driver for MSSQLServer 2000, and then click OK. The Microsoft JDBC driver for MSSQLServer 2000 window appears in the right pane.

  10. Under Configuration, change the value of the Name field to XBikesDB.

  11. Make sure the value of the Implementation Classname field is set to com.microsoft.jdbcx.sqlserver.SQLServerDataSource, and then click OK.

  12. The Messages section appears at the top of the right pane. Click the Save link.

  13. In the Save pane, click Save. The right pane reverts to the WebSphere Application Server home page.

  14. In the left pane, click JDBC Providers again. The right pane changes to JDBC Providers.

  15. Click the XBikesDB link. The right pane changes to XBikesDB.

  16. At the bottom of the page under Additional Properties, click the Data Sources link. The right pane changes to the Data Sources page. Click the New button.

  17. The right pane changes to New. In the name and JNDI Name fields, type XBikesDB. Select the Use this Data Source in Container Managed Persistence (CMP) option.

  18. Next to Component-managed Authentication Alias, select the only option available from the drop down list box, which is in the form servername/dhb. Do the same for the Container-managed Authentication Alias field, and then click OK.

  19. On the Data Sources page, click the XBikesDB link. The XBikesDB page appears.

  20. At the bottom of the page under Additional Properties, click the Custom Properties link.

  21. Select the databaseName option, and then click the databaseName link. The databaseName page appears.

  22. In the Value field, enter XBikes, and then click OK.

  23. Click the serverName link. The serverName page appears.

  24. In the Value field, enter localhost, and then click OK.

  25. In the Messages section, click the Save link.

  26. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To add the licensed Glue.jar file

  1. In the left pane, expand Environment, and then click the Shared Libraries link.

  2. Under Scope, select the Server option, and then click the Apply button.

  3. Click the New button. The New page appears.

  4. In the Name field, enter GLUE.jar.

  5. In the Classpath field, enter c:\tme\glue\lib\GLUE.jar, and then click OK.

  6. In the Messages section, click the Save link.

  7. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To add the EJB bindings

  1. In the left pane, expand Environment, and then expand Naming.

  2. Click the Name Space Bindings link. The right pane changes to the Name Space Bindings page.

  3. Under Scope, select the Server option, and then click Apply.

  4. Click New. The New page appears.

  5. In the Binding Type options, select EJB and click Next.

  6. In the Binding Identifier field, enter BusinessServiceFacade.

  7. In the Name in Name Space field, enter BusinessServiceFacade.

  8. In the Enterprise Bean Location field, type your WebSphere host name. This name is displayed at the top of the left pane in the administration console.

  9. In the Server field, enter server1.

  10. In the JNDI Name field, enter ejb/xbikes/bll/facade/BusinessServiceFacadeHome, click Next, and then click Finish.

  11. Click the New button. The New page appears.

  12. In the Binding Type options, select EJB and click Next.

  13. In the Binding Identifier field, enter DalServiceFacadeHome.

  14. In the Name in Name Space field, enter DalServiceFacadeHome.

  15. In the Enterprise Bean Location field, type your WebSphere host name. This name is displayed at the top of the left pane in the administration console.

  16. In the Server field, enter server1.

  17. In the JNDI Name field, enter ejb/xbikes/dal/fa ade/DalServiceFacadeHome, click Next, and then click Finish.

  18. In the Messages section, click the Save link.

  19. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To Install the SingleTierApp enterprise archive file

  1. In the left pane, expand Applications.

  2. Click the Enterprise Applications link. The Enterprise Applications page displays in the right pane.

  3. Click Install, and then click Browse next to the Local Path field.

  4. Navigate to C:\Xbikes, select the singletierxbikes.ear file, and then click Open. The full path to the singletierxbikes.ear file displays in the Local Path field. Click Next to continue.

  5. On the Preparing for the application installation page, click Next.

  6. On the Step 1 page, select the Deploy EJBs option, and then click Next.

  7. On the Step 2 page, select MSSQLServer_2000 in the Database Type list box, and then click Next.

  8. On the Step 3 page, click Next.

  9. On the Step 4 page, enter XBikesDB in the JNDI name field next to XBikesDal, and then click Next.

  10. Steps 5, 6, 7, 8 and 9 do not require any changes. Click Next on the page for each of these steps, and then click Finish on the Step 10 page. A command prompt window appears and messages display on the Installing page in the right pane.

    Note

    Do not do anything else until the deployment process completes and the command prompt window disappears.

  11. Click the Save to Master Configuration link.

  12. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  13. In the left pane, expand Applications.

  14. Click the Enterprise Applications link. The Enterprise Applications page displays in the right pane.

  15. Click the SingleTierXBikes link. The SingleTierXBikes page displays in the right pane.

  16. In the Additional Properties section, click the Libraries link. The Library Ref page displays in the right pane.

  17. Click the Add button. The New page displays.

  18. Ensure that GLUE.jar appears next to the Library Name field, and then click OK.

  19. In the Messages section, click the Save link.

  20. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure WebSphere MQ support

  1. In the left pane, expand Resources, and then select WebSphere MQ JMS Provider.

  2. Under Scope, select the Server option, and then click Apply.

  3. Under Additional Properties, select the WebSphere MQ Queue Connection Factories link. The WebSphere MQ Queue Connection Factories page appears.

  4. Click the New button. Next to the Name and JNDI Name fields, enter XBikesQCF.

    Note

    JNDI Name is case sensitive.

  5. In the Queue Manager field, enter the name of your Queue Manager. Typically, this is QM_YourComputerName.

  6. In the Host field, enter localhost, and then click OK to create the connection factory.

  7. Under Resources in the left pane, click the WebSphere MQ JMS Provider link. The WebSphere MQ JMS Provider page displays.

  8. Under Additional Properties, click the WebSphere Queue Destinations link. The WebSphere MQ Queue Destinations page displays.

  9. Click the New button. In the Name, JNDI Name, and Base Queue Name fields, enter XBikesQ.

    Note

    These fields are case sensitive.

  10. In the Base Queue Manager field, enter the name of your Queue Manager, and then click OK.

  11. In the Messages section, click the Save link.

  12. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  13. Click the Logout link at the top of the page to leave the Web Admin tool, and then close your browser window.

Restarting WebSphere Application Server

Before you can test the application, you need to restart WebSphere application server.

To restart WebSphere application server

  1. Open a command prompt and navigate to the C:\Was\WebSphere\AppServer\Bin folder.

  2. Type stopserver server1, and then press Enter. Wait for the prompt indicating that server1 has stopped.

  3. Type startserver server1, and then press Enter.

  4. After a few seconds a message displays, indicating that server1 is open for e business.

Testing the XBikes Application

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

Note

XBikesWeb is case sensitive.

After the XBikes Web site displays, you can change the configuration files to test Web Service, Message Queuing, and Interoperability functionality just as you did in the previous section.

Preparing XBikes for Multi-Tier Deployment

To deploy the J2EE XBikes to multiple computers, you need to export the enterprise archive files from the XBikes application. If you installed IBM Application Developer Studio 5.0 on the Presentation tier computer, complete the following steps on that computer.

To export the enterprise archive files

  1. Start WebSphere Application Developer Studio 5.0 by clicking Start, pointing to All Programs, pointing to IBM WebSphere Studio, and then clicking Application Developer 5.0.

  2. A WebSphere Studio dialog box appears. Change the workspace to C:\Xbikes\J2ee-Ibm, and then click OK. The J2EE – IBM WebSphere Studio Application Developer window appears.

  3. Switch to the J2EE Perspective view by clicking the Window menu, pointing to Open Perspective, and then clicking J2EE.

  4. Click the J2EE Hierarchy tab at the bottom of the left pane, and then expand Enterprise Applications.

  5. Right-click SingleTierXBikes, and then click Delete. The Delete Enterprise Applications Options dialog box appears.

  6. Make sure Delete Selected Enterprise Application Project(s) only is selected, and then click OK. The Confirm Project Delete dialog box appears.

  7. Make sure Also delete contents under c:\xbikes\j2ee-ibm\SingleTierXBikes is selected, and then click Yes. This removes the application and the Repair Server Configuration dialog box appears.

  8. Click OK.

  9. Click the J2EE Navigator tab at the bottom of the left pane, right-click XBikesWeb, and then click Properties. The Properties for XBikes Web dialog box appears.

  10. In the left pane, click Web Library Projects, and then click Add. The Add a Library Project dialog appears.

  11. Click Browse. The Select a Java Project dialog box appears.

  12. Click XBikesBiz, and then click OK. The Select a Java Project dialog box closes. The Add a Library Project dialog box now shows XBikesBiz.jar as the JAR Name and XBikesBiz as the Java Project.

  13. Click OK. The XBikesBiz.jar (XBikesBiz) is now listed as a Web Library Project.

  14. Click OK to close the dialog box.

  15. In the Navigator view, right-click XBikesBiz, and then click Properties. The Properties for XBikesBiz dialog box appears.

  16. In the left pane, click Java JAR Dependencies, and then make sure XBikesDALUtility.jar is selected. Click OK.

  17. At the bottom of the left pane, click the J2EE Hierarchy tab.

  18. Right-click XBikesWebApp, and then click Export EAR File. The Export dialog box appears.

  19. Under Where do you want to export resources to, enter c:\xbikes\XBikesWebApp.ear.

  20. Under Options, make sure that all three check boxes are selected, and then click Finish.

  21. Repeat steps 18 to 20 for XBikesBLL and XBikesDAL, naming the exported files XBikesBLL.ear and XBikesDAL.ear respectively.

  22. After you complete exporting the three EAR files, exit WebSphere Application Developer Studio 5.0.

  23. Copy the XBikesBLL.ear file to the C:\xbikes directory on the Business tier computer.

  24. Copy the XBikesDAL.ear file to the C:\xbikes directory on the Data tier computer.

Deploying XBikes on the Presentation Tier Computer

To deploy XBikes on the Presentation tier computer, complete the following procedures:

  1. Configure the WebSphere server.

  2. Install the XBikesWebApp enterprise archive file.

  3. Start the XBikes Presentation tier component.

To configure the WebSphere server

  1. Open a command prompt and navigate to the C:\Was\WebSphere\AppServer\Bin folder.

  2. Type startserver server1, and then press Enter.

  3. After a few seconds a message displays that indicates that server1 is open for e business.

  4. In Notepad or another text editor, open the C:\Xbikes\Config\WebConfig.xml file.

  5. Change the localhost entry within the <iiop> and <j2eews> tags to the name of the Business tier computer. This entry should now read as follows.

     <iiop>iiop://BusinessTierComputerName</iiop> <j2eews>http://BusinessTierComputerName:9080/XBikesBLLServiceInterface/services /BLLWSServiceInterface.wsdl</j2eews> 

  6. Open a Web browser window and navigate to http://localhost:9090/admin. For convenience, add this URL to your favorites.

  7. In the User ID field, enter admin, and then click OK.

  8. In the left pane, expand Environment, and then click the Shared Libraries link. The Shared Libraries page appears in the right pane.

  9. Under Scope, select the Server option, and then click Apply.

  10. Click the New button. The New page appears.

  11. In the Name field, enter GLUE.jar in the Name field.

  12. In the Classpath field, enter c:\tme\glue\lib\GLUE.jar, and then click OK.

  13. The Messages section appears at the top of the right pane. Click the Save link.

  14. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To install the XBikesWebApp enterprise archive file

  1. In the left pane of the Admin console, expand Applications, and then click the Install New Application link.

  2. Ensure the Local Path is selected, and then click Browse.

  3. In the C:\Xbikes folder, click XBikesWebApp.ear, and then click Next.

  4. On the Preparing for the application installation page, click Next.

  5. On each page for Steps 1–3, accept the default settings by clicking Next.

  6. On the Step 4 page, click Finish.

  7. After the application installs, click the Manage Applications link in the right pane.

  8. On the Enterprise Applications page, click the XBikesWebApp link.

  9. In Additional Properties box at the bottom of the page, click the Libraries link.

  10. Click the Add button. The New page appears in the right pane.

  11. The GLUE library should already be selected next to Library Name. Click OK.

  12. The Messages section appears at the top of the right pane. Click the Save link.

  13. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To start the XBikes Presentation tier component

  1. In the left pane, click Enterprise Applications.

  2. Select the XBikesWebApp check box, and then click Start. The XBikes Presentation Tier component should start.

  3. Close the administration console.

Deploying the Business Tier Components

To install the XBikes Business tier components on the Business tier computer, complete the following procedures:

  1. Configure the WebSphere server.

  2. Install the XBikesBLL enterprise archive file.

  3. Start the XBikes Business tier component.

To configure the WebSphere server

  1. Open a command prompt and navigate to the C:\Was\WebSphere\AppServer\Bin folder.

  2. Type startserver server1, and then press Enter.

  3. After a few seconds a message displays that indicates that server1 is open for e business.

  4. In Notepad or another text editor, open the C:\Xbikes\Config\BLLConfig.xml file.

  5. Change the localhost entry within the <iiop>, <j2eews>, and <netws> tags to the name of the Data tier computer. This entry should now read as follows.

     <iiop>iiop://DataTierComputerName</iiop> <j2eews>http://DataTierComputerName:9080/XBikesResWS/services/DALWSServiceInter face.wsdl</j2eews> <netws>http://DataTierComputerName/XBikes-DAL- WSServiceInterface/DALWSServiceInterface.asmx?WSDL</netws> 

  6. Open a Web browser window and navigate to http://localhost:9090/admin. For convenience, add this URL to your favorites.

  7. In the User ID field, enter admin, and then click OK.

  8. In the left pane, expand Environment, and then click the Shared Libraries link. The Shared Libraries page appears in the right pane.

  9. Under Scope, select the Server option, and then click Apply.

  10. Click the New button. The New page appears.

  11. In the Name field, enter GLUE.jar.

  12. In the Classpath field, enter c:\tme\glue\lib\GLUE.jar, and then click OK.

  13. The Messages section appears at the top of the right pane. Click the Save link.

  14. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  15. In the left pane, expand Naming, and then click the Name Space Bindings link.

  16. Under Scope, select the Server option, and then click Apply.

  17. Click the New button. The New page appears.

  18. Click EJB, and then click Next. The New Name Space Binding page appears.

  19. In the Binding Identifier field, enter BusinessServiceFacade.

  20. In the Name in Name Space field, enter BusinessServiceFacade.

  21. In the Enterprise Bean Location enter, the name of your WebSphere host. This should appear at the top of the navigation tree in the left pane of the Administrative console.

  22. In the Server field, enter server1.

  23. In the JNDI name field, enter ejb/xbikes/bll/fa ade/BusinessServiceFacadeHome, and then click Next.

  24. On the Summary page, click Finish.

  25. The Messages section appears at the top of the right pane. Click the Save link.

  26. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure WebSphere MQ support

  1. In the left pane, expand Resources, and then click WebSphere MQ JMS Provider.

  2. Under Scope, select the Server option, and then click Apply.

  3. Under Additional Properties, click the WebSphere MQ Queue Connection Factories link. The WebSphere MQ Queue Connection Factories page appears.

  4. Click the New button. Next to the Name and JNDI Name fields, enter XBikesQCF.

    Note

    JNDI Name is case sensitive.

  5. In the Queue Manager field, enter the name of your Queue Manager. Typically this is QM_DataTierComputerName.

  6. In the Host field, enter the name of the Data tier server.

  7. In the Port field, enter 1414.

  8. In the Transport Type field, choose CLIENT, and then click OK.

  9. Under Resources in the left pane, click the WebSphere MQ JMS Provider link. The WebSphere MQ JMS Provider page displays.

  10. Under Additional Properties, click the WebSphere Queue Destinations link. The WebSphere MQ Queue Destinations page displays.

  11. Click the New button. In the Name, JNDI Name, and Base Queue Name fields, enter XBikesQ.

    Note

    These fields are case sensitive.

  12. In the Base Queue Manager field, enter the name of your Queue Manager, and then click OK.

  13. In the Messages section, click the Save link.

  14. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  15. Click the Logout link at the top of the page to leave the Web Admin tool, and then close your browser window.

To install the XBikesBLL enterprise archive file

  1. In the left pane of the Admin console, expand Applications, and then click the Install New Application link.

  2. Ensure the Local Path option is selected, and then click Browse.

  3. In the C:\Xbikes folder, click XBikesBLL.ear, and then click Next.

  4. On the Preparing for the application installation page, click Next.

  5. On the Step 1 page, select the Deploy EJBs check box, and then click Next.

  6. On each page for Steps 2–7, accept the default settings by clicking Next.

  7. On the Step 8 page, click Finish. The application then installs and a blank command window displays.

  8. After the application installs, click the Manage Applications link in the right pane.

  9. On the Enterprise Applications page, click the XBikesBLL link.

  10. In Additional Properties box at the bottom of the page, click the Libraries link. The Library Ref page appears.

  11. Click the Add button. The New page appears in the right pane.

  12. The GLUE.JAR library should already be selected next to Library Name. Click OK.

  13. The Messages section appears at the top of the right pane. Click the Save link.

  14. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To start the XBikes Business tier component

  1. In the left pane, click Enterprise Applications.

  2. Select the XBikesWebApp check box, and then click Start. The XBikes Business tier component should start and a message in the Messages section at the top of the right pane should confirm this.

  3. Close the administration console.

Configuring the Data Tier Computer

To set up the Data tier computer, complete the following procedures:

  1. Configure the WebSphere server.

  2. Configure the EJB bindings.

  3. Configure the paths for the Microsoft JDBC driver.

  4. Configure the SQL Server login.

  5. Configure the XBikes JDBC data source.

  6. Install the XBikesDAL enterprise archive file.

  7. Start the XBikes Data tier component.

After you complete these procedures, you should be able to test the XBikes application.

Note

Ensure you have installed the XBikes database tables.

To configure the WebSphere server

  1. Open a command prompt and navigate to the C:\Was\WebSphere\AppServer\Bin folder.

  2. Type startserver server1, and press Enter.

  3. After a few seconds a message displays that indicates that server1 is open for e business.

  4. Open a Web browser window and navigate to http://localhost:9090/admin. For convenience, add this URL to your favorites.

  5. In the User ID field, enter admin, and then click OK.

  6. In the left pane, expand Environment, and then click the Shared Libraries link. The Shared Libraries page appears in the right pane.

  7. Under Scope, select the Server option, and then click Apply.

  8. Click the New button. The New page appears.

  9. In the Name field, enter GLUE.jar.

  10. In the Classpath field, enter c:\tme\glue\lib\GLUE.jar, and then click OK.

  11. The Messages section appears at the top of the right pane. Click the Save link.

  12. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure the EJB bindings

  1. In the left pane, expand Environment, expand Naming, and then click the Name Space Bindings link.

  2. Under Scope, select the Server option, and then click Apply.

  3. Click the New button. The New page appears.

  4. Click EJB, and then click Next.

  5. In the Binding Identifier field, enter DalServiceFacadeHome.

  6. In the Name in Name Space field, enter DalServiceFacadeHome.

  7. In the Enterprise Bean Location field, enter the name of your WebSphere host name. This should appear at the top of the navigation tree in the left pane of the Administrative console.

  8. In the Server field, enter server1.

  9. In the JNDI name field, enter ejb/xbikes/dal/fa ade/DalServiceFacadeHome, and then click Next.

  10. On the Summary page, click Finish.

  11. The Messages section appears at the top of the right pane. Click the Save link.

  12. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure the paths for the Microsoft JDBC driver

  1. In the left pane, expand Environment, and then click the Manage WebSphere Variables link. The WebSphere Variables window appears in the right pane.

  2. Click the MSSQLSERVER_JDBC_DRIVER_PATH link. The MSSQLSERVER_JDBC_DRIVER_PATH window appears in the right pane.

  3. In the Value field, enter C:\Program Files\Microsoft SQL Server 2000 Driver for JDBC\lib, and then click OK.

  4. The Messages section appears at the top of the right pane. Click the Save link.

  5. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure the SQL Server login

  1. In the left pane, expand Security, expand JAAS Configuration, and then click J2C Authentication Data.

  2. The right pane changes to J2C Authentication Data Entries. Click the New button.

  3. Click the Configuration tab.

  4. Enter dhb in the alias field, enter dhb in the User ID field, enter bikes in the password field, and then click OK.

  5. The Messages section appears at the top of the right pane. Click the Save link.

  6. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure the XBikes JDBC data source

  1. In the left pane, expand Resources, and then click JDBC Providers. The right pane changes to JDBC Providers.

  2. Under Scope, select the Server option, and then click Apply.

  3. Click the New button.

  4. In the JDBC Providers list, click Microsoft JDBC driver for MSSQLServer 2000, and then click OK. The Microsoft JDBC driver for MSSQLServer 2000 window appears in the right pane.

  5. Under Configuration, change the value of the Name field to XBikesDB.

  6. Make sure the value of the Implementation Classname field is set to com.microsoft.jdbcx.sqlserver.SQLServerDataSource, and then click OK.

  7. The Messages section appears at the top of the right pane. Click the Save link.

  8. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  9. In the left pane, click JDBC Providers again. The right pane changes to JDBC Providers.

  10. Click the XBikesDB link. The right pane changes to XBikesDB.

  11. At the bottom of the page under Additional Properties box, click the Data Sources link. The right pane changes to the Data Sources page. Click the New button.

  12. The right pane changes to New. In the name and JNDI Name fields, type XBikesDB. Select the Use this Data Source in Container Managed Persistence (CMP) check box.

  13. Next to Component-managed Authentication Alias, select the only option available from the drop down list box, which is in the form servername/dhb. Do the same for the Container-managed Authentication Alias field, and then click OK.

  14. On the Data Sources page, click the XBikesDB link. The XBikesDB page appears.

  15. At the bottom of the page under Additional Properties, click the Custom Properties link.

  16. Click the databaseName link. The databaseName page appears.

  17. In the Value field, enter XBikes, and then click OK.

  18. Click the serverName link. The serverName page appears.

  19. In the Value field, enter localhost, and then click OK.

  20. In the Messages section, click the Save link.

  21. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To configure WebSphere MQ support

  1. In the left pane, expand Resources, and then click WebSphere MQ JMS Provider.

  2. Under Scope, select the Server option, and then click Apply.

  3. Under Additional Properties, click the WebSphere MQ Queue Connection Factories link. The WebSphere MQ Queue Connection Factories page appears.

  4. Click the New button. Next to the Name and JNDI Name fields, enter XBikesQCF.

    Note

    JNDI Name is case sensitive.

  5. In the Queue Manager field, enter the name of your Queue Manager. Typically this is QM_YourComputerName.

  6. In the Host field, enter localhost, and then click OK.

  7. In the left pane under Resources, click the WebSphere MQ JMS Provider link. The WebSphere MQ JMS Provider page displays.

  8. Under Additional Properties, click the WebSphere Queue Destinations link. The WebSphere MQ Queue Destinations page displays.

  9. Click the New button. In the Name, JNDI Name, and Base Queue Name fields, enter XBikesQ.

    Note

    These fields are case sensitive.

  10. In the Base Queue Manager field, enter the name of your Queue Manager, and then click OK.

  11. In the Messages section, click the Save link.

  12. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  13. Click the Logout link at the top of the page to leave the Web Admin tool and then close your browser window.

To install the XBikesDAL enterprise archive file

  1. In the left pane, expand Applications, and then click the Enterprise Applications link. The Enterprise Applications page displays in the right pane.

  2. Click the Install button, and then click Browse next to Local Path.

  3. Navigate to C:\Xbikes and select the XBikesDAL.ear file. Click Open and the full path to the XBikesDAL.ear file displays in the Local Path field. Click Next.

  4. On the Preparing for the application installation page, click Next.

  5. On the Step 1 page, select the Deploy EJBs check box, and then click Next.

  6. On the Step 2 page, select MSSQLServer_2000 in the Database Type list box, and then click Next.

  7. On the Step 3 page, click Next.

  8. On the Step 4 page, enter XBikesDB in the JNDI name field next to XBikesDal, and then click Next.

  9. Steps 5, 6, 7, 8 and 9 do not require any changes. Click Next on each of these steps, and then click Finish on the Step 10 page. A command prompt window appears and messages display on the Installing page in the right pane.

    Note

    Do not do anything else until the deployment process completes and the command prompt window disappears.

  10. Click the Save to Master Configuration link.

  11. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

  12. In the left pane, expand Applications.

  13. Click the Enterprise Applications link. The Enterprise Applications page displays in the right pane.

  14. Click the XBikesDal link. The XBikesDal page displays in the right pane.

  15. In the Additional Properties section, click the Libraries link. The Library Ref page displays in the right pane.

  16. Click the Add button. The New page displays.

  17. Ensure that GLUE.jar appears next to the Library Name field, and then click OK.

  18. In the Messages section, click the Save link.

  19. In the Save pane, click the Save button. The right pane reverts to the WebSphere Application Server home page.

To start the XBikes Data tier component

  1. In the left pane, click Enterprise Applications.

  2. Select the XBikesDal check box, and then click Start. The XBikes Business Tier component should start and a message in the Messages section at the top of the right pane should confirm this.

  3. Close the administration console.

Testing the XBikes Application

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

Note

XBikesWeb is case sensitive.

After the XBikes Web site displays, you can change the configuration files to test Web service, message queuing, and interoperability functionality just as you did in the single tier section.




Application Interoperability. Microsoft. NET and J2EE
Application Interoperability: Microsoft .NET and J2EE: Microsoft(r) .Net and J2ee (Patterns & Practices)
ISBN: 073561847X
EAN: 2147483647
Year: 2003
Pages: 104

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net