TIBCO ActiveMatrix Adapter for SAP Installation · PDF fileTIBCO ActiveMatrix Adapter for SAP...

Two-Second Adv

TIBCO ActiveMatrix® Adapter for SAP

InstallationSoftware Release 7.2February 2016

antage®

Important Information

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

| iii

Contents

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v

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

Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viiiTIBCO ActiveMatrix Adapter for SAP Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viiiOther TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viiiThird-Party Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

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

Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xivHow to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xivHow to Access TIBCO Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xivHow to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv

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

TIBCO ActiveMatrix Adapter for SAP Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Installation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Installation Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Installation Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 2 Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Installer Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9System Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Supported Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 3 Installation and Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Installing in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Installing in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Installing in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

TIBCO ActiveMatrix Adapter for SAP Installation

iv | Contents

Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Uninstalling in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Uninstalling in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Chapter 4 Postinstallation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Setting Directory Permissions (UNIX Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Setting Environment Variables (UNIX Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Specifying the Port Number for SAP Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Updating the TRA File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Appendix A Installed Files Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Installed Directories and Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33


Tables | v

Tables

Table 1 TIBCO Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Table 2 General Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Table 3 Syntax Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Table 4 TIBCO ActiveMatrix Adapter for SAP Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Table 5 Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Table 6 Installed Directories and Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30


vi | Tables


| vii

Preface

TIBCO ActiveMatrix® Adapter for SAP is used as a bidirectional gateway between SAP applications and applications configured for the TIBCO environment.

The adapter can remotely connect and operate with SAP systems running on OS platforms not supported by the adapter.

This document describes how to install the TIBCO ActiveMatrix Adapter for SAP software.

Topics

• Related Documentation, page viii

• Typographical Conventions, page xi

• Connecting with TIBCO Resources, page xiv

This software might 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.


viii | Related Documentation

Related Documentation

This section lists documentation resources you may find useful.

TIBCO ActiveMatrix Adapter for SAP DocumentationThe following documents form the TIBCO ActiveMatrix Adapter for SAP documentation set:

• TIBCO ActiveMatrix Adapter for SAP Concepts Read this manual for terminology and concepts of the product. The other manuals in the documentation set assume you are familiar with the information in this manual.

• TIBCO ActiveMatrix Adapter for SAP Installation Read this manual for instructions on site preparation and installation.

• TIBCO ActiveMatrix Adapter for SAP Configuration and Deployment Read this manual for instructions on how to create, configure, and deploy adapter projects.

• TIBCO ActiveMatrix Adapter for SAP Examples Read this manual to work through the examples provided with the adapter.

• TIBCO ActiveMatrix Adapter for SAP Release Notes Read the release notes for a list of new and changed features. This document also contains lists of known issues and closed issues for this release.

• TIBCO ActiveMatrix® Adapter for SAP (TIBCO Business Studio™) Documentation Read this documentation for instructions on how to install, configure and deploy the adapter in TIBCO ActiveMatrix BusinessWorks™ 6.

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

Table 1 TIBCO Products (Sheet 1 of 2)

TIBCO Product Description

TIBCO ActiveMatrix BusinessWorks This product provides an integration platform that enables companies to rapidly integrate systems and automate business processes.


Preface | ix

Third-Party DocumentationYou may also find it useful to read the documentation on the following websites:

• http://help.sap.com

This website is the SAP Help Portal where you can find documentation on all SAP products, including SAP ECC 6.0 releases and SAP NetWeaver. In order for TIBCO ActiveMatrix Adapter for SAP to exchange data with SAP systems,

TIBCO ActiveMatrix Adapter for SAP (TIBCO Business Studio)

This product provides a design-time environment to configure adapter configurations and TIDManager configurations in TIBCO Business Studio™.

TIBCO® Adapter SDK This product provides a class library that helps developers implement an adapter with minimal effort.

TIBCO Administrator™ This product provides capabilities for managing users, monitoring machines, and deploying and managing applications that use TIBCO products.

TIBCO Business Studio This product provides capabilities that help business analysts document business processes, solution engineers implement business processes, and SOA developers create composite applications.

TIBCO Designer™ This product provides a graphical user interface to create TIBCO ActiveMatrix BusinessWorks process definitions, or create or modify TIBCO Adapter configurations.

TIBCO Enterprise Message Service™ This product sends messages from your applications in a format that conforms to the Java Messaging Service (JMS) specification.

TIBCO Hawk® This product is for monitoring and managing distributed applications and systems throughout the enterprise.

TIBCO Rendezvous® This product uses messages to enable distributed application programs to communicate across a wide variety of hardware platforms and programming languages.

TIBCO Runtime Agent™ This product is a bundle of TIBCO software and third-party software that is required to run many TIBCO applications such as TIBCO ActiveMatrix BusinessWorks, TIBCO Adapters, and so on.

Table 1 TIBCO Products (Sheet 2 of 2)

TIBCO Product Description


http://help.sap.com

x | Related Documentation

you must make configuration in the SAP system to allow for communication and the exchange of messages to take place. This website offers detailed information on such configuration required.

• http://service.sap.com/instguides

This website is provided by the SAP Support Portal and contains documentation on installations and upgrades. The documentation available contains information on components that can be used along with TIBCO ActiveMatrix Adapter for SAP, and the installation of the Secure Network Communications (SNC) libraries where security is required between the adapter and SAP systems.

• http://service.sap.com/connectors

This website provides information on the different types of SAP Connectors available. TIBCO ActiveMatrix Adapter for SAP is based on the SAP Java Connector libraries. You can download the latest versions of these libraries from this website. For more information on the SAP JCo libraries and configuration related to these libraries, see the available documentation from this website.


http://service.sap.com/connectors

http://service.sap.com/instguides

Preface | xi

Typographical Conventions

The following typographical conventions are used in this manual.

Table 2 General Typographical Conventions

Convention Use

ENV_NAME

TIBCO_HOME

TIBCO products are installed into an installation environment. A product installed into an installation environment does not access components in other installation environments. Incompatible products and multiple instances of the same product must be installed into different installation environments.

An installation environment consists of the following properties:

• Name Identifies the installation environment. This name is referenced in documentation as ENV_NAME. The default value is TIBCO_HOME.

• Directory The folder into which the product is installed. This folder is referenced in documentation as TIBCO_HOME.

TIB_ADR3_HOME TIBCO ActiveMatrix Adapter for SAP is installed into a directory within a TIBCO_HOME directory. This directory is referenced in documentation as TIB_ADR3_HOME. The default value of TIB_ADR3_HOME depends on the operating system. For example, on Windows systems, the default value is C:\tibco\adapter\adr3\ReleaseNumber.

TIB_DESIGNER_HOME TIBCO Designer is installed into a directory within a TIBCO_HOME directory. This directory is referenced in documentation as TIB_DESIGNER_HOME. The default value of TIB_DESIGNER_HOME depends on the operating system. For example, on Windows systems, the default value is C:\tibco\designer\ReleaseNumber.

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].


xii | Typographical Conventions

italic font Italic font is used in the following ways:

• To indicate a document title. For example: See TIBCO ActiveMatrix Adapter for SAP 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.

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 2 General Typographical Conventions (Cont’d)

Convention Use


Preface | xiii

Table 3 Syntax Typographical Conventions

Convention Use

[ ] An optional item in a command or code syntax.

For example:

MyCommand [optional_parameter] required_parameter

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

For example, you can select only one of the following parameters:

MyCommand param1 | param2 | param3

{ } A logical group of items in a command. Other syntax notations may appear within each logical group.

For example, the following command requires two parameters, which can be either the pair param1 and param2, or the pair param3 and param4.

MyCommand {param1 param2} | {param3 param4}

In the next example, the command requires two parameters. The first parameter 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 command can accept either two or three parameters. The first parameter must be param1. You can optionally include param2 as the second parameter. And the last parameter is either param3 or param4.

MyCommand param1 [param2] {param3 | param4}


xiv | Connecting with TIBCO Resources

Connecting with TIBCO Resources

How to Join TIBCOmmunityTIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to http://www.tibcommunity.com.

How to Access TIBCO DocumentationDocumentation for this and other TIBCO products is available on the TIBCO Documentation site:

https://docs.tibco.com

Documentation on the TIBCO Documentation site is updated more frequently than any documentation that might be included with the product. To ensure that you are accessing the latest available help topics, please visit us at https://docs.tibco.com.

How to Contact TIBCO SupportFor comments or problems with this manual or the software it addresses, 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

http://www.tibcommunity.com


| 1

Chapter 1 Installation Introduction

This chapter explains software components of the product, installation modes, installation environment, and installation logging.

Topics

• TIBCO ActiveMatrix Adapter for SAP Components, page 2

• Installation Modes, page 3

• Installation Environment, page 4

• Installation Logging, page 5


2 | Chapter 1 Installation Introduction

TIBCO ActiveMatrix Adapter for SAP Components

TIBCO ActiveMatrix Adapter for SAP consists of the software components listed in the following table.

You can select the installation components by either using the profiles pre-defined in TIBCO Universal Installer or explicitly selecting the components you want to install.

By default, TIBCO Universal Installer installs all the components with the Typical profile. Meanwhile, the installer enables you to customize the installation by explicitly selecting the installation components.

Table 4 TIBCO ActiveMatrix Adapter for SAP Components

Component Description

Documentation This component is required for the HTML and PDF documentation.

Runtime This component does the actual work of passing and converting data to and from the vendor application. It includes two parts:

• Adapter

• TID Manager

Design Adapter-specific GUI that is loaded in TIBCO Designer at configuration time. This component includes the palettes and samples that demonstrate how TIBCO ActiveMatrix Adapter for SAP interacts with TIBCO ActiveMatrix BusinessWorks.


Installation Modes | 3

Installation Modes

Three installation modes are available: GUI, console, and silent.

GUI Mode

In GUI mode, the installer displays panels for you to make choices about product selection, product location, and so on. To invoke the installer in GUI mode, double-click the executable program.

Console Mode

In console mode, you can run the installer on a command line. This is useful if your machine does not have a GUI environment.

Silent Mode

In silent mode, the installer installs the product without prompting you for information. The installer uses either default or custom settings that are saved in a response file.



Installation Environment

TIBCO products are installed into an installation environment. A product installed into an installation environment does not access products in other installation environments. Incompatible products and multiple instances of the same product must be installed into different installation environments.

An installation environment consists of the following properties:

• Name (ENV_NAME) Identifies the installation environment. The name cannot contain special characters such as "*", "?", ">", "<", ":", "|", "/", "\", or quotation marks(").

On Microsoft Windows, the name is appended to the name of Windows services created by the installer and is a component of the path to the product shortcut in the Windows Start > All Programs menu. The default value is TIBCO_HOME.

• Directory (TIBCO_HOME) Identifies the folder into which the product is installed. The path cannot contain special characters such as "*", "#", "?", ">", "<", "%", "&", "$", "`", or "|".

The installer installs any products installed to the default installation environment directly under the Windows Start > All Programs > TIBCO menu. For all other environments, the installer creates a shortcut under the Windows Start > All Programs > TIBCO > ENV_NAME menu.


Installation Logging | 5

Installation Logging

TIBCO Universal Installer writes logging information to the tibco_universal_installer.username_install.log file in the .TIBCO/install_timestamp folder of the user’s home directory. To change the location of the installer log file, specify the option -V logFile="myLogFile" when you run the installer.

The installer log file captures the following information:

• Installation environment details such as user that invoked the installer, host name, Java home in the environment, operating system details, and so on.

• List of assemblies installed.

• Information related to the Ant scripts that are executed by the installer.

Before you run the installer, ensure you meet all the hardware and software requirements and you have appropriate privileges to run the installer.




| 7

Chapter 2 Installation Requirements

This chapter explains the tasks you need to complete before the TIBCO ActiveMatrix Adapter for SAP installation.

Topics

• Installer Account, page 8

• System Requirements, page 9


8 | Chapter 2 Installation Requirements

Installer Account

Before you can run the installer on your Windows or UNIX system, you must log in as a user with appropriate permissions. The privileges differ for the different platforms.

• Microsoft Windows, page 8

• UNIX, page 8

Microsoft WindowsYou must have administrator privileges for the machine on which this product is installed. If you do not have administrator privileges, the installer exits. You must then log out of the system and log in as a user with the required privileges, or request your system administrator assign the privileges to your account.

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

UNIXAny user can install this product.

• Normal user (non-root)

• Superuser (root)

While installing this product on UNIX platforms, ensure that the same installer account is used to install all TIBCO Adapter products.

A graphic environment such as CDE or X Windows is required to run the installer in GUI mode.


System Requirements | 9

System Requirements

Before installing the TIBCO ActiveMatrix Adapter for SAP, ensure that you meet all the following system requirements:

• Disk Space, page 9

• System Memory, page 9

• Supported Platforms, page 9

• Required Software, page 10

Disk SpaceThe required disk space depends on the platform you use and the software components you select to install. The installer calculates the required disk space in TIBCO_HOME for the selected components. The calculation is done before the actual installation, that is, copying of files to system, begins. The installer proceeds only if sufficient free disk space is available. The disk space consumed by TIBCO ActiveMatrix Adapter for SAP depends on platforms:

• For Windows platforms, the adapter can consume up to 250 MB of free space under TIBCO_HOME.

• For UNIX platforms, the adapter can consume up to 550 MB of free space under TIBCO_HOME.

System MemoryThe runtime adapter is Java-based and the memory requirements are based on the amount of memory made available to the Java Virtual Machine. When running the adapter on a machine, you need to consider the following factors:

• For 32-bit platforms containing 4 GB of physical memory, the Maximum Heap Space is 1024 MB or 1 GB.

• For 64-bit platforms containing 192 GB of physical memory, the Maximum Heap Space is 32 GB.

Supported PlatformsSee the readme file for the supported platforms, versions, and required patches.



Required SoftwareThe following table lists the required and optional software products.

Table 5 Required Software (Sheet 1 of 4)

Software Description

TIBCO Software

The following software products are distributed and installed separately from this product.

See the readme file for the supported versions.

TIBCO Rendezvous Required. TIBCO Rendezvous is required if you use Rendezvous as the message transport for your adapter.

TIBCO Rendezvous is available as a separate installation, and you must install TIBCO Rendezvous before installing TIBCO Runtime Agent.

TIBCO Runtime Agent Required. TIBCO Runtime Agent is required on each machine that hosts an adapter.

TIBCO Runtime Agent includes TIBCO Designer, TIBCO Hawk agent, along with a number of TIBCO and third-party libraries used by the adapter and other TIBCO products.

TIBCO Runtime Agent is available as a separate installation. You must install TIBCO Runtime Agent before you install TIBCO ActiveMatrix Adapter for SAP.

TIBCO ActiveMatrix BusinessWorks

Optional. TIBCO ActiveMatrix BusinessWorks is required only if you integrate the adapter to the projects created using TIBCO ActiveMatrix BusinessWorks.

TIBCO ActiveMatrix BusinessWorks is a scalable, extensible, and easy-to-use integration platform for you to develop integration projects. TIBCO Adapters are typically part of integration projects created using TIBCO ActiveMatrix BusinessWorks.

TIBCO ActiveMatrix BusinessWorks is available as a separate installation, and you can install it after installing the adapter.



TIBCO Administrator Optional. TIBCO Administrator is required only for adapter deployment.

TIBCO Administrator includes the following modules:

• User Management The User Management module manages 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 run time.

• Resource Management The Resource Management module monitors machines and all running applications in a TIBCO administration domain. You can create alerts, for example, to notify an administrator if the number of processes or disk usage exceeds a certain number.

• Application Management The Application Management module uploads Enterprise Archive (EAR) files and creates, configures, deploys, and monitors applications. This console is also used to start and stop applications.

TIBCO Administrator is available as a separate installation, and you can install it after installing the adapter.

TIBCO Hawk Optional. TIBCO Hawk is required only for adapter monitoring by using TIBCO Hawk.

TIBCO Administrator is available as a separate installation, and you can install it after installing the adapter.





TIBCO Enterprise Message Service

Optional. TIBCO Enterprise Message Service is required only if you use the Java Messaging Services (JMS) as the message transport for your adapter.

TIBCO Enterprise Message Service sends messages from your applications in a format that conforms to the JMS specification. TIBCO ActiveMatrix Adapter for SAP is not necessarily installed on the machine on which TIBCO Enterprise Message Service is installed.

TIBCO Enterprise Message Service is available as a separate installation package, and you can install it after installing the adapter.

Note: TIBCO Enterprise Message Service is also used by the TIBCO ActiveMatrix SOAP and JMS binding types. The TIBCO ActiveMatrix Adapter for SAP license does not cover this usage of the included TIBCO Enterprise Message Service software. You must separately license TIBCO Enterprise Message Service or another supported JMS product for this usage.

Third-Party Software

See the readme file for the supported versions.

Java Virtual Machine Required. JRE is packaged with TIBCO ActiveMatrix Adapter for SAP as a convenience.

SAP Applications Required.The adapter does not require the SAP applications to be installed on the same machine as the adapter.

SAP Application Libraries Required. The adapter requires access to SAP Java Connector (SAP JCo) components, which enable the adapter to communicate with the SAP Application Server. They must be contained separately from SAP.

The latest SAP JCo libraries can be downloaded from SAP Service Marketplace at:


Also see SAP OSS Note 1077727 for information on the latest release available and how to download the software.






SAP GUI Optional. It is good practice to install the SAP GUI for troubleshooting and testing the SAP system.






| 15

Chapter 3 Installation and Uninstallation

This chapter explains how to install and uninstall TIBCO ActiveMatrix Adapter for SAP.

Topics

• Installation, page 16

• Uninstallation, page 20


16 | Chapter 3 Installation and Uninstallation

Installation

The following sections describe the installation process in the available installation modes:

• Installing in GUI Mode, page 16

• Installing in Console Mode, page 17

• Installing in Silent Mode, page 18

Installing in GUI ModeIn GUI mode, TIBCO Universal Installer displays dialogs for you to define the installation environment, customize the installation, and complete the installation.

To install TIBCO ActiveMatrix Adapter for SAP in GUI mode:

1. Extract the installation package to a temporary directory.

2. In the temporary directory, start the installation in one of the following ways:

— Windows Double-click TIBCOUniversalInstaller.exe.

— Linux Run TIBCOUniversalInstaller-platform_acronym.bin.

3. In the Welcome dialog, click Next.

4. In the License Agreement dialog, read through the license agreement, click I accept the terms of the license agreement, and then click Next.

For 64-bit Linux platforms, prior to installation, see the README.LINUX file that accompanies the installation for additional information. The installer for 64-bit Linux platforms uses the bundled JRE, which is for 32-bit platforms. You need to specify the 64-bit JRE when running the installer. To do so: enter the following command to start the installer:

./TIBCOUniversalInstaller-lnx-x86.bin -is:javahome

/opt/tibco/tibcojre64/version_number


Installation | 17

5. In the TIBCO Installation Home dialog, specify the installation environment and click Next.

— Create a new TIBCO HOME To install the product into a new installation environment, specify the following properties:

Directory (TIBCO_HOME) The directory where the product is installed. Enter a path or click Browse to select a path. The path cannot be the same as the path of an existing environment.

Name (ENV_NAME) The name used to identify the installation environment.

— Use an existing TIBCO HOME To install the product into an existing installation environment, select the environment from the list.

See Installation Environment on page 4 for details about installation environment and its properties.

6. In the Installation Profile Selection dialog, the Typical installation profile is selected by default. If you want to explicitly select the installation components, select the Customize Installation check box and use the feature tree on the right. Click Next.

See TIBCO ActiveMatrix Adapter for SAP Components on page 2 for the components that are available for installation and the pre-defined profiles you can select.

7. In the SAP Application Libraries dialog, click Browse to select the location of the SAP Java Connector (SAP JCo) components, and then click Next.

8. In the Pre-Install Summary dialog, review the list of products selected to be installed, and then click Install to start the installation process.

9. In the Post Install Summary dialog, review the list of the installation information. Click Finish to complete the installation process and exit the installer.

Installing in Console ModeTo install this product the console mode:


2. On a command line, navigate to the temporary directory where the installation package is extracted.



3. Run one of the following commands to start the installation:

— Windows TIBCOUniversalInstaller.cmd -console

— UNIX ./TIBCOUniversalInstaller-platform_acronym.bin -console

4. Complete the installation by responding to the messages on the command line. See Installing in GUI Mode on page 16 for details.

Installing in Silent ModeIn silent mode, TIBCO Universal Installer does not prompt for any inputs during installation. Instead, the installer reads inputs from a response file that you can provide as a command-line parameter. If no parameter is specified, the installer uses the default TIBCOUniversalInstaller_adr3_version_number.silent file.

The TIBCOUniversalInstaller_adr3_version_number.silent file is packaged in the directory that contains the installer. Edit the file with information for your environment before launching the silent installation. The file includes comments that describe the installation properties you can set. While you can use the TIBCOUniversalInstaller_adr3_version_number.silent file, it is good practice to copy the file to a different name and use that file for the silent install.

If errors occur during installation, they will be listed in the installation log file located in the User_Home/.TIBCO directory.

To install TIBCO ActiveMatrix Adapter for SAP in silent mode:


2. On a command line, navigate to the temporary directory where the installation package is extracted.

3. Make a copy of the TIBCOUniversalInstaller_adr3_version_number.silent file and rename the file.


./TIBCOUniversalInstaller-lnx-x86.bin -console -is:javahome



Installation | 19

4. Using a text editor, open the copied file. You might need to update the following items:

— Installation Environment Specify the installation environment you want to use. See Installation Environment on page 4 for details about installation environment and its properties.

— Components to install Specify the components to install by updating the product feature settings. Set the features that you want to install to true.

— SAP application libraries Specify the location of SAP JCo components.

5. Run one of the following commands to start the installation:

— Windows TIBCOUniversalInstaller.cmd -silent -V

responseFile="myfilename.silent"

— UNIX ./TIBCOUniversalInstaller-platform_acronym.bin -silent -V responseFile="myfilename.silent"


./TIBCOUniversalInstaller-lnx-x86.bin -silent -V

responseFile="myfilename.silent" -is:javahome /opt/tibco/tibcojre64/version_number



Uninstallation

The following sections describe the uninstallation process in the available installation modes:

• Uninstalling in GUI Mode, page 20

• Uninstalling in Console Mode, page 21

Uninstalling in GUI ModeTo uninstall this product in GUI mode:

1. Shut down all running TIBCO applications, and navigate to the TIBCO_HOME/tools/universal_installer directory.

2. Start the uninstallation in one of the following ways:

— Windows Double-click TIBCOUniversalInstaller.exe.

— UNIX Run ./TIBCOUniversalInstaller-platform_acronym.bin.

3. In the TIBCO Installation Manager dialog, perform the following steps:

a. Click Uninstall Products from a TIBCO Home Location.

b. From the TIBCO Home Location list, select the TIBCO_HOME location where the product is installed.

c. Click Next.

4. In the Welcome dialog, click Next.

5. In the Unistallation Type dialog, select an uninstallation option and click Next.

— Custom Uninstall You can select the products to be removed.

— Typical Uninstall You can not select the products. All the products in this selected TIBCO_HOME are removed.

The installer for 64-bit Linux platforms uses the bundled JRE, which is for 32-bit platforms. You need to specify the 64-bit JRE when running the installer. To do so: enter the following command to start the installer:

./TIBCOUniversalInstaller-lnx-x86.bin -is:javahome



Uninstallation | 21

6. If you click Custom Uninstall, select the check box next to TIBCO ActiveMatrix Adapter for SAP version_number in the Product Uninstall Selection dialog. Click Next.

7. In the Pre-Uninstall Summary dialog, review the list of products to be uninstalled. Click Uninstall to start the uninstallation process.

8. In the Post Uninstall Summary dialog, click Finish to complete the uninstallation process and exit the installer.

Uninstalling in Console ModeTo uninstall this product in console mode:

1. On a command line navigate to the TIBCO_HOME\tools\universal_installer directory.

2. Run one of the following commands to start the uninstallation:

— Windows TIBCOUniversalInstaller.exe -console

— UNIX ./TIBCOUniversalInstaller-platform_acronym.bin -console

