Title Page

webMethods JDBC Adapter Installation Guide

Version 6.5

April 2010

Copyright & Document ID

This document applies to webMethods JDBC Adapter Version 6.5 and to all subsequent releases. Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions. Copyright 20012010 Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, United States of America, and/or their licensors. The name Software AG, webMethods, and all Software AG product names are either trademarks or registered trademarks of Software AG and/or Software AG USA, Inc. and/or their licensors. Other company and product names mentioned herein may be trademarks of their respective owners. Use of this software is subject to adherence to Software AGs licensing conditions and terms. These terms are part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s). This software may include portions of third-party products. For third-party copyright notices and license terms, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party Products." This document is part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s).

Document ID: ADAPTER-JDBC-IG-65-20100430

Contents
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing webMethods JDBC Adapter 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Upgrading to JDBC Adapter 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling JDBC Adapter 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 3 5 6

Overview
This guide, in conjunction with the Software AG Installation Guide, explains how to install, upgrade, and uninstall webMethods JDBC Adapter 6.5. If you are installing the adapter with webMethods Integration Server (prerequisite) or other webMethods products, this webMethods JDBC Adapter Installation Guide refers to the Software AG Installation Guide, but you should use the correct installation guide as follows: If you are installing the adapter with webMethods 8 products, refer to the Software AG Installation Guide for instructions. If you are installing the adapter with previous versions of webMethods products, refer to the webMethods Installation Guide for instructions.

Requirements
For a list of operating systems, RDBMSs, and webMethods products supported by JDBC Adapter 6.5, see the webMethods Adapters System Requirements. JDBC Adapter 6.5 has no hardware requirements beyond those of its host webMethods Integration Server.

Installing webMethods JDBC Adapter 6.5

The instructions in this section are meant to be used with the more complete instructions in the Software AG Installation Guide. The instructions explain how to use the Software AG Installer wizard. However, to install the adapter on AS/400, you must use the Installers console mode, described in the Software AG Installation Guide. Note: If you are installing the JDBC Adapter in a clustered environment, you must install the JDBC Adapter on each Integration Server in the cluster, and each installation must be identical. For more information about working with the JDBC Adapter in a clustered environment, see the webMethods JDBC Adapter Users Guide.

webMethods JDBC Adapter Installation Guide Version 6.5

To install JDBC Adapter 6.5 1 2 3 Download the Installer from the Empower Product Support Web site. If you are installing the adapter on an existing Integration Server, shut down the Integration Server. Start the Installer and follow the instructions in the Installer wizard.

Choose the webMethods release that includes the Integration Server on which you want to install the adapter. For example, if you want to install the adapter on Integration Server 7.1, choose the 7.1 release. If you are installing on an existing Integration Server, specify the webMethods installation directory that contains the host Integration Server. If you are installing both the host Integration Server and the adapter, specify the installation directory to use. The Installer will install the adapter in the Integration Server_directory\packages directory. In the product selection list, select Adapters > webMethods JDBC Adapter 6.5. You can also choose to install documentation.

4 5 6

After installation is complete, start the host Integration Server. See the webMethods JDBC Adapter Users Guide for instructions on installing a compatible JDBC driver. If you are using IBM DB2 Universal Database (UDB) 7.2, you must get the datasource classes required to connect to your DB2 database. Create a db2java.zip file that will contain these class files. Run the usejdbc2.bat file from the sqllib/java12 directory as described below.

webMethods JDBC Adapter Installation Guide Version 6.5

System Windows

Steps 1 2 Open the Windows Services and stop the DB2 JDBC Applet Server Windows service. Using a command window, change to the SQLLIB\java12 directory where you installed DB2 and execute the usejdbc2.bat batch file. From the Windows Services, re-start the DB2 JDBC Applet Server Windows service. Stop the DB2 JDBC Applet Server process: a Obtain the PID number of the db2jd process by using the following command:
ps -ef | grep db2jd

3 UNIX 1

b 2 3

Using this PID number, kill the process using the command:
kill PID_number

Change to the sqllib/java12 (where you installed DB2) directory and execute the usejdbc2 script file. Start the DB2 JDBC Applet Server process by running the db2jstrt command.

Upgrading to JDBC Adapter 6.5

You can upgrade to JDBC Adapter 6.5 from JDBC Adapter 6.0, 6.0.1, 6.0.2, 6.0.3, and 6.0.3 FP1. The method you use to upgrade depends on whether you want to make a copy of the existing adapter package. Making a copy enables you to revert to the earlier adapter package later if necessary. If you do not want to make a copy of the existing adapter package, uninstall the existing adapter using instructions in the adapters installation guide. Then install JDBC Adapter 6.5 using the instructions in Installing webMethods JDBC Adapter 6.5 on page 3. If you do want to make a copy of the existing adapter, install JDBC Adapter 6.5 using the instructions in Installing webMethods JDBC Adapter 6.5 on page 3. The Installer will detect the existing adapter and ask whether you want to save a copy of the adapter package. Click Yes. The Installer saves the adapter package to the Integration Server_directory\replicate\salvage folder and then continues with the JDBC Adapter 6.5 installation. If you later find you need to revert to the earlier adapter, uninstall JDBC Adapter 6.5 using the instructions in Uninstalling JDBC Adapter 6.5 on page 6. Then copy the Integration Server_directory\replicate\salvage\WmJDBCAdapterBackup\install and

webMethods JDBC Adapter Installation Guide Version 6.5

Integration Server_directory\replicate\salvage\WmJDBCAdapterBackup IntegrationServer directories to the webMethods installation directory into which you installed JDBC Adapter 6.5. If you created any adapter notifications with JDBC Adapter 6.0 that use adapter connections configured to use NO_TRANSACTION or XA_TRANSACTION transaction types, they will not work using JDBC Adapter 6.0, 6.0.1, 6.0.2, or 6.0.3. You must disable those adapter notifications before upgrading from the 6.0 version of the adapter, and then you can either: Recreate the adapter notifications using adapter connections that are configured to use the LOCAL_TRANSACTION transaction type. Change the existing adapter connections to use the LOCAL_TRANSACTION transaction type. Note: If you choose to change the existing adapter connections, you could potentially break other flows using the adapter connection that require NO_TRANSACTION or XA_TRANSACTION transactions. Before you change the adapter connection, be sure to analyze your system to see whether or not this action will break any other flows.)

Uninstalling JDBC Adapter 6.5

The instructions in this section are meant to be used along with the uninstallation instructions in the Software AG Installation Guide. Uninstalling JDBC Adapter 6.5 1 2 Shut down the host Integration Server. You do not need to shut down any other webMethods products or applications that are running on your machine. The Software AG Uninstaller will not delete any user-defined JDBC Adapter 6.5 components such as connections, adapter services, or adapter notifications. Because these components will not work without the adapter, delete them manually, either at the file system level or using Developer or Designer. For instructions, see the webMethods Designer Online Help or the appropriate Developer user's guide for your release as indicated in the webMethods JDBC Adapter Users Guide. Start the Uninstaller, selecting the webMethods installation directory that contains the host Integration Server. In the product selection list, select Adapters > webMethods JDBC Adapter 6.5. You can also choose to uninstall documentation. Restart the host Integration Server. The Uninstaller removes all JDBC Adapter-related files that were installed. However, the Uninstaller does not delete files created after you installed the adapter (for example, user-created or configuration files), nor does it delete the adapter directory structure. You can go to the Integration Server_directory\packages directory and delete the WmJDBCAdapter directory.

4 5

webMethods JDBC Adapter Installation Guide Version 6.5