TIBCO ActiveMatrix Adapter for Kenan/BP Installation

TIBCO ActiveMatrix Adapter for Kenan/BP Installation
TIBCO ActiveMatrix® Adapter
for Kenan/BP
Installation
Software Release 6.0
November 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, TIBCO ActiveMatrix Administrator, 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
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
TIBCO ActiveMatrix Adapter for Kenan/BP Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Other TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Third-Party Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
How to Contact TIBCO Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Installer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstalling the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installer Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Major, Minor and Patch Releases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Calculating Available Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
2
2
3
3
4
4
5
Adapter Components and Additional TIBCO Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Adapter Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Required and Optional TIBCO Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Pre-Installation Worksheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Adapter Machine Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Kenan/BP User Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Kenan/BP Client Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Kenan/BP Software Required before installing the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Test Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapter 2 Installing on Microsoft Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Minimum Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Required TIBCO Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installing the Adapter on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installing the Adapter on 2003 Terminal Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing the Adapter on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
iv
| Contents
Chapter 3 Installation on UNIX Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Minimum Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Required TIBCO Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Supported Kenan/BP Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18
18
19
19
Installing TIBCO ActiveMatrix Adapter for Kenan/BP on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing on AIX 5.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing the Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Combining Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20
21
21
23
Post-Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Appendix A Installation FAQs and Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Running Out of Disk Space. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Installation Error on HP-UX 11.00 64 bit Platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Cannot Install the Adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Configuring TIBCO Hawk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Tables v
|
Tables
Table 1
General Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Table 2
TIBCO ActiveMatrix Adapter Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Table 3
Required and Optional TIBCO Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Table 4
Adapter Machine Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Table 5
Kenan/BP User Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Table 6
Supported platforms, Package Name, and Disk Space for Microsoft Windows. . . . . . . . . . . . . . . 13
Table 7
Supported UNIX Platforms, Package Name, and Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
vi
| Tables
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
| vii
Preface
This document describes how to install TIBCO ActiveMatrix Adapter for
Kenan/BP 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 viii
•
Typographical Conventions, page x
•
How to Contact TIBCO Support, page xii
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
viii
| Related Documentation
Related Documentation
This section lists documentation resources you may find useful.
TIBCO ActiveMatrix Adapter for Kenan/BP Documentation
The following documents form the TIBCO ActiveMatrix Adapter for Kenan/BP
documentation set:
•
TIBCO ActiveMatrix Adapter for Kenan/BP Concepts Read this manual to gain
an understanding of the product that you can apply to the various tasks you
may undertake.
•
TIBCO ActiveMatrix Adapter for Kenan/BP Installation Read this manual for
instructions on site preparation and installation.
•
TIBCO ActiveMatrix Adapter for Kenan/BP Configuration and Deployment Read
this manual for instructions on creating, configuring, and deploying adapter
projects.
•
TIBCO ActiveMatrix Adapter for Kenan/BP Examples Read this manual to work
through the examples provided with the adapter.
•
TIBCO ActiveMatrix Adapter for Kenan/BP Release Notes Read the release notes
for a list of new and changed features. This document also contains lists of
known issues and closed issues for this release.
Other TIBCO Product Documentation
You may find it useful to read the documentation for the following TIBCO
products. Note that only books that relate to adapters are listed. Each of the books
is available from the doc directory in the product’s installation area.
•
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 Kenan/BP Installation
Preface ix
|
Third-Party Documentation
You may also find it useful to read the followingKenan/BP documentation:
•
API TS Guide
•
API TS Reference
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
x
| Typographical Conventions
Typographical Conventions
The following typographical conventions are used in this manual.
Table 1 General Typographical Conventions
Convention
Use
TIBCO_HOME
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.
ENV_HOME
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 ActiveMatrix
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 Kenan/BP Installation
Preface xi
|
Table 1 General Typographical Conventions (Cont?)
Convention
Use
Key
combinations
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 Kenan/BP Installation
xii
| How to Contact TIBCO Support
How to Contact TIBCO 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 Kenan/BP Installation
|1
Chapter 1
Introduction
This chapter provides an overview of the installer, the installation registry, and
the additional software required before you can install TIBCO ActiveMatrix
Adapter for Kenan/BP.
Topics
•
Installer Overview, page 2
•
Adapter Components and Additional TIBCO Software, page 6
•
Pre-Installation Worksheets, page 8
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
2
| Chapter 1
Introduction
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:
TIBCO_HOME/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 Kenan/BP Installation
Installer Overview 3
|
Installer Mode
The installer allows you to run it in different modes. Each mode is supported on
all platforms.
•
GUI mode
•
Console mode
•
Silent mode
GUI Mode
In GUI mode, the installer presents panels that allow you to make choices about
product selection, product location, and so on. When you invoke the installer by
double-clicking on the icon, GUI mode is used.
Console Mode
Console mode allows you to run the installer from the command prompt or
terminal window. This is useful if your machine does not have a Windows
environment.
Silent Mode
Silent mode either installs using default settings or uses a response file that was
saved during an earlier installation. Silent mode installs without prompting you
for information.
•
•
If no response file has been recorded earlier and you invoke the installer with
the -silent argument, the default installation parameters are used.
If a response file exists, and the installer is started with -options
responseFileName as an argument, the installer uses the values specified by the
user when the response file was generated.
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 want 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.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
4
| Chapter 1
Introduction
For example, if you have installed the 5.3.0 release and are upgrading to a
6.0.0 release, the 6.0 release will be installed under the new 6.0 directory. This
allows both the 6.0 and 5.3 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
Kenan/BP 5.3.0 to 5.3.1 by replacing the contents of the 5.3 directory.
•
If you are upgrading the adapter or reinstalling a clean version of the
software, you may uninstall the product first or allow the installer to perform
the upgrade or reinstall action.
•
If you are reinstalling over the same adapter 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 installing location. After installation, the installer
prompts you to reboot your system. You must reboot before using the
software.
Calculating Available Disk Space
The installer calculates the disk space required in the adapter's 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 adapter's 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 Kenan/BP Installation
Installer Overview 5
|
Microsoft Windows Platforms
TIBCO ActiveEnterprise 5.x products maintain the installation registry in the
SystemDrive:\windows folder. The following files represent the installation
registry:
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_Directory/vpd.properties
User_Home_Directory/vpd.properties.tibco.systemName
On Solaris and HP-UX, if installation is performed by a super-user (root), the
installation registry is maintained in the root user’s home directory (which is /) as
two 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.
Do not edit, modify, rename, move, or remove the
TIBCOInstallationHistory.xml file.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
6
| Chapter 1
Introduction
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 Kenan/BP adapter on another machine.
Adapter Components
Table 2 describes the components of the adapter installation package.
Table 2 TIBCO ActiveMatrix Adapter Components
Component
Description
Runtime
This process does the actual work of passing and converting data to and from the
vendor application.
Parameters of data exchanges are stored in projects created using the adapter
palette and the design-time adapter.
Note that the TIBCO ActiveMatrix Adapter for Kenan/BP runtime component is
not installed on the Microsoft Windows platforms.
Design time
Adapter-specific GUI that is loaded in TIBCO Designer.
This component includes the palette and samples that demonstrate how TIBCO
ActiveMatrix Adapter for Kenan/BP interacts with TIBCO ActiveMatrix
BusinessWorks.
Documentation
This component is required for context-sensitive help.
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.
Table 3 describes the TIBCO Runtime Agent and the additional TIBCO products
you may be installing. For the supported versions of the listed products, refer to
TIBCO ActiveMatrix Adapter for Kenan/BP readme.txt.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Adapter Components and Additional TIBCO Software 7
|
Table 3 Required and Optional TIBCO Products
Product
Purpose
TIBCO Runtime
Agent
Required. TIBCO Runtime Agent supplies a number of TIBCO and third-party libraries
used by the adapter and other TIBCO products both at design-time and runtime. This
includes, for example, TIBCO Rendezvous software.
You must install TIBCO Runtime Agent on each machine that hosts an adapter. TIBCO
Runtime Agent must be installed before you install the adapter.
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 exceed 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 TIBCO ActiveMatrix BusinessWorks.
TIBCO ActiveMatrix BusinessWorks is available as a separate installation and can be
installed after installing the adapter.
TIBCO
Enterprise
Message Service
Optional. TIBCO Enterprise Message Service allows you to use the Java Messaging
Services (JMS) as the message transport for your adapter.
TIBCO Enterprise Message Service is available as a separate installation and can be
installed after the adapter is installed.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
8
| Chapter 1
Introduction
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. It provides a checklist of parameters you should obtain from various
system administrators within your organization before installing the adapter.
The information below is required during installation of TIBCO ActiveMatrix
Adapter for Kenan/BP.
Adapter Machine Information
Table 4 provides a checklist of parameters you should obtain from various system
administrators within your organization before installing the adapter.
Table 4 Adapter Machine Information
Adapter Information
Description
Hostname
Name of the machine on which the adapter
is being installed.
(Example: adapter1.tibco.com)
IP address
(Example: 192.168.12.12)
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)
Installer user password
Password for the installer user account
above.
Installer user domain
Network domain to which the user account
above belongs.
(Windows only)
(Example: ENGR2)
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Value for Your Machine
Pre-Installation Worksheets 9
|
Table 4 Adapter Machine Information
Adapter Information
Description
Value for Your Machine
Adapter installation package
Obtain the correct TIBCO ActiveMatrix
Adapter for Kenan/BP installation package.
This is available on CD, FTP, network drive,
or download.tibco.com.
Disk and path on which to
install adapter
(Example: /opt/tibco)
How will machine be accessed
[ ] directly [ ] terminal server [ ] xterm [ ] telnet
[ ] other: ………………………
How will installation files be
transferred to machine
[ ] CD-drive [ ] internet download [ ] FTP to machine
[ ] network disk mounting
Kenan/BP User Information
Obtain the following information for the account you will use to access the
Kenan/FX Security Server.
Table 5 Kenan/BP User Information
Field Name
Field Description
Username:
Valid User ID to logon to the Kenan/FX
Security Server.
(Example: arborsv)
Password:
Field Value
Password to logon to the Kenan/FX
Security Server.
(Example: csgfx)
Kenan/BP Client Software
Please specify where software for the Kenan/BP client can be found within your
organization:
[ ] It's already installed on the adapter machine.
Location on disk: ………………………….
[ ] Installation files are available via:
FTP (Server : ………… User : ………… Password: ……… )
Disk mount (full path: ………………………………………..)
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
10
| Chapter 1
Introduction
CD provided during install by (name/extension) : ………………………..
It is not mandatory to have a Kenan/BP client to run the adapter.
Kenan/BP Software Required before installing the Adapter
The Kenan/BP components given below need not be installed on the machine
you intend to install the adapter. But these components are required for running
the adapter. For the supported versions of the listed products, refer to TIBCO
ActiveMatrix Adapter for Kenan/BP readme.txt.
•
Kenan/BP
•
Kenan/FX Middleware
•
Kenan/BP Database
•
Kenan/BP API-TS
•
BEA Tuxedo
• JRE
Ensure that the prerequisite software for Kenan/BP contains the latest patches
as specified in the Kenan/BP Software Product Description.
Test Connectivity
If you install the Kenan/BP client, start it and ensure you can connect to the
Kenan/BP server using the username and password that you were provided by
your administrator.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
| 11
Chapter 2
Installing on Microsoft Windows Platforms
This chapter describes how to install TIBCO ActiveMatrix Adapter for Kenan/BP
on the supported Microsoft Windows platforms.
Topics
•
Installation Prerequisites, page 12
•
Installing the Adapter on Microsoft Windows, page 13
TIBCO ActiveMatrix Adapter for Kenan/BP 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 4 for more information.
The following is a list of prerequisites for installing the adapter on Microsoft
Windows platforms.
•
Minimum Disk Space
•
Required TIBCO Products
Minimum Disk Space
The installer requires 130 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.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Installing the Adapter on Microsoft Windows 13
|
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 installing from the network drive, make sure that the account used for
installation has permission to access the network drive.
Supported Platforms
The following table lists the platform-specific installation packages where
version_number is the Adapter release number. For example, the installation
package name for TIBCO Adapter for Kenan/BP 6.0.0 on the Microsoft Windows
2003 platform is TIB_adkenan-suite_6.0.0_win_x86.exe.
Table 6 Supported platforms, Package Name, and Disk Space for Microsoft Windows
Platform
Package Name
Hardware
Platform
Disk
Space
(MB)
Microsoft Windows Server 2003, 2008
TIB_adkenan-suite_6.0.0_
win_x86.exe
x86
130
Microsoft Windows XP Professional
Microsoft Windows Vista
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
14
| Chapter 2
Installing on Microsoft Windows Platforms
Installing the Adapter on 2003 Terminal Server
There are two modes in the Windows Terminal Server: Execute and Install. Users
are logged on by default in the 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:\WINNT\.
Windows Terminal Server must be running in remote admin mode, not
application sharing mode. The adapter is not supported if it is installed on a
machine that is using Windows Terminal Server in the 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 on Microsoft Windows
You can use any of the following modes to install TIBCO ActiveMatrix Adapter
for Kenan/BP on Microsoft Windows platforms:
•
Installing Using GUI Mode
•
Installing Using Console Mode
•
Installing Using Silent Mode
•
Installing Using a Response File (or a Template File)
Installing Using 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 double clicking the executable file in the installation
package.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Installing the Adapter on Microsoft Windows 15
|
Installing Using Console Mode
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 Wizard and exits the installation or uninstallation
•
4 = Redisplays the current screen
Execute the installation program from a command window by typing the
installation_package_name -a -is:javaconsole -console
Installing Using 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_name -a -silent
Installing Using a Response File (or a Template File)
When installing the adapter in the console mode, 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.
•
Generating a Response File
To install using Console mode and generate a response file, type the following
in a command window:
installation_package_name -s -a -is:javaconsole -console
responseFilepath
-options-record
There is no space between -options and -record in the above command.
The response file does not record selections at the component level. It does record
all other selections, such as which products you installed.
•
Generating a Template File
You can generate a template file without installing the adapter. The template
file is similar to a response file, but the values are not filled in. You can edit the
template file to generate a response file.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
16
| Chapter 2
Installing on Microsoft Windows Platforms
To generate a template file, type the following at the command prompt:
installation_package_name -options-template templateFilePath
There is no space between -options and -template in the above command.
After generating a response or a template file, you can use it to install the adapter
in silent mode or console 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_name -s -a -is:silent -silent -options
responseFilepath
•
In console 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_name -a -options responseFilepath
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
| 17
Chapter 3
Installation on UNIX Platforms
This chapter describes how to install TIBCO ActiveMatrix Adapter for Kenan/BP
on UNIX platforms.
Topics
•
Installation Prerequisites, page 18
•
Installing TIBCO ActiveMatrix Adapter for Kenan/BP on UNIX, page 20
•
Post-Installation, page 24
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
18
| 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
History on page 5 for more information.
The following is a list of prerequisites for installing the adapter on UNIX
platforms.
•
Minimum Disk Space
•
Required TIBCO Products
•
Supported Kenan/BP Application
Minimum Disk Space
This section lists the installer disk space requirements in the temporary area and
in the user’s home directory.
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, the following disk space is required in the temporary area:
•
On Solaris, 210 MB of free disk space in /var/tmp
•
On HP-UX, 500 MB of free disk space in /var/tmp
•
On AIX, 300 MB of free disk space in /var/tmp
If your system does not have sufficient free disk space in the above temporary
area, you can still run the installer with a different temporary area by using the
following option when starting the installer:
installation_package_name -is:tempdir /new_tmp
where the /new_tmp directory has sufficient free disk space.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Installation Prerequisites 19
|
Disk Space Requirement in User's Home Directory
On UNIX platforms, when a regular (non-root) user installs a TIBCO product, the
installation registry (two VPD files) is maintained in the user's home directory. As
more products are installed, entries are added into these VDP files.
The user's home directory must at least have 500 KB of free disk space.
Required TIBCO Products
Before you can install the adapter, you must install the TIBCO Runtime Agent. If
you use the Typical TIBCO Runtime Agent installation, the TIBCO Runtime
Agent installer places all of its libraries and other products required by the
adapter into the TIBCO_HOME directory, which is the user's home directory.
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, installation will proceed.
Supported Kenan/BP Application
Before proceeding to the adapter installation, ensure that you can connect to the
target application.
The adapter works with the following:
•
Kenan/BP 11.7.2 on Solaris 8, Solaris 9, and HP-UX 11i (PA-RISC)
•
Kenan/BP 12.0 on Solaris 10, HP-UX 11i(PA-RISC), HP-UX 11i(Itanium), and
AIX 5.3
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
20
| Chapter 3
Installation on UNIX Platforms
Installing TIBCO ActiveMatrix Adapter for Kenan/BP 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.
Supported Platforms and Disk Space
The following table lists the platform-specific installation packages where
version_number is the Adapter release number. For example, the installation
package name for TIBCO Adapter for Kenan/BP 6.0.0 on the AIX 5.3 is
TIB_adkenan-suite_6.0.0_aix52_power_java_kenan12.0_64.tar.
Table 7 Supported UNIX Platforms, Package Name, and Disk Space
Platform
Kenan/BP
Version
Package Name
Hardware
Disk Space
(MB)
AIX 5.3
Kenan/BP 12.0
TIB_adkenan-suite_6.0.0_aix52_po
wer_java_kenan12.0_64.tar
POWER
300
Solaris 8
Solaris 9
Kenan/BP
11.7.2
TIB_adkenan-suite_6.0.0_sol8_spa
rc_java_kenan11.7_64.tar
SPARC
210
Solaris 10
Kenan/BP 12.0
TIB_adkenan-suite_6.0.0_sol8_spa
rc_java_kenan12.0_64.tar
SPARC
210
HP-UX 11i
Kenan/BP
11.7.2
TIB_adkenan-suite_6.0.0_hpux111_
hppa_java_kenan11.7_64.tar
PA-RISC
500
HP-UX 11i
Kenan/BP 12.0
TIB_adkenan-suite_6.0.0_hpux111_
hppa_java_kenan12.0_64.tar
PA-RISC
500
HP-UX 11i
Kenan/BP 12.0
TIB_adkenan-suite_6.0.0_hpux112_
ia64_java_kenan12.0_64.tar
Itanium
500
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Installing TIBCO ActiveMatrix Adapter for Kenan/BP on UNIX 21
|
Installing on AIX 5.3
Your Tuxedo 9.0 software on AIX platforms should support JNI, which is required
for the Kenan/BP API-TS connection. A sample installation procedure is
provided below to patch your Tuxedo software for the JNI support. Contact your
Tuxedo provider to confirm if such patch is required and obtain the installation
steps and required source files (libbuft.im, libbuft.ex). The sample installation
procedure is as follows:
1. Enter $TUXDIR/lib.
2. Backup the libbuft.so file.
3. Copy the libbuft.im and libbuft.ex files to the $TUXDIR/lib directory.
4. Customize the libbuft.im file. Use #!libtux.so for a full installation,
otherwise change it to #!libwsc.so.
5. Build the libbuft.so file:
— 32-bit
$ cc -brtl -D__XCOFF32__ -I$TUXDIR/include -c tmtypesw.c
$ ld -bM:SRE -T512 -H512 -brtl -bE:libbuft.ex -bI:libbuft.im
-lc tmtypesw.o -o libbuft.so
— 64-bit
$ export OBJECT_MODE=64
$ cc -brtl -q64 -D__XCOFF64__ -I$TUXDIR/include -c tmtypesw.c
$ ld -bM:SRE -T512 -H512 -brtl -bE:libbuft.ex -bI:libbuft.im
-lc -bnoentry -berok tmtypesw.o -o libbuft.so
If the cc compiler can not compile the file, use the xlc compiler.
Installing the Adapter
You can use any of the following modes to install the adapter. Before proceeding
with the installation, untar the installation package.
•
Installing Using GUI Mode
•
Installing Using Console Mode
•
Installing Using Silent Mode with Default Values
•
Installing Using a Response File (or a Template File)
Installing Using GUI Mode
A window environment such as CDE (for example, X Windows) is required to run
the installer in GUI mode.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
22
| Chapter 3
Installation on UNIX Platforms
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_name
Installing Using Console Mode
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 Wizard 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_name -is:javaconsole -console
Installing Using Silent Mode with Default Values
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_name -silent
Installing Using a Response File (or a Template 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.
•
Generating a Response File
To install the software in a terminal window and generate a response file, type
the following in a terminal window:
% ./installation_package_name
-options-record
responseFilepath
There is no space between -options and -record in the above command.
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 Kenan/BP Installation
Installing TIBCO ActiveMatrix Adapter for Kenan/BP on UNIX 23
|
•
Generating a Template File
You can generate a template file without installing the adapter. The template
file is similar to a response file, but the values are not filled in. You can edit the
template file to generate a response file.
To generate a template file, type the following at the command prompt:
installation_package_name -options-template templateFilePath
There is no space between -options and -template in the above command.
After generating a response or a template file, you can use it to install the adapter
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_name -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_name
-options
responseFilepath
Combining Options
You can combine the different available options. For example, to install in silent
mode using a response file, use:
% ./installation_package_name -silent
-options
responseFileName
To install using Console mode and generate a response file, use:
% ./installation_package_name
-options-record
-is:javaconsole -console
responseFileName
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
24
| Chapter 3
Installation on UNIX Platforms
Post-Installation
After installation, perform the following:
•
Setting Directory Permissions
•
Getting the Encoding
Setting 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, write, and execute permissions for the
following directories where the adapter files and configuration information is
stored:
$TIBCO_HOME/adapter/adkenan/version_number/ledger
$TIBCO_HOME/adapter/adkenan/version_number/bin
$TIBCO_HOME/adapter/adkenan/version_number/logs
$TIBCO_HOME/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
a+w
a+w
a+w
a+w
/opt/tibco/adapter/adkenan/version_number/bin
/opt/tibco/adapter/adkenan/version_number/logs
/opt/tibco/adapter/adkenan/version_number/ledger
/opt/tibco/tra/version_number/logs
Getting the Encoding
Get the encoding used in Kenan/BP deployment from the Kenan/BP application
administrator. This encoding will be used later in the adapter configuration.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
| 25
Appendix A
Installation FAQs and Troubleshooting
This chapter lists some common errors along with their causes and solutions.
Topics
•
Frequently Asked Questions, page 26
•
Running Out of Disk Space, page 28
•
Installation Error on HP-UX 11.00 64 bit Platform, page 29
•
Cannot Install the Adapter, page 30
•
Configuring TIBCO Hawk, page 31
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
26
| Appendix A
Installation FAQs and Troubleshooting
Frequently Asked Questions
Where is the installation log file located?
Install and uninstall log files are created in the TIBCO_HOME\log directory.
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 for some reason, the JVM crashes, you could still run the
installer using another JVM, preferably JVM 1.3.1 or higher. The syntax is:
installation_package_name -is:javahome C:\j2sdk1.4.0
installation_package_name -is:javahome /opt/jre142
The javahome directory must contain bin/java.exe or bin/java.
The installer will use the externally supplied JRE to launch itself.
Will the installer recognize a 3.x or 4.x installation?
TIBCO products follow a three digit release numbering scheme:
Major.Minor.Maintenance
Product releases that differ in either Major or Minor numbers will be a separate
installation, and will not recognize the old installation. In this case, 5.0 is a major
release and hence will not recognize either 3.x or 4.x product installations.
Why and how should I set the DISPLAY variable on UNIX platforms for GUI
mode?
The installer on UNIX, must open an additional window, generally for graphics. It
uses the DISPLAY environment variable to tell it on what computer to open the
window. If the environment variable is not set, the installer will either wait or
abort after displaying:
InstallShield Wizard
Initializing InstallShield Wizard...
Preparing Java(tm) Virtual Machine...
...................................
...................................
........
The DISPLAY variable must be set 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
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Frequently Asked Questions 27
|
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 HPUX itaska 11.00
User:
Password:
itaska> export DISPLAY=alaska:0.0 # set display on alaska
itaska> installation_package_name
What is uninst2 directory?
If the original uninstall directory is in use at uninstall time, it cannot be removed
by the installer program. The installer then creates a second uninstall directory for
the second installation. To remove the second installation, you must invoke the
uninstall program from the second uninstall directory. The original uninstall
directory can also be manually removed, if empty.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
28
| Appendix A
Installation FAQs and Troubleshooting
Running Out of Disk Space
The installer calculates the disk space required in product home location, for the
selected components. The calculation is done before the actual installation
(copying of files to system) begins. The installer will proceed only if sufficient free
disk space is available in product home location.
However, if disk space is consumed by another process while the installer is
copying the files, and if the required disk space is thereby reduced, the installer
may fail and will then give a failure message.
Resolution
While performing installation, avoid running other processes that consume disk
space in product home location.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Installation Error on HP-UX 11.00 64 bit Platform 29
|
Installation Error on HP-UX 11.00 64 bit Platform
Error message
Installation on a HP-UX 11.00 64 bit system may crash with the following error
message:
Pid nnn killed due to trashed stack.
Pid nnn was killed due to failure in writing the signal context.
This happens only on HP-UX 11.00 64 bit systems. It does not happen on HP-UX
11.00 32 bit systems and HP-UX 11.11 (or 11.i) systems.
To determine the OS version on your system, run:
uname -a
To determine the kernel bits on your system, run:
getconf KERNEL_BITS
Resolution
HP-UX kernel patch PHKL_27282 resolves the above crash.
To determine if your system has the kernel patch, run:
/usr/sbin/swlist -l product PHKL_27282
or
what /stand/vmunix | grep PHKL_27282
If your system is an HP-UX 11.00 64 bit system and it does not have the patch, first
install HP-UX kernel patch PHKL_27282 and then proceed with the installation.
Installation of patch PHKL_27282 will reboot your system.
Error Message
While installing as root user on HP-UX, you may get the following error:
Assertion failed: so->so_hard_contents, file softobj.c, line 363
Resolution
Install as non-root user.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
30
| Appendix A
Installation FAQs and Troubleshooting
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.2 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 Kenan/BP Installation
Configuring TIBCO Hawk 31
|
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
Executable
field, provide the JVM executable. For example:
java.exe
The services will start properly and TIBCO Hawk Display will run.
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
32
| Appendix A
Installation FAQs and Troubleshooting
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
| 33
Index
A
Adapter Machine Information 8
Additional TIBCO Software 6
Available Disk Space 4
Installer Mode 3
Installing the Adapter on Microsoft Windows 13
Installing the Adapter on UNIX 20
K
C
Cannot Install the Adapter 30
Combining Options 23
Console Mode 3
customer support xii
Kenan/BP Client Software 9
Kenan/BP User Information 9
M
Major, Minor and Patch Releases 3
E
ENV_HOME x
P
Post-Installation 24
Pre-Installation Worksheets 8
F
Frequently Asked Questions 26
R
G
Response File 15, 22
Running Out of Disk Space 28
GUI Mode 3
S
I
Installation History 5
Installation Registry 4
Silent Mode 3
support, contacting xii
Supported Kenan/BP Application 19, 19
Supported Platforms and Disk Space 20
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
34
| Index
T
technical support xii
Template File 15, 22
TIBCO_HOME x
U
Uninstalling the Adapter 2
TIBCO ActiveMatrix Adapter for Kenan/BP Installation
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising