Advantage Joe. Deployment Guide for WebLogic v8.1 Application Server

Transcription

1 Advantage Joe Deployment Guide for WebLogic v8.1 Application Server

2 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 , 48 C.F.R. Sections (c)(1) and (2) or DFARS Section (c)(1)(ii) or applicable successor provisions Computer Associates International, Inc. (CA) All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

3 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 Advantage Plex Users...18 Contents iii

4 Starting the Deployment Tool Appendix A: Creating an Advantage Ingres Datasource... 1 Creating a Datasource for an Advantage Ingres Enterprise Relational Database... 1 iv Advantage Joe Deployment Guide for WebLogic v8.1 Application Servers

5 Chapter 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 for more information) Start the WebLogic 8.1 Application Server in Development mode for hotdeployment. If you intend to deploy Web Services to WebLogic 8.1 Application Server, you need to down load Apache Ant software from and then install it to <drive>:\ca\advantagejoe\ant directory. (Apache Ant is a copyright of The Apache Software Fundation.) Deploying to a WebLogic v8.1 Application Server 1

6 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 selfextracting 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. 2 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

7 Prerequisites Using the procedures described in this guide assumes that you have completed certain tasks using the appropriate Advantage Developer series software products. Deploying to a WebLogic v8.1 Application Server 3

8 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 4 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

9 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 shipmentproject. Properties. In Figure 1, the example project name is 3. Click on the Deployment Properties view and set the values as shown below. Click OK. Deploying to a WebLogic v8.1 Application Server 5

10 Figure 1 Session Bean and CMP/BMP Entity Bean Deployment Properties Note: In this example, the port number is The port number can be any value based on your WebLogic application server installation. The value "OracleDS" is the datasource name. 6 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

11 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 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 to a WebLogic v8.1 Application Server 7

12 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 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 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-installdirectory>\weblogic81\server\lib directory. You also need to have Apache Ant 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. 8 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

13 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 Password Deploy Directory Datatype Mapping guest guest /home/bea/user_projects/domains/mydomain/app lications 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. Deploying to a WebLogic v8.1 Application Server 9

14 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. 3. Click the Browse and Deploy Java Web Services link on the Web Services Explorer index page. The WSB:: Java page displays. 10 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

15 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 to a WebLogic v8.1 Application Server 11

16 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. 12 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

17 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= 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. 2. Set the fields as shown in Figure 2. Deploying to a WebLogic v8.1 Application Server 13

18 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 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

19 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 to a WebLogic v8.1 Application Server 15

20 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 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

21 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 to a WebLogic v8.1 Application Server 17

22 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 18 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

23 Deploying an Advantage Gen or Advantage Plex EJB Component 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] -ejbref [war id] [ejb ref name] [JNDI name] Deploying to a WebLogic v8.1 Application Server 19

24 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. 20 Advantage Joe Deployment Guide for WebLogic 8.1 Application Servers

25 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 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 Driver Classname URL Database User Name Password IngresPool ca.edbc.jdbc.edbcdriver jdbc:edbc://<ingres-server-name>:<portnumber>/<database-name>;auto=multi <ingres-user-id> <ingres-password> Creating an Advantage Ingres Datasource A-1

26 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. A-2 Advantage Joe Deployment Guide for WebLogic v8.1 Application Servers