TIBCO ActiveMatrix Adapter for Database Installation

Software Release 6.0 April 2009

Important Information
SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE. USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN LICENSE.PDF) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE LICENSE FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME. This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc. TIB, TIBCO, TIBCO Adapter, Predictive Business, Information Bus, The Power of Now, TIBCO ActiveMatrix BusinessWorks, TIBCO Rendezvous, TIBCO Administrator, TIBCO Designer, TIBCO Runtime Agent, TIBCO Hawk, TIBCO Enterprise Message Service, TIBCO Designer Add-in for TIBCO Business Studio, TIBCO ActiveMatrix Service Grid, TIBCO ActiveMatrix Service Bus, TIBCO ActiveMatrix BusinessWorks Service Engine, and TIBCO Business Studio are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. EJB, Java EE, J2EE, and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README.TXT FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM. THIS DOCUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME. THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright 1999-2009 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information

| iii

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi TIBCO ActiveMatrix Adapter for Database Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Other TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii How to Contact TIBCO Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Chapter 1 Installing TIBCO ActiveMatrix Adapter for Database . . . . . . . . . . . . . . . . . . . . . . . . . 1

Installer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Major, Minor and Patch Releases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Calculating Available Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2 2 3 3 3 4

Adapter Components and Additional TIBCO Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Adapter Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Required and Optional TIBCO Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Pre-Installation Worksheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Adapter Machine Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 2 Installing on Microsoft Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Required TIBCO Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supported Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supported Drivers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 12 12 14

Installing the Adapter on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Installing on Microsoft Windows 2003 Terminal Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Installing the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Additional Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Chapter 3 Installation on UNIX Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

TIBCO ActiveMatrix Adapter Service Engine for Database Installation

iv

| Contents
Minimum Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Supported Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Supported Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Installing TIBCO ActiveMatrix Adapter for Database on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Installing the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Chapter 4 Installation FAQs and Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Setting the DISPLAY Variable on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 JRE and JVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Configuring TIBCO Hawk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Cannot Install the Adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

TIBCO ActiveMatrix Adapter Service Engine for Database Installation

|v

Preface

This document describes how to install TIBCO ActiveMatrix Adapter for Database software. This software may be available on multiple operating systems. However, not all operating system platforms for a specific software version are released at the same time. Please see the readme.txt file for the availability of this software version on a specific operating system platform.

Topics
Related Documentation, page vi Typographical Conventions, page vii How to Contact TIBCO Customer Support, page ix

TIBCO ActiveMatrix Adapter for Database Installation

vi

| Related Documentation
Related Documentation
This section lists documentation resources you may find useful.

TIBCO ActiveMatrix Adapter for Database Documentation

The following documents form the TIBCO ActiveMatrix Adapter for Database documentation set: TIBCO ActiveMatrix Adapter for Database Concepts Read this manual to gain an understanding of adapters in general that you can apply to the various tasks you may undertake. TIBCO ActiveMatrix Adapter for Database Installation Read this manual to learn how to install TIBCO ActiveMatrix Adapter for Database. TIBCO ActiveMatrix Adapter for Database Configuration and Deployment This manual explains how to create and configure adapter projects. Information on deploying adapter projects is also included. TIBCO ActiveMatrix Adapter for Database Examples Read this manual for additional information about new features, closed and open issues. TIBCO ActiveMatrix Adapter for Database Release Notes Read this manual for additional information about new features, closed and open issues.

Other TIBCO Product Documentation

You may find it useful to read the documentation for the following TIBCO products. TIBCO Designer TIBCO Administrator TIBCO ActiveMatrix BusinessWorks TIBCO Rendezvous TIBCO Enterprise Message Service TIBCO Hawk TIBCO Adapter SDK TIBCO Runtime Agent

TIBCO ActiveMatrix Adapter for Database Installation

Preface vii

Typographical Conventions
The following typographical conventions are used in this manual Table 1 General Typographical Conventions Convention
TIBCO_HOME ENV_HOME

Use Many TIBCO products must be installed within the same home directory. This directory is referenced in documentation as TIBCO_HOME. The value of TIBCO_HOME depends on the operating system. For example, on Windows systems, the default value is C:\tibco. Other TIBCO products are installed into an installation environment. Incompatible products and multiple instances of the same product are installed into different installation environments. The directory into which such products are installed is referenced in documentation as ENV_HOME. The value of ENV_HOME depends on the operating system. For example, on Windows systems the default value is C:\tibco.

code font

Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window. For example: Use MyCommand to start the foo process.

bold code font

Bold code font is used in the following ways: In procedures, to indicate what a user types. For example: Type admin. In large code samples, to indicate the parts of the sample that are of particular interest. In command syntax, to indicate the default parameter for a command. For example, if no parameter is specified, MyCommand is enabled: MyCommand [enable | disable]

italic font

Italic font is used in the following ways: To indicate a document title. For example: See TIBCO BusinessWorks Concepts. To introduce new terms For example: A portal page may contain several portlets. Portlets are mini-applications that run in a portal. To indicate a variable in a command or code syntax that you must replace. For example: MyCommand pathname

TIBCO ActiveMatrix Adapter for Database Installation

viii

| Typographical Conventions
Table 1 General Typographical Conventions (Contd) Convention Key combinations Use Key name separated by a plus sign indicate keys pressed simultaneously. For example: Ctrl+C. Key names separated by a comma and space indicate keys pressed one after the other. For example: Esc, Ctrl+Q. The note icon indicates information that is of special interest or importance, for example, an additional action required only in certain circumstances. The tip icon indicates an idea that could be useful, for example, a way to apply the information provided in the current section to achieve a specific result. The warning icon indicates the potential for a damaging situation, for example, data loss or corruption if certain steps are taken or not taken.

TIBCO ActiveMatrix Adapter for Database Installation

Preface ix

How to Contact TIBCO Customer Support

For comments or problems with this manual or the software it addresses, please contact TIBCO Support as follows. For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site: http://www.tibco.com/services/support If you already have a valid maintenance or support contract, visit this site: https://support.tibco.com Entry to this site requires a user name and password. If you do not have a user name, you can request one.

TIBCO ActiveMatrix Adapter for Database Installation

| How to Contact TIBCO Customer Support

TIBCO ActiveMatrix Adapter for Database Installation

|1
Chapter 1

Installing TIBCO ActiveMatrix Adapter for Database

a

This chapter provides an overview of the installer, the installation registry, and the additional software required before you can install TIBCO ActiveMatrix Adapter for Database.

Topics
Installer Overview, page 2 Adapter Components and Additional TIBCO Software, page 5 Pre-Installation Worksheets, page 7

TIBCO ActiveMatrix Adapter for Database Installation

| Chapter 1

Installing TIBCO ActiveMatrix Adapter for Database

Installer Overview
This section introduces the adapter installer.

Installing the Adapter

Before you install the adapter, read this chapter and fill out the Pre-Installation Worksheets. Software, hardware, other prerequisites, and installation instructions for each platform are in the appropriate section of this document: Chapter 2, Installing on Microsoft Windows Platforms Chapter 3, Installation on UNIX Platforms

Uninstalling the Adapter

The TIBCO Installation Manager is used to uninstall TIBCO products. It allows you to: Display installed products Display product components Display product dependencies and references Uninstall products and all references

To start the program: On Microsoft Windows: Click Start>All Programs>TIBCO>TIBCO Installation Manager On UNIX: <install-path>/tibco/TibcoInstallationManager.bin The TIBCO Installation Manager displays all TIBCO software installed on your machine. Details about the selected TIBCO product are displayed in the right rows. Click the Uninstall button to remove the selected product. Note that some products cannot be installed from the utility. Instructions about uninstalling these products are listed in the uninstall window (after clicking the Uninstall button). Click the TIBCO Installation Manager help button for information about using the program.

TIBCO ActiveMatrix Adapter for Database Installation

Installer Overview 3

Major, Minor and Patch Releases

Software from TIBCO uses three numbers to indicate whether the release is major, minor or a patch. For example, 5.0.0 indicates a major release, 5.1.0 indicates a minor release and 5.1.1 indicates a patch release. For a major or minor release, the installer prompts whether you wish to upgrade, and informs you if incompatible products are on your system. If you proceed, the major or minor release is installed in a new directory that is named using the major or minor release version number. For example, if you have installed the 5.0.0 (major) release and are upgrading to a 5.1.0 (minor) release, the new release will be installed in a new directory named install-path5.1. This allows both the 5.0 and 5.1 releases to coexist on the same machine. The installer for a patch release performs an automatic upgrade. For example, the installer automatically upgrades TIBCO ActiveMatrix Adapter for Database 5.0.0 to 5.0.1 by overwriting the contents of the 5.0 directory.

Calculating Available Disk Space

The installer calculates the disk space required in the adapters home directory for the selected components. This calculation is done before starting to copy files. The installer will proceed only if sufficient free disk space is available. If the available disk space is consumed by another process during installation and there is not enough room to finish, the installer may fail and display a failure message. You can avoid this by not running other processes during installation that consume disk space in the adapters home directory.

Installation Registry
The installer maintains an installation registry. (Note that the installer does not recognize TIBCO ActiveEnterprise 4.x products.) The registry location depends on the platform, as described below. The registry files have vpd as a prefix, which stands for Vital Product Database. Do not edit, modify, rename, move, or remove any of the registry vpd files.

TIBCO ActiveMatrix Adapter for Database Installation

| Chapter 1

Installing TIBCO ActiveMatrix Adapter for Database

Microsoft Windows Platforms TIBCO ActiveEnterprise 6.x products maintain the installation registry in the SystemDrive:\windows folder. The following files represent the installation registry for Microsoft Windows 2003:
SystemDrive:\<User_Home>\vpd.properties SystemDrive:\<User_Home>\vpd.properties.tibco.systemName

The following files represent the installation registry for Microsoft Windows XP:
SystemDrive:\windows\vpd.properties SystemDrive:\windows\vpd.properties.tibco.systemName

UNIX Platforms If installation is performed by a regular user (non-root), the installation registry is maintained in the following files in the user's home directory:
<User_Home>/vpd.properties <User_Home>/vpd.properties.tibco.systemName

If installation is performed by a super-user (root), the installation registry is maintained in the Native registry database: On Solaris and HP-UX, in the root users home directory ( / ) as vpd files. On AIX, in /usr/lib/objrepos as vpd files and in the install database. On Linux, in the /root directory as vpd files.

Installation History
The installer and uninstaller create a file called TIBCOInstallationHistory.xml in the same location where the installation registry is created. Each time an installation or uninstallation is performed, entries are appended to the file. On Microsoft Windows:
SystemDrive:\windows\TIBCOInstallationHistory.xml

On UNIX: Users_Home_Directory/TIBCOInstallationHistory.xml The file TIBCOInstallationHistory.xml contains the record of all installation and uninstallation activities of all TIBCO products, features and components.

TIBCO ActiveMatrix Adapter for Database Installation

Adapter Components and Additional TIBCO Software 5

Adapter Components and Additional TIBCO Software

You can install the software on different machines and use them across the network. For example, you can use TIBCO Designer on one machine to configure a TIBCO ActiveMatrix Adapter for Database adapter on another machine.

Adapter Components
Table 2 describes the components of the adapter installation package. Table 2 TIBCO Adapter components Component Runtime Design time Description This process does the actual work of passing and converting data to and from the vendor application. Adapter-specific GUI that is loaded in TIBCO Designer (see next section for details) at configuration time. This component includes the palette and samples that demonstrate how TIBCO ActiveMatrix Adapter for Database interacts with TIBCO ActiveMatrix BusinessWorks. Documentation JDBC drivers This component is required for context sensitive help. TIBCO ActiveMatrix Adapter for Database uses the JDBC drivers packaged with TIBCO Runtime Agent. For more information see JDBC Drivers on page 14. TIBCO ActiveMatrix Adapter for Database software packages include the required ODBC drivers. See ODBC Drivers on page 14.

ODBC drivers

TIBCO ActiveMatrix Adapter for Database Installation

| Chapter 1

Installing TIBCO ActiveMatrix Adapter for Database

Required and Optional TIBCO Products

The TIBCO Runtime Agent must be installed before installing the adapter. Depending on your configuration, you may also need to install additional TIBCO products. The next table describes the TIBCO Runtime Agent and the additional TIBCO products you may be installing. For the supported versions of the listed products, refer TIBCO ActiveMatrix Adapter for Database readme.txt. Table 3 Required and optional TIBCO products Product TIBCO Runtime Agent Purpose Required by the adapter. TIBCO Runtime Agent includes TIBCO Designer along with a number of TIBCO and third-party libraries used by the adapter and other TIBCO products. This includes, for example, TIBCO Rendezvous software. You must install TIBCO Runtime Agent before you install TIBCO ActiveMatrix Adapter for Database. TIBCO Administrator Required for deployment. TIBCO Administrator includes the following modules: User Management. Management of authentication, roles and users, that is, connecting roles (groups) and users to access control lists (ACLs). This includes security for server-based projects at design-time and for deployed applications at runtime. Resource Management. Monitoring of machines and of all running applications in a TIBCO administration domain. Alerts can be created, for example, to notify an administrator if the number of processes or disk usage exceeds a certain number. Application Management. Uploading of Enterprise Archive (EAR) files, creation, configuration, deployment, and monitoring of applications. This console is also used to start and stop applications.

TIBCO Administrator is available as a separate installation and can be installed after installing the adapter. TIBCO ActiveMatrix BusinessWorks Optional. TIBCO ActiveMatrix BusinessWorks is a scalable, extensible, and easy to use integration platform that allows you to develop integration projects. TIBCO Adapters are typically part of integration projects created using BusinessWorks. TIBCO ActiveMatrix BusinessWorks is available as a separate installation and can be installed after installing the adapter.

TIBCO ActiveMatrix Adapter for Database Installation

Pre-Installation Worksheets 7

Pre-Installation Worksheets
The most time-consuming part of an adapter installation is the collection of environment information and parameters. This section helps you complete this process. Use these forms to gather information from the various system administrators and other sources within your organization before installing the adapter. Adapter Machine Information Database Information

Adapter Machine Information

The information below is required during installation of TIBCO ActiveMatrix Adapter for Database. If you are connecting to a DB2 for z/OS database, you will need additional information, as described for Windows in Post-Installation Tasks, page 20, or for UNIX in Post-Installation Tasks, page 41. Table 4 Adapter machine information worksheet Adapter Information Hostname Description Name of the machine on which the adapter is being installed. (Example: adapter1.tibco.com) IP address TIBCO home directory path IP address of the machine on which the adapter is being installed. This is the directory where TIBCO Runtime Agent was installed. TIBCO Runtime Agent must be installed on each machine where the adapter will be installed. (By default, this is C:\tibco on Microsoft Windows) Installer user account Account to log on to the machine with and run the installer. This user must have write permission to the TIBCO home directory. (Example: administrator) Value for Your Machine

TIBCO ActiveMatrix Adapter for Database Installation

| Chapter 1

Installing TIBCO ActiveMatrix Adapter for Database

Table 4 Adapter machine information worksheet (Contd) Adapter Information Installer user password Installer user domain (Windows only) Adapter installation package ODBC driver version Description Password for the installer user account above. Network domain to which the user account above belongs. (Example: ENGR2) Obtain the correct TIBCO ActiveMatrix Adapter for Database installation package. This is available on CD, FTP, network drive, or download.tibco.com as appropriate. The correct ODBC driver version for your database. For Windows, see Supported Drivers on page 14. For UNIX, see Supported Drivers on page 35. ODBC driver directory path The full path of the ODBC driver directory. Drivers are installed with the adapter or can also be third-party. For Windows, see Supported Drivers on page 14. For UNIX, see Supported Drivers on page 35. (By default, install-path\odbc\Drivers) Value for Your Machine

TIBCO ActiveMatrix Adapter for Database Installation

Pre-Installation Worksheets 9

Database Information
Most supported databases require you to enter these parameters to configure the adapter. The specific parameter names and the type of information required depends on the database and driver you are using. Check with your database administrator to determine exactly what information will be needed for your system. If you are connecting to a DB2 for z/OS database, you will need additional information, as described for Microsoft Windows in Post-Installation Tasks, page 20, or for UNIX in Post-Installation Tasks, page 41. Table 5 Database information worksheet Database Information Data Source Name and description Description A name and description you create that identifies this database configuration in the system. (Example: Accounting) Port Number SID The port number of the database listener. The System Identifier that refers to the instance of the database running on the server. (Example: ORCL) Server (or Host) The name, IP address, client connection string, or other identifier of the database server and database to which the adapter will connect. (Example: Oracleserver or 199.226.224.34) Database administrator account Database administrator password Service name Account that has database administration privileges and can create users. Password for the database administrator account. Name of the service to use when executing commands as the database administrator. (Example: adbsol27) Value for Your Database

TIBCO ActiveMatrix Adapter for Database Installation

10

| Chapter 1

Installing TIBCO ActiveMatrix Adapter for Database

Table 5 Database information worksheet (Contd) Database Information Database access account Description New account created by the database administrator during configuration. The adapter uses this account to connect to the database. (Example: jsmith) Database access account password Password for the database access account above. Value for Your Database

TIBCO ActiveMatrix Adapter for Database Installation

| 11
Chapter 2

Installing on Microsoft Windows Platforms

This chapter describes how to install TIBCO ActiveMatrix Adapter for Database on a Microsoft Windows platform.

Topics
Installation Prerequisites, page 12 Installing the Adapter on Microsoft Windows, page 16 Post-Installation Tasks, page 20

TIBCO ActiveMatrix Adapter for Database Installation

12

| Chapter 2

Installing on Microsoft Windows Platforms

Installation Prerequisites
Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements and that you have the prerequisite software installed. Product dependencies at install time are resolved at user level through the installation registry maintained at the user's home directory. See Installation Registry on page 3 for more information. The following is a list of prerequisites for installing the adapter on Microsoft Windows systems. These prerequisites are discussed in the next sections. Minimum Disk Space, page 12 Required TIBCO Products, page 12 Supported Databases, page 12 Supported Drivers, page 14

Minimum Disk Space The installer requires 85 MB of free space in the temp directory. The entire package is extracted into a temp folder, typically:
SystemDrive:\Temp or SystemDrive:\Documents and Settings\user_name\Local Settings\Temp

Required TIBCO Products

Before you can install the adapter, you must install TIBCO Runtime Agent. If you use the typical TIBCO Runtime Agent installation, the installer places all of its libraries and other products required by the adapter into the TIBCO HOME directory, C:\tibco. During adapter installation, the adapter installer checks for the availability of all required products. If any are not available, the installer immediately exits. When all products are available, you can proceed with the installation.

Supported Databases
One of the following databases must be installed and configured for your system before installing TIBCO ActiveMatrix Adapter for Database. You must be able to connect to the database before starting installation. On Oracle, both the Enterprise Edition and Standard Edition are supported.

TIBCO ActiveMatrix Adapter for Database Installation

Installation Prerequisites 13

The adapter supports both 32-bit and 64-bit versions, where applicable, for the databases listed below. The supported databases can be hosted on any platform supported by the database vendor. The adapter supports the following databases: Oracle 11g Oracle 10g/RAC Oracle 10g Oracle 9i/RAC Oracle 9i Microsoft SQL Server 2000 Microsoft SQL Server 2005 Sybase 12.5, 15 Sybase Adaptive Server Anywhere 9.0.2 DB2 UDB 8.1, 8.2, 9.1, 9.5 DB2 for z/OS v7x, v8.1 (via remote connection only) DB2 UDB V5R2, V5R3, V5R4 for iSeries (via remote connection only)

The adapter does not support Sybase Adaptive Server Anywhere 9.0.2 on the Microsoft Vista platform. Connecting to Remote Databases TIBCO ActiveMatrix Adapter for Database can remotely connect to databases running on other machines or different platforms, including a DB2 database running on z/OS or iSeries systems. See Connect to a DB2 z/OS Database on page 26 for details. TIBCO ActiveMatrix Adapter for Database cannot be installed on an z/OS or iSeries system.

TIBCO ActiveMatrix Adapter for Database Installation

14

| Chapter 2

Installing on Microsoft Windows Platforms

