[Top] [Previous] [Next] [End of Book]

# Chapter 2 . Installing BEA Connect OSI TP

This chapter contains information for installing and uninstalling the BEA Connect OSI TP product.

## Pre-Installation Considerations

Connect OSI TP runs on UNIXWARE, HP, SUN, and Windows NT platforms. Complete the following tasks prior to installing Connect OSI TP:

- Read the BEA Connect OSI TP Release Notes

- Install and verify the operation of the BEA TUXEDO 6.4 product

- Install and verify the Unisys OSI-TP Version 2.0.8 stack software

- The following server platforms are supported for BEA Connect OSI TP:

  - HP-UX Version 10.20

  - SUN Solaris Version 2.5.1

  - UNIXWARE Version 2.1

  - Microsoft Windows NT Version 4.0

### Configuring the Environment to Install Connect OSI TP

Before installing BEA Connect OSI TP, you must configure the environment properly. Ensure that BEA TUXEDO 6.4 and Unisys OSI-TP Version 2.0.8 stack software are configured properly.

## Upgrading BEA Connect OSI TP

If you are upgrading from a previous release of the BEA Connect OSI TP product, you must shut down all Domain administrative and gateway servers within an application domain, particularly the following:

- GWTDOMAIN

- GWADM

- DMADM

  Warning: Do not run `dmadmin`, `dmlaodcf`, and `dmunloadcf` commands until the installation is complete.

BEA Connect OSI TP is a full replacement for previous releases. To upgrade, you will need to reinstall the product.

## Installing BEA Connect OSI TP

Connect OSI TP will run on Unix-based platforms (UNIXWARE, HP, and SUN) and Windows NT. Refer to the appropriate platform sections that follow for installation instructions.

### Installing on Unix-based Platforms

The following steps will install Connect OSI TP on a Unix-based platform.

1. Log on as root to install Connect OSI TP.

> Listing 2-1 Log On as Root

>     $ su -
>     Password:

2. Mount the CD-ROM. The following example will mount the CD-ROM drive on a UNIXWARE system.

> Listing 2-2 Mount the CD-ROM Drive

>     # ls -l /dev/cdrom
>     total 0
>     brw-rw-rw-    1 root     sys       22,  0 Sep 16 10:55 c1b0t0l0
>     # mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
>     # cd /mnt
>     # ls
>     install.sh  uw          winnt

3. Run the installation script by typing the following command.

> Listing 2-3 Run the Installation Script

>     # sh ./install.sh

4. The installation script will prompt you for responses. In the sample installation that follows, responses are in bold.

> Listing 2-4 Sample UNIXWARE Installation

>     01) uw/uw21

>     Install which platform's binaries? [01-1, q to quit, l for list]: 01

>     ** You have chosen to install from uw/uw21 **

>     BEA Connect OSI TP Release 1.3 for TUXEDO System Release 6.4

>     This directory contains the BEA Connect OSI TP SDK for
>     UnixWare 2.1 on Intel i386.
>     Please refer to the product documentation for release notes and
>     further information.

>     Is this correct? [y,n,q]: y

>     To terminate the installation at any time
>     press the interrupt key,
>     typically <del>, <break>, or <ctrl+c>.

>     The following packages are available:

>       1     tuxositp        BEA Connect OSI TP

>     Select the package(s) you wish to install (or 'all' to install
>     all packages) (default: all) [?,??,q]: all

>     BEA Connect OSI TP
>     (i386) Release 6.4
>     Copyright (c) 1998 BEA Systems, Inc.
>     Portions of this software (c) 1995 Novell, Inc.
>     All Rights Reserved.  Distributed under license by BEA Systems, Inc.
>     TUXEDO (r) is a registered trademark of Novell, Inc. in the
>     United States and other countries.

>     Checking UnixWare version...
>     ...finished

>     The following installation options are available:

>       1     both    Install the complete TUXEDO System - client and server
>       2    client Install the client only

>     Select an option (default: both) [?,??,q]: 1

>     Directory where TUXEDO files are to be installed [?,q]: /usr/tuxedo

>     Determining if sufficient space is available ...
>     6931 blocks are required
>     2982512 blocks are available to /usr/tux64conn

>     Using /usr/tux64conn as the TUXEDO base directory

>     Unloading /mnt/uw/uw21/tuxositp/ws.z ...
>     bin/GWOSITP
>     lib/libgwo.a
>     lib/libgwo.so.60
>     lib/libtasn1.a
>     lib/libtasn1.so.60
>     locale/C/LIBGWO.text
>     locale/C/LIBGWO_CAT
>     6960 blocks
>     ... finished

>     Changing file permissions...
>     ...done

>     Installation of BEA Connect OSI TP was successful

>     Please don't forget to fill out and send in your registration card
>     #

5. Unmount the CD-ROM by typing a command similar to the following.

> Listing 2-5 Unmount the CD-ROM

>     # cd /
>     # umount /mnt
>     # exit
>     $ exit

6. Use a text editor to add the following line of text to the `udataobj/DMTYPE` file. If a line beginning with `OSITP` exists, then delete it and replace it with the following new line of text.

> Listing 2-6 Edit udataobj/DMTYPE File

>     OSITP:-lgwo:-ltasn1 -lnwi -lnws -lnwi -lxaptp::

### Installing on a Windows NT Platform

The following steps will install Connect OSI TP on a Windows NT system.

1. Insert the product CD-ROM and click on the Run option from the Start menu. The Run window displays. Click on the Browse button to select the CD-ROM drive. Change directories to the `winnt` directory and select the `Setup.exe` program. Click OK to run the executable and begin the installation. The following Welcome screen displays. Click Next to continue with the installation.

> Figure 2-1 Welcome Screen

2. The BEA Software License Agreement displays. Click Yes to accept the terms of the agreement and continue with the product installation. Click No to exit the installation process.

   > Figure 2-2 BEA Software License Agreement

3. The User Information screen displays after the License Agreement. Enter the name of the BEA TUXEDO System Administrator in the Name field. Enter the name of your company in the Company field. Click Next to continue with the installation.

   > Figure 2-3 User Information

4. The Select Components screen displays after the User Information screen. Click the check box to the left of the OSI Software option to install the Connect OSI TP product. Click the check box to the left of the Online Documentation option to load the Connect OSI TP online documentation. Click Next to continue with the installation.

   > Figure 2-4 Component Selection

5. The Enter Path Information screen displays next. Enter the directory path where you want to install the BEA Connect OSI TP product in the OSI field. Enter the directory path for the BEA Connect OSI TP online documentation in the Doc field. Click Next to continue with the installation.

   > Figure 2-5 Path Definition

6. The Select Program Folder screen displays next prompting you to name a folder for the Connect OSI TP files. Enter a folder name in the Program Folders field or select a name from the Existing Folders list. Program icons for Connect OSI TP will be added in the designated folder. Click Next to continue with the installation.

   > Figure 2-6 Folder Selection

7. A progress bar displays showing the status of the installation.

8. The Setup Complete screen displays notifying you that the BEA Connect OSI TP product is installed on your system. Click Finish to complete the Setup process.

9. Use a text editor such as Microsoft NotePad to add the following line to the `udataobj/DMTYPE` file. If a line beginning with `OSITP` exists in the file, then delete it and replace it with the following new text.

   > Listing 2-7 Edit udataobj/DMTYPE File

   >     OSITP;%TUXDIR%\lib\libgwo.lib;%TUXDIR%\lib\libtasn1.lib;%TUXDIR%\ lib\libnwi.lib %TUXDIR%\lib\libnws.lib %TUXDIR%\lib\libnwi.lib;;

## Distribution Libraries and Executables

The BEA Connect OSI TP CD-ROM contains the following libraries and executable programs. After installing the Connect OSI TP software, verify that these libraries and programs are installed on your system.

### HP-UX 10.20

Verify that the following files are installed by BEA Connect OSI TP:

Directory | Files
--- | ---
/bin | GWOSITP
/lib | libgwo.a libgwo.sl libtasn1.a libtasn1.sl
/locale/C | LIBGWO.text LIBGWO_CAT

### SUN Solaris 2.5.1

Verify that the following files are installed by BEA Connect OSI TP:

Directory | Files
--- | ---
/bin | GWOSITP
/lib | libgwo.a libgwo.so libtasn1.a libtasn1.so
/locale/C | LIBGWO.text LIBGWO_CAT

### UNIXWARE 2.1

Verify that the following files are installed by BEA Connect OSI TP:

Directory | Files
--- | ---
/bin | GWOSITP
/lib | libgwo.a libgwo.so libtasn1.a libtasn1.so
/locale/C | LIBGWO.text LIBGWO_CAT

### Windows NT 4.0

Verify that the following files are installed by BEA Connect OSI TP:

Directory | Files
--- | ---
/bin | gwositp.exe
/lib | libgwo.dll libgwo.lib libtasn1.dll libtasn1.lib libgwo.text libgwo_cat

## Uninstalling Connect OSI TP on Windows NT

The following steps will uninstall the BEA Connect OSI TP product on a Windows NT system.

1. Access the Control Panel window from the Start>Settings>Control Panel menu option.

2. Double click on the Add/Remove Programs option from the Control Panel listings to access the Add/Remove Programs Properties window.

3. In the Add/Remove Programs Properties window, select BEA Connect OSI TP from the program list and click on the Add/Remove button.

4. The uninstall process for BEA Connect OSI TP will begin. The Remove Programs From Your Computer screen displays. Click OK to complete the uninstall process.

   > Figure 2-7 Removing Programs From Your Computer

[Top] [Previous] [Next] [End of Book]