TIBCO FTL Installation

TIBCO FTL Installation Software Release 4.3 November 2015 Two-Second Advantage

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, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright 2010 2015 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information

3 Contents About this Product...4 TIBCO Documentation and Support Services...5 Preparing for Installation... 7 Requirements... 7 Installer Log File...7 Installation...8 Installing in GUI Mode... 8 Installing in Console Mode...9 Installing in Silent Mode...9 Platform-Specific Instructions...10 Installation on UNIX... 10 Installing on a Remote UNIX Computer... 10 Setting the DISPLAY Variable...11 Installation on Microsoft Windows...11 Uninstallation...13 Uninstalling in GUI Mode... 13 Uninstalling in Console Mode...13

4 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 www.tibco.com.

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: http://www.tibco.com/services/support

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: https://www.tibcommunity.com

7 Preparing for Installation Complete these steps before you begin to install TIBCO FTL software. 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. 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 Use an existing 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. 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. Click Finish in the Post-Install Summary screen.

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. 1. Download the installation package. 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. 1. Download the installation package. 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: TIBCOUniversalInstaller -silent -V responsefile="myfilename.silent"

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 Mac OS X 10.9, 10.10 Intel x86_64 linux_x86_64.zip 64-bit OS only. 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. 1. Set the local computer to allow other computers to share its monitor. alaska> xhost + 2. Telnet to the remote computer. alaska> telnet hawaii User: Password:

11 3. Set the DISPLAY variable on the remote computer to open installer interaction windows on the local computer. For example: Result hawaii> export DISPLAY=alaska:0.0 The value of the DISPLAY variable is a string with two parts, separated by a colon character: 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. 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 Bourne shell Korn shell C shell Description DISPLAY=display_computer:screen_addr export DISPLAY export DISPLAY=display_computer:screen_addr 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. %CommonProgramFiles%\InstallShield\Universal\TIBCO\Gen1\_vpddb\_envInfo.xml

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 Intel x86_64 win_x86_64.zip Requires Visual Studio 10. Windows Server 2008 R2 64- bit Windows Server 2012 64-bit Windows Server 2012 R2 64- bit

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. 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 Custom Uninstall Typical Uninstall Description Select TIBCO products to 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. 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 3. Complete the uninstallation by responding to the console window prompts.