Documente Academic
Documente Profesional
Documente Cultură
Installation
Software Release 5.8.0
November 2012
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 THE LICENSE FILE) 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.
TIBCO, The Power of Now, TIBCO Adapter, TIBCO Administrator, TIBCO BusinessWorks, TIBCO ActiveMatrix
BusinessWorks, TIBCO Designer, TIBCO Enterprise Message Service, TIBCO Rendezvous, TIBCO Repository,
and TIBCO Runtime Agent are either registered trademarks or trademarks of TIBCO Software Inc. in the United
States and/or other countries.
EJB, 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 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-2012 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
| iii
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
Changes from the Previous Release of this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
TIBCO Administrator Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Other TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Access TIBCO Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
xii
xii
xii
xii
iv
| Contents
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
|v
Preface
Topics
vi
Preface vii
Related Documentation
This section lists documentation resources you may find useful.
TIBCO Administrator Users Guide Read this manual for instructions on using
the product to manage users, resources, and applications inside an
administration domain.
TIBCO Administrator 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.
viii
| Related Documentation
Service (JMS) protocol. Enterprise Message Service can be set as the message
transport for an administration domain.
Preface ix
Typographical Conventions
The following typographical conventions are used in this manual.
Table 1 General Typographical Conventions
Convention
Use
ENV_NAME
TIBCO_HOME
code font
Path The folder into which the product is installed. This folder is referenced
in documentation as TIBCO_HOME.
bold code
font
In large code samples, to indicate the parts of the sample that are of
particular interest.
| Typographical Conventions
Table 1 General Typographical Conventions (Contd)
Convention
Use
italic font
Key
combinations
To introduce new terms For example: A portal page may contain several
portlets. Portlets are mini-applications that run in a portal.
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.
Use
[ ]
A logical OR that separates multiple items of which only one may be chosen.
For example, you can select only one of the following parameters:
MyCommand para1 | param2 | param3
Preface xi
Use
{ }
In the next example, the command requires two parameters. The first parameter
can be either param1 or param2 and the second can be either param3 or param4:
MyCommand {param1 | param2} {param3 | param4}
In the next example, the command can accept either two or three parameters.
The first parameter must be param1. You can optionally include param2 as the
second parameter. And the last parameter is either param3 or param4.
MyCommand param1 [param2] {param3 | param4}
xii
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.
Installation Overview 1
Chapter 1
Installation Overview
Topics
Introduction, page 2
| Chapter 1
Installation Overview
Introduction
TIBCO Administrator is dependent on TIBCO Runtime Agent. Before installing
Administrator, you must first install TIBCO Runtime Agent. After TIBCO
Administrator is installed, the installer utility prompts you to launch TIBCO
Domain Utility to create the initial administration domain. The initial
administration domain includes an administration server, a TIBCO Hawk agent
and a domain repository.
When creating an administration domain you can specify the transport to use for
domain communication, either TIBCO Rendezvous or TIBCO Enterprise Message
Service. If you use Rendezvous, you can specify whether domain data is stored in
a file or database. The default is a file based repository. If you select the database
option, you are prompted later to provide database driver information and a
database account that has write permissions to the database. If you specify TIBCO
Enterprise Message Service as the transport, you must use a database for domain
storage.
You can integrate an administration domain with an LDAP directory server. This
allows you to use users and groups defined in the LDAP directory in TIBCO
Administrator. If you want your initial administration domain to be integrated
with an LDAP directory server, you should review the LDAP options explained in
TIBCO Administrator Users Guide.
TIBCO Administrator supports a variety of administration domain options.
An administration domain can have many options defined. For example, for a
Rendezvous based domain, you can define a secondary administration server
and configure a domain to span across networks. See TIBCO Administrator
Server Configuration Guide for information. These options can be set after the
initial domain is created. See TIBCO Runtime Agent Domain Utility Users Guide
for details.
Introduction 3
| Chapter 1
Installation Overview
| Chapter 1
Installation Overview
| Chapter 1
Installation Overview
If you are installing using a service pack release (for example, 5.6.1 over 5.6.0),
the installer will silently overwrite the existing version of the software. No
interruptions to running software results.
In that case, TIBCO Domain Utility is not launched, and you are not prompted
to create an administration domain.
If you are installing using a new major or minor release of a product that has
already been installed, the installer will create a new directory in the directory
of the old installation that is named after the two-digit release number (e.g.
5.8). The old installation is not removed, and must be uninstalled separately if
you wish to remove it.
In that case, TIBCO Domain Utility is launched at the end of installation, and
you are prompted to create an administration domain.
If you install a product and that product is already installed on your machine, you
cannot choose a different location.
|9
Chapter 2
This chapter explains how to install TIBCO Administrator and create the initial
administration domain.
Topics
10
| Chapter 2
Installation Options
TIBCO Installer can run in GUI, console, or silent 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.
TIBCO Domain Utility is invoked after installation to create the initial
administration domain only if you use GUI mode. When you are initially
installing TIBCO Administrator, using GUI mode is recommended.
Console mode allows you to run the installer from the command line. This is
useful if your machine does not have a window environment or if you wish to
install in silent mode. Silent mode installs without prompting you for
information.
Silent mode installs using values in .silent file. Silent mode installs in console
mode without prompting you for input.
Installation Options 11
12
| Chapter 2
the file.
5. Using a text editor, open the copied file and update the install location and
features to install.
6. Run the following:
Windows TIBCOUniversalInstaller.cmd -silent -V
responseFile="myfilename.silent"
UNIX TIBCOUniversalInstaller.bin -silent -V
responseFile="myfilename.silent"
14
| Chapter 2
The summary screen appears. Click Finish to exit the uninstall wizard.
After uninstalling the software, the uninstaller may prompt you to reboot
your computer.
| 15
Appendix A
Topics
16
| Appendix A
in Use
or Address
in Use message
If a message displays indicating Port in Use, the port used by the TIBCO
Repository Server servlet to communicate with Tomcat (the web server) is not
available. Use TIBCO Domain Utility to change that port.
If you stop and restart TIBCO Administrator under UNIX, an error results that
indicates port 8080 is already in use. In that case, you have two choices to
resolve the issue:
Change the tcp_time_wait_interval. For example, on Solaris, place the
following line at the end of the file /etc/rc2.d/S69inet
ndd -set /dev/tcp tcp_time_wait_interval 60000
vpd.properties.tibco.systemName
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
18
| Appendix A
20
| Appendix A
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.
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> TIB_designer-simple_5.0.1_h7_110.bin
| 21
Index
C
changes from the previous release vi
customer support xii
I
installation
prerequisites 5
P
prerequisites for TIBCO BusinessWorks 5
S
support, contacting xii
T
technical support xii
TIBCO BusinessWorks
prerequisites 5
TIBCO_HOME ix
U
uninstalling the software 14
Uninstalling TIBCO Runtime Agent 14
TIBCO Administrator Installation