Supported Drivers
The adapter has been fully tested and certified against the JDBC and ODBC drivers listed in this section. Consult with your TIBCO representative before using the adapter with a driver not specifically listed here. JDBC Drivers TIBCO ActiveMatrix Adapter for Database uses JDBC to access your database during design-time. The correct JDBC driver is supplied with the TIBCO Runtime Agent installation package. When configuring the adapter, you specify the JDBC URL and the correct driver is automatically loaded. The JDBC URLs are documented in the TIBCO ActiveMatrix Adapter for Database Configuration and Deployment. ODBC Drivers The TIBCO ActiveMatrix Adapter for Database installation package includes the required ODBC drivers for use during runtime. ODBC drivers require one or two post-installation procedures, described in Post-Installation Tasks on page 20. The adapter also supports the following drivers, provided separately by the various database vendors. Consult with your TIBCO representative before using TIBCO ActiveMatrix Adapter for Database with an ODBC driver not specifically listed here.
ODBC Drivers for Oracle

ODBC driver included with the server installation. DataDirect Connect 5.30 ODBC driver.
ODBC Drivers for Microsoft SQL Server

ODBC driver included with the server installation. DataDirect Connect 5.3 ODBC driver.
ODBC Drivers for Sybase

ODBC driver included with the server installation. DataDirect Connect 5.3 ODBC driver.
ODBC Drivers Sybase Adaptive Server Anywhere

ODBC driver included with the server installation.

TIBCO ActiveMatrix Adapter for Database Installation

Installation Prerequisites 15

ODBC Drivers for DB2 UDB

DataDirect Connect 5.3 ODBC driver.

ODBC Drivers for DB2 z/OS or iSeries

DataDirect DB2 Wire Protocol 5.30 ODBC driver IBM drivers for DB2 z/OS on the Microsoft Windows platforms See Connect to a DB2 z/OS Database on page 26 for more information. ODBC Driver Documentation The DataDirect documentation is available in the install-path/odbc/help directory.

TIBCO ActiveMatrix Adapter for Database Installation

16

| Chapter 2

Installing on Microsoft Windows Platforms

Installing the Adapter on Microsoft Windows

You can either download the adapter package or install the package from a CD. The installer prompts you to accept the license agreement, then to choose to perform a typical install or custom install. A typical install has minimal prompts and installs standard components in default locations. A custom install prompts you to choose which components of the product suite to install and installs only those components.

The installer checks your system for the installation home directory that was established when TIBCO Runtime Agent was installed. The adapter is installed under the installation home directory. You must use the administrator account to install this product. If you do not have administrator privileges, the installer will exit. You must then log out of the system and log in as a user with the required privileges. If you are upgrading the adapter, or reinstalling a clean version of this release, you may uninstall the product first or let the installer take care of overwriting or removing existing files. If you are reinstalling over the same version: The software is automatically reinstalled where the previous version was installed. If any files are currently locked (that is, in use), the installer marks the file for deletion in the install location. After installation, the installer prompts you to reboot your system. You must reboot before using the software.

The following is a list of prerequisites for installing the adapter on Microsoft Windows systems. See Minimum Disk Space on page 12 for additional disk space requirements. Memory requirement for the adapter installation is around 512 MB. Table 6 Supported platforms and disk space requirements for Microsoft Windows Platform Microsoft Windows XP Professional Microsoft Windows Server 2003, 2008 Microsoft Windows Vista Hardware Platform x86 (32 and 64 bit platforms) Disk Space (MB) 84 MB

TIBCO ActiveMatrix Adapter for Database Installation

Installing the Adapter on Microsoft Windows 17

Installing on Microsoft Windows 2003 Terminal Server

There are two modes in Windows Terminal Server: Execute and Install. Users are logged on by default in Execute mode, which allows them to run applications. To install an adapter so that everyone can use it, log on as administrator in Install mode. When the adapter is installed in the Install mode, the installation registry is maintained in SystemDrive:\WINDOWS\. Windows Terminal Server must be running in remote admin mode, not application sharing mode. The adapter is not supported if installed on a machine that is using Windows Terminal Server in application sharing mode. The best way to install the adapter on Windows Terminal Server is to use the Add/Remove Programs control panel applet. This automatically sets your mode to Install during the installation and then back to Execute afterwards. Alternatively, you can manually change your mode to Install before starting the installation by typing the following at a command prompt:
C:\> change user /install

Change back to Execute mode after installation is complete by typing:

C:\> change user /execute

To check your current mode, type the following:

C:\> change user /query

Installing the Adapter

You can use any of the following modes to install TIBCO ActiveMatrix Adapter for Database on Microsoft Windows platforms: Install Using GUI, page 17 Install Using Console, page 18 Install in Silent Mode, page 18 Install and Generate a Response File, page 18 Install Using a Response File, page 19

Install Using GUI GUI mode performs the installation in an interactive graphical interface. The installer prompts you for values specific to your environment.Double-click on the executable appropriate for your platform

TIBCO ActiveMatrix Adapter for Database Installation

18

| Chapter 2

Installing on Microsoft Windows Platforms

Install Using Console Console mode allows you to install the software from a console window. The installer prompts you for values. When installing in console mode you can move through the installation process as shown: Enter Key = Moves forward in the installer. 2 = Goes back to previous screen. 3 = Cancels the installer and exits the installation or uninstallation. 4 = Redisplays the current screen.

Execute the installation program from a command window by typing:

<installation package> -s -a -is:javaconsole -console

Install in Silent Mode This mode installs the adapter in a command window without prompting you for any information during installation. It installs the adapter using default values. Execute the installation program from a command window by typing:
<installation package> -s -a -is:silent -silent

Install and Generate a Response File This installation is performed in Console mode or in a command window. The installer prompts you for information during installation and saves your answers in a response file. The response file can be used during subsequent installations to create another instance using the same values as the original installation, either with or without prompting for changes. Instructions for using the response file during subsequent installations are given in Install Using a Response File, below. To install using Console mode and generate a response file, type the following in a command window:
-options-record

<installation package> -s -a -is:javaconsole -console responseFilepath

To install in a terminal window and generate a response file, type the following at the command prompt (note there is no space between -options and -record):
<installation package> -a -options-record responseFilepath

The response file does not record selections at the component level. It does record all other selections, such as which products you installed.

TIBCO ActiveMatrix Adapter for Database Installation

Installing the Adapter on Microsoft Windows 19

Install Using a Response File This mode allows you to install the adapter in a command window using a response file (or an edited template file). Instructions for creating a response file and a template file are given above. The response file can be used in silent mode or interactive mode. In silent mode, you are not prompted during installation. The adapter is installed using the values in the response file. Type the following in a command window:
<installation package> -s -a -is:silent -silent -options responseFilepath

In interactive mode, you are prompted for values during installation. The values in the response file are presented as suggested defaults. Type the following in a command window:
<installation package> -a -options responseFilepath

TIBCO ActiveMatrix Adapter for Database Installation

20

| Chapter 2

