TIBCO ActiveMatrix

BusinessWorks™
Installation
Software Release 5.8
February 2010
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 Enterprise Message Service, TIBCO
InConcert, TIBCO Policy Manager, and TIBCO Hawk are either registered trademarks or trademarks of TIBCO
Software Inc. in the United States and/or 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-2010 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
 | iii

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
TIBCO ActiveMatrix BusinessWorks Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Other TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
How to Contact TIBCO Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Installing TIBCO ActiveMatrix BusinessWorks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Installer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Upgrading TIBCO ActiveMatrix BusinessWorks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Uninstalling TIBCO ActiveMatrix BusinessWorks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Installation Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Microsoft Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
UNIX Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Installation History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Required and Optional TIBCO Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installing on Microsoft Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Installing TIBCO ActiveMatrix BusinessWorks on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Combining Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Installation on UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installing TIBCO ActiveMatrix BusinessWorks on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Combining Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Post Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Configuring TIBCO ActiveMatrix BusinessWorks to Run in 64-bit Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Installation FAQs and Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Frequently Asked Questions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Speeding Up Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Running Out of Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

TIBCO ActiveMatrix BusinessWorks Installation

iv
| Contents

TIBCO ActiveMatrix BusinessWorks Installation

 |v

Preface

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.

This preface gives some information on the TIBCO ActiveMatrix BusinessWorks

documentation set, related documentation, and on conventions used in TIBCO
manuals.

Topics

• Related Documentation, page vi

• Typographical Conventions, page viii
• How to Contact TIBCO Customer Support, page x

TIBCO ActiveMatrix BusinessWorks Installation

vi
| Related Documentation

Related Documentation

This section lists documentation resources you may find useful.

TIBCO ActiveMatrix BusinessWorks Documentation

The following documents form the TIBCO ActiveMatrix BusinessWorks
documentation set:
• TIBCO ActiveMatrix BusinessWorks Concepts Read this manual before reading
any other manual in the documentation set. This manual describes
terminology and concepts of TIBCO ActiveMatrix BusinessWorks, and the
other manuals in the documentation set assume you are familiar with the
information in this manual.
• TIBCO ActiveMatrix BusinessWorks Getting Started This manual steps you
through a very simple example of designing, deploying, and monitoring a
ActiveMatrix BusinessWorks process.
• ActiveMatrix BusinessWorks Process Design Guide This manual describes how
to create, edit, and test business processes using TIBCO ActiveMatrix
BusinessWorks.
• ActiveMatrix BusinessWorks Palette Reference This manual describes each of
the palettes available in TIBCO ActiveMatrix BusinessWorks.
• TIBCO ActiveMatrix BusinessWorks Administration This manual describes how
to use TIBCO Administrator to deploy, manage, and monitor TIBCO
ActiveMatrix BusinessWorks processes.
• TIBCO ActiveMatrix BusinessWorks Installation Read this manual for
information on installing one or more components of ActiveMatrix
BusinessWorks and setting up a ActiveMatrix BusinessWorks domain.
• TIBCO ActiveMatrix BusinessWorks Error Codes This manual describes errors
returned by TIBCO ActiveMatrix BusinessWorks.
• TIBCO ActiveMatrix BusinessWorks 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

TIBCO ActiveMatrix BusinessWorks is used with other products. You may find it
useful to read the documentation for the following TIBCO products:

TIBCO ActiveMatrix BusinessWorks Installation

 Preface vii
|

• TIBCO Designer™ software: TIBCO Designer is an easy to use graphical user

interface for design-time configuration of TIBCO applications. TIBCO
Designer includes online help for each palette.
• TIBCO Administrator™ software: TIBCO Administrator is the monitoring
and managing interface for new-generation TIBCO products such as TIBCO
ActiveMatrix BusinessWorks.
• TIBCO Adapter software:
• Third-Party Documentation

TIBCO ActiveMatrix BusinessWorks Installation

viii
| 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
ENV_HOME
TIBCO_HOME depends on the operating system. For example, on Windows
BW_HOME 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.
TIBCO ActiveMatrix BusinessWorks installs into a directory within
TIBCO_HOME. This directory is referenced in documentation as BW_HOME. The
value of BW_HOME depends on the operating system. For example on Windows
systems, the default value is C:\tibco\bw\5.8.

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 Bold code font is used in the following ways:

font
• 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]

TIBCO ActiveMatrix BusinessWorks Installation

 Preface ix
|

Table 1 General Typographical Conventions (Cont’d)

Convention Use
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

Key Key name separated by a plus sign indicate keys pressed simultaneously. For
combinations 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 BusinessWorks Installation

x
| How to Contact TIBCO Customer Support

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 BusinessWorks Installation

 |1

Installing TIBCO ActiveMatrix

BusinessWorks

This document explains how to install TIBCO ActiveMatrix BusinessWorks on

Microsoft Windows and UNIX systems.

Topics

• Installer Overview, page 2

• Installation Registry, page 4
• Required and Optional TIBCO Products, page 6
• Installing on Microsoft Windows, page 8
• Installation on UNIX Systems, page 12
• Installation FAQs and Troubleshooting, page 17

TIBCO ActiveMatrix BusinessWorks Installation

2 Installing TIBCO ActiveMatrix BusinessWorks
|

Installer Overview

The installer allows you to run 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.

Upgrading TIBCO ActiveMatrix BusinessWorks

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.4.0 indicates a
minor release and 5.3.3 indicates a patch release. The installer for a patch release
performs an automatic upgrade. For example, the installer automatically
upgrades TRA 5.3.0 to 5.3.1 by overwriting the contents of the 5.3 directory.

TIBCO ActiveMatrix BusinessWorks Installation

 Installer Overview 3
|

For a major and minor release, the installer prompts whether you wish to
upgrade, and informs you if incompatible products are on your system. If you
proceed, major or minor releases are installed under a new directory that is
named using the major or minor release numbers.
For example, if you have installed the 5.3.0 release and are upgrading to a 5.4.0
minor release, it will be installed under the 5.4 directory. This allows both the 5.3
and 5.4 releases to coexist on the same machine.
If you are upgrading TIBCO ActiveMatrix BusinessWorks, or reinstalling a clean
version of the software, you may uninstall the product first or allow the installer
to perform the upgrade or reinstall.
Note that, 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.

Uninstalling TIBCO ActiveMatrix BusinessWorks

If another product is dependent on the product you wish to uninstall, you are
informed that you must uninstall the other product first.

Microsoft Windows
Use one of the following to uninstall TIBCO ActiveMatrix BusinessWorks:
• Click Start >Programs >TIBCO >TIBCO ActiveMatrix BusinessWorks 5.4 >
Uninstall
• Use Add/Remove Programs from the Control Panel.
• Navigate to the _uninst directory located in the TIBCO ActiveMatrix
BusinessWorks home directory and invoke the Tibuninstall.exe program.

UNIX Systems
Navigate to the _uninst directory located in the TIBCO ActiveMatrix
BusinessWorks home directory and invoke the Tibuninstall.exe program.

TIBCO ActiveMatrix BusinessWorks Installation

4 Installing TIBCO ActiveMatrix BusinessWorks
|

Installation Registry

The installer maintains an installation registry. The registry location depends on

platform. This section explains where the registry files are located. The 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.

Microsoft Windows Platforms

ActiveEnterprise 5.4 products maintain the installation registry in the
%SystemRoot% directory. The following files represent the installation registry:
%SystemRoot%\vpd.properties
%SystemRoot%\vpd.properties.tibco.systemName

Installer Disk Space Requirements in Temporary Area

The entire package is extracted into a temp folder, typically SystemDrive:\Temp
or SystemDrive:\Documents and Settings\<user_name>\Local
Settings\Temp.

The installer requires 60MB of free space in the temp directory.

UNIX Platforms
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

If installation is performed by super-user (root), the installation registry is

maintained as follows:
• On Solaris and HP-UX, in the root user’s home directory (which is /) as two
vpd files.
• On Linux, in the /root directory as two vpd files.
• On AIX, in the /usr/lib/objrepos directory as two vpd files.

TIBCO ActiveMatrix BusinessWorks Installation

 Installation Registry 5
|

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, 75 MB of free disk space in /var/tmp
• On HP-UX, 85 MB of free disk space in /var/tmp
• On AIX, 75 MB of free disk space in /tmp
• On Linux, 75 MB of free disk space in /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:
<install_package_name>.bin -is:tempdir /new_tmp

where /new_tmp has sufficient free disk space.

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 vpd files.
The user's home directory must at least have 500 KB of free disk space.

Installation History
The installer and uninstaller creates a file called
TIBCOInstallationHistory.xml in the same location where the installation
registry is created. Each time an installation and uninstallation is performed,
entries are appended to the file.
On Windows: %SystemRoot%\TIBCOInstallationHistory.xml
On UNIX: Users_Home_Directory/TIBCOInstallationHistory.xml
The file TIBCOInstallationHistory.xml therefore contains the record of all
installation and uninstallation activities of all products, features and components.

Do not edit, modify, rename, move, or remove the

TIBCOInstallationHistory.xml file.

TIBCO ActiveMatrix BusinessWorks Installation

6 Installing TIBCO ActiveMatrix BusinessWorks
|

Required and Optional TIBCO Products

Depending on the tasks you wish to perform, you must install one or more other
TIBCO products. The next table describes required and optional products and
their purpose.

Table 2 Required and Optional TIBCO Products

Component Purpose
TIBCO Runtime Agent Required. TIBCO Runtime Agent supplies a number of TIBCO and
5.6.2 or Higher third-party libraries used by TIBCO ActiveMatrix BusinessWorks 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 a
TIBCO ActiveMatrix BusinessWorks process engine. TIBCO Runtime
Agent must be installed before you install TIBCO ActiveMatrix
BusinessWorks.

TIBCO Designer 5.6 Required. TIBCO Designer is an easy to use graphical user interface for
design-time configuration of TIBCO ActiveMatrix BusinessWorks.
TIBCO Designer is installed as part of the TIBCO Runtime Agent
installation.

TIBCO Administrator Required. TIBCO Administrator is available in two editions, Repository

5.4.0 Edition and Enterprise Edition. The Enterprise Edition is required for
TIBCO ActiveMatrix BusinessWorks. 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 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 TIBCO ActiveMatrix BusinessWorks.

TIBCO ActiveMatrix BusinessWorks Installation

 Required and Optional TIBCO Products 7
|

Table 2 Required and Optional TIBCO Products

Component Purpose
TIBCO Enterprise Optional. TIBCO Enterprise Message Service (EMS) allows you to send
Message Service messages from your applications in a format that conforms to the Java
Messaging Service (JMS) specification. It also provides a reliable delivery
mode and a no-acknowledge acknowledgement mode.
TIBCO Enterprise Message Service is available as a separate installation
and can be installed after TIBCO BusinessWorks is installed.

TIBCO ActiveMatrix BusinessWorks Installation

8 Installing TIBCO ActiveMatrix BusinessWorks
|

Installing on Microsoft Windows

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.
The following is a list of prerequisites for installing TIBCO ActiveMatrix
BusinessWorks on Microsoft Windows systems. See Installer Disk Space
Requirements in Temporary Area on page 4 for additional disk space
requirements.

Table 3 Supported platforms for Microsoft Windows

Disk Space
Platform Service Pack/Edition
(MB)
Microsoft Service Pack 2 80
Windows 2000

Microsoft Professional Edition 80

Windows XP

Microsoft Enterprise Edition for server-class hardware, 80

Windows Standard Edition for desktops
Server 2003

TIBCO Runtime Agent Must be Installed Before TIBCO ActiveMatrix

BusinessWorks
Before you can install TIBCO ActiveMatrix BusinessWorks, you must install TRA.
If you select the Typical option during installation, the installer places all libraries
and other products required by TIBCO ActiveMatrix BusinessWorks into the
TIBCO HOME directory.
During installation, the installer checks for the availability of all dependent
products in the target system. If any of the dependencies are not available, the
installer immediately exits. Otherwise installation proceeds.

Installer Account
You must have administrator privileges for the machine on which TIBCO
ActiveMatrix BusinessWorks is installed.
If you do not have administrator privileges, the installer exits. You must then log
out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account.

TIBCO ActiveMatrix BusinessWorks Installation

 Installing on Microsoft Windows 9
|

Installing from Network Drive

If you intend to install the product on a network drive, you must ensure that the
account used for installation has permission to access the network drive.

Installing on Windows 2000 Terminal Server

There are two modes in terminal server, Execute and Install. By default all
users are logged on in Execute mode, which allows them to run the applications.
When you want to install TIBCO ActiveMatrix BusinessWorks for use by
everyone, the Administrator should change to Install mode.
The best way to install TIBCO ActiveMatrix BusinessWorks is to use the
Add/Remove Programs control panel applet, because this automatically sets the
mode to Install during the installation and then back to Execute at the end.
Alternatively, you can manually change your mode to Install by typing:
C:\> change user /install

Change back to execute:

C:\> change user /execute

Check your current mode:

C:\> change user /query

If you install in the Execute mode, the installation registry is maintained in your
user home directory. If you install in the Install mode, the installation registry is
maintained in the %SystemRoot% folder.

Installing TIBCO ActiveMatrix BusinessWorks on Microsoft Windows

You can either download the TRA installation package or install the components
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.
If you are installing for the first time, you can specify the installation directory
where the products in this product suite will be installed. On Microsoft Windows,
the default installation directory is c:\tibco.
Use one of the following modes to install TIBCO ActiveMatrix BusinessWorks.

TIBCO ActiveMatrix BusinessWorks Installation

10 Installing TIBCO ActiveMatrix BusinessWorks
|

Install Using GUI Mode

GUI Mode allows you input values in panels. Type the following at the command
prompt:
TIB_bw-simple_5.8.0_win_x86.exe

Install Using Console Mode

Console mode allows you to install the software in a non-windows environment.
The installer will prompt you for values. Type the following at the command
prompt:
TIB_bw-simple_5.8.0_win_x86.exe -is:javaconsole -console

When running in console mode you can move through the installation process as
described next:
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

Install Using Silent Mode

Silent mode allows you to install the software without prompts. Type the
following at the command prompt:
TIB_bw-simple_5.8.0_win_x86.exe -silent

Install and Generate a Response File

You can generate a response file during installation which you can later use to
invoke the installer with the selected values as default values (GUI mode) or as
selected values (silent mode).
To install and generate a response file, type the following at the command
prompt:
TIB_bw-simple_5.8.0_win_x86.exe -options-record
C:\<directoryPath>\<responseFile>

The response file does not record selections at the component level. It does record
all other selections, for example, which products you wished to install.

Install Using a Response File

You can use a previously generated response file for installation. For non-silent
modes, the response file determines the defaults that are presented. For silent
mode, the response file determines what will be installed.

TIBCO ActiveMatrix BusinessWorks Installation

 Installing on Microsoft Windows 11
|

To install using a response file, type the following at the command prompt:
TIB_bw-simple_5.8.0_win_x86.exe -options
C:\<directoryPath>\<responseFileName>

Combining Options
You can combine the different available options. For example, to install in silent
mode using a response file, use:
<install_package_name>.exe -silent -options <responseFileName>

To install using Console mode and generate a response file, use:

<install_package_name>.exe -is:javaconsole -console
-options-record <responseFileName>

TIBCO ActiveMatrix BusinessWorks Installation

12 Installing TIBCO ActiveMatrix BusinessWorks
|

Installation on UNIX Systems

Your operating system must meet the minimum patch requirements listed in
Table 4. See Installer Disk Space Requirements in Temporary Area on page 5 for
additional disk space requirements.

Table 4 Supported platforms, package names, patches and disk space for UNIX systems

Disk Space
Platform Notes
(MB)
Solaris 10 80

Solaris 9 80

Solaris 8 80

HP-UX 11i HP-UX 11i v2/11.23 on IA-64/Itanium 80

HP-UX 11i/11.11 on PA-RISC

AIX 5.2, 5.3 80

Linux Requires kernel 2.4.6 or later 80

glibc 2.2.2 or later

TIBCO Runtime Agent Must be Installed Before TIBCO ActiveMatrix

BusinessWorks
Before you can install TIBCO ActiveMatrix BusinessWorks, you must install TRA.
If you choose the Typical option during installation, the installer places all
libraries and other products required by TIBCO ActiveMatrix BusinessWorks into
the TIBCO HOME directory.

Installer Account
TIBCO 5.x products can be installed by a regular (non-root) user and super-user
(root). Different users can install the same product at different locations.
Product dependencies at install time are resolved at user level through the
installation registry maintained at user's home directory. See Installation Registry
on page 4 for more information.

TIBCO ActiveMatrix BusinessWorks Installation

 Installation on UNIX Systems 13
|

Windows Environment
A window environment such as CDE (that is, X Windows) is required to run the
installer in GUI mode. It is not required for a console installation.

Installing TIBCO ActiveMatrix BusinessWorks on UNIX

After unpacking the software and accepting the license agreement, you can
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 pieces of the product suite to
install and installs only those components.
If you are installing for the first time, you must specify the installation directory
where the products in this product suite will be installed. The default installation
directory depends on who performs the installation:
• For root users, the default installation directory is /opt/tibco.
• For non-root users, the default installation directory is /<myhome>/tibco,
where <myhome> is the home directory of the user.
• If installing TIBCO ActiveMatrix BusinessWorks on AIX, use a non-root user
account.
Use one of the following modes to install the software. The examples assume you
are installing TIBCO ActiveMatrix BusinessWorks on Solaris 2.7.

Install Using GUI Mode

GUI Mode allows you input values in panels. Type the following in a terminal
window:
% ./TIB_bw-simple_5.8.0_<platform>.bin

Install Using Console Mode

Console mode allows you to install the software in a non-windows environment.
The installer prompts you for values. Type the following in a terminal window:
% ./TIB_bw-simple_5.8.0_<platform>.bin -is:javaconsole -console

When running in console mode, you can move through the installation process as
described next:
Enter Key = Moves forward in the installer
2 = Goes back to previous screen
3 = Cancels the Wizard and exits the installation or uninstallation

TIBCO ActiveMatrix BusinessWorks Installation

14 Installing TIBCO ActiveMatrix BusinessWorks
|
4 = Redisplays the current screen

Install Using Silent Mode with Default Values

Silent mode allows you to install the software without prompts using default
values. Type the following in a terminal window:
% ./TIB_bw-simple_5.8.0_<platform>.bin -silent

Install and Generate a Response File

You can generate a response file during installation which you can later use to
invoke the installer with the selected values as default values (GUI mode) or as
selected values (silent mode).
To install and generate a response file, type the following at the command
prompt:
% ./TIB_bw-simple_5.8.0_<platform>.bin -options-record
/<directoryPath>/<responseFile>

The response file does not record selections at the component level It does record
all other selections, for example, which products you wished to install.

Install Using a Response File

You can use a previously generated response file for installation. For non-silent
modes, the response file determine the defaults that are presented. For silent
mode, the response file determines what will be installed.
To install using a response file, type the following at the command prompt:
% ./TIB_bw-simple_5.8.0_<platform>.bin -options

/<directoryPath>/<responseFileName>

Combining Options
You can combine the different available options. For example, to install in silent
mode using a response file, use:
% ./TIB_bw-simple_5.8.0_<platform>.bin -silent -options
<responseFileName>

To install using Console mode and generate a response file, use:

% ./TIB_bw-simple_5.8.0_<platform>.bin -is:javaconsole -console
-options-record <responseFileName>

TIBCO ActiveMatrix BusinessWorks Installation

 Installation on UNIX Systems 15
|

Post Installation
All TIBCO ActiveMatrix BusinessWorks users must have read, write, and execute
permissions for the following directories:
$TIBCO_HOME/bw/5.7/bin
$TIBCO_HOME/bw/5.7/bin/logs
$TIBCO_HOME/tra/5.6/logs

For example, if TIBCO ActiveMatrix BusinessWorks has been installed in

/opt/tibco, the user who installed TIBCO ActiveMatrix BusinessWorks should
execute the following commands:
% chmod 777 /opt/tibco/bw/5.7/bin/
% chmod 777 /opt/tibco/bw/5.7/bin/logs
% chmod 777 /opt/tibco/tra/5.6/logs

In addition, the palettes directory ($TIBCO_HOME/bw/5.7/lib/palettes) must

be writable by all users who will use TIBCO Designer. Users must have write
permission for this directory to be able to use the Java activity's Compile button.
Alternatively, change the Java activity's compilation directory by changing the
value of java.property.javaCode in the .tra file that is used to start TIBCO
ActiveMatrix BusinessWorks (designer.tra for the TIBCO Designer GUI or the
appropriate .tra file for the engine if running from a deployment).

Configuring TIBCO ActiveMatrix BusinessWorks to Run in 64-bit Mode

When installing TIBCO ActiveMatrix BusinessWorks on 64-bit platforms, you
must perform post-installation steps to use the 64-bit version of the product.

To enable TIBCO ActiveMatrix BusinessWorks to run in 64-bit mode,

perform the following:
1. Change directory to BW_HOME/bin
a. Copy bwengine to bwengine-bak
b. Copy bwengine64 to bwengine
2. Copy bwengine.tra to bwengine-bak.tra
a. Using a text editor, open bwengine.tra
b. In the tibco.env.STD_EXT_CP property, find %RV_HOME%/lib/ and
change it to
%RV_HOME%/lib/tibrvj.jar%PSP%%RV_HOME%/lib/tibrvjsd.ja
r

c. You also may want to increase the heap size by changing the
tibco.env.HEAP_SIZE property and the memory usage of the Java VM

TIBCO ActiveMatrix BusinessWorks Installation

16 Installing TIBCO ActiveMatrix BusinessWorks
|

using java extended properties. The following lines are example values for
these properties:
tibco.env.HEAP_SIZE=19050M
java.extended.properties = -XX:MinHeapFreeRatio=52
-XX:MaxHeapFreeRatio=90 -XX:GCTimeRatio=19

3. If you are using either Solaris, HP-UX on IA-64/Itanium, or Linux platforms,

perform the changes described in Table 5.
4. Save the file and exit the text editor.

Table 5 Platform-dependent changes to bwengine.tra

Platform Find... Change to...

Solaris 10, 9, and 8 on SPARC sparc sparcv9

Solaris 10 on x86 i386 amd64

HP-UX 11i v2/11.23 and 11i v3/11.31 IA64N IA64W

on IA-64/Itanium

Red Hat Enterprise Linux on x86 i386 amd64

SUSE Linux Enterprise on x86

TIBCO ActiveMatrix BusinessWorks Installation

 Installation FAQs and Troubleshooting 17
|

Installation FAQs and Troubleshooting

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

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. It for some reason, the JVM crashes, you could still run the
installer using another JVM, preferably JVM 1.5.0 or higher. The syntax is:

Example 1
TIB_bw-simple_5.8.0_win_x86.exe -is:javahome C:\j2sdk1.5.0
<UNIX_package_name>.bin -is:javahome /opt/jre150

The javahome directory must contain bin/java.exe or bin/java.

The installer will use the externally supplied JRE to launch itself.

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
DISPLAY=<ip_address>:0.0; export DISPLAY

# Korn shell
export DISPLAY=<ip_address>:0.0

TIBCO ActiveMatrix BusinessWorks Installation

18 Installing TIBCO ActiveMatrix BusinessWorks
|

# C-shell
setenv DISPLAY <ip_address>:0.0

For example, consider a scenario where you need to install TIBCO ActiveMatrix
BusinessWorks on a remote HPUX 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> tar -xvf TIB_tra-suite_5.6.0_hpux111_hppa_32.tar

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.

Speeding Up Installation
The installer is Java-based and requires a Java Virtual Machine (JVM) to launch. If
the installer can use a JVM already on your system, installation is faster and uses
less disk space. Otherwise, the installer extracts JVM from the installation
package. This section explains where the installer searches for JVM, and how you
can add a different location to the search path.
Every product installer is bundled with the appropriate platform-specific JVM
version. When launched, the installer first searches for the appropriate JVM
version on the target system.
• If the installer finds the required JVM version, it uses that JVM to launch itself.
• If the installer does not find the required JVM version, it extracts the bundled
JVM into a temporary space and uses that JVM to launch itself.

TIBCO ActiveMatrix BusinessWorks Installation

 Installation FAQs and Troubleshooting 19
|

How the Installer Searches for JVM

The installer by default searches for an appropriate JVM version in a set of
standard locations. These standard locations are platform specific and are listed in
JVM Search Locations on page 20. On each platform, the installer searches for
JVM 1.5.0 only.

Speeding the JVM Search

You can speed up the JVM search by taking one of these actions before you launch
the installer:
• Set the environment variable JAVA_HOME or JDKHOME to the JVM home
directory, for example:

Unix Bourne or JAVA_HOME=/opt/jre1.5.0; export JAVA_HOME

Korn shell

Unix C-shell setenv JAVA_HOME /opt/jre1.5.0

Microsoft
1. Choose Start > Settings > Control Panel >
Windows
System-Environment > System Variable or User
Variables
2. Add a JAVA_HOME variable and set its value
Note: On Microsoft Windows, setting JAVA_HOME in a
command prompt will not be effective.

• Include a command line option -is:javahome when launching the installer.

For example:

Windows suite <exe> -a -is:javahome c:\java\JRE\1.5.0

installer

Other installers <exe_or_bin> -is:javahome /opt/jre1.5.0

Benefits of Using Available JVM over Extracting Bundled JVM

• JVM search is quick. It is searched for in well defined locations. It can be sped
up by setting an environment variable or by using a command line option.
• Extraction of bundled JVM is avoided, which saves both time and temporary
disk space. Initial loading of the installer is faster.

TIBCO ActiveMatrix BusinessWorks Installation

20 Installing TIBCO ActiveMatrix BusinessWorks
|

• If the bundled JVM is extracted and used for launching the installer, then a
copy of this JVM is installed for launching the uninstaller in the _jvm directory
in the product location.
However, if JVM was resolved through JVM search, the uninstaller just points
to this JVM and uses it later to launch itself. In this case, JVM is not installed.
This is a major benefit in terms of disk space.
For example, on HP-UX, the size of JVM 1.5.0 is about 80 MB. When the
TIBCO Runtime Agent (TRA) suite is installed, and if the bundled JVM is
used for launching the installer, a copy of JVM 1.5.0 is installed for each of the
five products in the suite. This results in an additional 400 MB of disk space
used. If a local JVM can be used, these 400 MB are not needed.
• If the JVM the uninstaller points to is removed at any time, you can still run
the uninstaller using the -is:javahome option to point to a different JVM
location.

JVM Search Locations

The following tables list the search locations for the different platforms.

The installer only searches for JVM version 1.5.0. If a different JVM version exists
in the system, or is passed in using the environment variable or command-line
option, the installer ignores that JVM and extracts the bundled JVM.

Table 6 Windows (JVM 1.5.0)

Location Description
Environment Set in Control Panel, not in command prompt
JAVA_HOME
JDKHOME

Registry \HKEY_LOCAL_MACHINE\SOFTWARE\
JavaSoft\Java Runtime Environment\
1.3\JavaHome \HKEY_LOCAL_MACHINE\SOFTWARE\
JavaSoft\ Java DevelopmentKit\1.3\JavaHome

Directory \Program Files\JavaSoft\JRE\1.5.0

\JavaSoft\JRE\1.5.0
\Java\JRE\1.5.0

TIBCO ActiveMatrix BusinessWorks Installation

 Installation FAQs and Troubleshooting 21
|

Table 7 Solaris (JVM 1.1.8 & 1.5.0)

Location Description
Environment JAVA_HOME
JDKHOME

Path /usr/jre1.5.0
/usr/java1.5.0
/usr/jdk1.5.0
/opt/jre1.5.0
/opt/java1.5.0
/opt/jdk1.5.0

Table 8 HPUX (JVM 1.5.0)

Location Description
Environment JAVA_HOME
JDKHOME

Path /opt/java1.5
/opt/java1.5/jre

Table 9 AIX (JVM 1.5.0)

Location Description
Environment JAVA_HOME
JDKHOME

Path /usr/jdk_base
/usr/jdk_base
/usr/java150
/usr/java150

Table 10 Linux (JVM 1.5.0)

Location Description
Environment JAVA_HOME
JDKHOME

Path /usr/jre1.5
/usr/local/jre1.5
/opt/jre1.5
/opt/j2re1.5.0

TIBCO ActiveMatrix BusinessWorks Installation

22 Installing TIBCO ActiveMatrix BusinessWorks
|

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.

Solution
While performing installation, avoid running other processes that consume disk
space in product home location.

TIBCO ActiveMatrix BusinessWorks Installation