tibco activematrix businessworks installation · compatibility chart for tibco activematrix...

TIBCO ActiveMatrix BusinessWorks™

InstallationSoftware Release 6.4.0May 2017

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 (ORPROVIDE 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, EITHER EXPRESSOR 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-2017 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

Compatibility Chart for TIBCO ActiveMatrix BusinessWorks and TIBCO Enterprise Administrator . . . . . . . . . . . . . . . . . . . . . . . . 6

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Installation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Installing in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Installing in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Installing in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Postinstallation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Integrating with TIBCO Enterprise Message Service™ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Upgrading From Versions Lower than ActiveMatrix BusinessWorks™ 6.3.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Upgrading from ActiveMatrix BusinessWorks™ 6.3.1 or a Higher Version of ActiveMatrix BusinessWorks™ 6.3.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

Upgrading to ActiveMatrix BusinessWorks™ 6.4.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Updating the Database Schema to Enable bwagent to Use Database with TIBCO Enterprise Message Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Installing ActiveMatrix BusinessWorks™ Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Installing Plug-ins Using Eclipse Update Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Installing Plug-ins Using a Local Update Site or Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24

Troubleshooting Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Uninstalling the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

3


TIBCO Documentation and Support Services

Documentation for this and other TIBCO products is available on the TIBCO Documentation site. Thissite is updated more frequently than any documentation that might be included with the product. Toensure that you are accessing the latest available help topics, visit:

https://docs.tibco.com

Product-Specific Documentation

Documentation for TIBCO products is not bundled with the software. Instead, it is available on theTIBCO Documentation site. To directly access documentation for this product, double-click thefollowing file:

TIBCO_HOME/release_notes/TIB_BW_version_docinfo.html

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

● Concepts

● Installation

● Getting Started

● Application Development

● Administration

● Bindings and Palettes Reference

● Samples

● Error Codes

● Migration

● Performance Benchmarking and Tuning Guide

● API Reference

● REST Reference

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

● 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 TIBCO Community

TIBCO Community 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. TIBCO Community offersforums, blogs, and access to a variety of resources. To register, go to the following web address:

https://community.tibco.com

4


https://docs.tibco.com

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

https://support.tibco.com

https://community.tibco.com

Installation Requirements

Before installing the product on your system, ensure that you can log in to the system with appropriatepermissions, and that your system meets the hardware and software requirements need to installActiveMatrix BusinessWorks™.

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 on which you want to install the software. Ifyou do not have administrator privileges, the installer exits. If you want to install the product on anetwork drive, ensure that the account used for installation has permission to access the network drive.

Mac and UNIX

Any user, regular user (non-root) or super-user (root), can perform the installation. Use the same useraccount to install all TIBCO products.

On Unix systems, a graphic environment such as CDE or X Windows is required to run the installer inGUI 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 ActiveMatrix BusinessWorks™ software package for your platform from the TIBCOSoftware Product Download Site (https://edelivery.tibco.com/). Extract the ActiveMatrixBusinessWorks™ archive file to a temporary directory on the machine on which you will run theinstaller.

Required on Linux and Solaris: Download Eclipse LGPL Software Assembly

If the Eclipse LGPL software assembly (product_tibco_eclipse_lgpl) is not present in the temporarydirectory where you extracted the product archive file, and the machine on which you will be runningthe ActiveMatrix BusinessWorks™ installer is not connected to the internet, download the Eclipse LGPLsoftware assembly for your target platform before you install ActiveMatrix BusinessWorks™.

Save the downloaded assembly in a temporary directory accessible to the machine on which you willrun the installer. During installation, provide the location of the temporary directory where thedownloaded software assembly is available.

If the machine is connected to the internet, you can download the Eclipse LGPL software assembly filefor your target platform from the TIBCO Software Product Download Site during installation. Theproduct_tibco_eclipse_lgpl_3.7.2.001_OSplatform.zip is downloaded to the location you select.

Optional: Download Sunec LGPL Software Assembly

The software requires the Sunec LGPL library (Oracle Elliptic Curve Cryptography (ECC) Library) onlyif you want to use the ECC ciphers with SSL/TLS configurations. Without the ECC library, the SSL/TLSfunctionality is still available, but without ECC ciphers.

5


https://edelivery.tibco.com/

If the Sunec LGPL software assembly (product_tibco_sunec) is not present in the temporary directorywhere you extracted the product archive file, and the machine on which you will run the installer is notconnected to the Internet, download the Sunec LGPL software assembly for your target platform beforeyou install ActiveMatrix BusinessWorks™.

Save the downloaded assembly in a temporary directory accessible to the machine on which you willrun the installer. During installation, provide the location of the temporary directory where thedownloaded software assembly is available.

If the machine is connected to the Internet, you can download the Eclipse LGPL software assembly filefor your target platform from the TIBCO Software Product Download Site during installation. Theproduct_tibco_sunec_1.7.0.072_OSplatform.zip is downloaded to the location you select.

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 disk space while the installer is copying the files,the installer might fail and display a failure message.

System and Disk Space Requirements

The product readme file specifies the system memory and disk space required for installation. Inaddition to the disk space in the temporary directory before installation, the installer requiresadditional space in the temporary directory to copy files during installation. Ensure that sufficient spaceis available in the directory you want to use as the installation environment, your 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 your systemmeets the software requirements.

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. However, on Linux and Solaris platforms, you must download theEclipse LGPL software assembly for your target platform before installing thesoftware. See Pre-installation Tasks for details.

Sunec LGPL Optional. The software requires the Sunec LGPL library only if you want to use theECC ciphers with SSL/TLS configurations. Without the ECCL library, the SSL/TLSfunctionality is still available, but without ECC ciphers.

You must download the Sunec LGPL software assembly for your target platformbefore installing the software. See Pre-installation Tasks for details.

Compatibility Chart for TIBCO ActiveMatrix BusinessWorks and TIBCOEnterprise Administrator

The TIBCO® Enterprise Administrator (TEA) server is an application administration UI that supportsmultiple TIBCO products, including the ActiveMatrix BusinessWorks. Using the Admin UI you can

6


create, view, and monitor runtime entities. Each product registers its own agent with the server and theserver communicates with the products through these agents. The compatibility rules and chart helpdetermine the minimum version of the TEA server required by a given version of TIBCO ActiveMatrixBusinessWorks.

These are the compatibility rules for the TEA server and TEA agent libraries:

● The TEA server is backward compatible with earlier versions of TEA agent libraries, unless there isa known issue.

● The TEA server does not guarantee forward compatibility with newer versions of TEA agentlibraries.

The following table lists the version of the TEA agent library bundled with a given version of TIBCOActiveMatrix BusinessWorks.

TIBCO ActiveMatrix BusinessWorks Version Version of TEA Agent Library Bundled

6.1.0 1.2.0

6.1.1 1.2.0

6.2.0 2.0.0

6.2.1 2.1.0

6.2.2 2.1.0

6.3.0 2.1.0

6.3.1 2.1.0

6.3.2 2.1.0

6.3.3 2.1.0

6.3.4 2.1.0

6.3.5 2.1.0

6.4.0 2.1.0

Compatibility Chart

Based on compatibility rules and the version of the TEA agent library bundled in a given version ofTIBCO ActiveMatrix, the following compatibility chart can be inferred.

7


TIBCO ActiveMatrixBusinessWorks Version withTEA Agent Library Version

TEA Server Version

1.2.0

1.3.0

2.0.0

2.1.0

2.2.0

2.2.0HF-003

2.2.0HF-006

2.2.0HF-008

2.2.0HF-009

TIBCO ActiveMatrixBusinessWorks 6.1.0 with TEAAgent Library 1.2.0












8


Installation

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

Extract the downloaded product archive file to a temporary directory, and then run the TIBCOUniversal Installer executable 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.

Installation ModesYou can run the installer in one of the following modes: GUI, console, or silent. Each mode is supportedon all platforms.

GUI Mode

In GUI mode, invoke the installer by double-clicking the executable file TIBCOUniversalInstaller.The installer presents windows that you can use to select the product components, its location, and soon. Proceed through the installation process by providing your input.

Console Mode

In 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 silent mode, the installer installs without prompting you for information. Silent mode either installsusing the default settings or uses a response file that was saved during an earlier installation. In thismode:

● If no response file has been recorded earlier, invoke the installer with the -silent argument to usethe default installation parameters.

● If a response file exists, invoke the installer with the arguments -silent -VresponseFile="<responseFileName>" to use the values specified in the response file.

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

Procedure

1. Run the TIBCOUniversalInstaller executable.

● On Microsoft Windows: TIBCOUniversalInstaller.exe

● On Unix: TIBCOUniversalInstaller.bin

● On Mac OS: TIBCOUniversalInstaller-mac.command

2. On the Welcome screen, click Next.

3. Read through the license agreement, select I accept the terms of the license agreement if you agreeto the terms, and click Next.

4. Choose to create a new installation environment which will be your TIBCO_HOME and specify thedirectory for the new environment. Then click Next.

9


Option Procedure

Create a newTIBCO_HOME

In the Directory field, specify the directory into which the product isinstalled. The directory cannot be the same as the directory of an existinginstallation environment.

The directory path cannot contain the following special characters:

# $ % & * < > ? ` |

Use an existingTIBCO_HOME

Select an existing installation environment from the drop-down menu.

If you are upgrading to the latest version of the software froman earlier version, it is good practice to install the latest versionin the same installation environment. See Upgrading to a ThirdDigit Version of the Software for details.

5. On the Installation Profile Selection screen, select one or more of the pre-configured profiles, or clickCustomize Installation, and explicitly select the components you want to install. By default, thepre-configured profiles include the Oracle Elliptic Curve Cryptography Library (ECCL)component. The software requires the ECCL only if you want to use the ECC ciphers with SSL/TLSconfigurations. Without the ECCL, the SSL/TLS functionality is still available, but without the ECCciphers.

● To continue with the default selection, click Next.

● If you do not plan to use the ECC ciphers, you do not need to download and install the ECCL.Select the checkbox Customize Installation and clear the checkbox for the Oracle EllipticCurve Cryptography Library component. Then click Next.

6. On Linux and Solaris, the design feature requires Eclipse LGPL assembly to be available in thetemporary directory prior to installation. See Software Requirements for details. The installerprompts the LGPL License Agreement screen for the Eclipse LGPL assembly. Read through thelicense agreement, select I accept the terms of the license agreement if you agree to the terms, andclick Next to proceed.

7. On the LGPL Assembly Download screen, select one of the following download options and clickNext.

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

10


automatically 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 LGPL assembly is stored. Select the directory, and click Open.

8. Skip this step if the Oracle Elliptic Curve Cryptography Library component was notselected in the Installation Profile Selection screen.

If you choose to install the Oracle Elliptic Curve Cryptography Library component, the designfeature requires the Sunec LGPL assembly to be available in the temporary directory prior toinstallation. See Software Requirements for details. The installer prompts the LGPL LicenseAgreement screen for the Sunec LGPL assembly. To download the Oracle Elliptic CurveCryptography Library, select I accept the terms of the license agreement, and click Next. If you donot want to download the Oracle Elliptic Curve Cryptography Library, click Cancel to exit.

9. On the LGPL Assembly Download screen, select one of the following download options and clickNext.

● Download Oracle Elliptic Curve Cryptography Library assembly from TIBCO: Select thisoption if you are connected to the Internet or do not want to use a previously downloadedassembly. The assembly is automatically downloaded and stored in the assembliessubdirectory of the directory where you 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 LGPL assembly is stored. Select the directory, and click Open.

10. On the Pre-Install Summary screen, verify the list of products and components selected forinstallation, and click Install.

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

Installing in Console ModeWhen you run the installer in console mode, the installer prompts for values on a console window andyou can move through the installation by responding to the prompts. Console mode can be used toinstall the software in a non-Windows environment.

Prerequisites

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

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 section Installing in GUI Mode. The console also provides an option to return to aprevious selection periodically.

4. When the installation is completed, press Enter to exit the installer.

11


Installing in Silent ModeWhen you run the installer in silent mode, the installer does not prompt for your input. Instead, thevalues specified in a response file are used to complete the installation. You can use a default pre-configured response file or create your own response file.

By default, the installer uses the TIBCOUniversalInstaller_BW_<version>.silent file, which isincluded in the directory that contains 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, newfile.silent.

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

3. Open a console window, and navigate to the temporary directory where you extracted the productarchive file. Run the silent installer using one of the following commands:

● On Windows:TIBCOUniversalInstaller.cmd -silent [-V responseFile="newfile.silent" ]

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

● On Mac OS:TIBCOUniversalInstaller-mac.command -silent [-V responseFile='newfile.silent']

12


Postinstallation Tasks

Postinstallation tasks are additional tasks that you might have to perform after installation. These tasksmight 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 postinstallation tasks.

Set Environment Variable RV_HOME

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

Ensure that the environment variable RV_HOME is set and refers to the TIBCO Rendezvous installed.For example, on Windows platform, set "RV_HOME=TIBCO_HOME/tibrv/8.4".

On AIX Platform: Configure the Environment

On AIX platform, follow the steps to configure the environment:

1. Remove TIBCO_JRE_HOME/1.8.0/lib/xml.jar.

2. Copy BW_HOME/system/shared/com.tibco.tpcl.javax.system.exports_5.10.0.001/xml-apis.jar into TIBCO_JRE_HOME/1.8.0/lib/ext

3. Copy BW_HOME/system/shared/com.tibco.tpcl.com.ctc.wstx_3.2.300.002/wstx-asl-3.2.9.jar into TIBCO_JRE_HOME/1.8.0/lib/ext

4. To resolve localhost on AIX platform, add the property [hosts = local, bind4] to /etc/netsvc.conf if applicable.

On Windows Platform: Support bwagent Using TIBCO ActiveSpaces®

On Windows platform, download and install Microsoft Visual C++ 2010 Redistributable Package (x64)to ensure bwagent can use TIBCO ActiveSpaces for transport and data persistence.

Integrating with TIBCO Enterprise Message Service™

Prerequisites

Make sure that the TIBCO Enterprise Message Service™ client OSGi bundles are present in the<EMS_HOME>/components/1.0/plugins folder.

If you do not have these client libraries, install the TIBCO Enterprise Message Service™ libraries byselecting either the Development or Client installation profiles.

13


Alternatively, copy the <EMS_HOME>/components folder from an existing installation to your localmachine.

Installing TIBCO Enterprise Message Service™ Client Libraries

To install the TIBCO Enterprise Message Service™ client libraries for your ActiveMatrix BusinessWorksenvironment, run the following command from the <BW_HOME>/bin folder and follow the prompts:

bwinstall ems-driver

14


Upgrading From Versions Lower than ActiveMatrixBusinessWorks™ 6.3.1

These instructions apply if you are upgrading from a version of the software that is lower thanActiveMatrix BusinessWorks™ 6.3.1, for example ActiveMatrix BusinessWorks™ 6.2.1 to ActiveMatrixBusinessWorks™ 6.3.5. You can upgrade to a higher version of the software when new features areavailable or when problems in the software have been fixed. Typical steps include downloading andinstalling the newer version of the software, and some manual tasks to complete the upgrade. Themanual tasks consist of generic tasks required for all versions and some additional tasks that depend onthe version you are upgrading to.

Procedure

1. Install the software in a new TIBCO_HOME directory.Follow the instructions in Installation to install the software in a new TIBCO_HOME directory usingGUI, console, or silent mode.

2. Back up the domains.

Before you back up your domains, ensure that all runtime artifacts have been stopped, andare not running.

To back up a domain, open a console window and navigate to the TIBCO_HOME/bw/<older_version>/bin directory. Then run the following command:bwadmin backup -s <destination_file>.cmd domain <domain_name>

The bwadmin command file <destination_file>.cmd is generated.

3. Restore the domains.By default, the runtime components are installed under the TIBCO_HOME/bw/<new_version>directory and the runtime artifacts such as domains, AppSpaces, and AppNodes are created underthe TIBCO_HOME/bw/<new_version>/domains directory. If you want to use the runtime artifactscreated using the older version of the software, you can restore the runtime artifacts for the newerversion of the software. Complete the following tasks to restore the runtime artifacts to the newenvironment:

You also have the option to re-create the runtime artifacts. Refer to the "AdministrationTasks and Reference" section of the Administration guide for details on recreating runtimeartifacts.

a) Before restoring the domain, edit the <destination_file>.cmd as described:

● In the create -agent command, update the argument domainHome to provide theTIBCO_HOME/bw/<new_version>/domains directory.

● In the upload -domain command, update the location of the archive file to provide theabsolute path to the archive file. For example, update the upload -domain command to thefollowing:upload -domain BookStore-Domain <TIBCO_HOME>/bw/<old_version>/bin/archives/BookStore-Domain/tibco.bw.sample.binding.rest.BookStore.application_1.0.0.ear

15


You also have the option to import the TIBCO Business Studio™ projects to a newworkspace.

After installing the latest version of the software, use a new TIBCO Business Studio™workspace when developing applications, modules, or rebuilding archive files. To useprojects created in the older version, import the projects to the new workspace usingthe File > Import... menu in TIBCO Business Studio™. Reusing an existing workspacewith the newer version of the software makes that workspace unusable with the olderversion of the software.

If the agent name is specified as localhost in the command file, update it to specifythe bwagent name. The bwagent name (bw.agent.memberName) is the specified in thebwagent.ini file.

b) To restore the domain, or other runtime entities, in the new TIBCO_HOME environment,navigate to the TIBCO_HOME/bw/<new_version>/bin on the console, and run the followingcommand:bwadmin -f <destination_file>.cmd

4. Optional. If you have made manual updates to configuration files, or .tra files, copy them fromyour previous TIBCO_HOME to the appropriate locations in your new TIBCO_HOME.

5. Reconfigure the bwagent to use an external database with TIBCO Enterprise Message Service, orTIBCO FTL, for data persistence and transport. Refer to "Database with TIBCO Enterprise MessageService Configuration for bwagent" or "Database with TIBCO FTL for bwagent" in theAdministration guide for details.

6. Register the bwagent. Refer to "Compatibility Chart for TIBCO ActiveMatrix BusinessWorks andTIBCO Enterprise Administrator" in the Administration guide for compatibility details.

If you encounter issues with the TIBCO® Enterprise Administrator web client UI aftercompleting this step, stop the TIBCO® Enterprise Administrator server, clean up the srfolder under $TEA_ConfigHome/tibco/cfgmgmt/tea/data/sr, and restart the TIBCO®

Enterprise Administrator server.

7. Optional. Ensure third party JDBC drivers are installed.

If you want to use other databases, other than PostgreSQL or Microsoft SQL Server, you must addthem separately. This is a one time process for every installation of ActiveMatrix BusinessWorks ™.Open the README.txt in the respective database shells at BW_HOME/config/drivers/shells/ fordetails on what JAR files to download, and where to add them.

To add the drivers at run time for Oracle, MySQL or DB2, run the bwinstall command from<BW_Home>/6.x/bin. Ensure that you run bwinstall with no arguments to access the help andinstructions to add the driver to the run time. Refer to the section "Installing Supported Drivers forRun Time" in the Bindings and Palettes Guide for additional details.

8. Optional. Install EMS client libraries. Refer to Integrating with TIBCO Enterprise Message Service™for instructions.

This applies if you are moving to ActiveMatrix BusinessWorks™ 6.3.4 or higher.

16


Upgrading from ActiveMatrix BusinessWorks™ 6.3.1 or aHigher Version of ActiveMatrix BusinessWorks™ 6.3.x

These instructions apply if you are upgrading from ActiveMatrix BusinessWorks™ 6.3.1, or later, to ahigher version of the software up to ActiveMatrix BusinessWorks™ 6.3.5, for example, fromActiveMatrix BusinessWorks™ 6.3.1, to ActiveMatrix BusinessWorks™ 6.3.5. You can upgrade thesoftware when new features are available or when problems in the software have been fixed.Upgrading the software typically includes downloading and installing the newer version, and somemanual tasks to complete the upgrade. The manual tasks consist of generic tasks required for allversions and some additional tasks that depend on the version you are upgrading to.

Prerequisites

● The base version required for this upgrade scenario is ActiveMatrix BusinessWorks™ 6.3.1 or higher.

Procedure

1. Install the software in a new TIBCO_HOME directory.For instructions on how to complete this upgrade, refer to Upgrading From Versions Lower than6.3.1.

If you are upgrading from a version lower than ActiveMatrix BusinessWorks™ 6.3.1 tohigher, for example ActiveMatrix BusinessWorks™ 6.2.2 to higher, install the software in anew TIBCO_HOME. Refer to Upgrading From Versions Lower than 6.3.1 for instructionson how to complete this upgrade.

The installer performs a backup of the following folders in your BW_HOME, and stores the files atTIBCO_HOME/_installInfo/.spbackup/bw_6.3:

● bin

● config

● domains

● ext

● p2repos

● system

The installer also restores the bwagent_as.json and the bwagent_db.json files at BW_HOME/config/.

You can delete the bwagent_as.json_bkp and the bwagent_db.json_bkp files atBW_HOME/config/after confirming the contents of these files match the contents of thebwagent_as.json and the bwagent_db.json files .

After upgrading, you can copy the configuration and .tra files from the backup folder to retrieveyour settings before the upgrade.

2. Update the bwagent.ini file by running the config command with the -cf option. The commandchanges based on how the bwagent is configured for data persistence and transport.If the bwagent is configured to use TIBCO ActiveSpaces, run the following command.bwadmin config -cf ../config/bwagent_as.json agent

If the bwagent is configured to use an external database and TIBCO Enterprise Messaging Service,run the following command.bwadmin config -cf ../config/bwagent_db.json agent

17


If the bwagent is configured to use an external database and TIBCO FTL for data persistence andtransport, run the following command.bwadmin config -cf ../config/bwagent_ftl.json agent

3. Unregister and reregister the bwagent. Refer to "Compatibility Chart for TIBCO ActiveMatrixBusinessWorks and TIBCO Enterprise Administrator" in the Administration guide for compatibilitydetails.



4. Optional. If bwagent is configured to use an external database and TIBCO Enterprise MessageService (EMS) for data persistence and transport, update the database schemas for PostgreSQL,Microsoft SQL, Oracle, DB2, and MySQL. Refer to Updating the Database Schema to Enablebwagent to Use Database with TIBCO Enterprise Message Service for instructions.

This applies if you are upgrading from TIBCO ActiveMatrix BusinessWorks™ 6.3.1, orfrom TIBCO ActiveMatrix BusinessWorks™ 6.3.2, to a higher version of the software, up toActiveMatrix BusinessWorks™ 6.3.5.


This applies if you are moving to ActiveMatrix BusinessWorks™ 6.3.4 or higher.




What to do next

After you have completed the upgrade, import your projects to a new workspace and confirm all ofyour applications are running properly.

Reusing an existing workspace with the newer version of the software makes that workspace unusablewith the older version of the software

18


Upgrading to ActiveMatrix BusinessWorks™ 6.4.0

These instructions apply if you are upgrading from ActiveMatrix BusinessWorks™ 6.3.1, or laterversions of ActiveMatrix BusinessWorks™ 6.3.x, to ActiveMatrix BusinessWorks™ 6.4.0.

Prerequisites

● The base version required for this upgrade scenario is ActiveMatrix BusinessWorks™ 6.3.1.

● Complete these steps:

1. Back up the domains from the command line, or the Admin UI.

Before you back up your domains, ensure that all runtime artifacts have been stopped,and are not running.

To back up a domain, open a console window and navigate to the TIBCO_HOME/bw/<older_version>/bin directory. Then run the following command:bwadmin backup -s <destination_file>.cmd domain <domain_name>

The bwadmin command file <destination_file>.cmd is generated.

If you are restoring to a different location, you need to update the command file as follows:

● The agent name will point to localhost by default; you need to change this to the name ofthe machine you are restoring to.

● Update the domain home to point to the absolute path to the new location.

● Update the path to the application archive (EAR) file to an absolute path.

Refer to the section, "Backing Up and Restoring a Domain" in the Administration guide for moredetails.

2. Delete domains from the command line, or the Admin UI.

3. Stop the bwagent.

Procedure

1. Install the software in the same TIBCO_HOME directory.Follow the instructions in Installation to install the software in a same TIBCO_HOME directoryusing GUI, console, or silent mode.

The installer copies the following files, if they are present, from the TIBCO_HOME/bw/6.3/config/folder to TIBCO_HOME/bw/6.4/config/ folder and renames the original files with the _orig suffix.

● bwagent_as.json

● bwagent_db.json

● bwadmin_ftlrealmserver.json

● bwagent_ftl.json

● jaas.login.conf

● realm.properties

● krb5.conf

● mashery.ini

2. Optional. If you have made manual updates to configuration files, or .tra files, copy them fromyour previous TIBCO_HOME to the appropriate locations in your new TIBCO_HOME.

19


3. Reconfigure the bwagent to use an external database with TIBCO Enterprise Message Service, orTIBCO FTL, for data persistence and transport. Refer to "Database with TIBCO Enterprise MessageService Configuration for bwagent" or "Database with TIBCO FTL for bwagent" in theAdministration guide for details.

4. Start the bwagent.

5. Register the bwagent. Refer to "Compatibility Chart for TIBCO ActiveMatrix BusinessWorks andTIBCO Enterprise Administrator" in the Administration guide for compatibility details.






If you had already installed third party JDBC drivers in the previous version ofActiveMatrix BusinessWorks™ 6.3.x, the drivers will not need to be re-installed.


If you had already installed EMS client libraries in the previous version of ActiveMatrixBusinessWorks™ 6.3.x, the libraries will not need to be re-installed.

8. Restore the domains.By default, the runtime components are installed under the TIBCO_HOME/bw/<new_version>directory and the runtime artifacts such as domains, AppSpaces, and AppNodes are created underthe TIBCO_HOME/bw/<new_version>/domains directory. If you want to use the runtime artifactscreated using the older version of the software, you can restore the runtime artifacts for the newerversion of the software. Complete the following tasks to restore the runtime artifacts to the newenvironment:

You also have the option to re-create the runtime artifacts. Refer to the "AdministrationTasks and Reference" section of the Administration guide for details on recreating runtimeartifacts.

a) Before restoring the domain, edit the <destination_file>.cmd as described:

● In the create -agent command, update the argument domainHome to provide theTIBCO_HOME/bw/<new_version>/domains directory.

● In the upload -domain command, update the location of the archive file to provide theabsolute path to the archive file. For example, update the upload -domain command to thefollowing:upload -domain BookStore-Domain <TIBCO_HOME>/bw/<old_version>/bin/archives/BookStore-Domain/tibco.bw.sample.binding.rest.BookStore.application_1.0.0.ear

20


You also have the option to import the TIBCO Business Studio™ projects to a newworkspace.

After installing the latest version of the software, use a new TIBCO Business Studio™workspace when developing applications, modules, or rebuilding archive files. To useprojects created in the older version, import the projects to the new workspace usingthe File > Import... menu in TIBCO Business Studio™. Reusing an existing workspacewith the newer version of the software makes that workspace unusable with the olderversion of the software.

If the agent name is specified as localhost in the command file, update it to specifythe bwagent name. The bwagent name (bw.agent.memberName) is the specified in thebwagent.ini file.

b) To restore the domain, or other runtime entities, in the new TIBCO_HOME environment,navigate to the TIBCO_HOME/bw/<new_version>/bin on the console, and run the followingcommand:bwadmin -f <destination_file>.cmd

21


Updating the Database Schema to Enable bwagent to UseDatabase with TIBCO Enterprise Message Service

If you are upgrading from TIBCO ActiveMatrix BusinessWorks™ 6.3.1™, or from TIBCO ActiveMatrixBusinessWorks™ 6.3.2, to a higher version of the software, refer to the following sections forinstructions on how to update the database schemas for PostgreSQL, Microsoft SQL, Oracle, DB2, andMySQL.

PostgreSQL, Microsoft SQL, Oracle, or DB2

If bwagent has been configured to use PostgreSQL, Microsoft SQL, Oracle, or DB2 with TIBCOEnterprise Message Service (EMS) for persistence and transport, update the database schema byfollowing these steps:

1. Back-up your data in the commandHistory table.

2. Execute the following command to drop the table.drop table commandHistory;

3. Restart the bwagent.

MySQL

If bwagent has been configured to use MySQL with TIBCO Enterprise Message Service (EMS) forpersistence and transport, update the database schema by following these steps:

1. Execute the following command to alter the table.ALTER TABLE commandHistory MODIFY commandId int NOT NULL AUTO_INCREMENT;

2. Restart the bwagent.

22


Installing ActiveMatrix BusinessWorks™ Plug-ins

There are multiple ways to install the ActiveMatrix BusinessWorks™ Plug-ins.

● Install using the public Update Site: The plug-ins can be installed from within TIBCO BusinessStudio™ using the public Update Site http://update.tibco.com/eclipse/bw/version, where the versionat the end of the address reflects the version of the product you are using. See Installing Plug-insUsing Eclipse Update Site for instructions.

● Install from a local Update Site or directory: The plug-ins can be installed from within TIBCOBusiness Studio™ using a local update site or a shared directory managed by your organization. See Installing Plugins Using a Local Update Site or Directory for instructions.

● Install using the TIBCO Universal Installer package: To install using the TIBCO Universal Installerpackage, see the Installation guide provided with the plug-in.

Installing Plug-ins Using Eclipse Update SiteActiveMatrix BusinessWorks™ Plug-ins can be installed from within TIBCO Business Studio™ usingthe public update site maintained by TIBCO.

Prerequisites

The software package must be available on the update site, http://update.tibco.com/eclipse/bw/version (where the version at the end of the address reflects the version of BusinessWorks you areusing). Typically, the package name has the format <plugin_name>_<version>_p2installer.zip.

Procedure

1. Start TIBCO Business Studio™ if it has not already been started.

● On Microsoft Windows, click Start > All Programs > TIBCO > TIBCO_HOME > TIBCOBusiness Studio version_number > Studio for Designers.

● On Linux or Mac OS, run the TIBCO Business Studio™ executable located in the TIBCO_HOME/studio/version_number/eclipse directory.

2. From the menu, select Help > Install New Software to open Eclipse Update Manager.

3. In the Install dialog, enter the URL of the public update site, http://update.tibco.com/eclipse/bw/version, in the Work with field.You can save the URL by adding it to the list of available software sites using the TIBCO BusinessStudio™ menu Window > Preferences > Install/Update > Available Software Sites.

4. From the list of available plug-ins, select the plug-in you want to install. Click Next.

You can select more than one plug-in from the list to install multiple plug-ins at the sametime.

5. In the Install Details dialog, review the components you want to install. Click Next.

6. In the Review Licenses dialog, review the licenses, and click I accept the terms of the licenseagreement.

7. Click Finish to start the installation.

What to do next

After installing the software, restart TIBCO Business Studio™. This restart is necessary for the softwareto install completely.

23


http://update.tibco.com/eclipse/bw/version

Installing Plug-ins Using a Local Update Site or DirectoryActiveMatrix BusinessWorks™ Plug-ins can be installed from within TIBCO Business Studio™ using alocal site or directory maintained by your organization.

Prerequisites

Ensure that the software package is downloaded from the TIBCO download site and stored in anappropriate location, such as a local update site or a directory. The default package name has the format<plugin_name>_<version>_p2installer.zip.

Procedure

1. Start TIBCO Business Studio™ if it has not already been started.

● On Microsoft Windows, click Start > All Programs > TIBCO > TIBCO_HOME > TIBCOBusiness Studio version_number > Studio for Designers.

● On Linux or Mac OS, run the TIBCO Business Studio™ executable located in the TIBCO_HOME/studio/version_number/eclipse directory.

2. From the menu, select Help > Install New Software to open Eclipse Update Manager.

3. In the Install dialog, click Add to add a new update site you want to work with.

Only one update site can be added at a time. Repeat the following steps to add multiplerepositories that contain the downloaded software packages.

You can manage the list of software sites using the TIBCO Business Studio™ menu Window >Preferences > Install/Update > Available Software Sites.a) In the Add Repository dialog, click Archive and locate the Eclipse plug-in installation package

you want to install, and then click Open.The selected plug-in installation package is added to the Location field.

b) Provide a name for the repository. For example, specify the name as TIBCO Plugin UpdateSite for <plug-in>. Click OK.The plug-in installation package is added to the list of available software in the Install dialog.

4. In the Install dialog, select the plug-in you want to install. Click Next.

If there is more than one plug-in in the dialog, you can select multiple plug-ins to install atthe same time.

5. In the Install Details dialog, review the components you want to install. Click Next.

6. In the Review Licenses dialog, review the licenses, and click I accept the terms of the licenseagreement.

7. Click Finish to start the installation.

What to do next

After installing the software, restart TIBCO Business Studio™. This restart is necessary for the softwareto install completely.

24


Troubleshooting Installation

If you encounter problems during installation, ensure that your system meets all prerequisites, andthen check 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, host name, 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.

25


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, stop all running appnodes, the ActiveMatrix BusinessWorks™ engine,and the bwagents on the machine on which you want to uninstall the product. Also, close TIBCOBusiness Studio™.

Procedure

1. To uninstall the product, run the TIBCO Universal Installer (TIBCOUniversalInstaller) from theTIBCO_HOME/tools/universal_installer/ directory.

2. In the TIBCOInstallationManager screen, select Uninstall Products from a TIBCO Home Location,and select the TIBCO_HOME location from the drop-down menu. Then click Next.

3. Click Next on the Welcome screen.

4. On the Uninstallation Type screen, choose the type of uninstall from the following options and thenclick Next.

● Custom Uninstall: Select the products to be removed.

● Typical Uninstall: Removes all the products in the selected TIBCO_HOME folder.

5. If you selected Custom Uninstall, select the products you want to uninstall on the Product UninstallSelection screen. Then click Next.

6. Review the product to be uninstalled in the Pre-Uninstall Summary screen, and click Uninstall toproceed.

7. The installer uninstalls the selected products. When prompted to clean up the /tools directory,click Yes, clean it up.

8. Click Finish in the Post Uninstall Summary screen to exit the uninstall wizard.

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

26


tibco activematrix businessworks installation · compatibility chart for tibco activematrix...

Documents