Installing on Microsoft Windows Platforms

Post-Installation Tasks
Complete the following tasks to finish the installation process: Task A, Configure the Database Account Used by the Adapter, on page 20 Task B, Optionally Install Custom ODBC Drivers and Add to PATH, on page 21 Task C, Configure the ODBC System Data Source, on page 21 Task D, Install Additional TIBCO Software, on page 30 Additional Tasks on page 30

Task A Configure the Database Account Used by the Adapter SQL scripts are provided to set up the database account used by the adapter. The install-path\config directory contains subdirectories for supported databases. Each subdirectory contains one or more scripts that are specific to that database vendor. The create_user script creates a database user account with the necessary privileges required for the adapter. If you are using Oracle and will be using the alerter, this user also needs the privilege to access the alerter package. 1. Open a command window and change directory to your database directory. For example, for Oracle:
cd

<install-path>\tibco\adapter\adadb\<version_number>\config\oracle

2. Using a text editor, change the create_user script to identify the account name and password for the database user who will run the adapter. If you are using Oracle and will be using the alerter, also provide the account name to use. For example, for Oracle:
CREATE USER karlh IDENTIFIED BY adbuser; GRANT CONNECT, RESOURCE TO karlh IDENTIFIED BY adbuser; -- For Alerter use only GRANT EXECUTE on DBMS_AQ to karlh; GRANT EXECUTE on DBMS_AQADM to karlh;

This account is used to connect to the database and access tables created when configuring an adapter. Note that a publication source table or subscription destination table can belong to a different schema than the default specified in the create_user script. For more information, see the TIBCO ActiveMatrix Adapter for Database Configuration and Deployment.

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 21

3. Execute the create_user script as the database administrator. For example, for Oracle:
sqlplus

dba_userid/dba_pswd@service @create_user.sql

4. If you are using Oracle and will be using the alerter, also execute the alerter.sql script. This script sets up the tables used by the alerter. Use the database user account created in step 2. For example:
sqlplus

userid/pswd@service @alerter.sql

Task B Optionally Install Custom ODBC Drivers and Add to PATH Perform the following procedure, only if you are using database drivers supplied by your database vendor, instead of the database drivers provided by TIBCO. If you are using Oracle with a non wire protocol driver, you must provide the Oracle_Home\bin location to the tibco.env.CUSTOM_PATH property in the
<install-path>\tibco\adapter\adadb\<version_number>\bin\adbagent.tra

properties file. 1. Install the ODBC drivers according to the instructions provided by your database vendor. 2. Add the location of your drivers to the Path system variable according to the instructions provided by your database vendor. 3. Continue with Task C. Task C Configure the ODBC System Data Source If you are using a DB2 z/OS database, proceed to Connect to a DB2 z/OS Database on page 26. This task applies to all other databases. You must define a System DSN, not a User DSN. If you define a User DSN, the adapter will not be visible in the TIBCO Administrator GUI. 1. Navigate to the Control Panel, then locate and double-click the Data Sources (ODBC) icon.

TIBCO ActiveMatrix Adapter for Database Installation

22

| Chapter 2

Installing on Microsoft Windows Platforms

2. Click the System DSN tab, then click Add... .

3. Select an ODBC driver and click Finish.

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 23

4. In the ODBC Driver Setup dialog, type appropriate values in the fields. Click the Help button for an explanation of each field.

TIBCO ActiveMatrix Adapter for Database Installation

24

| Chapter 2

Installing on Microsoft Windows Platforms

5. In the Advanced tab, select the Procedure Returns Results checkbox. This is necessary for the ODBC driver to return retrieved data from stored procedures for Request-Reply operations. Also, the Enable Timestamp with Timezone checkbox should be selected. For more information, see TIBCO ActiveMatrix Adapter for Database Configuration and Deployment. Fill in the other fields as required for your configuration, or accept the defaults. 6. Click Apply, then click Test
Connect

to test the connection.

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 25

7. In the ODBC Driver Setup dialog, click OK to save the object, then click OK to exit.

TIBCO ActiveMatrix Adapter for Database Installation

26

| Chapter 2

Installing on Microsoft Windows Platforms

Connect to a DB2 z/OS Database The adapter can connect to a DB2 database running on z/OS. (The Adapter itself cannot run on z/OS.) In order to do so, you need to create ODBC and JDBC packages on the machine where DB2 z/OS is running. Once the packages are created, they can be used by PUBLIC. The packages can be used as long as you are using the TIBCO 5.00 DB2 Wire Protocol driver. If you upgrade to a newer driver, you will need to repeat these procedures with the new driver. For this procedure, the z/OS system logon and password must have DB2 BIND authority. For more information, see the section Connect ODBC for DB2 Wire Protocol in the DataDirect Connect ODBC Reference, available in <install-path>\tibco\adapter\adadb\<version_number>\odbc\help. To create the ODBC packages on the machine where DB2 z/OS database is running: 1. On the machine where TIBCO ActiveMatrix Adapter for Database is installed, navigate to the Control Panel, then locate and double-click the Data Sources (ODBC) icon. 2. Click the System DSN tab, then click Add... .

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 27

3. At the Create New Data Source dialog, select TIBCO 5.30 DB2 Wire Protocol and click Finish.

TIBCO ActiveMatrix Adapter for Database Installation

28

| Chapter 2

Installing on Microsoft Windows Platforms

4. Fill in the fields on the ODBC DB2 Wire Protocol Driver Setup dialog according to the configuration of the machine where DB2 for z/OS is running. The dialog below shows sample data. Click Help for the field descriptions.

5. Click the Modify Bindings tab to display the following dialog. Fill in these fields according to the configuration of the machine where DB2 for z/OS is

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 29

running. The dialog below shows sample data. Click Help for field descriptions.

6. Click Modify Binding to generate the ODBC packages on the machine where DB2 for z/OS is running. You will need your z/OS system logon and password. A status message displays when the packages are created. To verify the packages, submit a SQL statement to execute in DB2 for z/OS using, for example, SPUFI from TSO/ISPF or DB2 Command Center from NT. The following statement uses the values shown in step 4 above; use values that are appropriate to your configuration.
SELECT * FROM SYSIBM.SYSPACKAGE where name like DEF00% and COLLI = DATADIRECT00

If output similar to the following appears, the packages have been successfully created.
LOCATION COLLID NAME CONTOKEN ---------+---------+---------+---------+---------+------DATADIRECT00 DEF00A . DATADIRECT00 DEF00B . DATADIRECT00 DEF00C .

To create the JDBC packages on the machine where DB2 for z/OS is running:
TIBCO ActiveMatrix Adapter for Database Installation

30

| Chapter 2

Installing on Microsoft Windows Platforms

1. On the machine where TIBCO ActiveMatrix Adapter for Database is installed, start TIBCO Designer and display the Connection tab for the adapter. 2. Enter the following JDBC driver and URL information: JDBC Driver JDBC URL
tibcosoftwareinc.jdbc.db2.DB2Driver

