TIBCO FTL Installation

(1)

Installation

Software Release 4.3 November 2015

(2)

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, Two-Second Advantage, TIB, Information Bus, eFTL and Rendezvous are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform Enterprise Edition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle Corporation 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,

(3)

About this Product

TIBCO®_{is proud to announce the latest release of TIBCO FTL}®_software.

This release is the latest in a long history of TIBCO products that leverage the power of Information Bus®_{technology to enable truly event-driven IT environments. To find out more about how TIBCO} FTL software and other TIBCO products are powered by TIB®_{technology, please visit us at}

(5)

TIBCO Documentation and Support Services

Documentation for this and other TIBCO products is available on the TIBCO Documentation site:

https://docs.tibco.com

Documentation on the TIBCO Documentation site is updated more frequently than any documentation that might be included with the product. To ensure that you are accessing the latest available help topics, please visit https://docs.tibco.com.

Product-Specific Documentation

Documentation for TIBCO products is not bundled with the software. Instead, it is available on the TIBCO Documentation site. To access the documentation web page for this product from a local software installation, open the following file:

TIBCO_HOME/release_notes/TIB_ftl_4.3.0_docinfo.html

TIBCO_HOME is the top-level directory in which TIBCO products are installed. ● On Windows platforms, the default TIBCO_HOME is C:\tibco.

● On UNIX platforms, the default TIBCO_HOME is /opt/tibco.

The following documents for this product can be found on the TIBCO Documentation site.

TIBCO FTL®

Documentation Set

● TIBCO FTL Concepts Everyone reads this booklet first, for an intuitive introduction to the

fundamental concepts of FTL software.

● TIBCO FTL Development Application developers and architects read this manual to understand

concepts relevant in any supported programming language.

● TIBCO FTL API Reference Application developers use this HTML documentation to learn the details

of the FTL API in specific programming languages.

● TIBCO FTL Administration Administrators read this manual to learn how to use the realm server

and its interfaces, and how to define a realm. Developers can also benefit from understanding FTL software from an administrator’s perspective.

● TIBCO FTL Installation Read this manual before installing or uninstalling the product.

● TIBCO FTL Glossary The glossary contains brief definitions of key terms used in all other parts of

the documentation set.

● TIBCO FTL 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.

TIBCO eFTL™_{Documentation Set}

TIBCO eFTL software is documented separately. Administrators use the FTL realm server GUI to configure and monitor the eFTL service. For information about these GUI pages, see the documentation set for TIBCO eFTL software.

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, contact TIBCO Support: ● For an overview of TIBCO Support, and information about getting started with TIBCO Support,

visit this site:

(6)

● 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.

How to Join TIBCOmmunity

TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to the following web address:

(7)

Preparing for Installation

Complete these steps before you begin to install TIBCO FTL®_software. Procedure

1. If you are upgrading from an earlier release of TIBCO FTL software, first read “Upgrade Migration to a New Release” in TIBCO FTL Administration.

2. Refer to the readme file. Verify that the product supports your platforms and versions.

You can find the readme file on the TIBCO download site and on the product distribution, in the same directory as the installation files.

3. Read the TIBCO Software Inc. License Agreement included with the product. 4. Read the sections in this book that pertain to your operating system platforms.

5. Verify that the host computer satisfies the requirements for installation, and that prerequisite software is already installed. For details, see Requirements.

Requirements

Required Software

Java Runtime Environment (JRE), version 1.8 or later, 64-bit, is required to run the realm server component and to run your Java application programs.

Java Developer Kit (JDK), version 1.8 or later, 64-bit, is required to develop Java application programs.

Installer Log File

The installer writes its log file, tibco_universal_installer.timestamp.username_install.log, to the directory USER_HOME/.TIBCO.

(8)

Installation

You can install the product in any of three modes: GUI, console, or silent.

Installing in GUI Mode

In GUI mode, the installer presents panels in which to indicate your choices about product selection, product location, and other installation details.

GUI mode is the installer's default mode. For example, on Windows platforms, it runs when you double-click on the installer icon.

