Installing BEA eLink DIO

# Installing BEA eLink DIO

This chapter consists of the following topics:

- Installation Prerequisites

- Installing the eLink DIO Design Client (Windows NT only)

  - Distribution Libraries and Executables for eLink DIO Design Client

- Installing the eLink DIO Server on the Execution Platform

  - Installing eLink DIO Server on Windows NT

  - Installing eLink DIO Server on a UNIX Platform (HP-UX, AIX, or SUN Solaris)

  - Distribution Libraries and Executables for eLink DIO Server

- Uninstalling eLink DIO on Windows NT

## Installation Prerequisites

Refer to the BEA eLink Data Integration Option Release Notes for information on prerequisite software that must be installed and operational prior to installing the BEA eLink DIO software. Also, for planning purposes, refer to the "Data Mapping Worksheet" section.

The following products must be installed and operational during the development and execution of a data mapping service request.

### BEA eLink DIO Design Client

Prior to installing the eLink DIO Design Client, install the following prerequisite software in the following order.

1. TSI Mercator Open Edition Client 1.4.2

Note: Use the SERIAL number from the eLink DIO license key when prompted for a Serial number during the Mercator Open Edition Client installation.

The TSI Mercator Open Edition Client is available on the eLink DIO Design Client CD-ROM in the `client/tsi_Clnt` directory. Select the `Setup.exe` program to install the software.

2. TSI Mercator Open Edition Client 1.4.2 Service Pack 8

   You may apply service pack 8 to the TSI Mercator Open Edition Client. This service pack is available on the eLink DIO Design Client CD-ROM in the `client/tsiSpck8` directory. Select the `Setup.exe` program to install the service pack.

#### Unsupported Mercator Features

The following Mercator software components are not supported with BEA eLink DIO:

- Type Tree Collections (ANSI, X12, EDIFACT, HL7)

- Tree Installer

- Application and Database adapters

- System Editor

### BEA eLink DIO Server

Prior to installing the eLink DIO Server, install eLink Platform 1.1.

## Installing the eLink DIO Design Client (Windows NT only)

Perform the following steps to install the eLink DIO Design Client software on a Windows NT system.

Note: TSI Mercator Authoring System must be installed prior to installing the eLink DIO Design Client software for your development environment.

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. Select the `client/eLnkClnt` 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 3-1 Welcome

2. The Software License Agreement screen displays after the Welcome screen. Click Yes to accept the terms of the agreement and continue with the installation. Click No to abort the installation process.

   > Figure 3-2 User Information

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

   > Figure 3-3 User Information

4. The Select Product Directory screen displays after the User Information screen. Click the Browse button and select a new destination folder if you do not want to install to the default destination folder. Click Next to continue the installation.

   > Figure 3-4 Select Product Directory

   The installation begins and a progress bar displays the status. The eLink DIO Design Client components install into the specified directory.

5. The Setup Complete screen notifies you that the eLink DIO Design Client software is installed on your system. Click Finish to complete the setup process.

   > Figure 3-5 Setup Complete

### Distribution Libraries and Executables for eLink DIO Design Client

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

#### Windows NT 4.0

Verify that the following files are installed by the eLink DIO software:

> Table 3-1 Windows NT Installed Files for Design Client

> Directory | Files
> --- | ---
> /elink | elinkimprt.exe mti2fgf.exe libfml32.dll libgp.dll

## Installing the eLink DIO Server on the Execution Platform

This section explains how to install the eLink DIO Server software on the following execution platforms:

- Microsoft Windows NT

- HP-UX

- SUN Solaris

- IBM AIX

  Note: BEA eLink Platform must be installed prior to installing the eLink DIO Server software for your execution environment. You must install the eLink DIO Server execution components within the TUXEDO directory.

### Installing eLink DIO Server on Windows NT