jdbc:tibcosoftwareinc:db2://servername:port;

locationName=DB2locationName;collectionName=DATADIRECT00;packag eName=DEF00;createDefaultPackage=true;embedded=true

3. Click Test Connection to generate the JDBC packages on the machine where DB2 for z/OS is running. You will need your z/OS system logon and password. When the packages are created, a Successful Connection message displays and three packages are cataloged in DB2 for z/OS. To verify the packages, submit a SQL statement to execute in DB2 for z/OS using, for example, SPUFI from TSO/ISPF or DB2 Command Center from NT. The following statement uses the values shown in step 2 above; use values that are appropriate to your configuration.
SELECT * FROM SYSIBM.SYSPACKAGE where name like 'DEF00%' and COLLID = 'DATADIRECT00'

If output similar to the following appears, the packages have been successfully created.
LOCATION COLLID NAME CONTOKEN ---------+---------+---------+---------+---------+------DATADIRECT00 DEF00A .. DATADIRECT00 DEF00B .. DATADIRECT00 DEF00C ..

Task D Install Additional TIBCO Software If you will be using any of the following TIBCO products, install them now. These products are not provided with TIBCO ActiveMatrix Adapter for Database. TIBCO Administrator TIBCO ActiveMatrix BusinessWorks

Additional Tasks
If using the SSL feature for ODBC drivers, the path to the driver libraries should be added to the environment variable PATH. For example, set
PATH=<ADB_HOME>\odbc\Drivers;%PATH%

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 31

TIBCO ActiveMatrix Adapter for Database is now installed. See the TIBCO ActiveMatrix Adapter for Database Configuration and Deployment for additional configuration tasks and instructions for performing various procedures, including tutorials.

TIBCO ActiveMatrix Adapter for Database Installation

32

| Chapter 2

Installing on Microsoft Windows Platforms

TIBCO ActiveMatrix Adapter for Database Installation

| 33
Chapter 3

Installation on UNIX Platforms

This chapter describes how to install TIBCO ActiveMatrix Adapter for Database on UNIX platforms.

Topics
Installation Prerequisites, page 34 Installing TIBCO ActiveMatrix Adapter for Database on UNIX, page 37 Post-Installation Tasks, page 41

TIBCO ActiveMatrix Adapter for Database Installation

34

| Chapter 3

Installation on UNIX Platforms

Installation Prerequisites
Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements and that you have the prerequisite software installed. Product dependencies at install time are resolved at user level through the installation registry maintained at the user's home directory. See Installation Registry on page 3 for more information. The following is a list of prerequisites for installing the adapter on Microsoft Windows systems. See Installer Disk Space Requirements in Temporary Area on page 34 for additional disk space requirements.

Minimum Disk Space

Installer Disk Space Requirements in Temporary Area The installer launcher first extracts a Java Virtual Machine (JVM) in a temporary directory and uses this JVM to launch itself. The size of the extracted JVM differs from platform to platform. On UNIX platforms, 85 MB of disk space is required in the temporary area. If your system does not have sufficient free disk space, you can still run the installer with a different temporary area by using the following option when starting the installer:
<installation package> -is:tempdir /new_tmp

where new_tmp has sufficient free disk space. See Table 7 for the disk space requirement.

Supported Databases
One of the following databases must be installed and configured for your system before installing TIBCO ActiveMatrix Adapter for Database. On Oracle, Enterprise Edition and Standard Edition are supported. The adapter supports both 32-bit and 64-bit versions, where applicable, for the databases listed below. On the HP-UX Itanium platform, the adapter runs in the 64-bit mode. The supported databases can be hosted on any platform supported by the database vendor.

TIBCO ActiveMatrix Adapter for Database Installation

Installation Prerequisites 35

The adapter supports the following databases: Oracle 11g Oracle 10g/RAC Oracle 10g Oracle 9i/RAC Oracle 9i Sybase 12.5 Sybase 15 DB2 UDB 8.1, 8.2 for Unix DB2 UDB v7x, v8.1 for z/OS (via remote connection only) DB2 UDB V5R2, V5R3, V5R4for iSeries (via remote connection only)

The DB2 UDB v7x and v8.1 for z/OS (via remote connection only) database is not supported on the Red Hat Linux platforms. Connecting to Remote Databases TIBCO ActiveMatrix Adapter for Database can remotely connect to databases running on other machines or different platforms, including a DB2 database running on z/OS or iSeries. See Post-Installation Tasks on page 41 for details.

Supported Drivers
The adapter has been fully tested and certified against the JDBC and ODBC drivers listed in this section. Consult with your TIBCO representative before using the adapter with a driver not specifically listed here. JDBC Drivers TIBCO ActiveMatrix Adapter for Database can use JDBC to access your database. The correct JDBC driver is supplied with each adapter package. When configuring an adapter, you specify the JDBC URL and the correct package is automatically loaded.

TIBCO ActiveMatrix Adapter for Database Installation

36

| Chapter 3

Installation on UNIX Platforms

ODBC Drivers The TIBCO ActiveMatrix Adapter for Database installation package includes the required ODBC drivers for use during runtime. ODBC drivers require a post-installation procedure, described in Configure the ODBC System Data Source on page 42. The adapter also supports the following drivers, provided separately by the various database vendors. Consult with your TIBCO representative before using TIBCO ActiveMatrix Adapter for Database with an ODBC driver not specifically listed here.
On Solaris, HP-UX, AIX and Linux

ODBC Drivers for Oracle

DataDirect Oracle ODBC 5.3 (wire format and non-wire format).

ODBC Drivers for Sybase

DataDirect Connect ODBC 5.3

ODBC Drivers for DB2 UDB

DataDirect Connect ODBC 5.3

ODBC Drivers for DB2 z/OS or iSeries

DataDirect Connect ODBC 5.3 ODBC Driver Documentation The DataDirect documentation is available in the install-path/odbc/help directory.

TIBCO ActiveMatrix Adapter for Database Installation

Installing TIBCO ActiveMatrix Adapter for Database on UNIX 37

Installing TIBCO ActiveMatrix Adapter for Database on UNIX

You can either download the adapter package or install the package from a CD. The installer prompts you to accept the license agreement, then to choose to perform a typical install or custom install. A typical install has minimal prompts and installs standard components in default locations. A custom install prompts you to choose which components of the product suite to install and installs only those components.

The installer checks your system for the installation home directory that was established when TIBCO Runtime Agent was installed. The adapter is installed under the installation home directory. If you are upgrading the adapter, or reinstalling a clean version of this release, you may uninstall the product first or let the installer take care of overwriting or removing existing files. If you are reinstalling over the same version: You are not prompted to supply the installation location. The software is automatically reinstalled where the previous version was installed. If any files are currently locked (that is, in use), the installer marks the file for deletion in the install location. After installation, the installer prompts you to reboot your system. You must reboot before using the software.

