Installing BEA eLink TCP for Tuxedo

 

The installation procedure for BEA eLink for Mainframe TCP for Tuxedo 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 eLink TCP for Tuxedo

  • Installing on UNIX Platforms in Console Mode

  • Installing on Windows or UNIX Platforms in Graphics Mode

• Uninstalling eLink TCP for Tuxedo

• Distribution Libraries and Executables

 

---

Preparing to Install

The eLink TCP for Tuxedo product runs on UNIX-based, Windows NT, and Windows 2000 platforms. Complete the following tasks prior to installing the eLink TCP for Tuxedo software:

• Review the platform support and software requirements sections of the BEA eLink TCP Release Notes and make sure that the computer upon which you are installing satisfies the listed requirements.

• Install and verify the operation of one of the following:

  • BEA Tuxedo 8.0

  • BEA WebLogic Enterprise 6.0

• Verify the installation of one of the following:

  • Java Software Development Kit (SDK), Standard Edition, v 1.3.0

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

• Install and verify the TCP/IP stack software

 

---

Installing eLink TCP for Tuxedo

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

Installing on UNIX Platforms in Console Mode

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

1. Log on as root.

   $ su -
   Password:

2. Access the CD-ROM device.

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

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

   # cd /mnt

5. List the CD-ROM contents.

   # ls

   tcp32_Aix.bin

   tcp32_Nt.bin

   tcp32_Hp.bin

   tcp32_Sol7.bin

   tcp32_Sol8.bin

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:

   # sh tcp32_Aix.bin -i console

7. The installation program runs and prompts you for responses (see Listing 1-1 for an example).

   Listing 1-1 UNIX Console Mode Installation Example

   Preparing to install...
   Preparing CONSOLE Mode Installation...
   
   ================================================================
   BEA eLink for Mainframe TCP (created with InstallAnywhere by Zero G)

   ----------------------------------------------------------------
   
   
   
   
   ================================================================
   Introduction
   ------------
   
   This installer will guide you through the installation of 'eLink for Mainframe TCP'. On each step, answer the questions provided.  Type "quit" at any time to exit the installer.
   
   PRESS <ENTER> TO CONTINUE: <ENTER>
   
   ================================================================
   
   License Agreement
   
   -----------------
   
   Please read before installing:
   
   BEA eLink for Mainframe TCP 3.2 Software License
   
   The eLink for Mainframe TCP 3.2 Software and accompanying documentation respectively "Software" and "Documentation")...
                                 .
                                 .
                                 .
   BEA reserves all rights not expressly granted to you.
   
   General Terms
   
   Term. This License will become effective on the date you acquire the Software and will remain in force until terminated. You may terminate this License at any time by destroying the Documentation and Software together with all copies and adaptations. This License shall also automatically terminate if you breach any of the terms or conditions. You agree to destroy the original and all copies of the Software and Documentation, or to return them to BEA upon termination of this License.
   
   Governing Law. Except as otherwise restricted by law, this License shall be 
   
   PRESS <ENTER> TO CONTINUE: <ENTER>
   
   governed by, and interpreted in accordance with, the laws of the State of California of the United States of America, without regard...
                                 .
                                 .
                                 .
   Severability. If any provision in this License is invalid or unenforceable, 
   
   PRESS <ENTER> TO CONTINUE: <ENTER>

   that provision shall be construed, limited, modified or, if necessary, severed, to the extent necessary, to eliminate its invalidity or unenforceability, and the other provisions of this License shall remain unaffected.
   ...
                                 .
                                 .
                                 .
   THAT OPERATION OF THE SOFTWARE 
   
   PRESS <ENTER> TO CONTINUE: <ENTER>
   WILL BE UNINTERRUPTED.
   
   ...
                                 .
                                 .
                                 .
   LOST DATA, OR THE COST OF ANY SUBSTITUTE EQUIPMENT OR PROGRAM.
   
   BEA is a registered trademark of BEA Systems, Inc.
   
   BEA Tuxedo is a registered trademark of BEA Systems, Inc. in the US and other countries
   
   Copyright 2001, BEA Systems, Inc. All Rights Reserved.
   
   
   DO YOU AGREE WITH THE TERMS OF THE LICENSE? (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
   
   
   
   =================================================================
   
   Installing...
   
   -------------
   
    [===============|===============|===============|==============]
   
    [--------------|---------------|---------------|---------------]
   
   =================================================================...
                                 .
                                 .
                                 .
   
   =================================================================

   License Selection Option 

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

   1- Copy License File Now 

   2- Copy License File Later

   Enter a number: 1 

   Specify a Path to your License File: ./lic.txt
   
   ...
                                 .
                                 .
                                 .
   
   Install Complete
   
   ----------------
   
   Congratulations. 'eLink for Mainframe TCP' has been successfully installed to:
   
      /usr/bea/tuxedo8.0
   
   PRESS <ENTER> TO EXIT THE INSTALLER: <ENTER>

Installing on Windows or UNIX Platforms in Graphics Mode

Perform the following steps to install the eLink TCP for Tuxedo software on a Windows platform or on a UNIX platform in Graphics Mode:

1. Insert the eLink TCP for Tuxedo CD-ROM.

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

   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 Start—>Run. The Run dialog displays.

   2. Click Browse to navigate to the CD-ROM drive.

      The following files should be located in root:

      • tcp32_Aix.bin

      • tcp32_Hp.bin

      • tcp32_Nt.bin

      • tcp32_Sol7.bin

      • tcp32_Sol8.bin

   3. Select tcp32_Nt.exe.

   4. Click Open.

   5. InstallAnywhere runs and the Introduction screen (Figure 1-1) is displayed.

   6. Proceed to Step 3.

   On UNIX:

   1. Log on as root to install the eLink TCP for Tuxedo software.

      $ su -
      Password:

   2. Access the CD-ROM device.

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

      > 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 top-level directory on your CD-ROM device. For example,

      > cd /mnt/

   5. List the CD-ROM contents.

      The following files should be located in root:

      • tcp32_Aix.bin

      • tcp32_Hp.bin

      • tcp32_Nt.bin

      • tcp32_Sol7.bin

      • tcp32_Sol8.bin

   6. Execute the installation program.

      /mnt> sh tcp32_<platform>.bin

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

   7. Proceed to Step 3.

      Figure 1-1 Introduction Screen

      
       

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

   Figure 1-2 License Agreement Screen

   
    

4. Click the Yes 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.

   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.

   
    

5. Click Next to proceed with the installation. The Choose BEA Home Directory screen is displayed (see Figure 1-3).

   Figure 1-3 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.

   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 eLink TCP for Tuxedo software will install in the corresponding Tuxedo directory. If you do not want to install eLink TCP for Tuxedo 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.

      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 program encounters a previous version of eLink TCP for Tuxedo in the selected BEA Home directory, the Previous Installation Found message box displays (Figure 1-4).

   Figure 1-4 Previous Installation Found Message Box

   
    

   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 8.0 in the BEA Home directory, the Tuxedo 8.0 Not Installed message box displays (Figure 1-5).

   Figure 1-5 Tuxedo 8.0 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.

   • Click Next to proceed with the installation process. The libraries and executables will be installed in the Tuxedo directory.

9. If you click Next to continue the installation process, the Install License Installation Choice screen will display. To install the license now, select yes. To install the license later, select no.

   Figure 1-6 License Installation Choice Screen

   
    

   • If you select yes, the Choose License Location Directory screen will display. Type in the directory where the license is located or click on Browse to select a directory. Click Next to complete the installation process.

     Figure 1-7 Choose License Location Directory Screen

     
      

   • If you click No, the Install License Later screen will display. Click Next to complete the Installation process.

     To install the license later, refer to the "Installing the License" section in the BEA eLink for Mainframe TCP Release Notes.

     Figure 1-8 Install License Later Screen

     
      

10. Upon installation completion, the Install Complete screen is displayed (Figure 1-9). Click Done to exit the installation program.

    Figure 1-9 Install Complete Screen

    
     

 

---

Uninstalling eLink TCP for Tuxedo

This section provides instructions for uninstalling the eLink TCP for Tuxedo 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 eLink TCP for Tuxedo on a UNIX platform:

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

   > cd <bea/home>/tuxedo8.0/uninstaller_TCP

2. Start the uninstallation program with the following command:

   <bea/home> sh UninstallTCP -i console

   Listing 1-2 displays an eLink TCP for Tuxedo component uninstallation.

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

   Listing 1-2 UNIX Uninstallation Example

   Preparing CONSOLE Uninstall...

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

   BEA eLink TCP for Tuxedo(InstallAnywhere Uninstaller by Zero G)

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

   About to uninstall...

      BEA eLink for Mainframe TCP 

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

   PRESS <ENTER> TO BEGIN THE UNINSTALL, OR 'QUIT' TO EXIT THE UNINSTALLER: <ENTER>

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

   Uninstall...
   ------------

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

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

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

   Uninstall Complete

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

   All items were successfully uninstalled.

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

Uninstalling on Windows Platforms

Perform the following steps to uninstall the eLink TCP for Tuxedo software on a Windows platform:

1. Choose Start—>Programs—>BEA WebLogic E-Business Platform—>eLink for Mainframe TCP 3.2—>Uninstall eLink for Mainframe TCP from the Start menu. The eLink TCP for Tuxedo Uninstaller screen is displayed (Figure 1-10).

   Figure 1-10 eLink TCP for Tuxedo Uninstaller Screen

   
    

2. Click Uninstall to start uninstalling eLink TCP for Tuxedo. When the process is complete, the screen shown in Figure 1-11 is displayed.

   Figure 1-11 eLink TCP for Tuxedo Uninstallation Complete Screen

   
    

3. Click Exit to complete the uninstallation.

 

---

Distribution Libraries and Executables

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

HP-UX 11.00

Verify that the following files are installed by eLink TCP for Tuxedo.

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

Verify that the following files are installed by eLink TCP for Tuxedo.

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 eLink TCP for Tuxedo.

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 NT 4.0 and 2000

Verify that the following files are installed by eLink TCP for Tuxedo.

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