3. Complete the uninstallation by responding to the messages on the command line. See Uninstalling in GUI Mode on page 20 for details.

The installer for 64-bit Linux platforms uses the bundled JRE, which is for 32-bit platforms. You need to specify the 64-bit JRE when running the installer. To do so: enter the following command to start the installer:

./TIBCOUniversalInstaller-lnx-x86.bin -console -is:javahome





| 23

Chapter 4 Postinstallation Tasks

This section explains the tasks that you need to complete following the TIBCO ActiveMatrix Adapter for SAP installation.

Topics

• Setting Directory Permissions (UNIX Only), page 24

• Setting Environment Variables (UNIX Only), page 25

• Specifying the Port Number for SAP Connectivity, page 26

• Updating the TRA File, page 27


24 | Chapter 4 Postinstallation Tasks

Setting Directory Permissions (UNIX Only)

All adapter users must have read, write, and execute permissions for the following directories:

$TIB_ADR3_HOME/bin $TIB_ADR3_HOME/logs$TIB_ADR3_HOME/ledger$TIBCO_HOME/tra/version_number/logs$TIBCO_HOME/logs

For example, if the adapter has been installed in /opt/tibco, the user who installed the adapter can make these directories writable for all other users by entering the following commands:

% chmod a+w /opt/tibco/adapter/adr3/version_number/bin/% chmod a+w /opt/tibco/adapter/adr3/version_number/ledger% chmod a+w /opt/tibco/adapter/adr3/version_number/logs% chmod a+w /opt/tibco/tra/version_number/logs% chmod a+w /opt/tibco/logs


Setting Environment Variables (UNIX Only) | 25

Setting Environment Variables (UNIX Only)

You need to change the following environment variable settings before running TIBCO ActiveMatrix Adapter for SAP:

• SHLIB_PATH (HP-UX)

• LD_LIBRARY_PATH (Solaris and Linux)

• LIBPATH (AIX)

• PATH (ALL Platforms)

Run the adr3setenv.csh script installed to TIB_ADR3_HOME to set these variables:

1. Open a c-shell by typing csh on a command line.

2. Run adr3setenv.csh in TIB_ADR3_HOME with the following command:source adr3setenv.csh

If the settings are updated successfully, the following message is displayed:environment variables successfully set

The adr3setenv.csh script updates the environment for the current shell session only. If you open a new shell session, run the script afresh to update.



Specifying the Port Number for SAP Connectivity

You need to specify the port number for the following services used:

• SAP Gateway Service Always required in the case of server connections.

• SAP Message Service Required when you use a client connection and the connection is using Logon Groups.

Unless you installed an SAP GUI on the same computer before, which already specified the port numbers for a series of SAP services, you must create TCP/IP services in the services file of the operating system, with name sapmsSID and sapgwSID for each SAP service required. SID represents the message or gateway service ID. For example, if the gateway service is running a SAP application server where the system number is 01, then the service name required is sapgw01.

The location of the services file depends on the operating system:

• Windows C:\Windows\System32\drivers\etc\services

• UNIX /etc/services


Updating the TRA File | 27

Updating the TRA File

You need to add the home and library paths of the TIBCO Enterprise Message Service (EMS) server in the adapter TRA file if encountering either of the following scenarios:

• Install TIBCO ActiveMatrix Adapter for SAP before installing the EMS server.

• The version of TIBCO Runtime Agent you have installed is 5.9.1 or later, and the version of TIBCO Enterprise Message Service server you have installed is 8.2.2 or later.

To add EMS paths:

1. On a command line, navigate to TIBCO_HOME\tra\version_number\bin directory.

2. Enter the following command:

— Windows traUpgradeManager.exe -path TIBCO_HOME -ems TIBCO_HOME\ems\vesion_number

— UNIX ./traUpgradeManager -path TIBCO_HOME -ems TIBCO_HOME/ems/vesion_number

If the TRA tool does not work on your machine, you can also add the EMS paths manually.

To add EMS paths:

1. Navigate to the TIB_ADR3_HOME\version_number\bin directory and open the default launcher file provided with the installation, adr3.tra.

2. Add the following EMS home path in the common variables section:

tibco.env.EMS_HOME TIBCO_HOME/ems/version_number

3. Append the following EMS library path to the tibco.env.CUSTOM_CP_EXT variable in the common variables section:

%EMS_HOME%/lib




| 29

Appendix A Installed Files Reference

This appendix lists the directories and files under TIB_ADR3_HOME after installation of the adapter.

Topics

• Installed Directories and Files, page 30


30 | Appendix A Installed Files Reference

Installed Directories and Files

The following table lists the directories and files under TIB_ADR3_HOME after installation of the adapter.

Table 6 Installed Directories and Files

Directory Description

bin Wrappers and sample TRA properties files for configuration of services:

• adr3.exe: the wrapper file for the adapter.

• adr3.log4j.properties: the log4j properties file for the adapter.

• adr3.log4j.properties_template: the template log4j properties file for the adapter.

• adr3.tra: the TRA properties file for the adapter.

• adr3.tra_template: the template TRA properties file for the adapter.

• adr3Discoverer.exe: the wrapper file for the discovery agent.

• adr3Discoverer.log4j.properties: the log4j properties files for the discovery agent.

• adr3Discoverer.log4j.properties_template: the template log4j properties for the discovery agent.

• adr3Discoverer.tra: the TRA properties file for discovery agent.

• adr3Discoverer.tra_template: the template TRA properties file for discovery agent.

• adr3TIDManager.exe: the wrapper file for the TIDManager server.

• adr3TIDManager.log4j.properties: the log4j properties file for the remote TID manager.

• adr3TIDManager.log4j.properties_template: the template log4j properties file for the remote TID manager.

• adr3TIDManager.tra: the TRA properties file for the remote TID manager.

• adr3TIDManager.tra_template: the template TRA properties file for remote TID manager.

doc Documentation of the adapter. Two formats are available in two subdirectories:

• html

• pdf


Installed Directories and Files | 31

examples Examples provided with the adapter. This directory consists of two subdirectories:

gettingStarted: Getting Started examples. See "Getting Started" in TIBCO ActiveMatrix Adapter for SAP Configuration and Deployment for the procedures on running the examples.

Businessworks: Examples that show how to use the adapter’s services within a TIBCO ActiveMatrix BusinessWorks process. See TIBCO ActiveMatrix Adapter for SAP Examples for details.

hotfix Hotfixes of the adapter.

ledger Ledger files for certified message delivery through TIBCO Rendezvous.

See "Certified Message Delivery - Ledger Storage" in TIBCO Rendezvous Concepts for more details about ledger files.

lib Library files of the adapter.

logs Log files used by the adapter.

tools Migration tool and dependent files for migrating adapter projects from an early version.

setup post-install.xml: information concerning post-installation steps relevant for the installation.

Table 6 Installed Directories and Files (Cont’d)

Directory Description


32 | Appendix A Installed Files Reference


| 33

Index

C

console mode 3, 17, 17, 21

D

disk space requirements 9

E

ENV_NAME xi, 4, 17

G

GUI mode 3, 16, 20

I

installationconsole mode 17

installation environmentdirectory 4, 17name 4, 17

installation logging 5installation modes

console 3, 17GUI 3, 16silent 3, 18

installation procedure 16installation profiles

typical 2

installation requirementsdisk space 9installer accounts

Microsoft Windows 8UNIX 8

software 10supported platforms 9system memory 9

installeddirectories 30files 30

P

postinstallation tasks 23product components 2

R

related documentation viii

S

SAP gateway servicespecifying port number 26

SAP JCo libraries 12silent mode 3, 18software requirements 10system memory requirements 9


34 | Index

T

TIB_ADR3_HOME xiTIBCO support

contacting xivTIBCO documentation xivTIBCOmmunity xiv

TIBCO_HOME xi, 4, 17typographical conventions xi

U

uninstallation modesconsole 21GUI 20

uninstallation procedure 20


Date post:	07-Feb-2018
Category:	Documents
Upload:	lythu
View:	228 times
Download:	2 times

TIBCO ActiveMatrix Adapter for SAP Installation · PDF fileTIBCO ActiveMatrix Adapter for SAP...

Documents