> Installation Guide > Installing BEA Tuxedo Mainframe Adapter for TCP Gateway

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 BEA Tuxedo Mainframe Adapter for TCP Gateway

The installation procedure for BEA 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 BEA Tuxedo Mainframe Adapter for TCP Release Notes.

 

Preparing to Install

The TMA TCP Gateway product runs on UNIX-based and Windows 2000 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 2000. 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. Access the CD-ROM device.
    3. # ls -l /dev/cdrom
    total 0
    brw-rw-rw-     1 root     sys     22,   0 July 1 10:55 c1b0t010
  3. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM on any UNIX system, except HP-UX.
    4. # mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt

    If you are installing on an HP-UX system, use a command similar to the following command: 

    # mount -r -F cdfs -o cdcase /dev/cdrom/c1b0t010 /mnt
  4. Change the directory to the unix directory on your CD-ROM device. For example,
    5. # cd /mnt
  5. List the CD-ROM contents.
    6. # ls
    tmatcp91_32_sol_9_sp.bin
    tmatcp91_32_hpux_1123_pa.bin
    tmatcp91_32_sles_9_x86.bin
    tmatcp91_32_aix_53_ppc.bin
    tmatcp91_32_win_2k3_x86.exe
    NTMF
    UNIXMF
  6. 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:
    7. # sh tmatcp91_32_aix_53_ppc.bin -i console
  7. The installation program runs and prompts you for responses (see Listing 2-1 for an example).
    8. 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 9.1.

    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 

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

    License Agreement

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

    Please read before installing:

    You acknowledge that your use of this software is subject to (i) the license
    terms that you signed when you placed your most recent order with us; or,
    if you haven't signed a license agreement with us, (ii)  the shrinkwrap
    license terms included in your most recent order with us for which we shipped
    software media to you; or, if neither (i) or (ii) are applicable, then, (iii)
    if you are downloading this software from edelivery.oracle.com, then the
    Oracle Electronic Delivery Trial License Agreement (which you acknowledge
    that you have read and understand) governs your use of the software.  Note:
    Programs downloaded for trial use or downloaded as replacement media may not
    be used to update any unsupported programs.


    DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y


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

    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 9.1' has been successfully installed to:

       /usr/bea/tuxedo9.1

    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. Insert the Tuxedo Mainframe Adapter for TCP Gateway CD-ROM.
  2. Do one of the following, depending on your platform:

    3. On Windows:

    When installing on a Windows platform, Install Anywhere should start automatically when you load the CD. Proceed to Step 3.

    If it does not, complete the following steps:

    1. Choose StartArrow symbolRun. The Run dialog displays.
    2. Click Browse to navigate to the CD-ROM drive.

      3. The following files should be located in root: 

      tmatcp91_32_aix_53_ppc.bin
      tmatcp91_32_win_2k3_x86.exe
      tmatcp91_32_hpux_1123_pa.bin
      tmatcp91_32_sol_9_sp.bin
      tmatcp91_32_SLES_9_x86.bin
    3. Select tmatcp91_32_win_2k3_x86.exe.
    4. Click Open.
    5. Install Anywhere runs and the Introduction screen (Figure 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. Access the CD-ROM device.
      9. > ls -l /dev/cdrom
      total 0
      brw-rw-rw-     1 root     sys     22,   0 July 1 10:55 c1b0t010
    9. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM on any UNIX system, except HP-UX.
      10. > mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt

      If you are installing on an HP-UX system, use a command similar to the following command: 

      > mount -r -F cdfs -o cdcase /dev/cdrom/c1b0t010 /mnt
    10. Change the directory to the top-level directory on your CD-ROM device. For example,
      11. > cd /mnt/
    11. List the CD-ROM contents.

      12. The following files should be located in root: 

      tmatcp91_32_aix_53_ppc.bin
      tmatcp91_32_win_2k3_x86.exe
      tmatcp91_32_hpux_1123_pa.bin
      tmatcp91_32_sol_9_sp.bin
      tmatcp91_32_SLES_9_x86.bin
    12. Execute the installation program.
      13. /mnt> sh tmatcp91_<platform>.bin

      The Introduction screen (see Figure 2-1) is displayed.

    13. Proceed to Step 3.
      14. Figure 2-1 Introduction Screen


      Introduction Screen

  3. Click Next to continue with the installation. The License Agreement screen is displayed (Figure 2-2).
    4. Figure 2-2 License Agreement Screen


    License Agreement Screen

  4. Click the Accept option button to accept the license agreement; then click Next to proceed with the installation. The Choose Install Set screen is displayed. This screen appears in Windows installations only.
    5. Note: If you click the Do Not Accept 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.
  5. Click Next to proceed with the installation. The Choose BEA Home Directory screen is displayed (see Figure 2-3).
    6. Figure 2-3 Choose BEA Home Directory Screen


    Choose BEA Home Directory Screen

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

    7. 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.
  7. If the installation encounters a previous version of Tuxedo Mainframe Adapter for TCP in the selected BEA Home directory, the Previous Installation Found message box displays.

    8. 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.
  8. If you do not have a successful installation of Tuxedo 9.0 or 9.1 in the BEA Home directory, the Tuxedo 9.0 Not Installed message box displays (Figure 2-4).
    9. Figure 2-4 Tuxedo 9.0 or 9.1 Not Installed Message Box


    Tuxedo 9.0 or 9.1 Not Installed Message Box

    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.
  9. The Pre-Installation Summary screen is displayed (see Figure 2-5).
    10. Figure 2-5 Pre-Installation Summary Screen


    Pre-Installation Summary Screen

  10. 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.
  11. Upon installation completion, the Install Complete screen is displayed (Figure 2-6). Click Done to exit the installation program.
    12. Figure 2-6 Install Complete Screen


    Install Complete Screen

 

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>/tuxedo9.1/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 9.1
    ----------------------------------------------
    About to uninstall...
       BEA Tuxedo Mainframe Adapter TCP 9.1
    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 symbolBEA WebLogic E-Business PlatformArrow symbolTuxedo Mainframe Adapter for TCP 9.1Arrow symbolUninstall BEA Tuxedo Mainframe Adapter for TCP from the Start menu. The Tuxedo Mainframe Adapter for TCP Uninstaller screen is displayed (Figure 2-7).
    2. Figure 2-7 Tuxedo Mainframe Adapter for TCP Uninstaller Screen


    Tuxedo Mainframe Adapter for TCP Uninstaller Screen

  2. Click Uninstall to start uninstalling TMA TCP. When the process is complete, the screen shown in Figure 2-8 is displayed.
    3. Figure 2-8 Tuxedo Mainframe Adapter for TCP Uninstallation Complete Screen


    Tuxedo Mainframe Adapter for TCP Uninstallation Complete Screen

  3. Click Exit to complete the uninstallation.

 

Distribution Libraries and Executables

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

HP-UX 11.23

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

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

Solaris 10

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 5.3

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

SUSE Linux 9

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

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

Windows 2003

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