Installation Guide
Software Release 5.1.3
May 2004
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
TIBCO BUSINESSWORKS CONCEPTS). 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, Information Bus, The Power of Now, TIBCO Adapter, and TIBCO Designer 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. Please 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.
Copyright © 1999-2004 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
| iii
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
TIBCO Administrator Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Other Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
How to Contact TIBCO Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Installer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Installable Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
A Note on Installing Releases with Higher Version Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
A Note on Upward Compatibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Using the TIBCO Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Installer Startup Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Combining Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installation Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Microsoft Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
UNIX Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
TIBCO Administrator Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
TIBCO Administration Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
TIBCO Administration Domain Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Creating or Joining an Administration Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Server Configuration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Preface
Topics
Related Documentation
For comments or problems with this manual or the software it addresses, please
contact TIBCO Support Services as follows.
• For an overview of TIBCO Support Services, and information about getting
started with TIBCO Product Support, visit this site:
http://www.tibco.com/services/support/default.jsp
• If you already have a valid maintenance or support contract, visit this site:
http://support.tibco.com
Entry to this site requires a username and password. If you do not have a
username, you can request one.
Installer Overview
Topics
• Introduction, page 2
• Using the TIBCO Installer, page 4
• Installation Registry, page 7
• TIBCO Administrator Installation Overview, page 9
Introduction
TIBCO products use TIBCO Administrator for different tasks. Because of this, you
have several choices for installing TIBCO Administrator:
• TIBCO Administrator Repository Edition without user and resource
management—Supports local or server-based access of project repositories,
and fault tolerance using multiple Administration Servers.
• TIBCO Administrator Repository Edition with user and resource
management—Supports local or server-based access of project repositories,
and fault tolerance using multiple Administration Servers.
In addition, allows you to create a TIBCO Administration Domain and
manage an Access Control List (ACL) for the domain, which determines
which user can access which project repository.
• TIBCO Administrator Enterprise Edition—Supports all functionality of
TIBCO Administrator Repository Edition with user and resource
management. In addition, deployment configuration and application
management components are automatically enabled and become available
from the TIBCO Administrator GUI if you purchased the Enterprise Edition
and chose to enable user and resource management.
Installable Components
During installation, the following components are installed:
• Tomcat (web server) 4.1.27
• TIBCO Administration Server running as a servlet under tomcat
• Optionally, TIBCO Administration Server user and resource management
component running under Tomcat.
• Optionally, TIBCO Administrator documentation. If you choose not to install
documentation, online help will not be available.
Prerequisites
For a list of the required hardware and software, see the readme.txt for this
product.
Before you install TIBCO Administrator on a machine, you must install the
appropriate version of the TIBCO Runtime Agent (TRA). If TIBCO Runtime
Agent is not available, the installer will inform you and cannot continue.
If you install a product and that product is already installed on your machine, you
cannot choose a different location.
The TIBCO Installer for ActiveEnterprise 5.1 products can run in different modes.
Each mode is supported on all platforms.
• GUI mode presents panels that allow you to make choices about product
selection, product location, and so on.
• Console mode allows you to make installation choices from the
command-line.
• Silent mode either installs using the default settings or uses a file that was
saved during an earlier installation.
If you wish to create an Administration Server only (and not include User and
Resource Management), you must run the installer in GUI mode.
You must invoke the installer from a command line if you wish to use one of the
options listed under Installer Startup Options on page 5.
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 the icon, GUI mode is used.
Console Mode
Console mode allows you to run the installer from the command line. This is
useful if your machine does not have a windowing environment or if you wish to
install in silent mode.
Silent Mode
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.
The TIBCO Domain Utility is invoked only if you use GUI mode. Unless you are
doing an update or reinstall of TIBCO Administrator, using GUI mode is highly
recommended for TIBCO Administrator installation.
-is:javaconsole Uses the console interface mode. Messages during installation are displayed on
-console the command line.
Examples:
-options-record Instructs the installer to automatically generate a response file for the product
<responseFile> after the completion of the installation
Examples:
TIB_tibcoadmin-simple_5.1.3_s4_58_CC.bin -options-record
directory/<responseFileName>
TIB_tibcoadmin-simple_5.1.3_w32.exe -silent
TIB_tibcoadmin-simple_5.1.3_s4_58_CC.bin -silent
Combining Options
You can combine the different available options. For example, to install in silent
mode using a response file, use:
TIB_tibcoadmin-simple_5.1.3_w32.exe -options <responseFileName>
-silent
Installation Registry
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
-is:tempdir /<new_tmp>
If you do not install the documentation, online help will not work.
At the end of installation, you are prompted to click a Next button, which
launches the TIBCO Domain Utility for server setup. This happens for new
installations as well as upgrade installations (e.g. 5.0.0 to 5.1.0) but not for update
or reinstall (e.g. 5.1.0 to 5.1.1).
You may cancel the domain utility and launch it later to enable user and research
management.
If you wish to disable user and resource management (repository server only),
you must perform setup as part of installation. You cannot cancel and restart the
domain utility later.
This information is relevant only if you did not disable the user and resource
management component.
the machines on which they will run. It contains information about the
processes to be run, alerts, and so on.
• Runtime Application—After you have deployed the application, you can
start, stop, and monitor the individual business process engines and adapter
instances.
The advantage of an administration domain is that the components of your
integration project automatically know about each other. They can be monitored
as a group. Security, that is, required authentication and authorization for both
processes and data stores, is shared across the administration domain. Fault
tolerant setups are also possible.
The Domain Utility is launched at the end of installation for new installations as
well as upgrade installations (e.g. 5.0.0 to 5.1.0) but not for update or reinstall (e.g.
5.1.0 to 5.1.1).
You can later create additional servers and domains for you machine using the
domain utility, though this potentially resource-intensive option should not be
undertaken lightly.
If you wish to add a machine to an administration domain, you can do so using
the TIBCO Domain Utility. If you wish to register software to the domain, you can
do so using the TIBCO Administrator GUI for the domain.
Security
The TIBCO Administration Server supports centralized authentication and
authorization. Using the TIBCO Administrator GUI, users with the appropriate
administrative privileges can define which users should have access to which part
of the system.
TIBCO Administrator supports authentication and authorization for both data
stores (project repositories) and application components (process engines or
adapters) in the administration domain.
• Authentication—The verification of the identity of a person or process.
After you have completed installation, the installer prompts you to click the Next
button to launch the TIBCO Domain Utility. The domain utility offers a number of
server configuration choices:
• Install Master Server with user and resource management (and create an
administration domain).
• Install Secondary Server to run inside an already existing administration
domain.
• Install a Master Server without user and resource management (no
administration domain is created)
• Install a Secondary Server for a server that was installed without user and
resource management.
• Retrieve users from corporate LDAP.
Figure 1 gives an overview of the available options.
Each screen of the TIBCO Domain Utility includes a Help button in the bottom
left corner. Click that button for information about the choices available in that
screen.
Master or Secondary?
Domain or No Domain?
Master & Domain Master & Secondary Master & No Domain Secondary & No Domain
(optionally RV and (must match Master RV (optionally RV and (must match Master RV
Hawk parameters) & Hawk parameters) Hawk Parameters) & Hawk parameters)
Config
Database
Confirm
Done
Topics
Installation Prerequisites
Table 1 Supported platforms, package names, service packs and disk space for Microsoft Windows
Microsoft TIB_tibcoadmin-simple_5.1.3_w32.exe 50 MB
Windows XP
Installer Account
You must have administrator privileges to install this product.
You must use GUI mode (the default) if you wish to disable user and resource
management (standalone server, no administration domain).
2. After the Welcome, License Agreement, and Notice panels, you are prompted
whether you wish to perform Typical or Custom installation.
— If you choose Typical, the Administration Server and documentation
installed.
— If you choose Custom, you may choose to install only the server, or both the
server and documentation.
3. The installer will then inform you which components are selected. After you
confirm, installation proceeds. See A Note on Installing Releases with Higher
Version Numbers on page 3 for the installer behavior during upgrades.
4. When installation is complete, the last screen prompts you with a Next button,
which launches the TIBCO Domain Utility. You can use the utility to configure
servers.
You may cancel the first screen of the Domain Utility; however, configuring the
server as part of installation is highly recommended.
Otherwise, you can later invoke the domain utility from the Start > Programs>
tibco > TIBCO Runtime Agent and Adapter SDK 5.1 menu.
If you wish to install a server and disable user and resource management
(repository server only), you must perform setup as part of installation. You
cannot cancel and restart the domain utility later.
To run the server under Microsoft Windows, you must first start the TIBCO
Administration Server and TIBCO Hawk Microagent services. You can do so in
one of two ways:
• Reboot your machine. The services are started automatically.
• In the Microsoft Windows Services control panel, select each service and start
it. The order is not important.
You can then access the TIBCO Administrator GUI, as discussed in the TIBCO
Administrator User’s Guide.
Topics
Installation Prerequisites
Your operating system must meet the minimum patch requirements listed in
readme.txt. See Required Disk Space in Temporary Area on page 8 for additional
disk space requirements.
Table 2 Supported platforms, package names, and required disk space for UNIX systems
Disk
Platform Package Names Space
(MB)
Sun Solaris 2.6. TIB_tibcoadmin-epe-simple_5.1.3_s4_57_CC.bin or 177
TIB_tibcoadmin-repo-simple_5.1.3_s4_57_CC.bin or
2.7, or 8
Permissions
TIBCO 5.x products can be installed by a regular (non-root) user or by super-user
(root). Different users can install the same product at different locations.
Product dependencies at install time are resolved at the user level through the
installation registry maintained in the user's home directory. See Installation
Registry on page 7 for more information.
The installer works best when not using the native registry. On most UNIX
platforms, the installer therefore does not use the native registry even for root
user installations.
Windows Environment
A window environment such as CDE (i.e. X Windows) is required to run the
installer in GUI mode. It is not required for a console installation.
You must use GUI mode (the default) if you wish to disable user and resource
management (standalone server, no administration domain).
If BIN_SH is not properly specified, the installer will abort with this error: ^D@AA:
is not an identifier
You may cancel the first screen of the Domain Utility; however, configuring the
server as part of installation is highly recommended.
Otherwise, you can later invoke the domain utility on UNIX:
1. Navigate to the <tra_home>/tibco/tra/5.1/bin directory.
2. Execute domainutility.
If you wish to install a server and disable user and resource management
(repository server only), you must perform setup as part of installation. You
cannot cancel and restart the domain utility later.
2. Then start the TIBCO Hawk Agent, which performs the TIBCO Administrator
monitoring functions, by typing:
% cd <tra_home>/tra/5.1/domain/<domain_name>
% hawkagent_<domain-name>
Files are the preferred format, however, databases are supported as well.
Note that database backend is supported only for application repositories, not for
the domain repository.
Topics
• Introduction, page 26
• Creating the Database Tables, page 27
Introduction
Size Considerations
When creating a new database for use with TIBCO Administrator, configure the
database size to conform to the expected size of the ActiveEnterprise data you
will store. Size varies depending on the number and complexity of the
applications that use the project repository.
For a typical installation, configure the database to allow at least 30-40 MB of data
storage. The transaction log size for the database should be at least 20 MB. If you
are using Sybase, configure the server to truncate the transaction log on
checkpoints.
Normally, multiple users share a single database connection with a single user
name and password, which are specified in the tibcoadmin.tra file.
Scripts are provided for each of the supported databases. They can be found in
<install_home>/administrator/5.1/bin:
See Chapter 7, Utilities, in the TIBCO Administrator Server Configuration Guide for
information on running the scripts. See Reserved Database Tables for Storing
Repository Information on page 28 for information on the tables created by each
script.
Topics
Error
Error Message Installation on a HPUX 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 HPUX 11.00 64 bit systems. It does not happen on HPUX
11.00 32 bit system and HPUX 11.11 (or 11.i) system.
To determine the OS version on your system, run:
uname -a
or
what /stand/vmunix | grep PHKL_27282
If your system is an HPUX 11.00 64 bit system and it does not have the patch, first
install HPUX kernel patch PHKL_27282 and then proceed with the installation.
Installation of patch PHKL_27282, will reboot your system.
Resolution Apply 5.0.0.4 xlC libraries as indicated by APAR IY14529 and proceed with the
installation.
Cause TIBCO product installer maintains the registry information in the file
vpd.properties.tibco.systemName. The value for systemName is determined
by InetAddress.getLocalHost().getHostName(). However, the method
getHostName(), returns different values based on the JRE versions used. For
instance on AIX, JRE 1.3.1 returns only systemName, whereas JRE 1.4.0 returns
systemName.domainName. Because of this, the installer is not always able to
load the correct registry file.
Example:
$ cd ~
$ ln -s vpd.properties.tibco.upside
vpd.properties.tibco.upside.tibco.com
Example:
$ cd ~
$ ln -s vpd.properties.tibco.upside.tibco.com
vpd.properties.tibco.upside
Answer You cannot create a standalone Administration Server (no user and resource
management) if you perform a console install. Instead, you must install in GUI
mode.
You can create an administration domain by launching the domain utility:
• Windows: Start > Programs > tibco > TIBCO Runtime Agent and Adapter
SDK 5.1 > Domain Utility.
• UNIX: <tibco_home>tra/5.1/bin/domainutility
Answer 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
# C-shell
setenv DISPLAY <ip_address>:0.0
For example, consider a scenario where you need to install the adapter 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 use telnet to connect 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.