Title Page

webMethods JDBC Adapter Installation Guide

Version 6.5

April 2010
Copyright
& Docu-
ment 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 © 2001–2010 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 AG’s 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
 Installing webMethods JDBC Adapter 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
 Upgrading to JDBC Adapter 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
 Uninstalling JDBC Adapter 6.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 Installer’s 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 User’s Guide.

webMethods JDBC Adapter Installation Guide Version 6.5 3

To install JDBC Adapter 6.5
1 Download the Installer from the Empower Product Support Web site.
2 If you are installing the adapter on an existing Integration Server, shut down the
Integration Server.
3 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 After installation is complete, start the host Integration Server.
5 See the webMethods JDBC Adapter User’s Guide for instructions on installing a
compatible JDBC driver.
6 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.

4 webMethods JDBC Adapter Installation Guide Version 6.5

 System Steps
Windows 1 Open the Windows Services and stop the DB2 JDBC Applet Server
Windows service.
2 Using a command window, change to the SQLLIB\java12
directory where you installed DB2 and execute the usejdbc2.bat
batch file.
3 From the Windows Services, re-start the DB2 JDBC Applet Server
Windows service.
UNIX 1 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

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

2 Change to the sqllib/java12 (where you installed DB2) directory

and execute the usejdbc2 script file.
3 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 adapter’s 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 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 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.
2 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 User’s Guide.
3 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.
4 Restart the host Integration Server.
5 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.

6 webMethods JDBC Adapter Installation Guide Version 6.5