TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation

TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
TIBCO ActiveMatrix® Adapter
Service Engine for Tuxedo
Installation
Software Release 6.0
March 2010
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 LICENSE.PDF) 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.
TIB, TIBCO, TIBCO Adapter, Predictive Business, Information Bus, The Power of Now, TIBCO ActiveMatrix
BusinessWorks, TIBCO Rendezvous, TIBCO Administrator, TIBCO Designer, TIBCO Runtime Agent, TIBCO
Hawk, TIBCO Enterprise Message Service, TIBCO Designer Add-in for TIBCO Business Studio, TIBCO
ActiveMatrix Service Grid, TIBCO ActiveMatrix Service Bus, TIBCO ActiveMatrix BusinessWorks Service
Engine, TIBCO ActiveMatrix Administrator, and TIBCO Business Studio are either registered trademarks or
trademarks of TIBCO Software Inc. in the United States and/or other countries.
EJB, Java EE, J2EE, and all Java-based trademarks and logos are trademarks or registered trademarks of Sun
Microsystems, Inc. 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.TXT 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 © 2008-2010 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
| iii
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Preface
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Other TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Third-Party Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
How to Contact TIBCO Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Chapter 1 Installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo. . . . . . . . . . . . . . .1
Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Installation Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Installer Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Installer Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
System Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Installing in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Installing in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Installing in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Post-Installation Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 2 Uninstalling TIBCO ActiveMatrix Adapter Service Engine for Tuxedo . . . . . . . . . . .13
Uninstalling TIBCO ActiveMatrix Adapter Service Engine for Tuxedo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
iv
| Contents
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Figures v
|
Figures
Figure 1
Installation Environment Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Figure 2
Installation Type Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
vi
| Figures
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Tables vii
|
Tables
Table 1
General Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
Table 2
Syntax Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Table 3
Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Table 4
Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
viii
| Tables
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
| ix
Preface
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.txt file for the availability of this software
version on a specific operating system platform.
This document describes how to install TIBCO AdtiveMatrix Adapter Servcie
Engine for Tuxedo.
Topics
•
Related Documentation, page x
•
Typographical Conventions, page xii
•
How to Contact TIBCO Support, page xv
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
x
| Related Documentation
Related Documentation
This section lists documentation resources you may find useful.
TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo Documentation
The following documents form the TIBCO AdtiveMatrix Adapter Servcie Engine
for Tuxedo documentation set:
•
TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo Installation Read this
manual to learn how to install TIBCO AdtiveMatrix Adapter Servcie Engine
for Tuxedo.
•
TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo Configuration and
Deployment Read this manual for instructions on creating, configuring, and
deploying adapter projects.
•
TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo Examples Read this
manual to work through the examples provided with the adapter.
•
TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo 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.
Before TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo can be installed
and used, you have to install TIBCO ActiveMatrix Adapter for Tuxedo. The
following documents form the TIBCO ActiveMatrix Adapter for Tuxedo
documentation set:
•
TIBCO ActiveMatrix Adapter for Tuxedo Concepts Read this manual to
familiarize yourself with the concepts used by this product.
•
TIBCO ActiveMatrix Adapter for Tuxedo Installation Read this manual to learn
how to install TIBCO ActiveMatrix Adapter for Tuxedo.
•
TIBCO ActiveMatrix Adapter for Tuxedo Configuration and Deployment Read this
manual for instructions on creating, configuring, and deploying adapter
projects.
•
TIBCO ActiveMatrix Adapter for Tuxedo Examples Read this manual to work
through the examples provided with the adapter.
•
TIBCO ActiveMatrix Adapter for Tuxedo 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 Service Engine for Tuxedo Installation
Preface xi
|
Other TIBCO Product Documentation
You may find it useful to read the documentation for the following TIBCO
products. Each of the books is available from the doc directory in the product’s
installation area.
•
TIBCO Designer™
•
TIBCO Administrator™
•
TIBCO ActiveMatrix® Administrator
•
TIBCO ActiveMatrix BusinessWorks™
•
TIBCO ActiveMatrix BusinessWorks™ Service Engine
•
TIBCO Rendezvous®
•
TIBCO Enterprise Message Service™
•
TIBCO Hawk®
•
TIBCO Adapter™ SDK
•
TIBCO Runtime Agent™
•
TIBCO Business Studio™
•
TIBCO ActiveMatrix® Service Grid
•
TIBCO ActiveMatrix® Service Bus
Third-Party Documentation
You may also find it useful to read the Oracle Tuxedo User documentation.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
xii
| Typographical Conventions
Typographical Conventions
The following typographical conventions are used in this manual.
Table 1 General Typographical Conventions
Convention
Use
TIBCO_HOME
Many TIBCO products must be installed within the same home directory. This
directory is referenced in 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.
ENV_HOME
AMX_HOME
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.
TIBCO ActiveMatrix installs into a directory inside ENV_HOME. This directory is
referenced in documentation as AMX_HOME. The value of AMX_HOME depends
on the operating system. For example, on Windows systems the default value is
C:\tibco\amx\.
TIBCO AdtiveMatrix Adapter Servcie Engine for Tuxedo is installed in a
directory inside AMX_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]
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Preface xiii
|
Table 1 General Typographical Conventions (Cont’d)
Convention
Use
italic font
Italic font is used in the following ways:
Key
combinations
•
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
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 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 para1 | param2 | param3
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
xiv
| Typographical Conventions
Table 2 Syntax Typographical Conventions
Convention
Use
{ }
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}
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Preface xv
|
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.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
xvi
| How to Contact TIBCO Support
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
|1
Chapter 1
Installing TIBCO ActiveMatrix Adapter
Service Engine for Tuxedo
This chapter explains how to install TIBCO ActiveMatrix Adapter Service Engine
for Tuxedo on the supported platforms.
Topics
•
Installation Overview, page 2
•
Installation Requirements, page 5
•
Installation Steps, page 7
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
2
| Chapter 1
Installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
Installation Overview
This section provides an overview of the installer, the installation registry, and
the additional software required before you can install TIBCO ActiveMatrix
Adapter Service Engine for Tuxedo.
Installation Modes
The following three installation modes are supported on all platforms.
•
GUI Mode
•
Console Mode
•
Silent Mode
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 if your machine does not have a GUI
environment.
Silent Mode
Silent mode installs the product using either default settings or a response file that
was saved during an earlier installation. Silent mode installs the product without
prompting you for information.
Installer Account
The installer account information on different platforms is described below:
•
Microsoft Windows
•
UNIX
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Installation Overview 3
|
Microsoft Windows
You must have administrator privileges for the machine on which TIBCO
ActiveMatrix Adapter Service Engine for Tuxedo 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 to assign the privileges to your account.
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.
On Microsoft Windows 2003, before you start the installation, ensure that the files,
vpd.properties and vpd.properties.tibco.hostname, are available in the
USER_HOME\Windows\ folder. If not, copy these files from C:\Windows\ to the
USER_HOME\Windows\ directory.
UNIX
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo can be installed by any
type of user:
•
regular (non-root) user
•
super-user (root)
A graphic environment such as CDE or XWindows is required to run the installer
in GUI mode.
Installer Log File
The installer log file,
tibco_universal_installer.timestamp.username_install.txt, is written to
the User_Home/.TIBCO directory. For example, on Windows the installer log is
written to the C:\Documents and Settings\user-name\.TIBCO directory. The
installer log file captures the following information:
•
Installation environment details such as user who invoked the installer,
hostname, java home in the environment, Operating System details, etc.
•
List of assemblies installed.
Disk Space
When a TIBCO ActiveMatrix Adapter Service Engine for Tuxedo installation
package is unpacked, it is extracted into a temporary folder.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
4
| Chapter 1
Installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
Temporary Disk Space Required on Microsoft Windows Platforms
On Microsoft Windows platforms, the entire package is extracted into a temp
folder, typically:
SystemDrive:\Temp, or
SystemDrive:\Documents and Settings\user_name\Local Settings\Temp.
The installer requires 50 MB of free space in the temp folder.
Temporary Disk Space Required on UNIX Platforms
On UNIX platforms, 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 UNIX platforms, the following disk space is required in the temporary area:
•
On Solaris, 70 MB of free disk space in /var/tmp
•
On AIX, 80 MB of free disk space in /var/tmp
•
On Linux, 70 MB of free disk space in /tmp
•
On HP-UX, 170 MB of free disk space in /var/tmp
If your system does not have sufficient disk space in the default temporary area,
you can run the installer with a different temporary directory by using the
following option when starting the installer:
-is:tempdir /new_temp
where /new_temp has sufficient free disk space.
The 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 disk space available can be reduced. In this case, the installer
may fail and give a failure message.
While performing installation, it is recommended not to run other processes that
consume disk space in the product home location.
System Memory
A minimum of 512 MB of physical memory is required.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Installation Requirements 5
|
Installation Requirements
You can install the software on different machines and use them across the
network. For example, you can use TIBCO Business Studio on one machine to
configure a TIBCO ActiveMatrix Adapter Service Engine for Tuxedo adapter and
use it on another machine.
Software Requirements
The following table lists the prerequisite and compatible software.
Table 3 Required Software
Field
Description
The following products must be installed before installing TIBCO ActiveMatrix Adapter Service
Engine for Tuxedo.
See TIBCO ActiveMatrix Adapter Service Engine for Tuxedo readme.txt for the supported versions.
TIBCO ActiveMatrix Adapter for
Tuxedo
TIBCO ActiveMatrix Adapter for Tuxedo enables real-time
exchange of business data between Tuxedo applications and
other applications or external business partners.
For detailed information about installing TIBCO ActiveMatrix
Adapter for Tuxedo, refer to TIBCO ActiveMatrix Adapter for
Tuxedo Installation.
Hibernate
Hibernate is an object-relational mapping (ORM) library for
the Java language, providing a framework for mapping an
object-oriented domain model to a traditional relational
database.
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 Service Bus
TIBCO ActiveMatrix Service Bus provides service mediation
capabilities to the TIBCO ActiveMatrix SOA platform. Service
mediation allows you to easily adapt to changing requirements
by providing an easy-to-use interface for developing mediation
flows.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
6
| Chapter 1
Installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
Table 3 Required Software
Field
Description
TIBCO ActiveMatrix
BusinessWorks Service Engine
TIBCO ActiveMatrix BusinessWorks Service Engine provides
an ActiveMatrix container to deploy ActiveMatrix
BusinessWorks projects using the TIBCO ActiveMatrix
Administrator.
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.
Supported Platforms
The following table lists the platforms supported by TIBCO ActiveMatrix
Adapter Service Engine for Tuxedo.
Table 4 Supported Platforms
Platform
Hardware Platform
Disk Space (MB)
Microsoft Windows Server 2003 (Enterprise
Edition)
x86
50MB
Solaris 10
SPARC
70MB
Solaris 10
x86
70MB
Red Hat Enterprise Linux 4.x, 5.x
x86
65MB
HP-UX 11i v3
IA64 Itanium
170MB
IBM AIX 5.3
POWER
80MB
Microsoft Windows Server 2008
Microsoft Windows XP
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Installation Steps 7
|
Installation Steps
The following sections describe the installation process in the available
installation modes.
Make sure your TIBCO ActiveMatrix Adapter Service Engine for Tuxedo is
installed in AMX_HOME, which is the TIBCO ActiveMatrix installation directory.
•
Installing in GUI Mode, page 7
•
Installing in Console Mode, page 9
•
Installing in Silent Mode, page 10
•
Post-Installation Procedures, page 11
Installing in GUI Mode
To install the adapter in GUI mode:
1. Open the physical media or download the TIBCO ActiveMatrix Adapter
Service Engine for Tuxedo package.
2. Extract the product’s archive file to a temporary directory.
3. Navigate to the temporary directory.
4. Run TIBCOUniversalInstaller.
You can do so in one of the following ways:
— Double-click the installer icon.
— On the command prompt, provide the absolute path of the installer file
specifying any options. The installer defaults to the GUI mode.
5. The Welcome screen appears. Click Next.
6. The License Agreement screen appears. After reading through the license text,
click I accept the terms of the license agreement and then click Next.
7. The Installation Environment screen appears, as shown in Figure 1. In the
Environment drop-down list, select the installation environment, then click
Next.
The installation environment was created when the pre-requisite software was
installed.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
8
| Chapter 1
Installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
Figure 1 Installation Environment Screen
8. The Installation Type screen appears, as shown in Figure 2. Select one of the
following two installation types to instal.
— Typical (Install the default feature set)
The Typical installation type installs all the products in the package on the
specified platform.
If you select Typical, proceed to step 9.
— Custom
The Custom installation type allows you to select products and
components. If you select Custom, the Product Features screen appears
listing the components available for installation. By default, all the
components are selected. Uncheck the checkboxes next to the components
you don’t want installed. Click the Next button.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Installation Steps 9
|
Figure 2 Installation Type Screen
9. The Pre Install summary screen appears. Verify the list of products selected for
install and then click the Install button. Click the Yes to All button to close
any popup windows that display during installation.
10. The Post Install Summary screen appears. This screen summarizes the
installation process. Click the Finish button to complete the installation
process and close the installer window.
After installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo, files
are installed in the following directories:
AMX_HOME\extensions\ase
AMX_HOME\extensions\adtuxedose\version_number\docs
AMX_HOME\extensions\adtuxedose\version_number\samples
ENV_HOME\components\eclipse\plugins
ENV_HOME\components\eclipse\features
Installing in Console Mode
To install the software in console mode, follow these steps:
1. Open the physical media or download the TIBCO ActiveMatrix Adapter
Service Engine for Tuxedo package.
2. Extract the product’s archive file to a temporary directory.
3. Using a console window, navigate to the temporary directory.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
10
| Chapter 1
Installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
4. Run TIBCOUniversalInstaller
-console.
5. Complete the installation by responding to the console window prompts.
While running in the console mode, you can use the following keys to move
through the installation process:
Enter:
Moves forward in the installer.
BackSpace or 2:
Goes back to the previous screen.
3:
Cancels the Wizard and exits the installation or uninstallation.
5:
Redisplays the current screen.
Installing in Silent Mode
In silent mode, the universal installer does not prompt for any inputs during
installation. Instead, the inputs are read from a response file that can be provided
as a command-line parameter.
The TIBCOUniversalInstaller.silent file is packaged in the directory that
contains the universal installer. You must 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.silent file, it’s good practice to copy the file to a
different name and use that file for the silent install.
The following procedure explains how to install a TIBCO ActiveMatrix Adapter
Service Engine for Tuxedo in silent mode.
1. Open the physical media or download the TIBCO ActiveMatrix Adapter
Service Engine for Tuxedo package.
2. Extract the product’s archive file to a temporary directory.
3. Using a console window, navigate to the temporary directory.
4. Make a copy of the TIBCOUniversalInstaller.silent file and rename the
file.
5. Using a text editor, open the copied file and update the install location and
features to install.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Installation Steps 11
|
6. Run the following command on the platform:
— For Windows:
Run TIBCOUniversalInstaller.cmd
-silent -V
responseFile="myfilename.silent"
— For Unix:
Run TIBCOUniversalInstaller
-silent -V
responseFile="myfilename.silent"
When installation completes, a line similar to the following is written to the
installer log file:
Install, com.tibco.installer.util.TIBCOInstaller, dbg.Debug,
The installation has completed. Please check the log file for
additional information.
Post-Installation Procedures
After installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo, pay
attention to the following operations:
•
When you start TIBCO Business Studio for the first time after installing
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo, make sure you use
the -clean option.
•
If any errors occur during installation, they will be listed in the installation log
files located C:\Documents and Settings\user_name\.TIBCO.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
12
| Chapter 1
Installing TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
| 13
Chapter 2
Uninstalling TIBCO ActiveMatrix Adapter
Service Engine for Tuxedo
This chapter explains how to uninstall TIBCO ActiveMatrix Adapter Service
Engine for Tuxedo.
Topics
•
Uninstalling TIBCO ActiveMatrix Adapter Service Engine for Tuxedo, page 14
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
14
| Chapter 2
Uninstalling TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
Uninstalling TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
Before uninstalling the TIBCO ActiveMatrix Adapter Service Engine for Tuxedo
component, make sure you deactivate the container for the node where the
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo component is installed.
Follow these steps to uninstall the adapter service engine component:
1. Navigate to the TIBCO_HOME\_uninstall directory and invoke
universal_uninstall.
2. Choose the Custom Uninstall option
3. Check the checkbox forTIBCO ActiveMatrix Adapter Service Engine for
Tuxedo and uncheck the checkboxes for the other listed products.
4. When the summary screen appears, click Finish to exit the uninstall wizard.
After uninstalling the Adapter Service Engine, the uninstaller may prompt
you to reboot your computer.
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
| 15
Index
A
I
adapter
role 5
AMX_HOME xii
Installation Modes 2
Console Mode 2
GUI Mode 2
Silent Mode 2
Installation Steps 7
Installer
Account 2
Microsoft Windows 3
UNIX 3
Log file 3
Installing in Console Mode 9
Installing in GUI Mode 7
Installing in Silent Mode 10
C
Console Mode 2
custom installation 8
customer support xv
D
Disk Space 3
L
Log file 3
E
ENV_HOME xii
P
Post-Installation Procedures 11
G
GUI Mode 2
R
Related Documentation x
S
Silent Mode 2
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
16
| Index
Software Requirements 5
support, contacting xv
Supported Platforms 6
system memory 4
T
technical support xv
TIBCO_HOME xii
typical installation 8
TIBCO ActiveMatrix Adapter Service Engine for Tuxedo Installation
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement