Installation Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

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:

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:

 

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.
    2. $ 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:
    3. # sh <installer>.bin -i console
  3. The installation program runs and prompts you for responses (see Listing 2-1 for an example).
    4. 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:

    2. On Windows:

    1. Choose StartArrow symbolRun. The Run dialog displays.
    2. Click Browse to navigate to the installer folder.
    3. Select <installer>.exe.
    4. Click Open.
    5. Install Anywhere runs and the Introduction screen (Listing 2-1) is displayed.
    6. Proceed to Step 3.

      7. On UNIX:

    7. Log on as root to install the Tuxedo Mainframe Adapter for TCP Gateway software.
      8. $ su -
      Password:
    8. Execute the installation program.
      9. /mnt> sh <installer>.bin
    9. 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.
    3. 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.

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

    1. Select the Create a New BEA Home option button.
    2. 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.
    3. Click Next to proceed with the installation.

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

    4. Select the Use Existing BEA Home option button.
    5. 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.
    6. 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.

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

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

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

  1. Change directories to your uninstaller_TMATCP directory with the following command:
    2. > cd <bea/home>/tuxedo/uninstaller_TMATCP
  2. Start the uninstallation program with the following command:
    3. <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 StartArrow symbolProgramsArrow symbolOracle WebLogic E-Business PlatformArrow symbolOracle Tuxedo Mainframe Adapter for TCP Arrow symbolUninstall 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


  Back to Top       Previous  Next