Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Installation on UNIX Platforms : Installing TIBCO ActiveMatrix Adapter for Kenan/BP on UNIX

Installing TIBCO ActiveMatrix Adapter for Kenan/BP on UNIX
You can either download the adapter package or install the package from a CD. The installer prompts you to accept the license agreement, then to choose to perform a typical install or custom install.
The installer checks your system for the installation home directory that was established when TIBCO Runtime Agent was installed. The adapter is installed under the installation home directory.
Supported Platforms and Disk Space
The following table lists the platform-specific installation packages where version_number is the Adapter release number. For example, the installation package name for TIBCO Adapter for Kenan/BP 6.0.0 on the AIX 5.3 is TIB_adkenan-suite_6.0.0_aix52_power_java_kenan12.0_64.tar.
Kenan/BP Version
Solaris 8 Solaris 9
Installing on AIX 5.3
Your Tuxedo 9.0 software on AIX platforms should support JNI, which is required for the Kenan/BP API-TS connection. A sample installation procedure is provided below to patch your Tuxedo software for the JNI support. Contact your Tuxedo provider to confirm if such patch is required and obtain the installation steps and required source files (libbuft.im, libbuft.ex). The sample installation procedure is as follows:
1.
Enter $TUXDIR/lib.
2.
Backup the libbuft.so file.
3.
Copy the libbuft.im and libbuft.ex files to the $TUXDIR/lib directory.
4.
Customize the libbuft.im file. Use #!libtux.so for a full installation, otherwise change it to #!libwsc.so.
5.
Build the libbuft.so file:
$ cc -brtl -D__XCOFF32__ -I$TUXDIR/include -c tmtypesw.c
$ ld -bM:SRE -T512 -H512 -brtl -bE:libbuft.ex -bI:libbuft.im -lc tmtypesw.o -o libbuft.so
$ export OBJECT_MODE=64
$ cc -brtl -q64 -D__XCOFF64__ -I$TUXDIR/include -c tmtypesw.c
$ ld -bM:SRE -T512 -H512 -brtl -bE:libbuft.ex -bI:libbuft.im -lc -bnoentry -berok tmtypesw.o -o libbuft.so
If the cc compiler can not compile the file, use the xlc compiler.
Installing the Adapter
You can use any of the following modes to install the adapter. Before proceeding with the installation, untar the installation package.
Installing Using GUI Mode
A window environment such as CDE (for example, X Windows) is required to run the installer in GUI mode.
GUI mode performs the installation in an interactive graphical interface. The installer prompts you for values specific to your environment. Execute the installation program by typing the following in a terminal window:
% ./installation_package_name
Installing Using Console Mode
Console mode allows you to install the software in a console window. The installer prompts you for values. When installing in console mode you can move through the installation process as shown:
Execute the installation program by typing the following in a terminal window:
% ./installation_package_name -is:javaconsole -console
Installing Using Silent Mode with Default Values
This mode installs the adapter in a terminal window without prompting you for any information during installation. It installs the adapter using default values. Execute the installation program by typing the following in a terminal window:
 
% ./installation_package_name -silent
Installing Using a Response File (or a Template File)
This installation is performed in a console window or a terminal window. The installer prompts you for information during installation and saves your answers in a response file. The response file can be used during subsequent installations to create another instance using the same values as the original installation, either with or without prompting for changes.
To install the software in a terminal window and generate a response file, type the following in a terminal window:
 
% ./installation_package_name -options-record  responseFilepath
There is no space between -options and -record in the above command.
You can generate a template file without installing the adapter. The template file is similar to a response file, but the values are not filled in. You can edit the template file to generate a response file.
To generate a template file, type the following at the command prompt:
installation_package_name -options-template templateFilePath
There is no space between -options and -template in the above command.
After generating a response or a template file, you can use it to install the adapter in silent mode or interactive mode.
In silent mode, you are not prompted for values; the adapter is installed using the values in the response file. Type the following in a terminal window:
% ./installation_package_name -silent -options responseFilepath
In interactive mode, you are prompted for values during installation. The values in the response file are presented as suggested defaults. To install using a response file in interactive mode, type the following in a terminal window:
% ./installation_package_name -options responseFilepath
Combining Options
You can combine the different available options. For example, to install in silent mode using a response file, use:
% ./installation_package_name -silent -options       responseFileName
To install using Console mode and generate a response file, use:
% ./installation_package_name -is:javaconsole -console       -options-record responseFileName

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved