[Table of Contents]     [Index]     [Previous]     [Next] Installing BEA eLink Adapter for R/3

Installing BEA eLink Adapter for R/3

This chapter describes how to install BEA eLink Adapter for R/3 on UNIX and Windows NT systems. It covers the following topics:

Installing on a UNIX System

This section describes how to install BEA eLink Adapter for R/3 on UNIX systems. It covers the following topics:


 

Creating the conr3 User

A UNIX user with non-administrative privileges should be created on the R/3 application server to provide a context in which to run both TUXEDO and BEA eLink Adapter for R/3. This user should be used to run TUXEDO and BEA eLink Adapter for R/3 only so that processes associated with TUXEDO and BEA eLink Adapter for R/3 can be identified easily.

BEA suggests that you use conr3 for the user name. This document will refer to this UNIX user as conr3. If your organization uses a different user name, then substitute your user name whenever you encounter a reference to conr3 in this document.

Note: BEA strongly recommends that you do not use the UNIX R/3 administration user (nnnadm, where nnn represents the R/3 system identifier) to run TUXEDO and BEA eLink Adapter for R/3.
 

Logging In as con3

After creating the conr3 user name, log in as that user.
 

Running install.sh

Run the install.sh script to install the BEA eLink Adapter for R3 as follows:

  1. Insert the CD-ROM in the CD-ROM drive.

    If your system is not already configured to access data from a CD-ROM directory, you will need to create a mount directory (for example, mkdir /cdrom) and mount the CD-ROM device (with the mount command).

    Change directories to your CD-ROM directory, for example:

    cd /cdrom 

  2. Type ls to view the contents of the CD.

    The CD should contain the following files and directories:

    HPUX/   IBM/   install.sh   readme.txt   SUN5X/   WINNT/

  3. Start the installation by typing the following at the command line prompt:

    sh ./install.sh

    Press Enter.

    This invokes the installation script.

    The UNIX system installation script provides a set of step-by-step instructions to help you quickly install the BEA eLink Adapter for R3. This script lets you specify your platform, operating system, and the directory where you want to install. The installation script prompts you through the entire installation process. You can cancel the installation at any time by pressing CTRL-C simultaneously.

  4. Type the number that corresponds to the name of the operating system you are using (for example, if using HPUX1020, type 1).

    01) HP/HPUX1020    02) HP/HPUX1100      03)IBM/AIX414   
    04) IBM/AIX421 05)IBM/AIX43 06) SUN5X/SOL251
    07) SUN5X/SOL26
    Install which platform's files? [01-7, q to quit, l for list]: 1

    Press Enter.

  5. You are prompted to confirm your choice. If correct, type y for "yes," or n for "no" or q to "quit." Press Enter.

    ** You have chosen to install from HP/HPUX1020 **
    BEA eLink Adapter for R/3 Release 1.4
    This directory contains the BEA eLink Adapter for R/3 for
    HP-UX 10.20 on 9000/800 series.
    Is this correct? [y,n,q]: y

  6. The script indicates which packages are available for the chosen operating sytem. Indicate which package to install and press Enter.

    The following packages are available:
      1  eLinkR3  BEA eLink Adapter for R/3
    Select the package(s) you wish to install (or 'all' to install
    all packages) (default: all) [?,??,q]: 1

    The following copyright information is displayed about the product you are about to install:

    BEA eLink Adapter for R/3 Release BEA eLink Adapter for R/3 Release 1.4
    Copyright (c) 1999 BEA Systems, Inc.
    All Rights Reserved.
    Distributed under license by BEA Systems, Inc.
    BEA and eLink are trademarks of BEA Systems, Inc.

  7. You are prompted for the directory location where you want to install the product. Type the install directory and press Enter.

    Note: It is recommended that you install BEA eLink Adapter for R3 under a directory named eLink. The host machine where you install and the prefix path to the eLink directory is up to you. For this example, we install on /usr/eLink/.

    Directory where eLink files are to be installed [?,q]: /usr/eLink

  8. Watch the screen messages to verify that the installation is successful. The messages will be similar to the following.

    Creating /usr/eLink
    Using /usr/eLink as the eLink base directory
    Creating /usr/eLink/adapters
    Creating /usr/eLink/adapters/sapr3
    Determining if sufficient space is available ...
    3180 blocks are required
    8201216 blocks are available to /usr/eLink/adapters/sapr3
    Using /usr/eLink/adapters/sapr3
    as the eLink Adapter for R/3 install directory
    Unloading /usr/cd/HP/HPUX1020/ELINKR3/ELINKR3.Z ...
    bin/cr3alein
    bin/cr3aleout
    bin/cr3rfcin
    bin/cr3tidmanager
    config/cr3_queues.sh
    config/cr3_tlog.sh
    config/cr3aleout.sh
    config/setenv.sh
    config/cr3alein.env
    config/cr3rfcin.env
    config/cr3.ubb
    config/cr3.fml
    config/sideinfo
    3180 blocks
    ... finished
    Installation of BEA eLink Adapter for R/3 was successful
    The following packages are available:
      1  eLinkR3  BEA eLink Adapter for R/3

  9. When the installation completes successfully, exit the install script. (Or proceed with another installation, as appropriate.)

    Select the package(s) you wish to install (or 'all' to install
    all packages) (default: all) [?,??,q]: q
    Please don't forget to fill out and send in your registration card

