Installing Oracle Tuxedo Mainframe Adapter for TCP Gateway

The installation procedure for Oracle Tuxedo Mainframe Adapter for TCP Gateway is slightly different for each platform on which the product can be installed. Follow the directions for the appropriate platform. The following information assists you in successfully installing this product:

•	Preparing to Install

•	Installing TMA TCP Gateway

•	Installing on UNIX Platforms in Console Mode

•	Installing on Windows or UNIX Platforms in Graphics Mode

•	Uninstalling Tuxedo Mainframe Adapter for TCP Gateway

•	Distribution Libraries and Executables

Note:

To upgrade from previous releases of eLink for Mainframe TCP, refer to Oracle Tuxedo Mainframe Adapter for TCP Release Notes.

Preparing to Install

The TMA TCP Gateway product runs on UNIX-based and Windows platforms. Complete the following tasks prior to installing the TMA TCP Gateway software:

•	Review the platform support and software requirements sections of the Oracle Tuxedo Mainframe Adapter for TCP Release Notes and make sure that the computer upon which you are installing satisfies the listed requirements.

•	Install and verify the operation of the following:

•	Oracle Tuxedo 12c Release 1 (12.1.1)

•	Verify the installation of one of the following:

•	Java Software Development Kit (JDK), Standard Edition, v 1.5

•	Java Runtime Environment (JRE), International Version, v 1.5

A JDK is required by the InstallAnywhere installation product to install Oracle Tuxedo Mainframe Adapter for TCP. A JDK is installed with Tuxedo. Verify that the system PATH environment variable is set to the correct version of the JDK. If the JDK version displayed is lower than the required version, you will need to configure your PATH environment variable to use the required JDK that is installed with Tuxedo.

•	Install and verify the TCP/IP stack software

Installing TMA TCP Gateway

The TMA TCP Gateway product runs on Unix-based platforms and Windows. Refer to the appropriate platform sections for installation instructions.

Installing on UNIX Platforms in Console Mode

Perform the following steps to install the Tuxedo Mainframe Adapter for TCP Gateway software in console mode on a certified UNIX platform:

1.	Log on as root.

$ su -
Password:

2.	Execute the installation program in character-based mode by selecting the appropriate file for your platform from the listed files. For example, for the AIX platform, select:

# sh <installer>.bin -i console

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

Listing 2‑1 UNIX Console Mode Installation Example

Preparing to install...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

==========================================================================
(created with InstallAnywhere by Zero G)
--------------------------------------------------------------------------




==========================================================================
Introduction
------------

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

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: 1

Specify a New BEA Home: /usr/bea

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

Please Review the Following Before Continuing:

Product Name:
    Tuxedo Mainframe Adapter for TCP

Install Folder:
    PATH

Java VM to be Used by Installed Product:
    PATH

Product Version
    xxx

Disk Space Information (for Installation Target):
Required: 2,833,299 bytes
Available: 528,988,708,864 bytes

PRESS <ENTER> TO CONTINUE: <ENTER>

=================================================================

Installing...

-------------

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

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

=================================================================...
.
.
.

=================================================================
Install Complete

----------------

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

/usr/bea/tuxedo

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

 

Installing on Windows or UNIX Platforms in Graphics Mode

Perform the following steps to install the Tuxedo Mainframe Adapter for TCP Gateway software on a Windows platform or on a 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 <installer>.exe.

d.	Click Open.

e.	Install Anywhere runs and the Introduction screen (Listing 2‑1) is displayed.

f.	Proceed to Step 3.

On UNIX:

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

$ su -
Password:

b.	Execute the installation program.

/mnt> sh <installer>.bin

c.	Proceed to Step 3.

 

2.	Click Next to continue with the installation. The Choose Install Set screen is displayed. This screen appears in Windows installations only.

Note:

If you click the No option button, you will not be able to continue with the installation. You must either exit the installation or go back to the Introduction screen.

 

3.	Click Next to proceed with the installation. The Choose BEA Home Directory screen is displayed.

4.	Create or select a BEA Home directory (the default for Windows is c:\bea; the default for UNIX is $HOME/bea). The BEA Home directory is the root directory in which you install all BEA products.

If you do not already have a BEA Home directory, you can create one by following these steps:

a.	Select the Create a New BEA Home option button.

b.

Accept the default location for your BEA Home directory or click Browse to specify a different location. If you accept the default location, it will be your BEA Home directory and your Tuxedo Mainframe Adapter for TCP Gateway software will install in the corresponding Tuxedo directory. If you do not want to install Tuxedo Mainframe Adapter for TCP Gateway in this default location, you will have the opportunity, in Step 7, to choose another directory in which to install the software.

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

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

c.	Click Next to proceed with the installation.

5.	If the installation encounters a previous version of Oracle Tuxedo Mainframe Adapter for TCP 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.

6.	If you do not have a successful installation of Oracle Tuxedo 12c Release 1 in the BEA Home directory, the Oracle Tuxedo 12c Release 1 Not Installed message box displays.

From this message box, do one of the following:

•	Click Exit to exit the installation program.

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

7.	The Pre-Installation Summary screen is displayed.

8.	If the Pre-Installation Summary information is correct, click Install to continue with the Installation. If information requires editing, click Previous to go back to the screens that require changes. Click Cancel to abort the installation process.

9.	Upon installation completion, the Install Complete screen is displayed. Click Done to exit the installation program.

Uninstalling Tuxedo Mainframe Adapter for TCP Gateway

This section provides instructions for uninstalling the Tuxedo Mainframe Adapter for TCP Gateway component. The following topics are discussed:

•	Uninstalling on UNIX Platforms in Console Mode

•	Uninstalling on Windows Platforms

Uninstalling on UNIX Platforms in Console Mode

To uninstall Tuxedo Mainframe Adapter for TCP Gateway on a UNIX platform:

1.	Change directories to your uninstaller_TMATCP directory with the following command:

> cd <bea/home>/tuxedo/uninstaller_TMATCP

2.	Start the uninstallation program with the following command:

<bea/home> sh UninstallTMATCP -i console

Listing 2‑2 displays a Tuxedo Mainframe Adapter for TCP Gateway component uninstallation.

Note:

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

Listing 2‑2 UNIX Uninstallation Example

Preparing CONSOLE Mode Uninstall...
=================================================================
(created with InstallAnywhere by Zero G)
--------------------------------------------------------------------------



==========================================================================
Uninstall Tuxedo Mainframe Adapter for TCP
----------------------------------------------
About to uninstall...

BEA Tuxedo Mainframe Adapter TCP

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

Some items could not be removed.

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

 

Uninstalling on Windows Platforms

Perform the following steps to uninstall the Tuxedo Mainframe Adapter for TCP Gateway software on a Windows platform:

1.	Choose Start→Programs→Oracle WebLogic E-Business Platform→Oracle Tuxedo Mainframe Adapter for TCP →Uninstall Oracle Oracle Tuxedo Mainframe Adapter for TCP from the Start menu. The Oracle Tuxedo Mainframe Adapter for TCP Uninstaller screen is displayed.

2.	Click Uninstall to start uninstalling TMA TCP. Click Exit to complete the uninstallation.

Distribution Libraries and Executables

The Oracle Tuxedo Mainframe Adapter for TCP software contains the following libraries and executable programs. After installing the TMA TCP software, verify that these libraries and programs are installed on your system.

Solaris

Verify that the following files are installed by TMA TCP Gateway.

 

Directory	Files
/bin	GWIDOMAIN
/lib	ConvMVS.so.60 ConvMVSC.so.60 libctxcp_10.so WrapTPS.so.60 WrapTPSD.so.60
/locale/C	LIBGWI_CAT LIBGWI.text
/udataobj/codepage	00819x00037 00819x00273 00819x00278 00819x00284 00819x00285 00819x00297 00819x00500 00819x00860 00819x01047 00912x00870 none tuxedo

AIX

Verify that the following files are installed by TMA TCP Gateway.

 

Directory	Files
/bin	GWIDOMAIN
/lib	ConvMVS.so.60 ConvMVSC.so.60 libctxcp_10.so WrapTPS.so.60 WrapTPSD.so.60
/locale/C	LIBGWI_CAT LIBGWI.text
/udataobj/codepage	00819x00037 00819x00273 00819x00278 00819x00284 00819x00285 00819x00297 00819x00500 00819x00860 00819x01047 00912x00870 none tuxedo

Windows

Verify that the following files are installed by TMA TCP Gateway.

 

Directory	Files
/bin	GWIDOMAIN.exe ConvMVS.dll ConvMVSC.dll ctxcp_10.dll libgwi.dll WrapTPS.dll WrapTPSD.dll
/locale/C	LIBGWI_CAT LIBGWI.text
/udataobj/codepage	00819x00037 00819x00273 00819x00278 00819x00284 00819x00285 00819x00297 00819x00500 00819x00860 00819x01047 00912x00870 none tuxedo