tibco be installation

7/29/2019 Tibco BE Installation

1/100

TIBCO BusinessEvents

Installation

Software Release 5.0

April 2011

The Power to Predict


2/100

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUN DLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDEDOR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITEDADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLEDSOFTWARE IS NOT LICEN SED TO BE USED OR ACCESSED BY AN Y OTHER TIBCO SOFTWARE OR FORANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF ALICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSEAGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USERLICENSE AGREEMENT WH ICH IS DISPLAYED DURING DOWN LOAD OR INSTALLATION OF THESOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARELICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATEDIN TH E LICENSE FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMSAND CON DITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND ANAGREEMENT TO BE BOUN D BY THE SAME.

This documen t contains confidential information that is subject to U.S. and international copyright laws an dtreaties. No p art of this document m ay be reprod uced in any form without th e written auth orization of TIBCOSoftware Inc.

TIBCO, The Power of Now , TIBCO ActiveMatr ix, TIBCO ActiveMatr ix BusinessWorks, TIBCO Ad min istrator ,TIBCO ActiveSpaces, TIBCO Design er, TIBCO Enter pr ise Message Service, TIBCO H aw k, TIBCO Run timeAgent, TIBCO Rendezvou s, are either registered trad emarks or trad emarks of TIBCO Softwar e Inc. in th e United

States and/ or other countries.EJB, Java EE, J2EE, and all Java-based tr adem arks an d logos are trad emarks or registered trad emarks of SunMicrosystems, Inc. in the U.S. and other countries.

All other produ ct and company nam es and m arks mentioned in this document are the property of theirrespective owners and are mentioned for identification pu rposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HO WEVER, NOT ALLOPERATIN G SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAMETIME. SEE THE README.TXT FILE FOR THE AVAILABILITY OF TH IS SOFTWARE VERSION ON ASPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS ORIMPLIED, 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 TYPOGRAPH ICAL ERRORS.CHANGES ARE PERIODICALLY ADDED TO THE IN FORMATION H EREIN; THESE CHAN GES WILL BEINCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKEIMPROVEMENTS AND/ OR CHAN GES IN THE PRODUCT(S) AND/ OR THE PROGRAM(S) DESCRIBED INTHIS DOCUMENT AT ANY TIME.

THE CON TENTS OF THIS DOCUMENT MAY BE MODIFIED AND/ OR QUALIFIED, DIRECTLY ORINDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDINGBUT NOT LIMITED TO ANY RELEASE NO TES AND "READ ME" FILES.

Copyright 2004-2011 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO Software Inc. Confidential Information


3/100

TIBCO BusinessEvents Installation

| iii

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Changes from the Previous Release of this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

TIBCO BusinessEvents Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

TIBCO BusinessEvents and Add-On Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xAccessing TIBCO BusinessEvents Functions Reference Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Other TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii

Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv

Connecting with TIBCO Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

How to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

How to Access All TIBCO Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

How to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Chapter 1 Installation Requirements and Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

Required and Optional Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Required and Optional Third-Party Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Optional TIBCO Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

TIBCO BusinessEvents Components and Add-on Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

TIBCO BusinessEvents Standard Edition Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

TIBCO BusinessEvents Express Edition Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Add-on Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Upgrading TIBCO BusinessEvents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Standard Upgrade Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Supported Windows Platforms and Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Supported Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Windows Installation Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Supported UNIX Platforms and Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Supported UNIX Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

UNIX Installation Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Installation History Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Chapter 2 TIBCO BusinessEvents Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

TIBCO Environment and Default Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Limiting Access to TIBCO BusinessEvents Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14


4/100


iv | Contents

Using an Existing Eclipse (or TIBCO Business Studio) Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Installing TIBCO BusinessEvents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Install in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Install in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Install in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Verifying the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Verifying TIBCO BusinessEvents Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Verifying Add-On Product Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Uninstalling TIBCO BusinessEvents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Chapter 3 Post Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Post Installation Tasks for All Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Migrating Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Re-Initialize Studio Plug-ins Registry after Add-on Software Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Check and Update JVM Settings in Properties Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

All UNIX Installations Directory Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Permissions for TIBCO BusinessEvents Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Configuration for 64-bit Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Chapter 4 Migrating Projects from Earlier Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Project Migration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

For Berkeley DB Object Management Users Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Migration from 4.x to 5.0 Automatic Migration Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Migrating 4.x Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Importing a TIBCO BusinessEvents 4.x Project at the Command Line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Migrating 3.x Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Understanding the CDD File (For 3.x Users) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Most Runtime Properties are Configured in the CDD File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Processing Units (Engines) and Agent Classes are Configured in the CDD File . . . . . . . . . . . . . . . . . . . . . 51

Metadata Properties (Extended Properties) are Configured in the CDD File . . . . . . . . . . . . . . . . . . . . . . . . 51

Importing a 3.x TIBCO Designer Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Importing a 3.x Project into TIBCO BusinessEvents Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Importing a TIBCO BusinessEvents 3.x Project at the Command Line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Clean and Validate 3.x Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Clean and Validate the Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Fixing Ambiguous Reference Errors (Unqualified References) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Fixing XSLT Mapper Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Fixing Errors Due to Use of Words in Reserved Word List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Oracle Types to JDBC Backing Store Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57


5/100


Contents |v

Backing Store Data Migration Property Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Chapter 5 Property Migration Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61

Property Migration Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Appendix A Deprecated and Unused Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79


6/100


vi | Contents


7/100


|vii

Preface

TIBCO BusinessEvents allows you to abstract and correlate m eaningful bu sinessinformation from the events and d ata flowing throu gh your information systems,

and take app ropriate actions using business rules. By detecting patt erns within

the real-time flow of events, TIBCO BusinessEvents can help you to detect and

un derstan d u nu sual activities as well as recognize trend s, problems, and

opportunities. TIBCO BusinessEvents publishes this business-critical information

in real time to you r critical enterp rise systems or d ashboards. With TIBCO

BusinessEvents you can pred ict the n eeds of your custom ers, make faster

decisions, and take faster action.


The Power to Pred ict

Topics

Changes from th e Previous Release of this Guide, page viii

TIBCO BusinessEvents Express, page ix

Related Documentation, page x

Typograph ical Conventions, page xiv

Connecting w ith TIBCO Resources, page xvii

This softw are may be available on multiple operating systems. How ever, not

all operating system platforms for a specific sof tware version are released at the

same time. Please see the readme.txt file for the availabil ity of this softw are

version on a specific operating system platform.


8/100


viii | Changes from the Previous Release of this Guide

Changes from the Previous Release of this Guide

This section itemizes the major changes from the p revious release of this gu ide.

Migration Topics

The migration topics have been up da ted. See the following:

Chap ter 4, Migrating Projects from Earlier Versions, page 33

Chapter 5, Property Migration Reference, page 61

Other Changes

The full version of TIBCO Hawk w as required for the machine-level

mon itoring feature available in TIBCO BusinessEvents Monitoring and

Managem ent. Now the limited version provided with TIBCO Run time Agent

is sufficient. The d ocumen tation has been u pd ated accordingly.

In th e section Using an Existing Eclipse (or TIBCO Business Stud io)Installation on p age 16, the requirements have been u pd ated to specify Eclipse

Orbit package plug-ins, and not just Apache Xerces.

The documentation now ad dresses the needs of partial installers as well as full

installers.

The chapter on installation FAQs and troubleshooting section has been

removed because the content was no longer relevant for the curren t release.


9/100


Preface | ix

TIBCO BusinessEvents Express

The TIBCO BusinessEvents Express edition provides more limited functionality

than the TIBCO BusinessEvents standard edition. Some content in this

docum enta tion is not relevan t to users of TIBCO BusinessEvents Express. Such

content includ es but is not limited to any chap ters and major sections that contain

a note ind icating that the content d oes not apply to TIBCO BusinessEvents

Express.

Minor references to un sup ported features may not be called ou t in the text. Use

the following general guidelines to un derstand what is and is not sup ported in

these cases:

Only In Memory object management (OM) is supported. Therefore all

functionality that requ ires Cache OM, such as use of a backing store, is not

available. Berkeley DB OM is also not supp orted with the TIBCO

BusinessEvents Express edition.

The Monitoring and Management component and the related Site Topology

editor are not su pp orted with the TIBCO BusinessEvents Express edition.

Instead you can use TIBCO Administrator an d JMX for deploym ent,

monitoring, and m anagement.

Only the TIBCO BusinessEvents Decision Manager add-on is supported with

the TIBCO BusinessEvents Express edition in this release. Other add-on

produ cts are not supp orted.


10/100


x | Related Documentation

Related Documentation

This section lists documen tation resources you may find u seful.

TIBCO BusinessEvents and Add-On Product Documentation

The following d iagram shows th e ma in docum ents in the TIBCO BusinessEvents

documentation set, and the d ocum entation sets for the optional add -on p roducts.

Each set also contains an installation gu ide, release notes, and a read me file.

TIBCO BusinessEvents Documentation

TIBCO BusinessEvents Stud io, the design-time UI, is supp orted on Windows and

Linux. The documenta tion set for TIBCO BusinessEvents is as follows.

TIBCO BusinessEvents Installation: Read this man ual for instructions on site

prep aration, installation, upgrad ing from an earlier release, and project

migration.

TIBCO BusinessEvents Gett ing Started: After the prod uct is installed, u se this

manu al to learn the basics of TIBCO BusinessEvents: project design, cache


Getting Started

AdministrationArchitects Guide

DevelopersGuide

Java APIReference

FunctionsReference

Legend PDF HTML Eclipse help


Data Modeling Add-OnDocumentation


Event Stream ProcessingAdd-On Documentation


Decision Manager Add-OnDocumentation


Views Add-OnDocumentation


11/100


Preface |xi

OM, and backing store. This guide explains the m ain ideas so you gain

understanding as well as practical knowledge.

TIBCO BusinessEvents A rchitects Guide: If you are architecting an application

using TIBCO BusinessEvents, read th is guide for overview and detailedtechnical information to gu ide your w ork.

TIBCO BusinessEvent s Developers Guide: Use this guide wh en you imp lement a

project design in TIBCO BusinessEvents Stud io. It covers top ics such as

project-level tasks, resource-level tasks, debugging, and integration with

TIBCO ActiveMatrix BusinessWorks.

TIBCO BusinessEvents Administration: This book explains h ow to configure,

deploy, monitor, and m anage a TIBCO BusinessEvents ap plication an d the

data it generates. It explains how to configure th e CDD file for d ifferent object

managem ent options, set up a backing store, and how to w ork with TIBCO

BusinessEvents Monitoring an d Man agemen t compon ent, and with TIBCO

Administrator.

Online References:

TIBCO BusinessEvents Java API Reference: This on line reference is available

from the H TML docum entation interface. It provides th e Javad oc-based

documentation for the TIBCO BusinessEvents API.

TIBCO BusinessEvents Functions Reference: This reference is available from

the H TML docum entation interface. It provides a listing of all fun ctions

provid ed w ith TIBCO BusinessEvents, showing the sam e details as the

tooltips available in TIBCO BusinessEvents Stud io.

TIBCO BusinessEvents Release Notes: Read the release notes for a list of new and

changed features. This documen t also contains lists of know n issues and

closed issues for this release.

TIBCO BusinessEvents Event Stream Processing

This TIBCO BusinessEvents add-on is available separately, and includes the

TIBCO BusinessEvents Query Langu age features and the Pattern Matcher

Service. TIBCO BusinessEvents Event Stream Processing Installation : Read this brief

manu al for installation instructions. A compatible version of TIBCO

BusinessEvents m ust be installed before you install any ad d-on.

TIBCO BusinessEvents Query Developers Guide: This manu al explains how to

use the object query language to query va rious aspects of the ru nning system

For details on configuring and dep loying qu ery agents, see TIBCO

BusinessEvent s Administration.


12/100


xii | Related Documentation

TIBCO BusinessEvents Event Stream Processing Pattern M atcher Developers

Guide: This manu al explains how to u se the pattern m atcher language and

engine to correlate event patterns in a run ning system.

TIBCO BusinessEvents Event Stream Processing Release Notes: Read th e releasenotes for a list of new an d changed features. This documen t also contains lists

of known issues and closed issues for this release.

TIBCO BusinessEvents Decision Manager

This TIBCO BusinessEvents ad d-on is available separately. It incorporates th e

Decision Manager d ecision mod eling bu siness user interface (sup ported on

Wind ows and Linu x), and the Rules Managem ent Server (sup ported on all

platforms sup ported by TIBCO BusinessEvents).

TIBCO BusinessEvents Decision Manager Installation: Read this brief manu al for

installation instructions. A comp atible version of TIBCO BusinessEvents mu st

be installed before you install any ad d-on.

TIBCO BusinessEvents Decision Manager Users Guide: This man ua l explains

how business users can use decision tables and other d ecision artifacts to

create bu siness rules. It also covers configuration and administration of Rules

Managem ent Server, wh ich is used for au thentication, authorization, and

app roval processes.

TIBCO BusinessEvents Decision Manager Release Notes: Read the release notes

for a list of new and chan ged features. This documen t also contains lists of

know n issues and closed issues for this release.

TIBCO BusinessEvents Data Modeling

This TIBCO BusinessEvents ad d-on is available separately. It contains state

mod els and da tabase concept features.

TIBCO BusinessEvents Data M odeling Installation: Read this brief manu al for

installation instructions. A comp atible version of TIBCO BusinessEvents mu st

be installed before you install any ad d-on.

TIBCO BusinessEvents Data Modeling Developers Guide: This man ual explainsda ta m odeling ad d-on features for TIBCO BusinessEvents. The database

concepts feature enables you to model TIBCO BusinessEvents concepts on

Database tables. The state m odeler feature enables you to create state

machines.

TIBCO BusinessEvents Data Modeling Release Notes: Read th e release notes for a

list of new an d changed features. This documen t also contains lists of know n

issues and closed issues for this release.


13/100


Preface |xiii

TIBCO BusinessEvents Views

This TIBCO BusinessEvents add-on is available separately. It includes graphical

dashboard comp onents for ru n-time event monitoring.

TIBCO BusinessEvents Views Installation: Read th is manu al for instructions on

site preparation an d installation. A compatible version of TIBCO

BusinessEvents m ust be installed before you install any ad d-on.

TIBCO BusinessEvents Views Developers Guide: This guide explains how to u se

TIBCO BusinessEvents Views to create meaningful metrics that are presented

to bu siness users in real-time for proactive decision m aking.

TIBCO BusinessEvents Views Users Guide: This book explains how to mon itormetrics in TIBCO BusinessEvents TIBCO BusinessEvents Views and how to

represent the business p rocesses graph ically.

TIBCO BusinessEvents Views Release Notes: Read the release n otes for a list of

new and changed features. This docum ent also contains lists of know n issues

and closed issues for th is release.

Accessing TIBCO BusinessEvents Functions Reference Documentation

Reference documen tation for functions, includ ing those used in ad d-ons, is

available in the HTML documen tation interface for the TIBCO BusinessEvents

docum enta tion set, and as tooltips in TIBCO BusinessEvents Studio. To use the

HTML-based functions reference from the file system do the following:

1. Browse to BE_HOME/doc/standard/html and clickindex.htm . The H TML

documentation interface appears.

2. In the left panel, browse to Online References and in the right pan el choose

TIBCO BusinessEvents Functions Reference. The reference op ens in a n ew tab.

3. Click the navigation links to browse to the functions as desired.

Other TIBCO Product Documentation

You may find it useful to refer to th e d ocumen tation for the following TIBCOproducts:

TIBCO ActiveSpaces

TIBCO Hawk

TIBCO Rendezvous

TIBCO Enterprise Message Service

TIBCO ActiveMatrix BusinessWorks


14/100


xiv | Typographical Conventions

Typographical Conventions

The following typ ographical conventions are used in this manu al.

Table 1 General Typographical Conventions

Convention Use

TIBCO_HOME

ENV_HOME

BE_HOME

Many TIBCO prod ucts mu st be installed w ithin the sam e hom e directory. This

directory is referenced in d ocumen tation as TIBCO_HOME. The valu e of

TIBCO_HOMEdep ends on the operating system. For example, on Window s

systems, the default value is C:\tibco .

Other TIBCO produ cts are installed into an installation environment. Incompat ible

prod ucts and m ultiple instances of the same p rodu ct are installed into d ifferent

installation environments.

An environm ent home directory is referenced in documentation asENV_HOME.

The value ofENV_HOMEdep ends on the operating system. For example, on

Wind ows systems the default value is C:\tibco .

TIBCO BusinessEvents installs into a d irectory within an ENV_HOME. This

directory is referenced in d ocumen tation as BE_HOME. The va lue ofBE_HOME

dep ends on the operating system. For example on Window s systems, the default

value is C:\tibco\be\5.0.

code font Code font iden tifies comm and s, code exam ples, filenam es, path nam es, and

outpu t displayed in a command wind ow. For examp le:

Use MyCommand to start the foo process.

bold code

font

Bold code font is used in the following w ays:

In procedures, to indicate what a user types. For example: Type admin .

In large code samples, to indicate the parts of the sample that are of

par ticular interest.

In comm and syntax, to indicate the default parameter for a command. For

example, if no param eter is specified, MyCommand is enabled:

MyCommand [enable | d isable]

P f |


15/100


Preface |xv

italic font Italic font is u sed in the following ways:

To indicate a document title. For example: See TIBCO BusinessWorks Concepts.

To introduce new terms For example: A portal page may contain several

portlets. Portlets are mini-applications that run in a portal.

To indicate a variable in a command or code syntax that you m ust replace.

For example: MyCommand pathname

Keycombinations

Key name separated by a p lus sign ind icate keys pressed simu ltaneously. Forexample: Ctrl+C.

Key nam es separated by a comm a and space ind icate keys pressed one after the

other. For example: Esc, Ctrl+Q.

The note icon ind icates information that is of special interest or importance, for

example, an ad ditional action required only in certain circum stances.

The tip icon ind icates an idea that could be u seful, for example, a way to app ly

the information p rovided in the cur rent section to achieve a specific result.

The warn ing icon ind icates the potential for a dam aging situation, for example,

da ta loss or corrup tion if certain steps are taken or n ot taken.

Table 1 General Typographical Conventions (Contd)

Convention Use

Table 2 Syntax Typographical Conventions

Convention Use

[ ] An optional item in a comman d or code syntax.

For examp le:

MyCommand [optional_parameter] required_parameter

| A logical OR that separates multiple items of which only one may be chosen.

For examp le, you can select only one of the following p aram eters:

MyCommand param1 | param2 | param3

xvi | Typographical Conventions


16/100


xvi | Typographical Conventions

{ } A logical group of items in a comm and . Other syntax notations may app earwithin each logical group .

For example, the following command requires two pa rameters, wh ich can be

either the pair param1 an d param2 , or the pair param3 an d param4 .

MyCommand {param1 param2} | {param3 param4}

In the next examp le, the command requires two parameters. The first param eter

can be either param1 or param2 and the second can be either param3 or param4 :

MyCommand {param1 | param2} {param3 | param4}

In the next example, the comm and can accept either two or three param eters.

The first parameter must be param1 . You can optionally includ e param2 as the

second parameter. And the last param eter is either param3 or param4 .

MyCommand param1 [param2] {param3 | param4}

Table 2 Syntax Typographical Convent ions

Convention Use

Preface |xvii


17/100


Preface |xvii

Connecting with TIBCO Resources

This section p rovides links to helpfu l TIBCO resources.

How to Join TIBCOmmunity

TIBCOmm un ity is an online destination for TIBCO customers, partners, and

residen t experts, a p lace to share and access the collective experience of the

TIBCO comm un ity. TIBCOm mun ity offers forum s, blogs, and access to a var iety

of resources. To register, go to http:/ / www.tibcommunity.com.

How to Access All TIBCO Documentation

After you join TIBCOmm un ity, you can access the docum entation for a ll

supp orted prod uct versions here:

http:/ / docs.tibco.com/ TibcoDoc

How to Contact TIBCO Support

For comm ents or problems with th is manu al or the software it add resses, please

contact TIBCO Suppor t as follows.

For an overview of TIBCO Supp ort, and information about getting started

with TIBCO Supp ort, 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 p assword . If you d o not have a u ser

nam e, you can request one.

xviii | Connecting with TIBCO Resources
http://www.tibcommunity.com/http://docs.tibco.com/TibcoDochttp://www.tibco.com/services/supporthttps://support.tibco.com/https://support.tibco.com/http://www.tibco.com/services/supporthttp://docs.tibco.com/TibcoDochttp://www.tibcommunity.com/


18/100


xviii | Connecting with TIBCO Resources

|1


19/100


|

Chapter 1 Installation Requirements and Guidelines

This chap ter lists software requ irements and supported platforms. It also

provid es other information to en sure a successful installation of the TIBCO

BusinessEvents software.

Topics

Required and Op tional Produ cts, page 2

TIBCO BusinessEvents Comp onents and Ad d-on Produ cts, page 5

Upgrad ing TIBCO BusinessEvents, page 7

Sup ported Wind ows Platforms and Guidelines, page 8

Sup ported UNIX Platforms an d Guidelines, page 10

Installation H istory Log Files, page 12

TIBCO BusinessEvents Express This guid e is also used to d ocumen t installation

of the TIBCO BusinessEvents Expresss ed ition. The TIBCO BusinessEventsExpress edition supp orts only In Memory object man agemen t. Content tha t

requ ires cache functionality does not ap ply to TIBCO BusinessEvents Express

edition.

2 | Chapter 1 Installation Requirements and Guidelines


20/100


|

Required and Optional Products

Depend ing on the tasks you w ish to perform, the following third -party prod uctsand additional TIBCO produ cts listed in th is section can be u sed w ith TIBCO

BusinessEvents.

Required and Optional Third-Party Products

TIBCO BusinessEvents p rovides JRE version 1.6.0, wh ich is the requ ired version.

DBMS for (Optional) Backing Store

For the op tional backing store feature, the following DBMS software is supported :

Oracle

Oracle Database 10g Enterprise Edition Release 2

Oracle Database 11g Enterprise Edition Release 1 and 2

Oracle Real App lication Clusters (RAC) 10g Release 2

Oracle Real Application Clusters (RAC) 11g Release 1 and 2

The Oracle Express Edition can also be used for non-production u sage.

Database driver ojdbc6.jar for u se w ith Sun Java JRE 6 (Oracle Thin

Driver only)

Microsoft SQL Server 2005 and 2008 Enterprise Edition w ith sqljdbc4.jar

Using Oracle Coherence as Alternative Cache Provider

Only TIBCO BusinessEvents DataGrid is provided with TIBCO BusinessEvents.

An Oracle Coherence cache provider option is available for customers w ho w ant

to use their own licensed copy of Oracle Coherence software.

Use of Oracle Coherence Version 3.6 and above is sup ported .

The version of TIBCO BusinessEvents and all add-on products must match.

When you up grad e TIBCO BusinessEvents, you mu st also up grade all add -on

prod ucts in u se to the same version. Similarly, you cannot install a later version of

an add -on onto an earlier version of TIBCO BusinessEvents. Add -ons mu st be atthe sam e version as TIBCO BusinessEvents in ord er to w ork correctly.

Required and Optional Products |3


21/100


|

Using an Existing Eclipse (or TIBCO Business Studio) Installation

Using the bun dled Eclipse software is recomm end ed. How ever, you can

optionally use an existing Eclipse installation. You can , for example, use th e

Eclipse installation p rovided with TIBCO Business Studio business modelingsoftware. This option is not available with partial installers (comm only used for

service pack releases). See Using an Existing Eclipse (or TIBCO Business Stud io)

Installation on p age 16 for details.

Using Copssh for TIBCO BusinessEvents Monitoring and Management

TIBCO BusinessEvents Mon itoring and Managem ent (MM) is a provid ed

compon ent. It is one of the options ava ilable for deploymen t, monitoring, andman agemen t. (If TIBCO Adm inistrator is used in your environmen t, you can use

it instead.)

Copssh is one of the options available to enable MM to perform remote start and

dep loyment of TIBCO BusinessEvents engines run ning on Microsoft Window s.

Copssh versions 3.1.3 and 3.1.4 are supported.

Due to changes in the Copssh prod uct, versions 4.0 and above do not workcorrectly with MM.

LDAP Support for Optional Authorization Features

You can op tionally use au thor ization for TIBCO BusinessEvents Monitor ing and

Management, and also TIBCO BusinessEvents Decision Manager and TIBCO

BusinessEvents Views add-ons. You can u se file-based or LDAP-based

authorization mechanisms. Supported LDAP products are:

Oracle Directory Server Enterprise Edition 6.1 (formerly Sun Directory Server

Enterprise Edition)

Windows Server 2003 Active Directory



22/100


|

Optional TIBCO Products

TIBCO BusinessEvents does not require installation of other TIBCO products.

Certain features requ ire use of other TIBCO p rodu cts. The next table lists

prod ucts that are typ ically used w ith TIBCO BusinessEvents and the sup portedversions.

Table 3 Optional TIBCO Products

Component Purpose

TIBCO ActiveMatr ix

BusinessWorks 5.8, 5.9

Optional. TIBCO ActiveMatrix BusinessWorks is a scalable, extensible,

and easy to use integration p latform th at allows you to develop

integration projects. Optionally, you can use ActiveMatrixBusinessWorks in integrat ion projects.

TIBCO Administrator

5.6, 5.7

Optional. Can be used for dep loyment.

TIBCO Design er 5.6.2,

5.7

Optional. Includ ed in the TIBCO Runtim e Agent d istribution. Used for

ActiveMatrix BusinessWorks integration pro jects.

TIBCO Enterp rise

Message Service 5.0

Optional. TIBCO Enterp rise Message Service allows you to use the Java

Messaging Services (JMS) as a message tran spor t.

TIBCO Hawk 4.8.1 and

higher

Optional. Provides monitoring capability. Used (if available) by the

TIBCO BusinessEvents Monitoring an d Managem ent component to

provide machine-level health m etrics.

Note that the limited version of TIBCO Haw k bun dled with TRA is

sufficient for use with TIBCO Administrator and with TIBCOBusinessEvents Monitoring and Managem ent.

TIBCO Rend ezvous 8.2.1

and higher

Optional. TIBCO Rendezvou s can be used as a message transport.

TIBCO Runtime Agent

5.6.2, 5.7

Used w ith TIBCO Ad ministrator and TIBCO ActiveMatrix

BusinessWorks. Includ es TIBCO Designer.

TIBCO BusinessEvents Components and Add-on Products |5


23/100


|

TIBCO BusinessEvents Components and Add-on Products

This section lists the prod uct comp onents and add-on prod ucts.

TIBCO BusinessEvents Standard Edition Components

TIBCO BusinessEvents Standard edition p rovides the following comp onents.

Studio Eclipse-based component for designing TIBCO BusinessEvents

projects.

Eclipse Platform A provided Eclipse platform. If you do not u se the provided

Eclipse insta llation, you mu st have a p reexisting Eclipse 3.4.2 installation . See

Using an Existing Eclipse (or TIBCO Business Studio) Installation on page 16

for more information.

TIBCO BusinessEvents DataGrid Used for cache functionality. Cannot be

separately installed or uninstalled.

Monitoring and Management A configurable web-based u ser interface for

mon itoring and man aging TIBCO BusinessEvents clusters.

Documentation TIBCO BusinessEvents documentation. The doc folder

contains an H TML and a PDF folder. If you d o not install docum entation, this

folder is not includ ed in the installation.

Runtime The runtim e engine. Cannot be separa tely installed or uninstalled.

TIBCO BusinessEvents Express Edition Components

TIBCO BusinessEvents Express edition p rovides th e following components.

Studio Eclipse-based component for designing TIBCO BusinessEvents

projects.

Eclipse Platform A provided Eclipse platform. If you do not u se the provided

Eclipse installation, you mu st have a preexisting Eclipse installation of a

sup ported version. See Using an Existing Eclipse (or TIBCO Business Stud io)

Installation on p age 16 for more information.

Documentation TIBCO BusinessEvents documentation. The doc folder

contains an H TML and a PDF folder. If you d o not install docum entation, this

folder is not includ ed in the installation.

Runtime The runtim e engine. Cannot be separa tely installed or uninstalled.



24/100


Add-on Products

When you install TIBCO BusinessEvents Stand ard edition, you can also install

any ad d-on prod ucts you have pu rchased. Add-ons available in this release are

shown below.

TIBCO BusinessEvents Data Modeling

TIBCO BusinessEvents Event Stream Processing

TIBCO BusinessEvents Decision Manager

TIBCO BusinessEvents Views

Install TIBCO BusinessEvents first, and only install add -ons that are the sameversion as TIBCO BusinessEvents.

For TIBCO BusinessEvents Express ed ition, only TIBCO BusinessEvents Decision

Manager is supp orted.

Upgrading TIBCO BusinessEvents |7


25/100


Upgrading TIBCO BusinessEvents

Standard Upgrade Procedures

Software from TIBCO uses three nu mbers to ind icate w hether the release is major,

minor or a patch. For examp le, 5.0.0 ind icates a ma jor release, 5.4.0 indicates a

minor release and 5.3.3 indicates a service pack release.The installer for a service pack release performs an au tomat ic up grad e. For

example, the installer wou ld a utom atically up grad e TIBCO BusinessEvents 5.3.0

to 5.3.1 by overwriting the conten ts of the 5.3 d irectory.

If you are upgrading TIBCO BusinessEvents to a new major or m inor version, it is

strongly recomm ended that you u ninstall the earlier version of the prod uct first

and perform a fresh installation (full prod uct installers only).

Installing Over the Same Version

Note th at if you are reinstalling over the sam e version, if any files are curren tly

locked (that is, in use), the installer marks the file for d eletion in the install

location. After installation if the installer prom pts you to reboot your system, you

mu st reboot before using the software.

Before You Upgrade Read Chap ter 4, Migrat ing Projects from Earlier Versions, on

page 33.



26/100


Supported Windows Platforms and Guidelines

Supported Windows Platforms

The following is a list of sup ported platforms for Microsoft Window s:

Windows Server 2003 (x86 and x86_64) Windows Server 2008 (x86 and x86_64)

Windows XP (x86)

Windows Vista Business Edition (x86)

Windows 7

Disk Space Requirements

Disk space required for the installed p rodu ct is between 530MB and 550MB

depend ing on platform.

In add ition to the disk space required for the installed p rodu ct, files created by th e

installer requ ire about 500 KB of disk space in the user s hom e directory.

Windows Installation Guidelines

Installer Account

You m ust have administrator p rivileges for the machine on wh ich the software isinstalled.

If you do not h ave ad ministrator p rivileges, the installer exits. You mu st then log

out of the system and log in as a user w ith the required p rivileges, or request your

system administrator to assign the privileges to your accoun t.

The TIBCO BusinessEvents DataGrid component is sup ported on all Wind ows

platforms except Wind ows 7.

Within a single cache cluster, you can u se a m ixture of 64bit and 32bit operating

systems.

Supported Windows Platforms and Guidelines |9


27/100


Installing from a Network Drive

If you intend to install the produ ct from a network d rive, you m ust ensure that

the accoun t used for installation has perm ission to access the network d rive.

Installing on Windows 2000 Terminal Server

There are two mod es in term inal server, Execute an d Install . By d efault a ll

users are logged on in Execute mod e, wh ich allows them to run th e app lications.

When you want to install the software for use by everyone, the Administrator

should change to Install mode.

The best way to insta ll the software on Window s 2000 Terminal Server is to use

the Ad d/ Remove Programs control panel applet, because this autom atically sets

the mode to Install du ring the installation and then back to Execute at the end.

Alternatively, you can manu ally change your m ode to Install by typing C:\>

change user /install

Change back to execute by typing C:\> change user /execute

Check your current mod e by typing C:\> change user /query

If you install in th e Execute mod e, the installation registry is mainta ined in you r

user h ome d irectory. If you install in the Install mod e, the installation registry is

maintained in the %SystemRoot% folder.



28/100


Supported UNIX Platforms and Guidelines

Supported UNIX Platforms

The following is a list of sup ported platforms for UN IX:

Red Hat (x86) (32-bit & 64-bit)

Red Hat Enterprise Linux 4.x, 5.x, and m aterially equivalent Linux

distributions

SUSE (x86)

SUSE Linux Enterprise 11

SUSE Linux Enterprise 10

Solaris X86_64

Solaris 10 (64-bit)

Solaris SPARC

Solaris 10 (32-bit and 64-bit)

Hewlett-Packard:

HP-UX 11i (v1, v2, v3) (PA-RISC) (32-bit and 64-bit)

HP-UX 11i (v2, v3) (IA-64/ Itanium ) (64-bit)

IBM (POWER):

AIX 6.1 (64-bit)

AIX 5.3 (64-bit)

TIBCO BusinessEvents Studio is supp orted only on Linux (and Windows)

platforms.

TIBCO BusinessEvents DataGrid is not supported on HP-UX and AIX

platforms.

Supported UNIX Platforms and Guidelines |11


29/100


Disk Space Requirements

App roximate d isk space required for the installed prod uct is as follows:

530MB for Linux

800MB for H P-UX and Solaris X86_64

830MB for Solaris SPARC

440MB for AIX

In add ition to the d isk space required for the installed prod uct, files created by the

installer requ ire abou t 500 KB of disk space in the user s hom e directory.

UNIX Installation Guidelines

Installer Account

The software can be installed by a regular (non-root) user and sup er-user (root).

Different u sers can install the same p rodu ct at d ifferent locations.

Windowing Environment

A window ing environm ent such as CDE (that is, X11 Window s) is required to run

the installer in GUI mode. It is not required for a console installation or silent

installation.

For platforms that su pp ort 64-bit mode, post installation configuration is

required. See Configuration for 64-bit Mode on page 30.

For HP-UX platforms, also see HP-UX on page 31.

All 32-bit installers are supported on 64-bit platforms as 32-bit software.

Installation of TIBCO BusinessEvents add-on products must be performed by the

same user who installed TIBCO BusinessEvents Depend ency checking will notwork correctly un less the same user installs all dep endent prod ucts.



30/100


Installation History Log Files

Installation and un installation history is kept in log files in the.TIBCO

directorywithin the installer s user (or home) d irectory.

The folder nam es use this format:

install_month-day-year.time

uninstall_month-day-year.time

The installation log files record environm ent d etails such as the u ser that invoked

the installer, hostname, operating system d etails, and so on.

|13


31/100


Chapter 2 TIBCO BusinessEvents Installation

This chap ter d escribes how to insta ll this release using TIBCO Universal Installer.

Topics

Installation Overview, page 14

Using an Existing Eclipse (or TIBCO Business Studio) Installation , page 16

Installing TIBCO BusinessEvents, page 18

Verifying th e Installation, page 22

Uninstalling TIBCO BusinessEvents, p age 23

14 | Chapter 2 TIBCO BusinessEvents Installation


32/100


Installation Overview

TIBCO Environment and Default Installation Directory

The installer promp ts you to specify the environm ent (TIBCO_HOME) where you

want to install TIBCO BusinessEvents. Each TIBCO environm ent is isolated . You

can install the sam e software into d ifferent environ men ts safely, for examp le, for

test, QA, and staging purp oses. You can install mu ltiple TIBCO prod ucts into the

same environment.

An environm ent has a nam e and a d irectory on d isk. The directory is the rootdirectory for all TIBCO prod ucts you w ant to install into this environment.

Microsoft Windows

The default installation location is the TIBCO_HOMEwh ere all TIBCO produ cts areinstalled. Typically, TIBCO_HOMEis c:\tibco .

The Start m enu path to the executable files includ es the environm ent as follows:

Start > TIBCO > TIBCO_HOME> TIBCO BusinessEvents 5.0

The name is also app end ed to the name of Window s services created by the

installer.

UNIX

The default installation directory dep ends on who performs the installation:

For root users, the default installation directory is /opt/tibco .

For non-root users, the default installation directory is //tibco ,

where is the home directory of the user.

Limiting Access to TIBCO BusinessEvents Installations

In some enterp rises, users are given limited access to software installations, such

as TIBCO BusinessEvents. All users, how ever, require full rights to the Eclipse

installation because certain files are w ritten d uring normal u se of BusinessEvents

Studio.

When installing m ultiple TIBCO produ cts into a single installation environmen t,

ensure that all the prod ucts are comp atible.

Installation Overview |15


33/100


In this case you m ust install Eclipse separately, in areas wh ere users have

perm ission to write.

Use of a separately insta lled Eclipse installation (instead of the Eclipse software

provid ed with TIBCO BusinessEvents) may be required for other reasons too.

See Using an Existing Eclipse (or TIBCO Business Studio) Installation on p age 16.



34/100


Using an Existing Eclipse (or TIBCO Business Studio) Installation

This section is optional. It is also relevan t only for releases w ith full insta llers. It is

not relevant for releases with par tial installers, such as service pack releases.

Requirements and Guidelines

TIBCO recommends using th e Eclipse software bu nd led w ith the TIBCO

BusinessEvents software. However, if you prefer to use your existing Eclipse

software installation, or w ant to install Eclipse separately, or want to install

TIBCO BusinessEvents for use with the TIBCO Business Studio businessmod eling software prod uct, you mu st up da te the existing Eclipse installation

with the requ ired p lug-ins. You can d o this before or after insta lling TIBCO

BusinessEvents.

The Eclipse requiremen ts are:

Eclipse release 3.4.2

Eclipse Modeling Framework (EMF) release 2.4.2

Model Development Tools (MDT) UML release 2.2.2

The following Eclipse Orbit package plug-ins:

Javax XML 1.3.4

Apache Commons Codec 1.3.0

Apache Commons Httpclient 3.1.0

Apache Commons Lang 2.3.0

Apache Xerces 2.9

Apache XML Resolver 1.2.0

Apache XML Serializer 2.7.1

To Use an Existing Eclipse Installation with TIBCO BusinessEvents

1. Download the above files from the Eclipse Found ation web site.

2. If you have not already done so, install the Eclipse release.

3. Extract the other comp onents (EMF, MDT, and Eclipse Orbit package

plug-ins) to th e top -level directory of your Eclipse installation.

4. For partial installers (such as service packs) only: Re-initialize Eclipse in your

existing TIBCO BusinessEvents insta llation before you install the cur rent

Using an Existing Eclipse (or TIBCO Business Studio) Installation |17

l f TIBCO B i E T d hi h di


35/100


release of TIBCO BusinessEvents. To d o th is, change directory to

BE_HOME/studio/eclipse and execute the command :

studio -clean -initialize

5. Install TIBCO BusinessEvents for use w ith an existing Eclipse installation, asexplained in th is guide. Remem ber to select the Use my ow n Eclipse

installation check box.

(You can install TIBCO BusinessEvents before you install the Eclipse softw are

if you prefer; but by step 6 in this procedure, both shou ld be installed).

6. Cop y the TIBCOBusinessEvents-Studio-plugins.link file from

BE_HOME/studio/eclipse/dropins_configuration to Your_Eclipse/links.

7. Configure the Your_Eclipse/eclipse.ini file as follows:

Ensure that the VM setting is done for Java 1.6 JVM. Path shou ld appear in

a new line:

vm

path to JRE 1.6

Add the following properties to -vmargs , each on a n ew line

-DBE_HOME=path to BE_HOM E

-Dstudio.wrapper.tra.file=/studio/eclipse/configuration/studio.tra

-DJDK_LIB=path to JRE 1.6/lib

8. Change directory to the Your_Eclipse locationand run the command :

eclipse -clean initialize

9. Run the command eclipse.

Running this comm and loads Eclipse w ith the BusinessEvents Stud io

plug-ins.


Installing TIBCO BusinessEvents


36/100


Installing TIBCO BusinessEvents

Download the TIBCO BusinessEvents p rodu ct package from

http:/ / www.download.tibco.com. To dow nload the software, you need a

username and password. If you d id not receive a username and password,

contact TIBCO Technical Suppor t.

You can install using one of the following mod es, wh ich are su pp orted on all

platforms.

Install in GUI Mode

Install in Console Mode

Install in Silent Mod e

Install in GUI Mode

The following procedu re explains how to install the software in GUI mode.

1. Prepare to install as follows:

a. Log in to the system on which you w ant to install TIBCO BusinessEvents.b. Extract the TIBCO BusinessEvents produ ct archive file to a temp orary

directory then n avigate to that directory.

2. Run TIBCOUniversalInstaller.

3. Review the information in the Welcome dialog and clickNext.

4. The License Agreement dialog displays. Review the term s of the license

agreement and , if you agree to them , clickI accept the terms of the licenseagreement. Then clickNext to continue with the installation. If you are also

installing ad d-on p rodu cts, you mu st accept each license separately.

If you do not agree to the term s of the license agreement , clickCancel to exit

from the installation p rocess.

If you will use an existing Eclipse installation See Using an Existing Eclipse (or

TIBCO Business Studio) Installation on page 16 for steps you m ay want to take

before insta lling TIBCO BusinessEvents.

After installation is complete Perform any post-installation tasks as requ ired. See

Chap ter 3, Post Installation Tasks, on page 25.

Installing TIBCO BusinessEvents |19

5 Select or create a TIBCO environment For more details and guidelines see


37/100


5. Select or create a TIBCO environment. For more details and guidelines see

TIBCO Environment an d Default Installation Directory on p age 14. Do one of

the following:

Select Use an Existing TIBCO_HOME, select an environm ent from th e list,and clickNext.

For a service pack, select the environment u sed by the p rior release.

Create a new environm ent. Browse to and select a d irectory, and p rovide a

name for the environment.

The nam e cann ot contain special characters such as "*", "?", ">", "


38/100


Install in Console Mode

The following procedu re explains how to install the software in console mode.

1. Open the physical media or down load the TIBCO BusinessEvents product

package.

2. Extract the TIBCO BusinessEvents p roduct archive file to a temp orary

directory.

3. Using a console window, navigate to the temp orary directory that contains the

un iversal installer and run the installer using this comm and line:

TIBCOUniversalInstaller -console

4. Complete the installation by respond ing to the console wind ow promp ts.

Install in Silent Mode

The following procedu res explain how to in stall the software in silent m ode.

Any errors th at occur du ring installation are listed in the installation log file (see

th e User_Home/.TIBCO directory.

Configure the Installation Responses

A configura tion file, TIBCOUniversalInstaller.silent , is provided w ith the

un iversal installer. Copy the file to anoth er nam e (but keep th e .silent

extension) and use it to configure your installation choices.

You m ust ed it the file in a text editor and provid e all non-default values as needed

before launching the silent installation. For examp le, ensure th at theinstallationRoot an d createNewEnvironment attr ibutes are set correctly. The

file includ es comm ents to help you set the installation prop erties.

Save the configura tion file to the same d irectory w here the un iversal installer file

is located. It is recommen ded that you back up the original file or save your

edited file to a d ifferent n ame. This file is known as the response file.

Install in Silent Mode1. Extract the TIBCO BusinessEvents p roduct archive file to a temp orary

directory.

2. Using a console window, navigate to the temp orary directory that contains the

universal installer.

3. Run the installer:

TIBCOUniversalInstaller -silent -V responseFile="myfile.silent"

Installing TIBCO BusinessEvents |21

If you are u sing the TIBCOUniversalInstaller.silent file, you n eed not


39/100


If you are u sing the C U file, you n eed not

supp ly the file name and can run TIBCOUniversalInstaller -silent .

A line similar to the following is written to the installer log file when

installation completes:Install, com.tibco.installer.util.TIBCOInstaller, dbg.Debug,The installation has completed. Please check the log file for

additional information.


Verifying the Installation


40/100


Verifying the Installation

TIBCO BusinessEvents and TIBCO BusinessEvents add-on product installations

can be verified as follows.

Verifying TIBCO BusinessEvents Installation

After installation of TIBCO BusinessEvents and any of its add -on prod ucts, verify

the installation as follows.

To ver ify if the insta llation is su ccessful, first check the filetibco_universal_installer.userid_install.log , which is located in the

.TIBCO directory of the user performing the installation:

Errors in th is file, or the existence of error files und er this folder, ind icates

installation p roblems. Error files have th e following format:

antTask_ERROR_log_post-install_mm-dd-yyy.n.log

If the log files dont ind icate any errors, then open a simple examp le project in

TIBCO BusinessEvents Studio, and also run th e example at the comm and line.The example readm e files explain how to run th e examples at the comm and line,

from the installed location. Check for errors on the comman d line or u ser

interface. Absence of errors, and a norm al engine start u p indicate successful

installation.

Verifying Add-On Product Installations

To verify that ad d-ons are installed, look for the list of add-ons in th e folder

TIBCO_HOME/_installInfo . Every successfully installed add-on h as a

corresponding XML file un der this folder.

You can a lso check the insta ll log file to confirm w hich ad d-ons are installed.

Uninstalling TIBCO BusinessEvents |23

Uninstalling TIBCO BusinessEvents


41/100


g

To un install TIBCO BusinessEvents d o the following.

1. Do one of the following to start the uninstaller:

Navigate to the TIBCO_HOME/tools/universal_installer directory

and run the TIBCOUniversalInstaller program.

(Window s) From the Start menu, select Start > All Programs > TIBCO >

TIBCO_HOME> Uninstall.

(Window s) Use Add / Remove Programs from the Control Panel.

2. The Welcome screen app ears. ClickNext.

3. Do one of the following:

To un install only a selection of products in this TIBCO hom e, clickCustom

Uninstall. Select the p rodu ct or products you w ant to u ninstall. Then click

Next. See TIBCO BusinessEvents Stand ard Edition Comp onents on page 5

for guid elines.

To un install all TIBCO prod ucts in this TIBCO hom e (that w ere installed

using the universal installer), clickTypical Uninstall. Then clickNext.

4. The Pre-Uninstall Sum mary screen app ears. ClickUninstall. Uninstallation

proceeds and then you see the Post-Uninstall Sum mary.

5. Click Finish to close the un installer w indow.

6. If you are prompted to do so, restart the computer.

You m ay also wan t to manu ally delete any remaining files in th e installation

directory to comp letely remove the prod uct.

For information on the u ninstallation log files, see Installation H istory Log Fileson page 12.

This procedure uninstalls the entire TIBCO BusinessEvents installation, not just

the service pack. It is not p ossible to uninstall only the service pack.



42/100


|25

Chapter 3 Post Installation Tasks


43/100


p

This chap ter explains some post-installation steps you may have to p erform in

your installation.

Topics

Post Installation Tasks for All Platforms, page 26

Check and Upd ate JVM Settings in Properties Files, page 27

All UNIX Installations Directory Perm issions, page 29

Configuration for 64-bit Mode, page 30

Also see Chap ter 4, Migrating Projects from Earlier Versions, on p age 33 for

additional procedures you may have to do after installation.

26 | Chapter 3 Post Installation Tasks

Post Installation Tasks for All Platforms


44/100


This section explains changes that are required in the circum stances shown.

Also see Check and Upd ate JVM Settings in Properties Files on p age 27 in case it

pertains to your situation.

Migrating Projects

For all projects created using p rior releases, you m ust p erform migration steps.

After you migrate, you mu st also rebuild the EAR files for the p rojects, as is

always the case wh en you upgrade. See Chap ter 4, Migrating Projects from

Earlier Versions, on p age 33 and carefully follow all instructions.

Re-Initialize Studio Plug-ins Registry after Add-on Software Installation

When you install add -on prod ucts after installing TIBCO BusinessEvents, you

need to ensure that th e correct plug-ins contributed by th e add -ons are initialized.

To do this, re-initialize the studio plug-ins registry before you start using TIBCOBusinessEvents Stud io, as explained next.

To Re-Initialize Studio Plug-ins

1. Open a command prompt

2. Change directory to BE_HOME/studio/eclipse.

3. Run the command

studio -clean -initialize

Check and Update JVM Settings in Properties Files |27

Check and Update JVM Settings in Properties Files


45/100


Check the engine p roperties file to ensure that all settings are app ropriate for your

platform.

Set the Heap Size as Needed

By default, the in itial (Xms) and maximum (Xmx) heap size are set to 1GB for

both TIBCO BusinessEvents an d TIBCO BusinessEvents Decision Manager.Change the settings as needed to meet you r requ irements. For TIBCO

BusinessEvents, the settings are in theBE_HOME/bin/be-engine.tra file. For

TIBCO BusinessEvents Decision Manager they are in the

BE_HOME/decisionmanager/eclipse/DecisionManager.ini file.

For example, if you w ant to ru n both TIBCO BusinessEvents Decision Manager

and TIBCO BusinessEvents on a m achine with 1GB mem ory, you m ight reduce

the initial heap size setting (Xms):java.extended.properties=-server Xms512m -Xmx1024m

As another examp le, if you u se a machine with more memory, and you w ork with

very large tables in TIBCO BusinessEvents Decision Manager, you m ight increase

the TIBCO BusinessEvents Decision Manager heap size accordingly.

It can also be helpful to set the MaxPermSize as follows:

-XX:MaxPermSize=128m

Platform-Specific Settings

Some of the JVM settings do n ot work for all platforms, and some p latforms use

additional, platform-specific parameters. For examp le:

For 64 bit Sun JVM for Intel or AMD on Linu x, use

JVM_LIB_PATH=%TIB_JAVA_HOME%/lib/amd64/server/libjvm.so

For 64 bit Sun JVM for Intel or AMD on Window s, use:

JVM_LIB_PATH=%TIB_JAVA_HOME%/lib/amd64/server/libjvm.dll

For AMD on Windows and 32 bit Sun JVM for Intel use:

JVM_LIB_PATH=%TIB_JAVA_HOME%/lib/i386/server/libjvm.dll

The IBM AIX platform u ses param eters common to all JVMs, but d oes not u se the

-d64 parameter. AIX also uses add itional param eters (using the format,

-Xparameter).

This task is requ ired for full installations. It is not typically requ ired for service

pack installations. It is valid on a ll platforms.


Refer to th e approp riate JVM reference manu als for the platform in qu estion. For

examp le, for AIX you could refer to the following resources.


46/100


examp le, for AIX you could refer to the following resources.

http:/ / www.ibm.com/ developerworks/ java/ jdk/ aix/ j564/ sdkguide.aix64.html

http:/ / www.ibm.com/ developerworks/ java/ jdk/ aix/ j532/ sdkguide.aix32.html

Note tha t on AIX, you can determ ine the mod e in which JVM is runn ing using the

following simp le Java p rogram:

System.getProperty("com.ibm.vm.bitmode");

It returns the following valu es:

* 32 - the JVM is running in 32-bit mode* 64 - the JVM is running in 64-bit mode

All UNIX Installations Directory Permissions |29

All UNIX Installations Directory Permissions
http://www.ibm.com/developerworks/java/jdk/aix/j564/sdkguide.aix64.htmlhttp://www.ibm.com/developerworks/java/jdk/aix/j532/sdkguide.aix32.htmlhttp://www.ibm.com/developerworks/java/jdk/aix/j532/sdkguide.aix32.htmlhttp://www.ibm.com/developerworks/java/jdk/aix/j564/sdkguide.aix64.html


47/100


This section explains wh at d irectory permissions must be set to enable users to

use the system.

Permissions for TIBCO BusinessEvents Directories

All TIBCO BusinessEvents u sers mu st have read , write, and execute perm issions

for the following directories:

bin Directory$TIBCO_HOME/be/5.0/bin

For examp le, if TIBCO BusinessEvents has been installed in /opt/tibco , the userwh o installed TIBCO BusinessEvents shou ld execute the following comm and s:

% chmod 777 /opt/tibco/be/5.0/bin/

(Other changes can be mad e using the chown comm and as needed.)

You can verify ownership and perm issions using the long listing comm and , ls

-l .

This task is required for full installations. It is not typically required for service

pack installations. This step is required on all UNIX platforms.

If you u se TIBCO BusinessEvents Decision Manager, refer to its installation

guid e for add itional actions.


Configuration for 64-bit Mode


48/100


The following platforms allow you to run TIBCO BusinessEvents in 64-bit mode:

AIX

H P-UX Itan iu m

H P PA-RISC

Linux

Solaris 10 SPARC

Solar is 10 X86

See Sup ported UNIX Platforms and Guidelines on p age 10 for versions

supported.

To Configure for 64-bit Mode

To configure TIBCO BusinessEvents for 64-bit mod e you rename the provided 64

bit wrapp er and configure the be-engine.tra an d be-rms.tra files.

1. Op en the be-engine.tra file and th e be-rms.tra file for ed iting. In each file

do th e following:

a. In the tibco.env.STD_EXT_CP property, find %RV_HOME%/lib and replace

it with %RV_HOME%/lib/tibrvj.jar.

b . Ensure that the JVM_LIB_PATH variable points to the app ropriate JVM

Server DLL or SO. For example:

For 64 bit Sun JVM for AMD on Linux, use:

JVM_LIB_PATH = %TIB_JAVA_HOME%/lib/amd64/server/libjvm.so

For 64 bit Sun JVM for AMD on Window s, use:

JVM_LIB_PATH =%TIB_JAVA_HOME%/bin/amd64/server/libjvm.dll

2. In each file, you also may w ant to increase the heap size and m emory usage of

the Java VM by add ing JVM arguments to the tibco.env.APP_ARGS property

and by changing the tibco.env.HEAP_SIZE property. The following lines are

example values for these properties:

tibco.env.APP_ARGS=-d64 -XX:MinHeapFreeRatio=52

-XX:MaxHeapFreeRatio=90 -XX:GCTimeRatio=19tibco.env.HEAP_SIZE=2048M

An ad ditional step is requ ired for the H P-UX platforms. See HP-UX on page 31).

Configuration for 64-bit Mode |31

3. Save the files. (Remember to upd ate the be-rms.tra , the be-engine.tra , and

the files.)


49/100


HP-UXIf you are u sing an H P-UX platform, open the be-engine.tra file and rem ove the

following entry from the p roperty java.extended.properties property:

-javaagent:%BE_HOME%/lib/cep-instrumentation.jar

(If this property is present, the executable fails to launch.)

Enabling 64-bit Properties

By d efault, th e 32-bit java.extended.properties are enabled.

Comm ent th e 32-bit java.extended.properties and enable the 64-bit

java.extended.properties in the TRA files in these folders:

BE_HOME/bin/be-engine.tra

BE_HOME/mm/bin/be-mm.tra

BE_HOME/rms/bin/be-rms.tra



50/100


|33

Chapter 4 Migrating Projects from Earlier Versions


51/100


Also see Chap ter 3, Post Installation Tasks, on page 25 for non-project related

actions required for various situations.

Read this chapter carefully and follow all migration steps that ap ply to your case.

Topics

Project Migration Overv iew, page 34

For Berkeley DB Object Management Users On ly, page 35

Migration from 4.x to 5.0 Autom atic Migration Chan ges, page 36

Migrating 4.x Projects, page 39

Migrating 3.x Projects, page 46

Und erstand ing the CDD File (For 3.x Users), page 50

Imp orting a 3.x TIBCO Designer Project, page 52

Clean and Validate 3.x Projects, page 55

Oracle Types to JDBC Backing Store Migration , page 57

34 | Chapter 4 Migrating Projects from Earlier Versions

Project Migration Overview


52/100


Many of the actions you m ust take to m igrate projects to the current release

depend on the version you are m igrating from, and the features you u se.

Some m anu al steps are required. More manu al steps are required for earlier

versions than for 4.x projects due to the changes in architecture.

If you are upgrading from 4.0, first upgrade to 4.0.1 and then m igrate to 5.0.

See Migrating 4.x Projects on p age 39, and referenced sections.

If you are upgrading from 3.x, you can migrate directly to 5.0. See Migrating

3.x Projects on p age 46, and referenced sections. If you are upgrading from a version earlier than 3.0, first upgrade to the latest

3.x version, following d irections in the 3.x docum entation.

Check Release

Notes

Check the new features, changed functionality, and the d eprecated features lists in

Release Notes and take action accordingly.

For Berkeley DB Object Management Users Only |35

For Berkeley DB Object Management Users Only


53/100


Berkeley DB OM, form erly called Persistence OM, is an older form of data

persistence and it is deprecated. If you still use it, it is strongly recommen ded thatyou m igrate to Cache OM with backing store in th is release.

There is no direct migra tion path from the Berkeley DB OM database to a JDBC

backing store. Migration is a two stage p rocedu re:

1. As needed u pgrad e to the latest u sing the latest 3.x (or 4.x) version of TIBCO

BusinessEvents. Those versions have a u tility to m igrate the d ata to th e Oracle

Types backing store schema.

2. Migrate from the Berkeley DB database to the legacy Oracle Types backing

store. To complete this step, follow instructions in the TIBCO BusinessEvents

Installation guid e for the version you are using.

3. Migrate from the Oracle Types backing store to the JDBC backing store,

following instructions in Oracle Types to JDBC Backing Store Migration on

page 57.

4. Migrate the project to 5.0.

If you are using the latest 4.x version, see Migrating 4.x Projects on page 39.

If you are using the latest 3.x version, see Migrating 3.x Projects on page 46.


Migration from 4.x to 5.0 Automatic Migration Changes


54/100


The migration u tility au tomatically does the following:

Migrates core Coherence functions to product neutral ones A set of core functions

has been renamed (and ad ditional internal changes have been m ade) so that these

functions can be u sed with either the Coherence or the TIBCO BusinessEvents

DataGrid cache provider. The renamed functions are in the Standard catalog

Cluster.DataGrid category. See Table 4, Mapp ing of Coherence Functions to

TIBCO BusinessEvents DataGrid Fun ctions, on p age 37 for details.

A TIBCO BusinessEvents Stud io refactoring operation , and a TIBCO

BusinessEvents Stud io Tools comm and line option a re available to d o this forspecific purp oses other than general migration. See Migrating Core Coherence

Functions for the TIBCO BusinessEvents Studio option and see Migrating Core

Coherence Fun ctions at the Comm and Line for the comm and -line option, both in

TIBCO BusinessEvents Developers Guide.

Migrates the channel driver type Driver type is migrated from the 4.0 format to the

current format.

Migrates HTTP channel settings HTTP channel tun ing settings are now

maintained in the channel resource instead of the p rocessing u nit (PU) area of the

CDD. During th e migration p rocess, you sp ecify the CDD and w ithin it the PU

wh ose settings you w ant to m igrate. Settings from th e selected PU are app lied to

all HTTP channels.

Migrates CDD file namespaces Nam espace is changed to the following:

http://tibco.com/businessevents/configuration/5.0 .

Migrates entity metadata properties to CDD domain object override settings In

earlier versions, entity-specific configuration for cache and backing store was

don e using metad ata prop erties (also known as extend ed p roperties). It is now

don e in the CDD only. The migration utility moves all relevant m etada ta p roperty

settings to the equ ivalent settings in the CDD Dom ain Objects Overrides area. An

override is added for each entity typ e. You can later rem ove unnecessary entries

as needed . (There is no change to configura tion for metadata p roperties used by

the TIBCO BusinessEvents Data Mod eling add-on p rodu ct.)

Migrates localStorage Property to isSeeder property (partial migration) The

property tangosol.coherence.distributed.localstorage is migrated to the

cache-provider-neutral property be.engine.cluster.isSeeder . How ever, a

change in design makes this property redu nd ant. Cache storage is now set at the

processing u nit level, using a checkbox labeled Enable Cache Storage. It is not

possible to set this checkbox at migration time. Note tha t w ithout fur ther action, if

th e isSeeder prop erty is set higher in the order of precedence than the p rocessing

unit, then the isSeeder prop erty is used a t run time. However, if the isSeeder

Migration from 4.x to 5.0 Automatic Migration Changes |37

prop erty is set lower in the ord er of precedence than the processing un it, then the

checkbox value is u sed. To complete migration, remove th e isSeeder property

and instead u se the processing u nit setting Enable Cache Storage in the project
http://../tib_be_developers_guide/intro-projects.pdfhttp://../tib_be_developers_guide/intro-projects.pdfhttp://../tib_be_developers_guide/intro-projects.pdfhttp://../tib_be_developers_guide/intro-projects.pdfhttp://../tib_be_developers_guide/intro-projects.pdfhttp://../tib_be_developers_guide/intro-projects.pdfhttp://../tib_be_developers_guide/intro-projects.pdfhttp://../tib_be_developers_guide/intro-projects.pdf


55/100


CDD file. Note that en abling cache storage on non-cache agen ts is not

recomm ended for prod uction. It can be useful for testing and dem onstrationpurposes.

Site Topology, TIBCO BusinessEvents Version Field The value of th e TIBCO

BusinessEvents Version field in Cluster Settings and in Host Settings is up da ted to

the current version.

Adds CDD properties for TIBCO BusinessEvents Monitoring and Management

authentication, which is a new feature in 5.0. The properties are added in these

locations:

BE_HOME/mm/project/emonitor > MM.cdd > mm-class agent class >

prop erties > mm/auth property group

ToBeMonitored_Project> project.cdd > Cluster prop erties > auth property group .

The properties are added to a ll project CDDs if a project has more than one. The

following prop erties are add ed, with the default values as show n:

be.mm.auth.type=filebe.mm.auth.file.location=BE_HOME/mm/config/users.pwdjava.security.auth.login.config=BE_HOME/mm/config/jaas-config.con

Add-on Product

Migration

Migrates TIBCO BusinessEvents Views default skin TIBCO BusinessEvents Views

has a new look-and -feel. The default skin is migrated autom atically. If you u se

this add -on produ ct, you can view the d efault skin settings using the view-only

System Elements resource. See TIBCO BusinessEvents Views Developers Guide for

details about how you can u se the System Elements wh en you define your own

color schemes and skins.

Migrates TIBCO BusinessEvents Decision Manager metadata location Metadata

information for decision tables was being stored in the (internal) .beproject file.

Now it is stored in the d ecision table file itself.

Table 4 Mapping of Coherence Functions to TIBCO BusinessEvents DataGrid Functions

4.x Coherence Category Function Name DataGrid Category Function NameC_CacheGetEntityById() CacheGetEntityById()

C_Ca cheLo adCon cep tByE xtI d() Cac heLoa dConc eptB yEx tId( )

C_CacheLoadConceptById() CacheLoadConceptById()

C_CacheLoadConceptIndexedByExtId() CacheLoadConceptIndexedByExtId()

C_Ca cheLo adCon cep tsBy Ext Id() Cac heLoa dConc epts ByE xtId ()


Table 4 Mapping of Coherence Functions to TIBCO BusinessEvents DataGrid Functions (Contd)

4.x Coherence Category Function Name DataGrid Category Function Name


56/100


C_CacheLoadEntity() CacheLoadEntity()

C_CacheLoadEventByExtId() CacheLoadEventByExtId()

C_CacheLoadEventById() CacheLoadEventById()

C_CacheLoadParent() CacheLoadParent()

C_CacheName() CacheName()

C_CacheReevaluate() CacheReevaluate()

C_ClassName() ClassName()

C_EnableCacheUpdate() EnableCacheUpdate()

C_Index() Index()

C_Lock() Lock()

C_TransactionProperties TransactionProperties()

C_UnLock() UnLock()

Migrating 4.x Projects |39

Migrating 4.x Projects


57/100


This section out lines how to migrate 4.x projects, after you install TIBCO

BusinessEvents 5.0 (as expla ined in Chapter 1 through Chapter 3 of this guide).

Task A Upgrade 4.0.0 Projects to 4.0.1

If you are runn ing 4.0.0, first up grad e to 4.0.1. Open th e 4.0.0 projects in TIBCOBusinessEvents Studio and save them.

Task B Import Projects in TIBCO BusinessEvents Studio

A comman d line u tility to do th e same actions is also provid ed. After imp orting

using the comm and line utility an add itional procedu re is required before you can

work w ith th e pro ject in TIBCO BusinessEvents Stud io. See Imp orting a TIBCO

BusinessEvents 4.x Project at the Comm and Line on page 42.

For details about wh at is migrated, see Migrat ion from 4.x to 5.0 Autom atic

Migration Changes on page 36.

1. After installing TIBCO BusinessEvents 5.0, start TIBCO BusinessEvents Stud io

using a d ifferent w orkspace from the workspace containing the 4.x projects.

2. Select File > Import > Existing TIBCO BusinessEvents Studio 4.0 Project an d

clickNext.

3. Browse to and select the project root directory of the 4.x project you are

migrating.

4. Do one of the following:

Check the Copy project into w orkspace checkbox. This option copies

tibco be installation

Documents