[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

- Installing on a Windows NT System

## 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

- Logging In as con3

- Running install.sh

### 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]