Procedure

1. Download the installation package.

2. Extract the TIBCO FTL archive file to a temporary directory. 3. Navigate to that temporary directory.

4. Run the platform-specific installer executable, TIBCOUniversalInstaller. Click Next on the Welcome screen.

5. Read the License Agreement, select I accept the terms of the license agreement, and click Next. 6. Select a new TIBCO_HOME installation environment or an existing TIBCO_HOME installation

environment, and click Next.

Option Description Create a new

TIBCO_HOME location

Specify the following properties:

● Name Identifies the installation environment. The name cannot contain special characters, for example:

" * / : < > ? \ |

● Path The directory into which the product installs.

The directory path cannot contain special characters, for example: " # $ % & ' * < > ? |

The directory cannot be the same as the directory of an existing environment.

Use an existing

TIBCO_HOME location

Select an environment from the drop-down list.

7. Select one of the installation profiles in the left pane of the Installation Profile Selection screen. If you select Customize Installation (optional), you may then select or clear individual components in the right pane.

Click Next.

8. On the Pre-Install summary screen, verify the list of products you have selected for installation, and click Install.

(9)

Installing in Console Mode

In console mode a command line starts the installer. Consider console mode if your machine does not have a window environment.

Procedure

2. Extract the TIBCO FTL archive file to a temporary directory. 3. In a console window, navigate to that temporary directory. 4. Run the platform-specific installer executable in console mode:

TIBCOUniversalInstaller -console

5. Complete the installation by responding to the console window prompts.

Installing in Silent Mode

Silent mode installs the product without prompting you to input information during installation. Instead of prompting for inputs, the installer reads inputs from a response file. You can specify the response file as a command-line parameter. If you do not specify a response file, the installer uses the default file, TIBCOUniversalInstaller.silent.

If errors occur during installation, the installer lists them in the installation log file, which is in the directory USER_HOME/.TIBCO.

Procedure

2. Extract the TIBCO FTL archive file to a temporary directory. 3. In a console window, navigate to that temporary directory.

4. Copy the template response file TIBCOUniversalInstaller-ftl_4.3.0.silent.

If you rename your copy with the default file name, TIBCOUniversalInstaller.silent, you may omit the responseFile parameter from the installer command line.

5. Using a text editor, open the response file copy. Update the installation location and the features to install.

6. Run the platform-specific installer executable:

(10)

Platform-Specific Instructions

Before using the installer to install or uninstall the product, read the topics that pertain to your operating system platform.

Installation on UNIX

Before installing on UNIX platforms, read this platform-specific information. Installer Account

Log in either as a regular (non-root) user or as super-user (root). A graphic environment is required to run the installer in GUI mode.

To install on remote UNIX platforms, see Installing on a Remote UNIX Computer. Installation Registry

The installer maintains an installation registry. The registry location depends on the platform. Do not edit, modify, rename, move, or remove any of the registry files.

On UNIX platforms, the installation registry is in the user's home directory: USER_HOME/InstallShield/Universal/TIBCO/Gen1/_vpddb/_envInfo.xml If installation is performed by super-user (root), then USER_HOME is /root. Installation Packages

TIBCO FTL software is available on the UNIX operating systems listed in the following table. For the latest changes, see the readme file.

All installer package names begin with the prefix TIB_ftl_4.3.0_ and end with a suffix from the table.

UNIX Distribution Directories

OS Hardware Installer Package Suffix Notes

Red Hat Enterprise Linux 6.x, 7.x

Intel x86_64 linux_x86_64.zip 64-bit OS only. Mac OS X 10.9,

10.10 Intel x86_64 macosx_x86_64.zip 64-bit OS only.

Installing on a Remote UNIX Computer

On UNIX platforms, the installer opens a user interaction window. The DISPLAY environment variable specifies the computer where that window opens.

Procedure

(11)

3. Set the DISPLAY variable on the remote computer to open installer interaction windows on the local computer. For example:

hawaii> export DISPLAY=alaska:0.0

The value of the DISPLAY variable is a string with two parts, separated by a colon character: Result

● The IP address or name of the local display computer ● A screen address, such as 0.0

1. Start the installer on the remote computer.

hawaii> ./TIBUniversalInstaller-lnx-x86-64.bin

Setting the DISPLAY Variable

Set the DISPLAY variable before starting the installer on a remote UNIX computer. Procedure

● Set the DISPLAY variable to a string that specifies two parts, separated by a colon character: ● The IP address or name of a display computer

● A screen address, such as 0.0

The appropriate command depends on the UNIX shell.

Option Description

Bourne shell DISPLAY=display_computer:screen_addr export DISPLAY

Korn shell export DISPLAY=display_computer:screen_addr

C shell setenv DISPLAY display_computer:screen_addr

Installation on Microsoft Windows

Before installing on Microsoft Windows platforms, read this platform-specific information. Installer Account

You must have administrator privileges to install TIBCO FTL software. If you do not have

administrator privileges, the installer exits. To continue, either log out of the system and log in as a user with the required privileges, or request your system administrator to assign privileges to your account. 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.

Installation Registry

The installer maintains an installation registry. The registry location depends on the platform. Do not edit, modify, rename, move, or remove any of the registry files.

On Windows platforms, the installation registry is in the folder specified as the value of the environment variable CommonProgramFiles.

(12)

General Assembly Cache

The TIBCO.FTL and TIBCO.FTL.GROUP assemblies, and their associated policy DLLs all install into the Windows general assembly cache (GAC). Application programs in the .NET framework use classes from these assemblies.

Installation Packages

TIBCO FTL software is available on the Windows platforms listed in the following table. For the latest changes, see the readme file.

All installer package names begin with the prefix TIB_ftl_4.3.0_ and end with a suffix from the table.

Microsoft Windows Distribution Directories

OS/Platform

Hardwar

e Installer Package Suffix Notes

Windows 7 SP1 64-bit Windows 8 64-bit

Windows Server 2008 R2 64-bit

Windows Server 2012 64-bit Windows Server 2012 R2 64-bit

Intel

(13)

Uninstallation

You can uninstall the product in either of two modes: GUI or console.

Silent uninstallation is no longer supported in this version of the universal installer.

Uninstalling in GUI Mode

In GUI mode, the installer presents panels in which to indicate your choices about product uninstallation details.

Procedure

1. Navigate to the installer directory, TIBCO_HOME/tools/universal_installer. 2. Run the platform-specific installer executable, TIBCOUniversalInstaller. 3. Select Uninstall Products From Selected TIBCO Home Location, and click Next.

Select an uninstallation option, and click Next.

Option Description

Custom Uninstall Select TIBCO products to uninstall.

Typical Uninstall Uninstall all TIBCO products.

4. If you selected Custom Uninstall, select the products to uninstall, and click Next. 5. In the Pre-Uninstall Summary, click Uninstall.

During uninstallation the installer can clean up the /tools directory. It is good practice to do so. In the dialog box, click Yes, clean it up.

6. In the summary screen, click Finish.

After uninstalling the software, the installer could prompt you to restart your computer.

7. If you had selected Typical Uninstall, uninstalling all TIBCO products, then manually delete the directories under TIBCO_HOME.

Uninstalling in Console Mode

Use console mode if your machine does not have a window environment. Procedure

1. In a console window, navigate to the installer directory, TIBCO_HOME/tools/ universal_installer.

2. Run the platform-specific installer executable in console mode: TIBCOUniversalInstaller -console

TIBCO FTL Installation

Installation

Contents

About this Product

TIBCO Documentation and Support Services

Preparing for Installation

Requirements

Installer Log File

Installation

Installing in GUI Mode

Installing in Console Mode

Installing in Silent Mode

Platform-Specific Instructions

Installation on UNIX

Installing on a Remote UNIX Computer

Setting the DISPLAY Variable

Installation on Microsoft Windows

Uninstallation

Uninstalling in GUI Mode

Uninstalling in Console Mode