Installing the Oracle Tuxedo Mainframe Adapter for OSI TP Product

This section covers the following information:

•	“Pre-Installation Considerations”

•	“Installing Oracle TMA OSI TP on UNIX Platforms in Console Mode”

•	“Installing Oracle TMA OSI TP in Graphics Mode”

Pre-Installation Considerations

Complete the following tasks prior to installing the TMA OSI TP product:

•	Read the Oracle Tuxedo Mainframe Adapter for OSI TP Release Notes for supported platform information.

•	Install and verify the operation of the Oracle Tuxedo product.

•

On a UNIX operating system, if you are upgrading to Tuxedo 11gR1 (11.1.1.2.0) from a previous version of Tuxedo, you must remove the old version of Tuxedo before you install Tuxedo 11gR1 (11.1.1.2.0) or you must install Tuxedo 11gR1 (11.1.1.2.0) in a different directory. Do not overwrite the old version of Tuxedo.

Configuring the Environment to Install TMA OSI TP

Before installing the TMA OSI TP product, you must ensure that the Oracle Tuxedo system is installed and configured properly for your environment. Refer to your Tuxedo documentation for more information about setting the Tuxedo environment variables.

A JDK is required by the InstallAnywhere installation product to install TMA OSI TP. A JDK is installed with Tuxedo. Verify that the system PATH environment variable is set to the correct version of the JDK installed by Tuxedo.

In addition to the Tuxedo environment variables, the TMA OSI TP system requires an additional environment variable, OSIRUNDIR, before you can boot the gateway or run the osiadmin utility. Refer to the Oracle Tuxedo Mainframe Adapter for OSI TP User Guide for more information about the osiadmin utility. If you do not set the OSIRUNDIR environment variable before you boot the gateway, you will receive a message telling you to set OSIRUNDIR. This environment variable specifies the path that the TMA gateway uses for runtime files. You can set the OSIRUNDIR environment variable through a script, a command line entry, or, for Windows operating systems, through the Windows System Properties in the Control Panel. The variable value should include the path and directory as appropriate for your operating system.

Upgrading from eLink OSI TP 4.0

If you are upgrading from eLink OSI TP 4.0, you do not need to modify your udmconfig input file. Perform a dmloadcf of the udmconfig file to create the dmconfig binary file, BDMCONFIG. If you are running eLink OSI TP 4.0, uninstall eLink OSI TP 4.0

Note:

Beginning with eLink OSI TP 4.1, the version 4.0 udmloadcf utility, the BUDMCONFIG binary file and the eLink OSI TP Administrative Server UDADM no longer exist. The function performed by the version 4.0 udmloadcf command is now done by the dmloadcf command. The information contained in the version 4.0 BUDMCONFIG file is now incorporated within the BDMCONFIG file. If your ubbconfig contains the UDMADM Server, delete it and perform a tmloadcf of the modified ubbconfig file.

Installing Oracle TMA OSI TP on UNIX Platforms in Console Mode

Perform the following steps to install the Tuxedo Mainframe Adapter for OSITP software in console mode:

1.	Log on as root.

$ su -
Password:

2.	Execute the appropriate installation program for your operating system in character-based mode. For example, execute the AIX program to install only the Tuxedo Mainframe Adapter for OSITP Gateway:

# sh <installer>.bin -i console

3.	The installation program runs and prompts you for responses (see Listing 0‑1 for an example).

Listing 0‑1 UNIX Console Mode Installation Example, Gateway on AIX 53

Preparing to install...
Preparing CONSOLE Mode Installation...

==============================================================================
BEA Tuxedo Mainframe Adapter OSITP (created with InstallAnywhere by Zero G)
------------------------------------------------------------------------------
==============================================================================
Introduction
------------

InstallAnywhere will guide you through the installation of Tuxedo Mainframe
Adapter for OSITP.

It is strongly recommended that you quit all programs before continuing with

this installation.

Respond to each prompt to proceed to the next step in the installation. If you

want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE: ENTER

==============================================================================
Choose BEA Home Directory
-------------------------

1- Create a New BEA Home
2- Use Existing BEA Home

Enter a number: 2
1- /bea/
2- /bea/tuxedo

Existing BEA Home: 2

==============================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    Tuxedo Mainframe Adapter for OSITP

Install Folder:
    /bea/tuxedo

Java VM to be Used by Installed Product:

    /bea/tuxedo/jre

Product Version
    xxx

Disk Space Information (for Installation Target):
    Required: 7,117,715 bytes
    Available: 531,012,902,912 bytes

PRESS <ENTER> TO CONTINUE: ENTER

==============================================================================
Installing...
-------------

[==================|==================|==================|==================]
[------------------|------------------|------------------|------------------]

Press <ENTER> to continue.:
==============================================================================
Install Complete
----------------

Congratulations. 'Tuxedo Mainframe Adapter for OSITP' has been successfully installed to:

/bea/tuxedo
PRESS <ENTER> TO EXIT THE INSTALLER: ENTER

 

Distribution Libraries and Executables for AIX

The TMA OSI TP software contains the following libraries and executable programs for the AIX operating system:

 

Table 1 TMA OSI TP Distribution Libraries for AIX 5.3

Directory	Files
/bin	getulogpfx GWOSITP osiadmin osiltmain portproxy prdebuginfo setPROXYpriv
/lib	libgwo.so libnwunisys.so libtasn1.so
/locale/C	LIBGWO.text LIBGWO_CAT libnwunisys.cat
/udataobj	gbebc2u.fld jbis82u.fld ksc2u.fld u2gbebc.fld u2jbis8.fld u2ksc.fld

Distribution Libraries and Executables for Solaris

The TMA OSI TP software contains the following libraries and executable programs for the Solaris operating system:

 

Table 2 TMA OSI TP Distribution Libraries for Solaris

Directory	Files
/bin	getulogpfx GWOSITP osiadmin osiltmain portproxy prdebuginfo setPROXYpriv
/lib	libgwo.so libnwunisys.so libtasn1.so
/locale/C	LIBGWO.text LIBGWO_CAT libnwunisys.cat
/udataobj	gbebc2u.fld jbis82u.fld ksc2u.fld u2gbebc.fld u2jbis8.fld u2ksc.fld

Note:

The $TUXDIR/bin/portproxy executable listens on privileged ports (< 1024) on behalf of GWOSITP. The script $TUXDIR/bin/setPROXYpriv is used to set the appropriate permissions. For UNIX platforms, please login as root and run setPROXYpriv manually after the installation.

Installing Oracle TMA OSI TP in Graphics Mode

Perform the following steps to install the Tuxedo Mainframe Adapter for OSITP Gateway on a Windows or UNIX platform in Graphics Mode:

1.	Do one of the following, depending on your platform:

On Windows:

a.	Choose Start→Run. The Run dialog displays.

b.	Click Browse to navigate to the installer folder.

c.	Select the installer program.

d.	Click Open. The selected path and executable appear in the Run dialog.

e.	Click OK to begin the installation. The Introduction screen displays.

Note:

All screen illustrations in this section are for Windows.

On UNIX:

a.	Log on as root to install the Tuxedo Mainframe Adapter for OSITP software.

$ su -
Password:

b.	Execute the appropriate installation program for your operating system. For example, execute the AIX program:

/mnt/> sh <installer>.bin

The Introduction screen displays.

 

 

2.	Click Next to proceed with the installation. The Choose BEA Home Directory screen displays.

 

3.	Select a New or Existing BEA Home option to specify the BEA Home directory (the default is c:\bea). The BEA Home directory is the root directory in which you install all Oracle products. This directory was set up when you installed Tuxedo.

If you want to create a new BEA Home directory, follow these steps:

a.	Select the Create a New BEA Home option.

b.	Accept the default location for your BEA Home directory or click Browse to specify a different location. If you accept the default location, your BEA Home directory will be c:\bea, and your Tuxedo Mainframe Adapter for OSITP software default installation directory will be the Tuxedo Home directory.

c.	Click Next to proceed with the installation.

If you already have one or more BEA Home directories on your system, you can use one of those directories as follows:

a.	Select the Use Existing BEA Home option.

b.	Select a BEA Home directory from the list displayed to the right of the options. All valid BEA Home directories are displayed in this list. Valid BEA Home directories are directories where Oracle products have been installed using the standard installation program.

c.	Click Next to proceed with the installation.

4.	If the installation program encounters a previous version of Tuxedo Mainframe Adapter for OSITP in the selected BEA Home directory, the Previous Installation Found message box displays .

From this message box, do one of the following:

•	Click Continue to install over the previous version.

•	Click Cancel to return to the Choose BEA Home Directory Screen and select another directory.

•	Click Exit to exit the installation program.

5.	If you do not have a successful installation of Tuxedo in the BEA Home directory, the Tuxedo Not Found! message box displays

From this message box, do one of the following:

•	Click Exit to exit the installation program so you can install Tuxedo.

•	Click Previous to return to the Choose BEA Home Directory Screen and select another directory.

6.	If you have a successful installation of Tuxedo, the pre-installaton Summary screen displays,

From this message box, do one of the following:

•	Click Next to begin installing

•	Click Previous to return to the Choose BEA Home Directory Screen and select another directory.

7.	Then Installing Tuxedo Mainframe Adapter message srceen displays

8.	After the product is installed, the Install Complete screen displays

9.	Click Done to exit the installation program.

Distribution Libraries and Executables for Windows

The TMA OSI TP software contains the following libraries and executable programs for Windows operating systems. After installing the TMA OSI TP product, verify that these files and programs are installed on your system.

 

Table 3 TMA OSI TP Distribution Libraries for Windows

Directory	Files
/bin	DbgHelp.dll gwo.dll GWOSITP.exe nwunisys.dll osiadmin.exe osilt.dll osiltmain.exe osiltpp.dll osiltppmain.exe osimsg.dll Psapi.dll tasn1.dll
/locale/C	LIBGWO.text LIBGWO_CAT
/udataobj	gbebc2u.fld jbis82u.fld ksc2u.fld u2gbebc.fld u2jbis8.fld u2ksc.fld
$TUXDIR/tma/osi/ samples/simpapp	dmconfig ubbsimple tailor.txt

Uninstalling Oracle TMA OSI TP on UNIX Platforms in Console Mode

To remove Tuxedo Mainframe Adapter for OSITP from a UNIX platform:

1.	Change directories to your uninstaller_TMAOSI directory with a command similar to the following example:

> cd /bea/tuxedo/uninstaller_TMAOSI

2.	Start the uninstall program with the following command:

/bea/tuxedo/uninstaller_TMAOSI> sh UninstallTMAOSI -i console

Listing 0‑1 displays an Tuxedo Mainframe Adapter for OSITP uninstallation.

Note:

The single-dash bar just beneath the double-dash bar in Listing 0‑1 is a progress indicator. When the single-dash bar becomes the same length as the double-dash bar, uninstallation is complete.

Listing 0‑1 UNIX Console Mode Uninstall Example

Preparing CONSOLE Uninstall...
==============================================================================
BEA Tuxedo Mainframe Adapter for OSITP (InstallAnywhere Uninstaller by Zero G)
------------------------------------------------------------------------------

Uninstall Tuxedo Mainframe Adapter for OSITP
----------------------------------------------
About to uninstall...

BEA Tuxedo Mainframe Adapter for OSITP

This will remove features installed by InstallAnywhere. It will not remove files and folders created after the installation.

PRESS <ENTER> TO CONTINUE: <ENTER>

==============================================================================
Uninstalling...
------------

[==================|==================|==================|==================]
[------------------|------------------|------------------|------------------]

==============================================================================
Uninstall Complete
------------------

All items were successfully uninstalled.

PRESS <ENTER> TO EXIT THE UNINSTALLER: <ENTER>

 

Uninstalling Oracle TMA OSI TP in Graphics Mode

Perform the following steps to remove the Tuxedo Mainframe Adapter for OSITP software from a Windows or UNIX platform:

Note:

Make sure that TMA OSI TP is shut down before you uninstall.

1.	Choose Start→Programs→BEA WebLogic E-Business Platform→Tuxedo Mainframe Adapter for OSITP→Uninstall BEA Tuxedo Mainframe Adapter for OSITP from the Start menu. The Tuxedo Mainframe Adapter for OSITP Uninstaller screen displays

2.	Click Uninstall to start removing Tuxedo Mainframe Adapter for OSITP. When the process is complete, the Uninstall complete screen displays.

3.	Click Exit to complete the uninstallation.

Note:

Some files may not be removed because they are required for another Oracle product.