Advantage
™
Joe
Deployment Guide for WebLogic® v8.1
Application Server
This documentation and related computer software program (hereinafter referred to as the “Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. (“CA”) at any time.
This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies.
This right to print copies is limited to the period during which the license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the user’s responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed.
To the extent permitted by applicable law, CA provides this documentation “as is” without warranty of any kind, including without limitation, any implied warranties of merchantability, fitness for a particular purpose or noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or indirect, from the use of this documentation, including without limitation, lost profits, business interruption, goodwill, or lost data, even if CA is expressly advised of such loss or damage.
The use of any product referenced in this documentation and this documentation is governed by the end user’s applicable license agreement.
The manufacturer of this documentation is Computer Associates International, Inc.
Provided with “Restricted Rights” as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
2003 Computer Associates International, Inc. (CA)
Contents
Chapter 1: Deploying to a WebLogic® v8.1 Application
Server...1
All Users ... 1
Document Conventions... 1
Installing the WebLogic 8.1 Plug-in... 2
Deploying an Advantage Joe or Advantage 2E EJB Component ... 2
Prerequisites... 2
Advantage Joe EJBs... 3
Advantage 2E EJB Objects ... 3
Setting Advantage Joe Deployment Properties ... 4
Running the Build Wizard... 6
Running the Deployment Wizard – Local/Remote Deployment (for Windows® Platforms)... 6
Running the Deployment Wizard – Remote Deployment (for Supported UNIX® Platforms)... 8
Completing Web Services Deployment ... 9
Testing the EJB Component... 10
Building the Advantage Joe Test Harness ... 10
Debugging the EJB Component ... 11
Building the Advantage Joe 3.1 EJB Project... 11
Preparing the WebLogic Server for Debug Mode Start-up... 12
Starting the WebLogic Server... 12
Starting the Debugger ... 12
Setting a Breakpoint and Debugging the EJB Component... 15
Deploying an Advantage Gen or Advantage Plex EJB Component ... 17
Prerequisites... 17
Advantage Gen EAR Files ... 17
Advantage Plex EAR Files ... 17
Running the Stand-alone Deployment Wizard... 18
Advantage Gen Users... 18
Starting the Deployment Tool... 18
Appendix A: Creating an Advantage Ingres Datasource ... 1
Creating a Datasource for an Advantage™ Ingres Enterprise Relational Database... 1Chapter
1
Deploying to a WebLogic® v8.1
Application Server
The Advantage Joe 3.1 product uses a plug-in architecture for application server support. This allows in-place additions to the deployment targets supported by the Advantage Joe Deployment Wizard. These additions make it possible for Computer Associates to make new deployment targets available between major releases of the Advantage Joe product software.
This guide provides deployment details for deploying Enterprise JavaBeans™ (EJB™) components, generated with Advantage Joe version 3.1, to a WebLogic® 8.1 Application Server. This document targets the Windows XP® and Windows® 2000 platform for the English language version only. It has the information for the remote deployment to different WebLogic® supported platforms like Solaris, AIX, Linux and HP-UX. The information in this document is subject to change as updates and enhancements are made to the software. For clarifications on specific topics, please contact the Customer Support team.
All Users
Before deploying, all users need to:
Install the Advantage Joe WebLogic 8.1 plug-in
Create the connection pool, datasource, connection factory, and destination in the WebLogic 8.1 Application Server (refer to the WebLogic 8.1
documentation on the BEA Systems web site at http://www.bea.com/ for more information)
Start the WebLogic 8.1 Application Server in Development mode for hot-deployment.
If you intend to deploy Web Services to WebLogic 8.1 Application Server, you need to down load Apache Ant 1.5.4 software from
http://ant.apache.org/ and then install it to
<drive>:\CA\AdvantageJoe\ant directory. (Apache Ant is a copyright of The Apache Software Fundation.)
Installing the WebLogic 8.1 Plug-in
Document Conventions
The instructions in this guide lead you through a sequence of steps to accomplish each task. The typographic conventions include:
Boldface type calls attention to items you click or manipulate with the mouse, such as menu items or buttons.
Courier type font identifies text that you type in a field, the name of a keyboard key, or message text displayed by a window or dialog box. Italic type identifies the names of objects, fields, windows or dialog boxes,
and wizards or tools.
The name token <Advantage Joe install> refers to the default installation directory, <drive>:\CA\AdvantageJoe.
Note: Throughout this tutorial, the term “click” refers to pressing the mouse’s primary button. The term “right-click” refers to pressing the mouse’s secondary button, usually on an object in the Project Tree or in a diagram.
Installing the WebLogic 8.1 Plug-in
Installing the plug-in is simply a matter of downloading and executing the self-extracting file. To download this plug-in, refer to the instructions on the
eSupport web site.
You will need to have both the Advantage Joe software and the WebLogic 8.1 plug-in installed on your computer, even if you are deploying an Advantage Gen or Advantage Plex EAR file with the Advantage Joe stand-alone Deployment Tool. Note: If the Advantage Joe software was running while you downloaded the plug-in, stop and then restart the software.
Deploying an Advantage Joe or Advantage 2E EJB
Component
Deployment procedures for EAR files from the Advantage Joe and Advantage 2E products are similar in that EJB components from both tools are deployed from within the Advantage Joe toolset. In addition, you can use the generated test harness to test and debug your EJB component once deployed.
Prerequisites
Using the procedures described in this guide assumes that you have completed certain tasks using the appropriate Advantage™ Developer series software products.
Deploying an Advantage Joe or Advantage 2E EJB Component
Advantage Joe EJBs
If you want to deploy EJBs generated with the Advantage Joe product, you must have:
Created a component implementation
Defined the business logic for the EJB component
Generated and created Projects for an EJB Session Bean, Entity Bean, and/or Message-Driven Bean
Generated a Test Harness and/or Web Application
Created a project for the Test Harness and/or Web Application, or added these items to an existing project
Note: Wait to build the EJB components, Test Harness, and/or Web Application with the Build Wizard until you execute the procedures later in this guide! The steps you follow in this guide include:
Setting deployment properties Running the Build Wizard
Running the Deployment Wizard Completing Web Services Deployment Testing the EJB component
Debugging the EJB component
Advantage 2E EJB Objects
To deploy EJB objects created with the Advantage 2E product, you must have: Generated EJB objects according to the guidelines in the Advantage 2E EJB Option User Guide
Followed the steps in the Advantage Joe Task Advisor task definition, Advantage_2E_EJB_Processing_V10-00.xml up to the steps for “Deploy the EJB” (the task definition is supplied with the Advantage 2E EJB Option) The steps you follow in this guide include:
Setting deployment properties Running the Build Wizard Running the Deployment Wizard
Completing Web Services Deployment Testing the EJB Component
Setting Advantage Joe Deployment Properties
The configuration procedure for deploying an EJB component to a WebLogic 8.1 application server requires changes only to the configuration for the Advantage Joe product.
1. Start the Advantage Joe 3.1 software and open the model that contains your EJB component.
2. Right-click on the Project in the Project Tree that contains your EJB jar and select Properties…. In Figure 1, the example project name is
shipmentProject.
3. Click on the Deployment Properties view and set the values as shown below. Click OK.
Deploying an Advantage Joe or Advantage 2E EJB Component
Figure 1 Session Bean and CMP/BMP Entity Bean Deployment Properties
Note: In this example, the port number is 7004. The port number can be any value based on your WebLogic application server installation. The value "OracleDS" is the datasource name.
Running the Build Wizard
1. Right-click on the Project in the Project Tree that contains the EJB Jar file. 2. Select Build to start the Build Wizard so that the changes to the
Deployment Properties will be included. For more information about the wizard, refer to the online help.
Running the Deployment Wizard – Local/Remote Deployment (for Windows®
Platforms)
For remote deployments on Windows systems, access the remote machine’s drive locally. For local deployments, skip to step 2.
1. Access the remote machine’s drive locally. For example, you can access the WebLogic 8.1 server directory running remotely on “SERVER2” machine from your local machine, as K:\<bea-install-directory>.
2. Right-click on the Project in the Project Tree that contains the EJB jar. 3. Select Deploy EJBs/WARS… to start the Deployment Wizard. The EJB
Server Profile panel displays.
4. Select WebLogic 8.1 Application Server from the EJB Server Type list box. 5. Click the Add Profile icon to create a profile for the WebLogic EJB server
and click Next. The Select Platform panel displays.
6. Select the Windows platform, and click Next. The EJB Server Profile Details panel displays.
7. Set the values as shown below:
Field Name Value
Profile Name My WebLogic 8.1 Server 1 EJB Server Host Name SERVER1
EJB Server Port Number 7004
Datatype Mapping This field is only used for Container-Managed Persistence (CMP) Entity Beans. Select or type the name of a supported DBMS if you plan to use the automatic table creation feature in the WebLogic application server.
Leave this field blank for other bean types.
Target Deploy Directory <drive>:\bea\user_projects\domains\mydomain\ap plications
Deploying an Advantage Joe or Advantage 2E EJB Component
Replace the <drive>: designation, EJB Server Host Name, and the SERVER1 token with the correct values for your installation. Click Next. The Web Service Endpoints panel displays, if you are deploying stateless Session Beans. Otherwise, the EAR File Contents panel displays, and you should skip steps 8-12 and go on to step 13.
8. If you choose not to deploy any Session Beans as Web Service endpoints, click Next without selecting a Session Bean. Omit steps 9-12 and proceed to step 13.
9. To deploy the selected Session Beans as a web service endpoints:
Select the EJB components that you would like to expose as Web Service endpoints by marking the desired check boxes.
Select the desired Target Soap Server from the drop down list. You can use ether Apache AXIS / CA WSB or Weblogic 8.1 Application Server.
Click Next. The Apache AXIS / CA WSB Settings or Weblogic Web Service Settings panel displays.
Note: If you plan to use the Apache AXIS / CA WSB Soap Server, the Web Services Broker (WSB) needs to be started prior to deployment. To start the WSB, open the command prompt, change directory to <drive>:\Program Files\CA\SharedComponents\Web Services Broker\bin, and execute the “startup” command.
If you experience problems in starting the Apache Tomcat server, stop the server using the “shutdown” command, and then restart the server. 10. Enter the desired service name under the Service Name column or accept the
default name.
11. Enter the desired hive name in the WSB Hive Name column, or accept the default value.
Note: If you selected the WebLogic 8.1 Application Server as the Target SOAP Server, enter the location of the WebLogic webservices.jar and weblogic.jar files in the Servicegen Classpath field. These files are usually located in
<bea-install-directory>\weblogic81\server\lib directory. You also need to have Apache Ant 1.5.4 installed in <drive>:\CA\AdvantageJoe\ant
directory as indicated in the first page of this document.
Accept the default Output Path value, and click Next. The Web Service Publishing panel displays.
12. If you choose to publish a Web Service to an XML registry, refer to the online help for more information. Otherwise, click Next without marking the Publish Web Services to XML Registry check box. The Ear File Contents panel displays.
13. Edit the application.xml, ejb-jar.xml, weblogic-ejb-jar.xml, and web.xml files, if needed. You can also add or modify resource
references and resource environment references. Click “Next”. The Confirm Input panel displays.
14. Verify the selected options and click Finish to deploy the EJB jar to a local or remote WebLogic application server on a Windows platform.
Running the Deployment Wizard – Remote Deployment (for Supported UNIX®
Platforms)
1. Right-click on the Project in the Project Tree that contains the EJB jar. 2. Select Deploy EJBs/WARs… to start the Deployment Wizard and click
next on the Welcome panel. The EJB Server Profile panel displays.
3. Select WebLogic 8.1 Application Server from the EJB Server Type list box. 4. Click the Add Profile icon to create a profile for the WebLogic EJB server
and click Next. The Select Platform panel displays.
5. Select the desired remote platform and click Next. The EJB Server Profile Details panel displays.
6. Set the values as shown below:
Field Name Value
Profile Name My WebLogic 8.1 Server 1 EJB Server Host Name SERVER1
EJB Server Port Number 7004
User ID guest
Password guest
Deploy Directory /home/bea/user_projects/domains/mydomain/app lications
Datatype Mapping This field is only used for Container-Managed Persistence (CMP) Entity Beans. Select or type the name of a supported DBMS if you plan to use the automatic table creation feature in the WebLogic application server.
Deploying an Advantage Joe or Advantage 2E EJB Component
Change the EJBServer Host Name “SERVER1” to the remote host name. Replace the sample values with the actual FTP User ID, Password, and specific directory where the generated EJB.ear should be placed by the FTP process. Click Next. The EAR File Contents panel displays.
7. Edit the application.xml, weblogic-ejb-jar.xml, ejb-jar.xml, and web.xml files, if needed. You can also add or modify resource references and resource environment references. Click Next. The Confirm Input panel displays.
8. Verify the selected options and click Finish to deploy the EJB jar to the remote WebLogic application server.
Completing Web Services Deployment
The following steps are necessary to complete deployment of a WSB Web Service which invokes a WebLogic 8.1-deployed EJB. These steps should be executed only after the successful deployment of stateless Session Beans as Web Service endpoints to the WebLogic 8.1 server with WSB selected as the target SOAP engine.
1. Launch the Web Services Explorer by selecting Start Programs Computer Associates CleverPath Web Services Broker Web Services Explorer.
2. Verify that the option Browse and Deploy Java Web Services is available on the Web Services Explorer index page. If the option is not available:
a. Close the Web Services Explorer and stop the WSB Service. To stop the WSB Service, open a command prompt, change directories to
<drive>:\Program Files\CA\SharedComponents\Web Services Broker\bin, type the shutdown command and press Enter.
b. Open the file <drive>:\Program
Files\CA\SharedComponents\Web Services
Broker\webapps\WSB\WEB-INF\wsb-config.dat for editing. c. Locate the following two lines:
<property name="WSB.WSBConfiguration.Deployment.Java" value="false"/> <property name="WSB.useWSBConfiguration" value="false"/>
and change the “false” values to “true”. Close and save the edited file. d. Start the WSB Service. To start the WSB Service, open a command
prompt, change directories to <drive>:\Program
Files\CA\SharedComponents\Web Services Broker\bin, type the startup command and press Enter.
e. Launch the Web Services Explorer.
4. Click the Deploy Java package and Manage deployment hives… link in the Operations column. The WSB:: Deployment Hive: Global page displays.
5. Locate the Hive Name for the Web Service that you deployed and click the Hive Name link in the Navigate column under Child Hives. The WSB:: Deployment Hive: <Hive name> page displays.
Note: The default name EJBServices is assigned to the Hive during deployment. You can modify the name by editing the entry under WSB Hive Name on the Advantage Joe Deployment Wizard - Apache AXIS / CA WSB Settings panel. 6. Locate the URLs for the utility libraries title on the WSB:: Deployment Hive:
<Hive name> page. Enter the location of the weblogic.jar file in the New library URL: field. For example:
<mapped_drive>:\bea\weblogic81\server\lib\weblogic.jar Click the Apply… button.
7. Close the Web Services Explorer. Your Web Service is now deployed and ready for use.
Testing the EJB Component
You can use the test harness to create a simple user interface for testing your deployed EJB component. As mentioned in the Prerequisites section of the
Introduction, you should have generated, but not built your test harness with the Test Harness Wizard prior to starting this procedure.
Testing your EJB component involves: Building the Advantage Joe test harness
Building the Advantage Joe Test Harness
1. Right-click on testharnessProject in the Advantage Joe 3.1 Project Tree and select Properties….
2. Click the Edit Project Classpath icon and then click Add Jar/Zip to add these JAR files:
For Windows systems:
<drive>:\bea\weblogic81\server\lib\weblogic.jar; <drive>:\bea\weblogic81\common\lib\log4j.jar;
<drive>:\bea\weblogic81\common\templates\domains\wls.jar
<drive>:\CA\AdvantageJoe\output\<EJBProjectName>\<EJBProjectJarName>.jar
For UNIX systems:
For all of the supported UNIX platforms [Solaris, HP-UX, AIX and Linux], copy weblogic.jar, log4j.jar, and wls.jar files from the UNIX WebLogic server machine to local Windows machine where the Advantage Joe 3.1 product is installed.
Deploying an Advantage Joe or Advantage 2E EJB Component
From Advantage Joe 3.1 Project Tree, right-click on testharnessProject and select Properties….
Click the Edit Project Classpath icon and then click Add Jar/Zip to add these JAR files:
<drive>:unix-copied\weblogic.jar; <drive>:unix-copied\log4j.jar; <drive>:unix-copied\wls.jar;
<drive>:\ca\advantagejoe\output\<EJBProjectName>\<EJBProjectJarName>.jar
3. Click OK twice after you have finished adding all JAR files. 4. Right-click on testharnessProject and select Build…. 5. Click Finish to build the test harness.
6. Expand the testharnessProject in the Project Tree.
7. Right-click on <Component>Frame and then click Test…. This displays a small window that contains a Task menu from which you can select a method to test.
8. Click on Task and then click a method name to test that method. The appropriate results display on the method panel.
Debugging the EJB Component
Follow these steps to have the WebLogic 8.1 Application Server setup program start in the debug mode and to debug the EJB from within the Advantage Joe 3.1 software.
Building the Advantage Joe 3.1 EJB Project
Use the Advantage Joe software to build the EJBProject with the –g option. 1. Right-click on the Project object and select Build….
2. Click Next to display the Build Wizard’s Generation Options panel. 3. Type “-g” in the Compiler Options field and then click Finish.
4. Deploy or re-deploy the Advantage Joe 3.1 EJB project using the instructions in previous sections.
Preparing the WebLogic Server for Debug Mode Start-up
1. Stop the WebLogic Application Server process if it is already running. 2. Copy the file
<drive>:\bea\user_projects\domains\mydomain\startWebLogi c.cmd to startWebLogicInDebug.cmd.
3. Edit the startWebLogicInDebug.cmd file to add the parameters shown below in boldface type into the file:
%JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% Xdebug
Xrunjdwp:transport=dt_socket,server=y,address=8008
Dweblogic.Name=%SERVER_NAME%
Dweblogic.ProductionModeEnabled=%PRODUCTION_MODE%
-Djava.security.policy="%WL_HOME%\server\lib\weblogic.policy" weblogic.Server
4. Save the startWebLogicInDebug.cmd file.
Starting the WebLogic Server
1. Open an MS-DOS command prompt and execute the batch file,
<drive>:\bea\user_projects\domains\mydomain\setenv.cmd 2. Start the WebLogic Application Server.
You may find it easiest to execute startWebLogicInDebug.cmd from the same command prompt window. The WebLogic 8.1 Application Server is now waiting for the debugger to connect to it.
Starting the Debugger
1. Right-click on the testharnessProject and then choose Debug…. This action displays the Define Debug Process Parameters dialog.
Deploying an Advantage Joe or Advantage 2E EJB Component
Figure 2 Define Debug Process Parameters Dialog Box and Values
3. Select Remote Application from the Type drop down list.
4. Type the host name on which the WebLogic 8.1 Application Server is running in the Host Name field.
5. Edit the Source Path by clicking the Edit Classpath icon. Include the session bean package or the entity bean source package as shown in Figure 3.
Figure 3 Debug Source Path Entry
6. Click OK to return to the DebugTool.sourcePathEdit dialog. 7. Click the Save button.
8. Click the Debug button on the Define Debug Process Parameters dialog. This displays the Attach to Remote Process window shown in Figure 4.
Figure 4 Attach to Remote Process Window
9. Enter the password as the port number used in the WebLogic
startWLSInDebug.cmd file and then click Accept. You might see a dialog box that asks if you want to restore break-points. If this dialog box displays, click No.
For example, if you used "8008" in the startWebLogicInDebug.cmd file, type “8008” in the password field and then click Accept.
10. Enter your WebLogic startup username and password in the WebLogic 8.1 startup window when prompted. The WebLogic 8.1 Application Server now starts in debug mode.
Deploying an Advantage Joe or Advantage 2E EJB Component
11. Wait until the WebLogic application server complete the start-up process before continuing with testing. It may take from several seconds to a few minutes to complete the start-up process.
Setting a Breakpoint and Debugging the EJB Component
1. Open the component source and set a break point. Figure 5 shows an example of the break points set in
com.myCompany.shipment.ShipmentComponent for the listCarriers method. Do not close this file until debugging is complete.
Figure 5 Breakpoint Location Example
2. Right-click on <EJB-Component-name>Frame in the test-harness package in the Project Tree and then select Test….
3. Select the method you want to debug and perform testing. The program flow stops at the breakpoint you set. This is shown in Figure 6.
Figure 6 Testing Stopped at Breakpoint
4. Click on the appropriate icon to proceed further to debug the method on the main window’s toolbar as shown in Figure 7.
Figure 7 Selecting Debugging Actions Using the Tool Bar
Test the Selected Class Debug the Selected Class Continue Execution
Step into Current Statement Step out of Current Method Step over Current Statement
5. Right-click on the testharnessProject right and select Stop debug to stop the debugger.
Deploying an Advantage Gen or Advantage Plex EJB Component
Deploying an Advantage Gen or Advantage Plex EJB
Component
Both Advantage Gen and Advantage Plex produce EAR files ready for deployment. Use the stand-alone Deployment Wizard to create required application server-specific files (deployment descriptors) and to deploy these EAR files to a WebLogic application server. Testing and debugging are done outside of the Deployment Wizard using your regular testing tools.
Prerequisites
Using the procedures described in this guide assumes that you have completed certain tasks using the appropriate Advantage™ Developer series software products.
Advantage Gen EAR Files
To deploy an EAR file created with the Advantage Gen product, you must have: Installed both Advantage Joe and the WebLogic 8.1 deployment plug-in Generated an EAR file containing one or more EJB components you want to deploy according to the guidelines in the Advantage Gen EJB Option
Generation Guide
Configured the WebLogic server as described in the Advantage Gen EJB Option Generation Guide – Appendix D
The steps you follow in this guide include: Running the Stand-alone Deployment Wizard
Advantage Plex EAR Files
To deploy an EAR file created with Advantage Plex product, you must have: Installed both Advantage Joe and the WebLogic 8.1 deployment plug-in Generated an EAR file containing one or more EJB components you want to deploy according to the guidelines in the Advantage Plex for Java help system. The steps you follow in this guide include:
Running the Stand-alone Deployment Wizard
The stand-alone Deployment Tool is used to deploy EAR files created by other software programs, such as Advantage™ Gen and Advantage™ Plex. While installation of the Advantage Joe software is still required, you do not need to start the full product to run the Deployment Tool.
Advantage Gen Users
The Advantage Gen software can start the stand-alone Deployment Tool automatically, if specifically requested on the Ear File Deployment Details dialog, Select the Invoke Advantage™ Joe Deploy Tool check box to enable this feature. If you do not use this feature, you will need to start the Deployment Tool from a command prompt as described below.
Advantage Plex Users
Advantage Plex users start the stand-alone Deployment Tool from the Build Deploy EJB Connector menu on the Generate and Build window.
Starting the Deployment Tool
Refer to the steps below to start the stand-alone Deployment Tool from a command prompt:
1. Access a command prompt and change directories to <drive>:\CA\AdvantageJoe\bin.
2. Execute the Joedeploytool.bat command with the syntax and options noted below:
Joedeploytool EARfilename –option 1 –option2 –option3...
where the EARfilename is the fully-qualified file name for the EAR file you want to deploy (required parameter)
The options include:
-xmlEditor allows editing of XML files -ejbTree allows display of the EJB tree -noProgress prevents progress page display -contextRoot [war id] [context root] -f [parametersFileName]
Deploying an Advantage Gen or Advantage Plex EJB Component
-noRestoreUpdates does not restore updates to a rebuilt ear file. Used by a calling tool to prevent the default ear update restoration.
-noDeleteButton prevents display of history deletion dialog The calling tool can use this flag to prevent display of the dialog if it has it's own dialog for the same purpose.
For example, your command line might resemble this:
<drive>:\CA\AdvantageJoe\bin> Joedeploytool d:\deploy\EJB.ear –xmlEditor –ejbTree
3. When the stand-alone Deployment Wizard starts, follow the instructions in the documentation supplied with your specific Advantage series development tool.
Appendix
A
Creating an Advantage Ingres
Datasource
Creating a Datasource for an Advantage™ Ingres Enterprise
Relational Database
This optional procedure explains how to create a WebLogic 8.1 datasource for use with the Advantage Ingres Enterprise Relational Database provided by Computer Associates.
1. Edit the WebLogic startup file, startWebLogic.cmd, located in the directory <drive>:\bea\user_projects\domains\mydomain for Windows XP or Windows 2000. On all Unix platforms, the file name is startWebLogic.sh.
2. Append the JAR file, <drive>:\Ingres\lib\edbc.jar, in the classpath. 3. Start the WebLogic 8.1 Application Server.
4. Start the WebLogic console.
5. Expand the Services, JDBC, Connection Pools and Data Sources nodes. 6. Right-click on Connection Pools, and select Configure a new
JDBCConnectionPool.
7. Select Other from the Datebase Type dropdown list and then click Continue. 8. Input the following in the Define and test connection panel and then click
Continue.
Name IngresPool
Driver Classname ca.edbc.jdbc.EdbcDriver
URL jdbc:edbc://<ingres-server-name>:<port-number>/<database-name>;auto=multi Database User
Name <ingres-user-id> Password <ingres-password>
Creating a Datasource for an Advantage™ Ingres Enterprise Relational Database
9. Click the Create and deploy button on the Create and deploy panel.
10. Right-click on the Data Sources node from the column on the left, and select Configure a new JDBCTxDataSource .
11. Input the following and then click Continue.
Name IngresDS
JNDI Name jdbc.IngresDS
12. Select IngresPool from Pool Name dropdown list and then click Continue. 13. Select the checkbox by the targeted server and click Create.
14. After creating the data source and connection pool, specify the data source in the Advantage Joe deployment properties window. Type jdbc.IngresDS in the JDBC URL field.