Memory requirement for the adapter installation is around 512 MB. Table 7 Supported platforms and disk space requirements for UNIX systems Platform Solaris 8 Solaris 9 Solaris 10 Solaris 10 x86 (32 and 64 bit platforms) HP-UX 11i PA-RISC (32 and 64 bit platforms) 400 MB 400 MB Hardware Platform SPARC (32 and 64 bit platforms) Disk Space (MB) 400 MB

TIBCO ActiveMatrix Adapter for Database Installation

38

| Chapter 3

Installation on UNIX Platforms

Table 7 Supported platforms and disk space requirements for UNIX systems Platform HP-UX 11.x Itanium (ia64) Hardware Platform Itanium (64 bit platforms) Disk Space (MB) 400 MB

AIX 5.2, 5.3, 6.1

POWER (32 and 64 bit platforms)

400 MB

Red Hat Enterprise Linux 4.0, 4.5, 4.6, 4.7, 5.0, 5.1, 5.2 SUSE Enterprise Server Linux 9.3, 10.1

x86 (32 and 64 bit platforms)

400 MB

Installing the Adapter

You can use any of the following modes to install the adapter. Before proceeding with the installation, untar the installation package. Install Using GUI, page 38 Install Using Console, page 39 Install in Silent Mode, page 39 Install and Generate a Response File, page 39 Install Using a Response File, page 40

Install Using GUI A window environment such as CDE (for example, X Windows) is required to run the installer in GUI mode. GUI mode performs the installation in an interactive graphical interface. The installer prompts you for values specific to your environment. Execute the installation program by typing the following in a terminal window:
% ./<installation

package>

TIBCO ActiveMatrix Adapter for Database Installation

Installing TIBCO ActiveMatrix Adapter for Database on UNIX 39

Install Using Console Console mode allows you to install the software in a console window. The installer prompts you for values. When installing in console mode you can move through the installation process as shown: Enter Key = Moves forward in the installer. 2 = Goes back to previous screen. 3 = Cancels the installer and exits the installation or uninstallation. 4 = Redisplays the current screen.

Execute the installation program by typing the following in a terminal window:

% ./<installation

package> -console

Install in Silent Mode This mode installs the adapter in a terminal window without prompting you for any information during installation. It installs the adapter using default values. Execute the installation program by typing the following in a terminal window:
% ./<installation

package> -silent

Install and Generate a Response File This installation is performed in a console window or a terminal window. The installer prompts you for information during installation and saves your answers in a response file. The response file can be used during subsequent installations to create another instance using the same values as the original installation, either with or without prompting for changes. Instructions for using the response file during subsequent installations are given in Install Using a Response File, below. To install using Console mode and generate a response file, type the following in a terminal window (note there is no space between -options and -record):
% ./<installation

package> -console -options-record responseFilepath

To install the software in a terminal window and generate a response file, type the following in a terminal window (note there is no space between -options and -record):
% ./<installation

package> -options-record

responseFilepath

The response file does not record selections at the component level. It does record all other selections, such as which products you installed.

TIBCO ActiveMatrix Adapter for Database Installation

40

| Chapter 3

Installation on UNIX Platforms

Install Using a Response File This mode allows you to install the adapter in a terminal window using a response file (or an edited template file). Instructions for creating a response file and a template file are given above. The response file can be used in silent mode or interactive mode. In silent mode, you are not prompted for values; the adapter is installed using the values in the response file. Type the following in a terminal window:
% ./<installation

package> -silent -options responseFilepath

In interactive mode, you are prompted for values during installation. The values in the response file are presented as suggested defaults. To install using a response file in interactive mode, type the following in a terminal window:
% ./<installation

package> -options responseFilepath

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 41

Post-Installation Tasks
After installation, perform the following tasks. Task A, Set Environment Variables, on page 41 Task B, Set Directory Permissions, on page 41 Task C, Configure the ODBC System Data Source, on page 42 Task D, Install Additional TIBCO Software, on page 43

Task A Set Environment Variables Certain changes to the environment variable settings are required before running TIBCO ActiveMatrix Adapter for Database. Execute the appropriate file to automatically make these changes.
When using the Oracle non-wire protocol driver, ODBC_HOME/lib

must always appear in LD_LIBRARY_PATH before any database vendor's lib directory, such as ORACLE_HOME/lib. For csh, execute install-path/bin/adbagent_env.csh, as shown:
% source adbagent_env.csh

For sh and ksh, execute install-path/bin/adbagent_env.sh, as shown:

$ . adbagent_env.sh

The file modifies the following environment variables on UNIX platforms:

PATH SHLIB_PATH

(on HP-UX only) (on Solaris, Red Hat Linux, SUSE Linux)

LD_LIBRARY_PATH LIBPATH

(on AIX only)

Task B Set Directory Permissions Depending on whether a repository server is used, and whether TIBCO Administrator is used to set access permissions, users may need a TIBCO Administrator account. See your TIBCO Administrator guide for details. Make sure that all adapter users have read and write permissions for the odbc.ini file. This file is located ininstall-path/odbc.

TIBCO ActiveMatrix Adapter for Database Installation

42

| Chapter 3

Installation on UNIX Platforms

Make sure that all adapter users have read, write, and execute permissions for the following directories where the adapter files and configuration information is stored:
DB2 for z/OS$TIBCO_HOME/adapter/adadb/<version_number>/bin $TIBCO_HOME/adapter/adadb/<version_number>/logs $TIBCO_HOME/adapter/adadb/<version_number>/ledger $TIBCO_HOME/adapter/adadb/<version_number>/sql $TIBCO_HOME/tra/<TRA_version_number>/logs $TIBCO_HOME/logs

For example, if you installed the adapter in /opt/tibco, you can make these directories writable for all other users by executing the following commands:
% % % % % chmod chmod chmod chmod chmod a+w a+w a+w a+w a+w /opt/tibco/adapter/adadb/<version_number>/bin /opt/tibco/adapter/adadb/<version_number>/logs /opt/tibco/adapter/adadb/<version_number>/ledger /opt/tibco/adapter/adadb/<version_number>/sql /opt/tibco/tra/<TRA_version_number>/logs

Task C Configure the ODBC System Data Source The data source on UNIX systems is configured using the odbc.ini file. This file is located ininstall-path/odbc. For Oracle, the EnableTimestampWithTimeZone parameter in the odbc.ini file should be set to 1. For more information, see TIBCO ActiveMatrix Adapter for Database Configuration and Deployment. Refer to the ODBC driver documentation for information on configuring your system data sources. The adapter can connect to a DB2 database running on z/OS. (TIBCO ActiveMatrix Adapter for Database itself cannot run on z/OS.) In order to connect to the database, you need to create ODBC and JDBC packages on the machine where DB2 for z/OS is running. Once the packages are created, they can be used by PUBLIC. The packages can be used as long as you are using the TIBCO 5.30 DB2 Wire Protocol driver. If you upgrade to a newer driver, you will need to repeat these procedures with the new driver. For this procedure, the z/OS system logon and password must have DB2 BIND authority. If connecting to a DB2 for z/OS database, follow the instructions in the section Configuring Data Sources in Chapter 3 of the DataDirect Connect ODBC Reference, available in install-path\doc\help.

