TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E ... · TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite Installation |ix Preface This document describes

TIBCO ActiveMatrix BusinessWorks™ Plug-in for Oracle E-Business Suite

InstallationSoftware Release 1.1January 2011

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc.TIBCO, The Power of Now, TIBCO ActiveMatrix BusinessWorks, TIBCO Designer, and TIBCO Runtime Agent are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only.THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.Copyright © 2010-2011 TIBCO Software Inc. ALL RIGHTS RESERVED.TIBCO Software Inc. Confidential Information

| iii

Contents

Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xTIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite Documentation . . . . . . . . . . . . . . . xOther TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xThird-Party Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

How to Contact TIBCO Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii

Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Installation Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Installation Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Installation Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Installation History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Disk Space Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Supported Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Installer Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Installing from Network Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Chapter 2 Installing and Uninstalling TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Installing In GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Installing In Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Installing In Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Uninstalling In GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Uninstalling In Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Uninstalling In Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite Installation

iv | Contents

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19


Figures | v

Figures

Figure 1 Select the TIBCO ActiveMatrix BusinessWorks Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Figure 2 Select the Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Figure 3 Package Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12


vi | Figures


Tables | vii

Tables

Table 1 General Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Table 2 Required and Optional TIBCO Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Table 3 Supported Platforms, Package Names, Hardware Platforms, and Disk Space . . . . . . . . . . . . . . . . 7


viii | Tables


| ix

Preface

This document describes how to install TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.

Topics

• Related Documentation, page x

• Typographical Conventions, page xi

• How to Contact TIBCO Support, page xiii

This software may be available on multiple operating systems. However, not all operating system platforms for a specific software version are released at the same time. Please see the readme file for the availability of this software version on a specific operating system platform.


x | Related Documentation

Related Documentation

This section lists documentation resources you may find useful.

TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite Documentation

The following documents form the TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite documentation set:

• TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite Installation Read this manual for instructions on how to install the plug-in on Microsoft Windows and UNIX systems.

• TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite User’s Guide Read this manual for the concepts relating to the plug-in, the applications with which the plug-in interacts, configuration and deployment information, and examples.

• TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite Release Notes Read the release notes for a list of new and changed features. This document also contains lists of known issues and closed issues for this release.

Other TIBCO Product DocumentationYou may find it useful to read the documentation for the following TIBCO products:

• TIBCO Designer™

• TIBCO Administrator™

• TIBCO Runtime Agent™

• TIBCO ActiveMatrix BusinessWorks™

• TIBCO ActiveMatrix BusinessWorks™ Service Engine

• TIBCO ActiveMatrix® Service Grid

• TIBCO Business Studio™

Third-Party DocumentationYou may also find it useful to read the Oracle E-Business Suite Documentation Library which is available from the Oracle Technical Network at http://www.oracle.com/technology/documentation.


http://www.oracle.com/technology/documentation

Preface | xi

Typographical Conventions

The following typographical conventions are used in this manual.

Table 1 General Typographical Conventions

Convention Use

TIBCO_HOME

ENV_HOME

ORACLE_HOME

USER_HOME

Many TIBCO products must be installed within the same home directory. This directory is referenced in the documentation as TIBCO_HOME. The value of TIBCO_HOME depends on the operating system. For example, on Windows systems, the default value is C:\tibco.

Other TIBCO products are installed into an installation environment. Incompatible products and multiple instances of the same product are installed into different installation environments. The directory into which such products are installed is referenced in documentation as ENV_HOME. The value of ENV_HOME depends on the operating system. For example, on Windows systems the default value is C:\tibco.

Oracle E-Business Suite database server installs into a directory. This directory is referenced in documentation as ORACLE_HOME. The default value of ORACLE_HOME depends on the operating system.

The user’s home directory on the operating system is referenced in documentation as USER_HOME.

code font Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window. For example:

Use MyCommand to start the foo process.

bold code font

Bold code font is used in the following ways:

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 particular interest.

In command syntax, to indicate the default parameter for a command. For example, if no parameter is specified, MyCommand is enabled: MyCommand [enable | disable]

italic font Italic font is used in the following ways:

To indicate a document title. For example: See TIBCO ActiveMatrix 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 must replace. For example: MyCommand PathName


xii | Typographical Conventions

Key combinations

Key name separated by a plus sign indicate keys pressed simultaneously. For example: Ctrl+C.

Key names separated by a comma and space indicate keys pressed one after the other. For example: Esc, Ctrl+Q.

The note icon indicates information that is of special interest or importance, for example, an additional action required only in certain circumstances.

The tip icon indicates an idea that could be useful, for example, a way to apply the information provided in the current section to achieve a specific result.

The warning icon indicates the potential for a damaging situation, for example, data loss or corruption if certain steps are taken or not taken.

Table 1 General Typographical Conventions (Cont’d)

Convention Use


Preface | xiii

How to Contact TIBCO Support

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

• 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 can request one.


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

https://support.tibco.com

xiv | How to Contact TIBCO Support


| 1

Chapter 1 Introduction

This chapter explains how to install TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.

Topics

• Installation Overview, page 2

• Installation Requirements, page 4

TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite

2 | Chapter 1 Introduction

Installation Overview

This section provides an overview of the installer, the installation registry, and the additional software required before you install TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.

Installation ModesThe installer can run in different modes. Each mode is supported on all platforms.

GUI Mode

In GUI mode, the installer presents panels that allow you to make choices about product selection, product location, and so on.

To invoke the installer in GUI mode, double-click the executable.

Console Mode

Console mode allows you to run the installer from the command prompt or terminal window. This is useful for machines that have no Microsoft Windows environment.

Silent Mode

Silent mode either installs using default settings or uses a response file that was saved during an earlier installation. Silent mode installs without prompting you for information.

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

• If a response file exists and the installer is started with -options responseFileName as an argument, the installer uses the values specified by the user when the response file was generated.

Installation TypesTwo installation types are available: Typical and Custom.

• The Typical installation type installs all the products in the package on the specified platform.

• The Custom installation type allows you to select products and components.


Installation Overview | 3

Installation RegistryThe installer maintains an installation registry. The registry location depends on the platform. This section explains where the registry files are located. The files have vpd as a prefix, which stands for Vital Product Database.

Microsoft Windows Platforms

TIBCO products maintain the installation registry in the SystemDrive:\windows folder. The following files represent the installation registry:

SystemDrive:\windows\vpd.propertiesSystemDrive:\windows\vpd.properties.tibco.systemName

UNIX Platforms

The installation registry is maintained in the following files in the user's home directory:

USER_HOME/vpd.propertiesUSER_HOME/vpd.properties.tibco.systemName

Installation HistoryThe installer and uninstaller create a file named TIBCOInstallationHistory.xml in the same location where the installation registry is created. Each time an installation or uninstallation is performed, entries are appended to the file.

On Microsoft Windows:

SystemDrive:\Windows\TIBCOInstallationHistory.xml

On UNIX:

Users_Home/TIBCOInstallationHistory.xml

The file TIBCOInstallationHistory.xml contains the record of all installation and uninstallation activities of all products, features and components.

Do not edit, modify, rename, move, or remove any of the registry vpd files.

Do not edit, modify, rename, move, or remove the TIBCOInstallationHistory.xml file.



Installation Requirements

This section describes the disk space requirements, software requirements, and supported platforms for the TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.

Disk Space RequirementsThe installer calculates the disk space required in the product home location for the selected components before the actual installation (the copying of files to the system) begins. The installer will proceed only if sufficient free disk space is available in the product home location.

If the disk space required is consumed by another process while the installer is copying the files, the available disk space can be reduced. In this case, the installer may fail and give a failure message.

While performing installation, it is recommended to end other processes that consume disk space in the product home location.

Microsoft Windows Platforms

• Installer disk space requirements in temporary area

The entire package is extracted into a temporary folder, typically SystemDrive:\Temp or SystemDrive:\Documents and Settings\USER_NAME\Local Settings\Temp.

The installer requires 45MB of free space in the temp directory.

UNIX Platforms

• Installer disk space requirements in temporary area

The installer launcher first extracts a Java Virtual Machine (JVM) in a temporary directory and uses this JVM to launch itself. The size of the extracted JVM differs from platform to platform.

On the supported UNIX platforms, 20 MB of free disk space in /var/tmp is required.

If your system does not have sufficient free disk space in the above temporary area, you can still run the installer with a different temporary area by using the following option when starting the installer:

install_package_name.bin -is:tempdir /new_tmp


Installation Requirements | 5

where /new_tmp has sufficient free disk space.

• Disk space requirement in user's home directory

On UNIX platforms, when a regular (non-root) user installs a TIBCO product, the installation registry (two vpd files) is maintained in the user's home directory. As more products are installed, entries are added into these vpd files.

The user's home directory must have at least 500 KB of free disk space.

Software RequirementsBefore starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements and that you have the prerequisite software installed.

TIBCO Software Requirements

TIBCO Runtime Agent and additional TIBCO products you may be installing are listed in Table 2. For the supported versions of the listed products, refer to the readme file for TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.

Table 2 Required and Optional TIBCO Products

Product Purpose

TIBCO Runtime Agent (Required by the plug-in) TIBCO Runtime Agent includes TIBCO Designer along with a number of TIBCO and third-party libraries used by the plug-in and other TIBCO products.

You must install TIBCO Runtime Agent before you install TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.



TIBCO Administrator (Required for deployment) TIBCO Administrator includes the following modules:

-- User Management. Management of authentication, roles and users, that is, connecting roles (groups) and users to access control lists (ACLs). This includes security for server-based projects at design time and for deployed applications at runtime.

-- Resource Management. Monitoring of machines and of all running applications in a TIBCO administration domain. Alerts can be created, for example, to notify an administrator if the number of processes or disk usage exceeds a certain number.

-- Application Management. Uploading of Enterprise Archive (EAR) files, creation, configuration, deployment, and monitoring of applications. This console is also used to start and stop applications.

TIBCO Administrator is available as a separate installation and can be installed after installing TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.

TIBCO ActiveMatrix BusinessWorks

(Required) TIBCO ActiveMatrix BusinessWorks is a scalable, extensible, and easy to use integration platform that allows you to develop integration projects.

TIBCO ActiveMatrix BusinessWorks must be installed before installing TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite.

To run the plug-in with BusinessWorks Service Engine, the following products must be installed before installing TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite:

(See the readme file for TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite for the supported versions.)

TIBCO ActiveMatrix Service Grid

TIBCO ActiveMatrix Service Grid is a scalable and extensible platform for developing, deploying, and managing applications that conform to a service-oriented architecture.

TIBCO ActiveMatrix BusinessWorks Service Engine

TIBCO ActiveMatrix BusinessWorks Service Engine provides an ActiveMatrix container to deploy ActiveMatrix BusinessWorks projects using the TIBCO ActiveMatrix Administrator.

Before installing TIBCO ActiveMatrix BusinessWorks Service Engine, you need to install TIBCO Designer Add-in for TIBCO Business Studio.

TIBCO Designer Add-in for TIBCO Business Studio

TIBCO Designer Add-in for TIBCO Business Studio is used for running TIBCO Designer in TIBCO Business Studio.

Note: This product is only available on Windows platform.

Table 2 Required and Optional TIBCO Products (Cont’d)

Product (Cont’d) Purpose (Cont’d)


Installation Requirements | 7

Oracle Software Requirements

You need copies of the Oracle JDBC Driver package and the Oracle AQ API package on your machine, as they will be required during the installation. The JDBC Driver package is located under the ORACLE_HOME\jdbc\lib directory. Choose the appropriate JAR file, ojdbc5.jar, ojdbc6.jar or ojdbc14.jar. The AQ API package, aqapi.jar, is located under the ORACLE_HOME\RDBMS\jlib directory. Refer to the readme file for TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite for the supported version.

Supported PlatformsThe platforms supported by TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite are listed in Table 3.

Table 3 Supported Platforms, Package Names, Hardware Platforms, and Disk Space

Platform Package Names Hardware Platform

Disk Space (MB)

Microsoft Windows Server 2003 SP1

Microsoft Windows Server 2008

Microsoft Windows XP

TIB_bwpluginoracleebs-simple_version_number_win_x86.exe

x86 55

Solaris 8, 9, 10 TIB_bwpluginoracleebs-simple_version_number_sol8_sparc.bin

SPARC 30

Solaris 10 TIB_bwpluginoracleebs-simple_version_number_sol10_x86.bin

x86 30

SUSE Linux Enterprise 10.x

Red Hat Enterprise Linux 4.x, 5.x.

TIB_bwpluginoracleebs-simple_version_number_linux24gl23_x86.bin

x86 30

HP-UX 11i v2/11.23, v3/11.31

TIB_bwpluginoracleebs-simple_version_number_hpux112_ia64.bin

IA64 Itanium 30

HP-UX 11i v1, v2, v3 TIB_bwpluginoracleebs-simple_version_number_hpux111_hppa.bin

PA-RISC 30

AIX 5.3, 6.1 TIB_bwpluginoracleebs-simple_version_number_aix52_power.bin

POWER 30



Installer Account

Microsoft Windows

You must have administrator privileges for the machine on which TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite is installed.

If you do not have administrator privileges, the installer exits. You must then either log out of the system and log in as a user with the required privileges, or request your system administrator to assign the privileges to your account.

UNIX

TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite can be installed by regular (non-root) users and super-users (root).

Installing from Network Drive If you intend to install the product on a network drive, you must ensure that the account used for installation has permission to access the network drive.


| 9

Chapter 2 Installing and Uninstalling TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite

This chapter describes how to install and uninstall TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite on Microsoft Windows platforms and UNIX platforms.

Topics

• Installation, page 10

• Uninstallation, page 16


10 | Chapter 2 Installing and Uninstalling TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite

Installation

Use one of the following modes to install TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite:

• Installing In GUI Mode

• Installing In Console Mode

• Installing In Silent Mode

Installing In GUI ModeTo install the product in GUI mode:

1. Open the physical media or download the TIBCO ActiveMatrix BusinessWorks Plug-in for Oracle E-Business Suite package.

2. Extract the product’s archive file to a temporary directory.

3. Run the installer. You can do so in one of the following ways:

— Navigate to the temporary directory and double-click the installer icon.

— On the command prompt, provide the absolute path of the installer file without specifying any options. The installer defaults to the GUI mode.

4. Click the Next button on the Welcome screen.

5. Read through the license text when the License Agreement screen appears. Select the I Accept The Terms Of The License Agreement radio button, and then click the Next button.

If an error The wizard cannot continue because of the following error: could not load wizard specified in /wizard.inf(104) occurs when installing on Linux platforms, use the following command to launch the installer:

% ./TIB_bwpluginoracleebs-simple_version_number_platform.bin -is:javahome JRE_HOME

If you install the plug-in with JAVA_HOME set or using -is:javahome TIBCO_HOME/jre/1.x.0 (1.5.0 or 1.6.0) for Redhat 5.x and SUSE 10.x, the plug-in installation does not include the Tibuninstall.bin file under the TIBCO_HOME/bw/plugins/oracleebs/_uninst folder. Execute the following commands in the Linux terminal to launch the installer:

$ export PATH= TIBCO_HOME/jre/1.x.0/bin:$PATH

$ cd TIBCO_HOME/bw/plugins/oracleebs/_uninst

$ java -cp uninstaller.jar run


Installation | 11

6. After the Base Product screen appears, select the specific version of TIBCO ActiveMatrix BusinessWorks that the plug-in will be applied to if two or more versions of TIBCO ActiveMatrix BusinessWorks are installed on your machine. Click the Next button.

Figure 1 Select the TIBCO ActiveMatrix BusinessWorks Version

7. On the Installation Home screen, review the installation home directory. This is the TIBCO ActiveMatrix BusinessWorks directory by default, and can’t be changed. Click the Next button.

8. Select the Typical or Custom radio button. Click the Next button.

See Installation Types for an explanation of the difference between the Typical and Custom installation types.



Figure 2 Select the Installation Type

9. Click the Browse button, navigate to the Oracle JDBC Driver Package location and the Oracle AQ API Package location, and then click the Next button.

See Oracle Software Requirements for the package location and supported version.

Figure 3 Package Selection


Installation | 13

10. Review the information on the Installation Preview screen. Click the Next button to start the installation.

11. Review the information on the Installation Summary screen. Click the Finish button to exit the installer.

Installing In Console ModeConsole mode allows you to install the software from a command line. The installer will prompt you for values.

To install the plug-in in console mode, follow these steps:



3. Using a console window, navigate to the temporary directory.

4. Type the following command:

— On Microsoft Windows

TIB_bwpluginoracleebs-simple_version_number_win_x86.exe -is:javaconsole -console

— On UNIX

For example, on Solaris 8 system:

% ./TIB_bwpluginoracleebs-simple_version_number_sol8_sparc.bin -is:javaconsole -console

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

Installing In Silent ModeSilent mode allows you to install the software without prompting you for information.

When running in console mode you can move through the installation process as follows:Enter Key or 1 = Moves forward in the installer2 = Goes back to previous screen3 = Cancels the Wizard and exits the installation or uninstallation4 = Redisplays the current screen



Install Using Default Values

To install the plug-in in silent mode, follow these steps:



3. Using a console window, navigate to the temporary directory.

4. Type the following command:


TIB_bwpluginoracleebs-simple_version_number_w32.exe -silent

— On UNIX


% ./TIB_bwpluginoracleebs-simple_version_number_sol8_sparc.bin -silent

Install Using a Response File

1. Generate a response file

You can generate a response file during installation which you can later use to invoke the installer with the selected values as default values (GUI mode) or as selected values (silent mode).

To generate a response file, type the following command:


TIB_bwpluginoracleebs-simple_version_number_w32.exe -options-record C:\directoryPath\responseFile

— On UNIX


% ./TIB_bwpluginoracleebs-simple_version_number_sol8_sparc.bin -options-record /directoryPath/responseFile

2. Install using the response file


Installation | 15

To install using the response file, type the following command:


TIB_bwpluginoracleebs-simple_version_number_w32.exe -options C:\directoryPath\responseFile

— On UNIX


% ./TIB_bwpluginoracleebs-simple_version_number_sol8_sparc.bin -options /directoryPath/responseFile



Uninstallation

The uninstaller allows you to run in different modes. Each mode is supported on all platforms.

• Uninstalling In GUI Mode

• Uninstalling In Console Mode

• Uninstalling In Silent Mode

Uninstalling In GUI ModeTo run the uninstaller in GUI mode, follow the platform-specific instructions listed below:

• On Microsoft Windows

Use one of the following options:

— Click Start > Programs > TIBCO > TIBCO ActiveMatrix BusinessWorks version_number > Plugin-Oracle E-Business Suite > Uninstall.

— Navigate to the _uninst directory located in the plug-in installation home directory and invoke the Tibuninstall.exe program.

• On UNIX

Navigate to the _uninst directory located in the plug-in installation home directory and invoke the Tibuninstall.bin program.

Follow the prompts from the wizard to uninstall the plug-in.

Uninstalling In Console ModeTo run the uninstaller in console mode, execute the following steps:

1. Using a command window, navigate to the _uninst directory located in the plug-in installation home directory.

2. Type the following command at the command prompt:


Tibuninstall.exe -is:javaconsole -console

— On UNIX% ./Tibuninstall.bin -is:javaconsole -console

Complete the uninstallation by responding to the console window prompts.


Uninstallation | 17

Uninstalling In Silent ModeTo run the uninstaller in silent mode, execute the following steps:

1. Using a command window, navigate to the _uninst directory located in the plug-in installation home directory.

2. Type the following command at the command prompt:


Tibuninstall.exe -is:javaconsole -silent

— On UNIX

% ./Tibuninstall.bin -is:javaconsole -silent





| 19

Index

C

Customer Support xiii

D

Disk Space 4

E

ENV_HOME xi

G

General Typographical Conventionsgeneral xi

I

InstallationInstallation History 3Installation Registry 3Installation Requirements 4

Installation modeConsole mode 2GUI mode 2Silent mode 2

Installation Type 2Custom 2Typical 2

installer accountMicrosoft Windows 8UNIX 8

O

ORACLE_HOME xi

R

Related Documentation x

S

Software Requirements 5Supported Platforms 7

T

Technical Support xiiiThird-Party Documentation xTIBCO_HOME xiTypographical Conventions

general xi

U

Uninstallation 16USER_HOME xi