Table 2-1 describes the files and directories that are installed for BEA eLink Adpater for R3 on a UNIX system.
Table 2-1 Directory Structure of BEA eLink Adapter for R/3 on a UNIX System

File or Directory Name Description

eLink/bin/

Directory containing executables

eLink/bin/cr3alein

ALE Inbound executable

eLink/bin/cr3aleout

ALE Outbound executable

eLink/bin/cr3rfcin

RFC Inbound executable

eLink/bin/cr3tidmanager

TID manager executable

eLink/config

Directory containing configuration files.

eLink/config/cr3_queues.sh

Semi-configured startup script for queues

eLink/config/cr3_tlog.sh

Semi-configuredstartup script for log files

eLink/config/setenv.sh

Semi-configured setup file for generic eLink for R3 environment variables

eLink/config/cr3aleout.sh

Semi-configured startup script for ALE Outbound

eLink/config/cr3alein.env

Environment file for ALE Inbound

eLink/config/cr3rfcin.env

Environment file for RFC Inbound

eLink/config/cr3.ubb

TUXEDO UBB configuration file

eLink/config/cr3.fml

CR3 FML field table

eLink/config/sideinfo

Example R/3 sideinfo file

Installing on a Windows NT System

The BEA eLink Adapter for R3 product install program for the Windows NT platform is located in the winnt\setup.exe file on the CD-ROM.

To install the product, insert the CD into the CD-ROM drive and double click on the winnt\setup.exe file to launch the installation wizard.

When the installation program launches, follow the prompts shown in the windows as described.

  1. The Welcome window describes the product you are about to install. Click Next to continue (or click No to cancel the installation process).

    Figure 2-1 Welcome to BEA eLink Adapter for R3 Setup Program

  2. In order to proceed with the installation, you must accept the license agreement. Click Yes to accept (or click No to cancel the installation process).

    Figure 2-2 License Agreement

  3. After you accept the license agreement, the User Information window is displayed. Provide the requested information, and click Next to continue (or Back to return to a previous window).

    Figure 2-3 Provide User Information

  4. The path shown for the "Destination Folder" on the Choose Destination Location window is the location where the BEA eLink product(s) will be installed. The default Destination Folder is YourDrive:\eLink\ as shown in Figure 2-4. To accept the default, click Next to continue. Otherwise, use the file browser to choose a different destination folder as explained below.

    Figure 2-4 Choose Directory Location for Product Installation

If you want to install the BEA eLink product in a folder other than the default, click on the Browse button to get the file browser. Use the file browser to locate the directory in which you want to install the BEA eLink product and click OK to specify this new path name as the Destination Folder.

Note: It is recommended that you install BEA eLink Adapter for R3 under a directory named eLink. The host machine where you install and the prefix path to the eLink directory is up to you. For this example, we install on C:\eLink\.

Figure 2-5 File Browser for Choosing an Install Location

If you do change the Destination Folder to something other than the default, you should now see the new path name reflected on the Choose Destination Location window.

  1. Select the program folder where you want to store the startup icon for the BEA eLink Adapter for R3 product. The default folder is already chosen for you. If you wish to choose a different folder, do so. Click Next to continue (or Back to return to a previous window).

    Figure 2-6 Select a Program Folder

  2. If you are satisfied with the current settings, click Next to proceed with the installation. (Otherwise, click Back to return to a previous window.)

    Figure 2-7 Current Settings

  3. When all files have been successfully copied to the destination folders, the Setup Complete window is displayed. Click Finish to exit the installation.

    Figure 2-8 Setup Complete

Table 2-2 describes the files and folders that are installed for BEA eLink Adpater for R3 on a Windows NT system.
Table 2-2 Directory Structure of BEA eLink Adapter for R/3 on Windows NT

File or Folder Name Description

eLink\bin\

Directory containing executables

eLink\bin\cr3alein.exe

ALE Inbound executable

eLink\bin\cr3aleout.exe

ALE Outbound executable

eLink\bin\cr3rfcin.env

Environment file for RFC Inbound

eLink\bin\cr3tidmanager.exe

TID manager executable

elink\bin\librfc.dll

R/3 RFC Dynamic Link Library

eLink\config

Directory containing configuration files.

eLink\config\cr3_queues.nt

Semi-configured startup script for queues

eLink\config\cr3_tlog.bat

Semi-configuredstartup script for log files

eLink\config\setenv.bat

Semi-configured setup file for generic eLink for R3 environment variables

eLink\config\cr3aleout.bat

Semi-configured startup script for ALE Outbound

eLink\config\cr3alein.env

Environment file for ALE Inbound

eLink\config\cr3rfcin.exe

RFC Inbound executable

eLink\config\cr3.ubb

TUXEDO UBB configuration file

eLink\config\cr3.fml

CR3 FML field table

eLink\config\sideinfo

Example R/3 sideinfo file


[Table of Contents]     [Index]     [Previous]     [Next]