Installing BEA eLink Adapter for MQSeries

# Installing BEA eLink Adapter for MQSeries

This chapter contains information for installing and uninstalling the eLink Adapter for MQSeries.

## Pre-Installation Considerations

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

- Read the BEA eLink Adapter for MQSeries Release Notes.

- Install and verify the operation of the eLink Platform product.

- Set up the required MQSeries resource manager.

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.

### Setting up the MQSeries XA Compliant Resource Manager

Before installing eLink Adapter for MQSeries, set up the MQSeries XA Compliant Resource Manager. The steps to do this are as follows.

1. Add the following line to the TUXEDO RM file: This file is located in the TUXDIR/UDATAOBJ directory (where TUXDIR is the directory where you installed TUXEDO).

    MQSeries_XA_RMI:MQRMIXASwitchDynamic: /mqmtop/lib/libmqmxa.a \
       mqmtop/lib/libmqm.s1 /opt/tuxedo/lib/libtux.s1

Note: In the above example, the backslash (`\') character at the end of the first line is a continuation character. If you enter the entire command on one line in the RM file, do not enter the backslash (`\') character.
The file extensions shown in the above example vary depending on the platform you are using. The example above illustrates the line in the TUXEDO RM file for the HP-UX platform. For Solaris, the line would be as follows:

    MQSeries_XA_RMI:MQRMIXASwitchDynamic: /mqmtop/lib/libmqmxa.a \
       mqmtop/lib/libmqm.so mqmtop/lib/libmqmcs.so \
       /mqmtop/lib/libmpmzse.so /opt/tuxedo/lib/libtux.so

2. Run the following command while in the TUXDIR/BIN directory to create the resource manager executable (where TUXDIR is the directory where you installed TUXEDO).

    buildtms   -o MQXA -r MQSeries_XA_RMI

3. Add the following lines to the GROUP section of the UBBCONFIG file for the group used for the eLink Adapter for MQSeries servers.

    TMSNAME=MQXA TMSCOUNT=x
    OPENINFO="MQSeries_XA_RMI:BEA.TEST.MANAGER"

In the above example, the `x' indicates the number of instances to execute the MQXA.

## Installing BEA eLink Adapter for MQSeries

### Installing on Unix Platforms

To install the eLink Adapter for MQSeries on Unix platforms, you run the `install.sh` script. This script installs all the necessary software components.

Perform the following steps to install the eLink Adapter for MQSeries on a supported UNIX platform.

1. Log on as root.

    $ su -
    Password:

2. Access the CD-ROM device.

    # ls -1 /dev/cdrom
    total 0
    brw-rw-rw-   1 root   sys    27,   0 January 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

6. Execute the installation script.

    # sh ./install.sh

7. The installation script runs and prompts you for responses. Listing 2-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) sun5x/sol26

>     04) sun5x/sol7

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

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

>     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     emqm       BEA eLink Adapter for MQSeries

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

>     BEA eLink Adapter for MQSeries
>     (9000) Release 1.0
>     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 MQSeries Adapter files are to be installed
>     (Enter your TUXEDO directory path) [?,q]: /work/cmadm/tux65

>     Using  /work/cmadm/tux65 as the MQSeries Adapter base directory

>     Determining if sufficient space is available ...
>     492 blocks are required
>     8781780 blocks are available to /work/cmadm/tux65

>     Unloading /cmhome/dist/emqm-1/hp/hpux1020/emqm/EMQMT65.z...
>     bin/ELINKMQI
>     bin/ELINKMQO
>     bin/TMQUEUE_MQM
>     eLink/mqseries/ELINKMQI.cfg
>     eLink/mqseries/ELINKMQO.cfg
>     eLink/mqseries/RM.emqm
>     eLink/mqseries/TMQUEUE_MQM.cfg
>     eLink/mqseries/ELINKADK.fml
>     eLink/mqseries/ubbconfig.emqm
>     lib/libadk.sl
>     lib/libemqcmn.sl
>     udataobj/binfiles.emqm
>     480 blocks

>     ...finished

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

>     Installation of BEA eLink Adapter for MQSeries 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 Windows NT

Perform the following steps to install the eLink Adapter for MQSeries 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 MQSeries 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 MQSeries product is installed on your system. Click Finish to complete the Setup process.

   > Figure 2-7 Setup Complete Screen

### Uninstalling eLink Adapter for MQSeries on Windows NT

Perform the following steps to uninstall the eLink Adapter for MQSeries 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 MQSeries from the program list and click the Add/Remove button.

4. The uninstall process for eLink Adapter for MQSeries 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 MQSeries CD-ROM contains the following libraries and executable programs. After installing the eLink Adapter for MQSeries software, verify that these libraries and programs are installed on your system.

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

> Table 2-1 Distribution Libraries and Executables

Directory | Files
--- | ---
/bin | ELINKMQI
/bin | ELINKMQO
/bin | TMQUEUE_MQM
/bin | lic.sh
/elink/mqseries | ELINKMQI.cfg
/elink/mqseries | ELINKMQO.cfg
/elink/mqseries | TMQUEUE_MQM.cfg
/elink/mqseries | ELINKADK.fml
/elink/mqseries | RM.emqm
/elink/mqseries | ELINKMQM.fml
/elink/mqseries | ubbconfig.emqm
/lib | libadk.s1
/lib | libemqcmn.s1
/udataobj | binfiles.emqm

## Post-Installation Procedures

After you complete the installation procedures for the eLink Adapter for MQSeries, make sure the following has been done before continuing with the eLink Adapter configuration procedures:

- MQSeries `/lib` directory must be defined in the library path.

- MQSeries programs you intend to use must be built, must be accessible to run, and must have triggers defined, if applicable.

- All MQSeries queues you intend to use must be defined and must be accessible.

For more information on these procedures, refer to the MQSeries documentation.

[Table of Contents] [Prev] [Next]