TIBCO ActiveMatrix Adapter for Database Installation

Post-Installation Tasks 43

If you are using Oracle with a non wire protocol driver, you must provide the Oracle_Home/bin location to the tibco.env.CUSTOM_PATH property in the
<install-path>/tibco/adapter/adadb/<version_number>/bin/adbagent.tra

properties file. Task D Install Additional TIBCO Software If you will be using any of the following TIBCO products, install them now. These products are not provided with TIBCO ActiveMatrix Adapter for Database. TIBCO Administrator TIBCO ActiveMatrix BusinessWorks

TIBCO ActiveMatrix Adapter for Database Installation

44

| Chapter 3

Installation on UNIX Platforms

TIBCO ActiveMatrix Adapter for Database Installation

| 45
Chapter 4

Installation FAQs and Troubleshooting

This section lists some common installation errors along with their causes and solutions.

Topics
Setting the DISPLAY Variable on UNIX, page 46 JRE and JVM, page 47 Configuring TIBCO Hawk, page 48 Cannot Install the Adapter, page 49

TIBCO ActiveMatrix Adapter for Database Installation

46

| Chapter 4

Installation FAQs and Troubleshooting

Setting the DISPLAY Variable on UNIX

The installer on UNIX usually opens an additional window for graphics when operating in GUI mode. The DISPLAY environment variable tells the installer on which computer to open the window. If this variable is not set, the installer will either wait or abort after displaying the following output:
InstallShield Wizard Initializing InstallShield Wizard... Preparing Java(tm) Virtual Machine... ................................... ................................... ........

You set the DISPLAY variable to the IP address or name of the computer on which the installer graphics window are to be displayed, followed by a screen address, which can be :0.0. For example:
# Bourne shell DISPLAY=ip_address:0.0; export DISPLAY # Korn shell export DISPLAY=ip_address:0.0 # C-shell setenv DISPLAY

ip_address:0.0

For example, consider a scenario where you need to install the adapter on a remote HP-UX machine (named itaska). Because you have a Solaris 5.6 machine (named alaska) that has a video card and monitor installed, you can run an X-window application on it. So you decide to telnet to itaska from alaska. When you telnet to itaska, you will not get access to itaska's monitor and will be unable to display an X-window application. That is why you must set the DISPLAY variable, which instructs the X-server to redirect all windows to the computer set in the variable. Before doing so, the computer (specified in the DISPLAY variable) must give permissions to share its monitor.
alaska> xhost + # give permission for all to its share monitor alaska> telnet itaska Welcome to HP-UX itaska 11.00 User: Password: itaska> export DISPLAY=alaska:0.0 # set display on alaska itaska> <installation package>

TIBCO ActiveMatrix Adapter for Database Installation

JRE and JVM 47

JRE and JVM

What should I do if JVM crashes when I run the installer? The installer first extracts the bundled JVM into a temporary area and then uses it to launch itself. If the JVM crashes, you can still run the installer using another JVM, preferably JVM 1.3.1 or higher. The syntax is shown below. For Windows:
<installation package> -s -a -is:javahome C:\j2sdk1.4.0

For UNIX (using Solaris 8 as an example):

<installation package> -is:javahome /opt/jre140

The javahome directory must contain bin/java.exe or bin/java. The installer will use your JRE to launch itself.

TIBCO ActiveMatrix Adapter for Database Installation

48

| Chapter 4

Installation FAQs and Troubleshooting

Configuring TIBCO Hawk

Problem Description TIBCO Runtime Agent includes the TIBCO Hawk Agent only. If you install the full TIBCO Hawk package after installing TIBCO Runtime Agent and do not have a Java Runtime Environment (other then the TIBCO JRE) installed, the TIBCO Hawk Configuration tool is unable to determine the Java home location and the JVM executable. The TIBCO Hawk services will not start correctly and you will be unable to start the TIBCO Hawk Display. Resolution 1. Start the TIBCO Hawk Configuration tool. For example, on Microsoft Windows: Start>TIBCO>TIBCO Hawk>Hawk Configuration 2. Under the General tab, click Advanced. 3. In the Java
Home Directory

field, provide the path to Java. For example:

C:\tibco\jre\1.5.0 4. In the JVM java.exe The services will start properly and TIBCO Hawk Display will run.
Executable

field, provide the JVM executable. For example:

TIBCO ActiveMatrix Adapter for Database Installation

Cannot Install the Adapter 49

Cannot Install the Adapter

On HP-UX and AIX platforms, even though the correct version of TIBCO Runtime Agent version is already installed on the system, installation of an adapter that depends on TIBCO Runtime Agent may fail in the dependency resolution. The TIBCO product installer maintains the registry information in the vpd.properties.tibco.systemName file. The value for systemName is determined by InetAddress.getLocalHost().getHostName(). However, the method getHostName(), returns different values based on the JRE versions used. For example, on AIX, JRE 1.3.1 returns only systemName, whereas JRE 1.4.0 returns systemName.domainName. Because of this, the installer is not able to load the correct registry file. Resolution On UNIX platforms, the installer registry file vpd.properties.tibco.systemName is located in the user's home directory. Case 1: If the vpd.properties.tibco.systemName file exists:
$ cd user's_home_directory $ ln -s vpd.properties.tibco.systemName vpd.properties.tibco.systemName.domainName

For example:
$ cd ~ $ ln -s vpd.properties.tibco.upside vpd.properties.tibco.upside.tibco.com

where upside is systemName, and tibco.com is domainName Case 2: If the vpd.properties.tibco.systemName.domainName file exists:
$ cd user's_home_directory $ ln -s vpd.properties.tibco.systemName.domainName vpd.properties.tibco.systemName

For example:
$ cd ~ $ ln -s vpd.properties.tibco.upside.tibco.com vpd.properties.tibco.upside

where upside is systemName, and tibco.com is domainName.

TIBCO ActiveMatrix Adapter for Database Installation

50

| Chapter 4

Installation FAQs and Troubleshooting

TIBCO ActiveMatrix Adapter for Database Installation

|1

Index

C
Configure adapter database account 20 ODBC system data source 42 Connect remote database 26 create_user.sql script 20 Customer Support ix

T
TIBCO_HOME vii

E
ENV_HOME vii

J
JDBC drivers 14

O
ODBC drivers 14 ODBC drivers documentation 15, 36

S
scripts create_user.sql 20

TIBCO ActiveMatrix Adapter for Database Installation

| Index

TIBCO ActiveMatrix Adapter for Database Installation