TIB BW 6.1.0 Installation

TIBCO ActiveMatrix BusinessWorks™

InstallationSoftware Release 6.1.0May 2014

Two-Second Advantage®

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCHEMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY(OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THEEMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANYOTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS ANDCONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTEDSOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THECLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOADOR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE)OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USERLICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THESOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, ANDYOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BEBOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright lawsand treaties. No part of this document may be reproduced in any form without the writtenauthorization of TIBCO Software Inc.

TIBCO, TIBCO ActiveMatrix BusinessWorks, TIBCO Rendezvous, TIBCO Enterprise Message Service,TIBCO Business Studio, TIBCO Enterprise Administrator, TIBCO ActiveSpaces, TIBCO Runtime Agent,TIBCO Designer, and Two-Second Advantage are either registered trademarks or trademarks of TIBCOSoftware Inc. in the United States and/or other countries.

Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform EnterpriseEdition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks ofOracle Corporation in the U.S. and other countries.

All other product and company names and marks mentioned in this document are the property of theirrespective owners and are mentioned for identification purposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOTALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASEDAT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWAREVERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICALERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESECHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCOSOFTWARE 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 ORINDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE,INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.

Copyright © 2001-2014 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO Software Inc. Confidential Information

2

TIBCO ActiveMatrix BusinessWorks™ Installation

Contents

TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Hardware and Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Installation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Installing in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Installing in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Installing in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Post Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Troubleshooting Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Uninstalling the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3


TIBCO Documentation and Support Services

All TIBCO documentation is available in the TIBCO Documentation Library, which can be found here:

https://docs.tibco.com

Product-Specific Documentation

The following documents for TIBCO ActiveMatrix BusinessWorks can be found in the TIBCODocumentation Library:

● Concepts● Installation● Getting Started● Application Development● Administration● Bindings and Palettes Reference● Samples● Migration

The following documents provide additional information and can found be in the TIBCODocumentation Library:

● TIBCO Enterprise Administrator User's Guide

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, contact TIBCO Support asfollows:

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

How to Join TIBCOmmunity

TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is aplace to share and access the collective experience of the TIBCO community. TIBCOmmunity offersforums, blogs, and access to a variety of resources. To register, go to:

http://www.tibcommunity.com

4


https://docs.tibco.com

http://www.tibco.com/services/support

https://support.tibco.com

http://www.tibcommunity.com

Installation Requirements

Before installing the product on your Windows or UNIX system, ensure that you can log in to thesystem with appropriate permissions, and your system meets the hardware and software requirements.

If you plan to install in an existing installation environment, stop all running processes inTIBCO_HOME.

Installation Account

The privileges required to install the product differ for Windows and UNIX platforms. Ensure that youhave the appropriate privileges to install on the target platform.

Microsoft Windows

You must have administrator privileges for the machine where you want to install the software. If youdo not have administrator privileges, the installer exits. If you want to install the product on a networkdrive, ensure that the account used for installation has the permission to access the network drive.

UNIX

Any user, regular (non-root) user or super-user (root)—can perform the installation. Use the sameinstaller account to install all TIBCO products. A graphic environment such as CDE or X Windows isrequired to run the installer in the GUI mode.

Pre-Installation TasksPre-installation tasks include the tasks that you must complete before you start the installer, such asensuring your system meets the installation requirements and customizing your environment forcertain platforms.

Download TIBCO ActiveMatrix BusinessWorks Software

Download the TIBCO ActiveMatrix BusinessWorks software package for your platform from theTIBCO Software Product Download Site (https://download.tibco.com/tibco/). Extract the TIBCOActiveMatrix BusinessWorks archive file to a temporary directory on the machine on which you will berunning the ActiveMatrix BusinessWorks installer.

Download Eclipse LGPL Software Assembly (Required for Linux)

If the Eclipse LGPL software assembly (product_tibco_eclipse_lgpl_assembly) is not present in thetemporary directory where you extracted the product archive file, and the machine on which you willbe running the ActiveMatrix BusinessWorks installer is not connected to the Internet, you mustdownload the Eclipse LGPL software assembly for Linux platform linux26gl23_x86_64 before youinstall ActiveMatrix BusinessWorks.

Save the downloaded assembly in a temporary directory accessible to the Linux machine on which youwill be running the ActiveMatrix BusinessWorks installer. During installation, provide the location ofthe temporary directory where the downloaded software assembly is available.

If the machine is connected to the Internet, you can choose to download the Eclipse LGPL softwareassembly file for Linux (linux26gl23_x86_64) from the TIBCO Software Product Download Siteduring installation. The product_tibco_eclipse_lgpl_3.7.2.001_OSplatform.zip is downloadedto the location you select.

5


https://download.tibco.com/tibco/

Hardware and Software RequirementsReview the system memory and disk space requirements before you start the installation.

While installing the product, avoid running other processes that consume disk space in the installationenvironment directory. If another process consumes the disk space while the installer is copying thefiles, the installer might fail and display a failure message.

System and Disk Space Requirements

The product readme specifies the system memory and disk space required for installation. In additionto the disk space in the temporary directory before installation, the installer requires additional space inthe temporary directory to copy files during installation. Ensure that sufficient space is available in thedirectory you want to use as the installation environment (TIBCO_HOME).

See the readme file for information about the system and disk space requirements, supported operatingsystem platforms and versions, and required patches, if any.

Software Requirements

Before running the installer on a target platform, ensure that the platform is supported and also ensurethat your system meets the software requirements. Eclipse LGPL components are required wheninstalling the software on Linux.

Unless indicated otherwise, see the readme file for the supported products and versions.

Required Software

Software Description

Eclipsecomponents

Required. On some operating system platforms, TIBCO Universal Installerautomatically downloads certain Eclipse LGPL components during installation, ifnecessary.

6


Installation

TIBCO provides downloadable product archive files and the products can be installed using TIBCOUniversal Installer.

Extract the product archive file to a temporary directory and then run the TIBCO Universal Installerexecutable from that directory.

If installing more than one product, you can extract multiple product archive files to the sametemporary directory and then run TIBCO Universal Installer.

The installer allows you to run in one of the following modes: GUI, console, or silent, which areavailable on all platforms.

Once you launch the installer, you must specify the installation directory and select an installationprofile. If installing for the first time, create a new installation directory. For subsequent installations,you can choose to either use an existing installation directory or create a new one. On MicrosoftWindows, the default installation directory is c:\Program Files\tibco. You can choose to customizeyour installation if needed.

Installation ModesThe installer allows you to install in one of the following modes: GUI, console, or silent. Each mode issupported on all platforms.

GUI Mode

In the GUI mode, the installer presents windows that allow you to select the product components, itslocation, and so on. To install using the GUI mode, double-click the fileTIBCOUniversalInstaller.exe.

Console Mode

In the console mode, you invoke the installer from a command prompt or a terminal window and theinstaller prompts for values on the console. You can move through the installation process byresponding to the prompts. This mode is useful if your machine does not have a Windowsenvironment.

Silent Mode

In the silent mode, the installer installs without prompting you for information. Silent mode eitherinstalls using the default settings or uses a response file that was saved during an earlier installation. Inthis mode:

● If no response file has been recorded earlier and you invoke the installer with the -silentargument, the default installation parameters are used.

● If a response file exists, and the installer is started with using the arguments -silent -VresponseFile="<responseFileName>", the installer uses the values specified in the response file.

Installing in GUI ModeWhen you run the installer in the GUI mode, the installer presents panels that allow you to choose theinstallation environment and customize your installation.

Procedure

1. Run TIBCOUniversalInstaller.exe on Windows and TIBCOUniversalInstaller.bin on UNIX.

2. On the Welcome screen, click Next.

7


3. Read through the license agreement, select I accept the terms of the license agreement, and clickNext.

4. Choose to either create a new installation environment (TIBCO_HOME) or use an existinginstallation environment and click Next.Option Procedure

Create a newTIBCO_HOME

Specify properties:

● Directory The directory into which the product is installed. Thedirectory cannot be the same as the directory of an existing installationenvironment.

The directory path cannot contain special characters such as "*", "#","?", ">", "<", "%", "&", "$", "`" or "|".

● Name Identifies the installation environment. The name cannotcontain special characters such as "*", "?", ">", "<", ":", "|", "/", "\", orquotes (").

Use an existingTIBCO_HOME

Select an installation environment from the drop-down list.

5. On the Installation Profile Selection screen, select one or more of the pre-configured profiles, orclick Customize Installation and explicitly select the components you want to install. Click Next.

6. On Linux platform, the Design feature requires Eclipse LGPL assembly to be available in thetemporary directory prior to installation. If you select Typical or Design installation profile, and theassembly product_tibco_eclipse_lgpl_3.7.2.001 is not available in the assembliessubdirectory of your temporary directory, the LGPL Assembly Download screen displays. Selectone of the following download options and click Next.

● Download Gnome Binding assembly from TIBCO: Select this option if you are connected tothe Internet or do not want to use a previously downloaded assembly. The assembly isautomatically downloaded and stored in the assemblies subdirectory of the directory whereyou extracted the installer.

● Provide the location for the assembly previously downloaded from TIBCO: Select this optionif you are not connected to the Internet. Click Browse to navigate to the directory where thepreviously downloaded assembly product_tibco_eclipse_lgpl_3.7.2.001 is stored. Selectthe directory and click Open.

7. On the LGPL License Agreement screen, select I accept the terms of the license agreement, andclick Next.

8. On the Pre-Install Summary screen, verify the list of products selected for installation, and clickInstall.

9. Verify the Post-Install Summary and click Finish to complete the installation process and close theinstaller window.

Installing in Console ModeWhen you run the installer in the console mode, the installer prompts for values on a console windowand you can move through the installation by responding to the prompts. The console mode can beused to install the software in a non-Windows environment.

Prerequisites

Prepare your system and the installation media before running the installer in the console mode.

8


Procedure

1. Open a console window and navigate to the temporary directory where you extracted the productarchive file.

2. Run TIBCOUniversalInstaller -console.The installer launches a second console window.

3. Complete the installation by responding to the console window prompts, which are similar to thosedescribed in the GUI mode instructions (Installing in GUI Mode). The console also provides anoption to return to a previous selection periodically.

4. When the installation completes, press Enter to exit the installer.

Installing in Silent ModeIn silent mode, you can run the installer without the user input by pointing the installer to a responsefile. A default preconfigured response file exists.In the silent mode, the installer does not prompt for inputs during the installation, but reads the inputsfrom a response file. By default, the installer uses theTIBCOUniversalInstaller_BW_<version>.silent file, which is included in the directory thatcontains the universal installer.

To customize the silent installer:

● Make a backup copy of the TIBCOUniversalInstaller_BW_<version>.silent file and edit the fileitself. You can then run the silent installer with or without the response file argument.

Procedure

1. Make a copy of TIBCOUniversalInstaller_BW_<version>.silent file and rename the file, forexample, newfilename.silent.

2. Using a text editor, open the copied file and update the installation location and features to install.

3. Run the silent installer with or without the optional response file. Select the silent installer on:

● Windows: TIBCOUniversalInstaller.cmd -silent [-VresponseFile="newfile.silent" ]

● UNIX: TIBCOUniversalInstaller.bin -silent [-V responseFile='newfile.silent']

9


Post Installation Tasks

Post installation tasks are additional tasks that you may have to perform after installation. These tasksmay be required for certain scenarios and must be performed before you develop your applications orcreate and configure the runtime objects.

Prerequisites

Complete the installation before running the post installation tasks.

Set Environment Variable RV_HOME

You must install TIBCO Rendezvous if you want to use the Rendezvous palette activities, or the Hawkmicro agents features. Refer to the product readme for the supported versions.

Important: Ensure that the environment variableRV_HOME is set and refers to the TIBCO Rendezvousinstalled. For example, on Windows platform, set RV_HOME=TIBCO_HOME\tibrv\8.4.

10


Troubleshooting Installation

If you encounter problems during installation, ensure that your system meets all prerequisites and thencheck the installer log for potential problems.

Installer Log FileThe installer log file captures information such as:

● Environment details such as the user that invoked the installer, hostname, operating systemdetails, and so on.

● List of assemblies installed.

● Information related to the Ant scripts executed by the installer.

The installer log file, tibco_universal_installer.username_install.log is available in thefollowing locations.

● Windows: C:\Users\username\.TIBCO\install_timestamp

● Linux: user_home_dir/.TIBCO/install_timestamp

To change the location of the installer log file, specify the option -V logFile="myLogFile" when runningthe installer.

11


Uninstalling the Software

TIBCO Universal Installer can be used to uninstall the software. Using the Universal Installer, you canchoose to uninstall either all products installed in the TIBCO_HOME directory, or just the selectedproducts.

Prerequisites

Before uninstalling the product, ensure that you stop all running appnodes, ActiveMatrixBusinessWorks engine, and bwagents on the machine where you want to uninstall the product. Alsoensure that you close TIBCO Business Studio.

Procedure

1. Run TIBCO Universal Installer to uninstall the product.a) In TIBCO_HOME/tools/universal_installer/, run TIBCOUniversalInstaller.b) In the TIBCOInstallationManager, select Uninstall Products from a TIBCO Home Location,

click Next, and click Next on the Welcome screen.c) Select an uninstall option and click Next:

● Custom Uninstall: You can select the products to be removed.● Typical Uninstall: Removes all the products in the TIBCO_HOME folder.

d) If you selected Custom Uninstall, select the check box next to the product to uninstall and clickUninstall.

e) Review the product to be uninstalled and click Uninstall.f) When prompted about the clean up of the /tools directory, click Yes, clean it up.g) Click Finish in the Post Uninstall Summary screen to exit the uninstall wizard.

2. If you have uninstalled all the software under TIBCO_HOME, delete the folders under theTIBCO_HOME directory.

12


TIB BW 6.1.0 Installation

Documents

Transcript of TIB BW 6.1.0 Installation