Perform the following steps to install the eLink DIO Server software 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. Select the `server/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 3-6 Welcome

2. The Software License Agreement screen displays after the Welcome screen. Click Yes to accept the terms of the agreement and continue with the installation. Click No to abort the installation process.

   > Figure 3-7 Software License Agreement

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

   > Figure 3-8 User Information

4. The Install License File? screen displays after the User Information screen. For additional license key information, refer to the BEA eLink Data Integration Option Release Notes.

   1. Click Yes to install the license file now. The following screen displays prompting you for the location of the license file. Browse to select the directory location of the license file. Click Next to continue with the installation process.

   2. Click No to bypass the installation of the license file now. Be sure to install the license file prior to initializing the software.

5. If BEA TUXEDO is installed and detected on your system, the installation begins and a progress bar displays the status. The eLink DIO Server components install into the TUXEDO directory. You may abort the installation process anytime prior to completion by clicking the Cancel button.

   When the installation completes, the Setup Complete screen shown in Step 6 notifies you that the eLink DIO Server software is installed on your system.

   If BEA TUXEDO is not installed on your system, the following Error screen displays.

   Warning: If Windows NT is your execution environment, BEA TUXEDO should be installed first and the eLink DIO Server should be installed within the same directory. If you install the eLink DIO Server outside of the TUXEDO directory, you will need to copy the files into the TUXEDO directory for processing of data mapping service requests.

   > Figure 3-9 Error

   Click OK to terminate the installation process.

6. The Setup Complete screen notifies you that the eLink DIO Server software is installed on your system. Click Finish to complete the setup process.

   > Figure 3-10 Setup Complete

### Installing eLink DIO Server on a UNIX Platform (HP-UX, AIX, or SUN Solaris)

To install the eLink DIO Server software, you run the `install.sh` script. This script installs all the necessary software components.

Note: The eLink DIO Server should be installed into the BEA TUXEDO directory. Prior to initiating the installation script, determine the directory location of BEA TUXEDO.

Perform the following steps to install the eLink DIO Server software on a supported Unix platform:

1. Log on as root to install the eLink DIO software.

>     $ su -
>     Password:

2. Access the CD-ROM device.

>     # ls -1 /dev/cdrom

>     total 0

>     brw-rw-rw-     1 root     sys     22,   0 May 17 10:55 c1b0t010

3. Mount the CD-ROM.

>     # mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt

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

>     # cd /mnt

5. List the CD-ROM contents.

>     # ls

>     install.sh  hp sun5x

6. Execute the installation script.

>     # sh ./install.sh

7. The installation script runs and prompts you for responses.

> Listing 3-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]: 1

>     ** You have chosen to install from hp/hpux1020 **

>     BEA eLink Data Integration Option Release 1.3

>     This directory contains the BEA eLink Data Integration Option System for
>     HP-UX 10.20 on 9000/800 series.

>     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     dio             BEA eLink Data Integration Option

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

>     BEA eLink Data Integration Option
>     (9000) Release 1.3
>     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 Data Integration Option files are to be installed
>     (Enter your Tuxedo directory path) [?,q]: /work/cmadm/tux65

>     Using /work/cmadm/tux65 as the Data Integration Option base directory

>     Determining if sufficient space is available ...
>     1856 blocks are required

>     6723480 blocks are available to /work/cmadm/tux65

>     Unloading /cmhome/dist/blue-2/server/hp/hpux1020/dio/DIOT65.Z ...
>     bin/ELINKDIO
>     bin/lic.sh
>     lib/libadk.sl
>     lib/libdbutil.sl
>     lib/libm4elink.sl
>     1780 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 Data Integration Option 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.

>     # unmount /mnt

### Distribution Libraries and Executables for eLink DIO Server

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

#### HP-UX

Verify that the following files are installed by the eLink DIO software:

> Table 3-2 HP-UX Installed Files

> Directory | Files
> --- | ---
> /bin | ELINKDIO
> /lib | libadk.sl libm4elink.sl libdbutil.sl

#### SUN Solaris

Verify that the following files are installed by the eLink DIO software:

> Table 3-3 SUN Solaris Installed Files

> Directory | Files
> --- | ---
> /bin | ELINKDIO
> /lib | libadk.so libm4elink.so libdbutil.so

#### IBM AIX

Verify that the following files are installed by the eLink DIO software:

> Table 3-4 IBM AIX Installed Files

> Directory | Files
> --- | ---
> /bin | ELINKDIO
> /lib | libadk.so libm4elink.so libdbutil.so

#### Windows NT 4.0

Verify that the following files are installed by the eLink DIO software:

> Table 3-5 Windows NT Installed Files

> Directory | Files
> --- | ---
> /bin | ELINKDIO.exe m4elink.dll libadk.dll dbutil.dll dbutil32.dll runmer32.dll mercma32.dll mercad32.dll mercrm32.dll mercadpt.dll

## Uninstalling eLink DIO on Windows NT

Perform the following steps to uninstall the eLink DIO software 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 eLink Data Integration Option 1.3 from the program list and click the Add/Remove button.

4. The uninstall process for BEA eLink Data Integration Option begins. The Remove Programs From Your System screen displays. Click OK to complete the uninstall process.

   > Figure 3-11 Removing Programs From Your Computer

[Table of Contents] [Prev] [Next]