Installing BEA eLink TCP for Tuxedo


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Search \| PDF Files \| Contact \|

eLink for Mainframe TCP Documentation \| eLink for Mainframe TCP Installation Guide \| Previous Topic \| Next Topic \| Contents \| Index

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

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:

Log on as root.
```
$ su -
Password:
```

Access the CD-ROM device.

# ls -l /dev/cdrom

total 0

brw-rw-rw-     1 root     sys     22,   0 July 1 10:55 c1b0t010

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
```
Change the directory to the unix directory on your CD-ROM device. For example,
```
# cd /mnt
```

List the CD-ROM contents.

# ls

tcp32_Aix.bin

tcp32_Nt.bin

tcp32_Hp.bin

tcp32_Sol7.bin

tcp32_Sol8.bin

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

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:

Insert the eLink TCP for Tuxedo CD-ROM.
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:
On UNIX:
Click Next to continue with the installation. The License Agreement screen is displayed (Figure 1-2).
Figure 1-2 License Agreement Screen
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.
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
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:
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:
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:
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
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

To uninstall eLink TCP for Tuxedo on a UNIX platform:

Change directories to your uninstaller_TCP directory with the following command:
```
> cd <bea/home>/tuxedo8.0/uninstaller_TCP
```

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:

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