Installing eLink Adapter for Vantive

# Installing eLink Adapter for Vantive

This chapter contains information for installing the eLink Adapter for Vantive software and consists of the following sections:

- Pre-Installation Considerations

- Installing BEA eLink Adapter for Vantive

- Installing on a UNIX Platform

- Installing on a Windows NT Platform

- Distribution Libraries and Executables

## Pre-Installation Considerations

The eLink Adapter for Vantive software runs on HP-UX, Solaris, AIX, and Windows NT. Complete the following tasks prior to installing the eLink Adapter for Vantive:

- Read the BEA eLink Adapter for Vantive Release Notes

- Install and verify the operation of the BEA TUXEDO product

- Install the Vantive API product

The current BEA eLink Platform leverages the BEA TUXEDO infrastructure because it is based on a service-oriented architecture. Both BEA TUXEDO and BEA eLink communicate directly with each other and with other applications through the use of services. Multiple services are grouped into "application servers" or "servers". The terms, TUXEDO services/servers and eLink services/servers can be used interchangeably. Because this document is specifically addressing the eLink family, the term "eLink service" and "eLink server" is used throughout.

### Configuring the Environment to Install the eLink Adapter for Vantive

Before installing the eLink Adapter for Vantive, you must configure the environment properly. Ensure that BEA TUXEDO is configured properly.

## Installing BEA eLink Adapter for Vantive

The eLink Adapter for Vantive software will run on HP-UX, Solaris, AIX, and Windows NT. Refer to the following section for installation instructions.

### Installing on a UNIX Platform

To install the eLink Adapter for Vantive software, you run the `install.sh` script. This script installs all the necessary software components.

Perform the following steps to install the eLink Adapter for Vantive software on a supported HP-UX, Solaris, or AIX platform.

1. Log on as root to install eLink for Vantive.

    $ su -
    Password:

2. Access the CD-ROM device.

    # ls -1 /dev/cdrom
    total 0
    brw-rw-rw-   1 root   sys    27,   0 September 27  10:55 c1b0t010

3. Mount the CD-ROM.

    # mount -r -F cdfs /dev/cdrom/c1b0t010 /mnt

4. Change the directory to your CD-ROM device.

    # cd /mnt

5. List the CD-ROM contents.

    # ls

    install.sh  hp  ibm  sun5x

6. Execute the installation script.

    # sh ./install.sh

7. The installation script runs and prompts you for responses. Listing 3-1 is an example of the installation script. The entries in bold represent user responses.

> Listing 2-1 Install.sh Example

>     01) hp/hpux1020			02) hp/hpux11		03) ibm/aix43
>     04) sun5x/sol26			05) sun5x/sol7

>     Install which platform's files? [01-5, q to quit, l for list]: 2

>     ** You have chosen to install from evan **

>     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     evan       BEA eLink Adapter for Vantive

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

>     BEA eLink Adapter for Vantive
>     (9000) Release 1.1
>     Copyright (c) 2000 BEA Systems, Inc.
>     All Rights Reserved.
>     Distributed under license by BEA Systems, Inc.
>     BEA eLink is a trademark of BEA Systems, Inc.

>     Directory where Vantive Adapter files are to be installed
>     (Enter your eLink Platform directory path) [?,q]: /bea/work/mytux

>     Using  /bea/work/mytux as the Vantive Adapter base directory

>     Determining if sufficient space is available ...
>     200 blocks are required
>     5080010 blocks are available to /bea/work/mytux

>     Unloading /cmhome/dist/ant-1/hp/hpux11/evan/EVANT65.Z ...
>     bin/ELINKVANO
>     bin/lic.sh
>     eLink/vantive/simpvantive/ReadCust
>     eLink/vantive/simpvantive/UpdateCust
>     eLink/vantive/simpvantive/elinkvantive.cfg
>     eLink/vantive/simpvantive/elinkvantive.env
>     eLink/vantive/simpvantive/elinkvantive.ubb
>     eLink/vantive/simpvantive/readme.txt
>     eLink/vantive/simpvantive/setenv.bat
>     eLink/vantive/simpvantive/setenv.sh
>     eLink/vantive/simpvantive/vam_clnt.c
>     lib/libadk.sl
>     udataobj/elinkvantive.fml
>     340 blocks
>     ...finished

>     Changing file permissions...
>     ...finished

>     If your license file is accessible, you may install it now.
>     Install license file? [y/n]:n

>     Please don't forget to use lic.sh located in your product bin directory to install the license file from the enclosed floppy.

>     Refer to your product Release Notes for details on how to do this.

>     Installation of BEA eLink Adapter for Vantive was successful

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

8. Change the directory to your root directory.

    # cd /

9. Unmount the CD-ROM device.

### Installing on a Windows NT Platform

Perform the following steps to install the eLink Adapter for Vantive software on the Windows NT platform.

1. Insert the product CD_ROM and click the Run option from the Start menu. The Run window displays. Click Browse 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 Screen

3. The User Information screen displays after the License Agreement. Enter the name of the eLink Platform 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 Screen

4. The Install License File? option screen displays next. You may select Yes to install your BEA Software License File, or you may select No to bypass this step and continue installing the eLink Adapter for Vantive software. If you select Yes, continue with Step 5. If you select No, continue with Step 7.

   > Figure 2-4 Install License File? Screen

5. The Select License File Source Directory screen displays. Enter the directory path where your license file resides in the field. You can browse and click directories by clicking the Browse button. Typically, the license file is installed in the `tuxedo/udataobj` directory.

   If you entered a valid directory path, click Next to continue with the installation. Go to Step 7. If you entered an invalid directory path, go to Step 6.

   > Figure 2-5 Select License File Source Directory Screen

6. If you do not enter a valid directory path for your license file, the installation software generates an error message dialog box. You can select Yes to enter a valid directory path, or you can select No to continue with the installation. If you select No, the installation software automatically searches for the TUXEDO software. If it finds TUXEDO installed, the installation software completes the process. If TUXEDO is not found, the installation software aborts the process.

   Note: If you select No, the installation continues but an error is generated in the ulog.mm/dd/yy file indicating that the product is unlicensed. Please refer to the "Using the License Key" section of the BEA eLink Adapter for Vantive Release Notes for instructions on using the license file.

   Once you have entered a valid directory path, click Next to continue with the installation. Go to Step 7.

   > Figure 2-6 Invalid License File Directory Dialog Box

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

8. The Setup Complete screen displays notifying you that the BEA eLink Adapter for Vantive product is installed on your system. Click Finish to complete the Setup process.

   > Figure 2-7 Setup Complete Screen

### Uninstalling eLink Adapter for Vantive on Windows NT

Perform the following steps to uninstall the eLink Adapter for Vantive on a Windows NT system.

1. Click the Start button, and then point to Settings. Point to the folder that contains Control Panel, and then click Control Panel.

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 Program properties window, select eLink Adapter for Vantive from the program list and click the Add/Remove button.

4. The uninstall process for elink Adapter for Vantive begins. The Remove Programs From Your Computer screen displays. Click OK to complete the uninstall process.

   > Figure 2-8 Remove Programs From Your Computer Screen

## Distribution Libraries and Executables

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

Verify that the following files are installed by the eLink Adapter for Vantive software.

> Table 2-1 Distribution Libraries and Executables

Directory | Files
--- | ---
/bin | ELINKVANO lic.sh

[Table of Contents] [Prev] [Next]