Previous     Contents     Index     DocHome     Next     
iPlanet Application Server Enterprise Connector for R/3 Administrator's Guide



Chapter 2   Installation


This chapter describes how to install and uninstall the iPlanet Application Server Enterprise Connector for R/3. The software components installed include the R/3 Enterprise Connector, which is a shared object, and the R/3 Worker, which is an executable file.

This chapter contains information about the following topics:



Software Prerequisites

The following software prerequisites are necessary to install the iPlanet Application Server Enterprise Connector for R/3:

  • the iPlanet Application Server version 6.0 SP1 must be installed

  • the iPlanet Application Server Unified Integration (UIF) version 6.0 SP1 must be installed

  • One of the following web browsers should be installed:

    • Netscape Communicator 4.5

    • Microsoft Internet Explorer 4.0 (NT only)


Caution

The R/3 connector operates with the iPlanet Application Server, therefore it must be installed in the same directory in which the iPlanet Application Server is installed.



Supported Versions of R/3

The iPlanet Application Server Enterprise Connector for R/3 supports R/3 Version 4.5B, and 4.0B.



Hardware Requirements


The following hardware requirements are necessary for installing the connectors.


Computers and Operating Systems

  • One of the following operating systems:

    • Microsoft Windows NT version 4.0 with Service Pack 5

    • Sun SPARC running Solaris 2.6

      Note

      The Management Console Tools are not supported if running under Exceed.


  • Memory Per CPU: 64 MB minimum; 128 MB recommended

  • Available disk space: 200 MB for NT, 400 MB for Solaris



Preparing to Install the iPlanet Application Server Enterprise Connector for R/3

Before installing the iPlanet Application Server Enterprise connector for R/3 complete the following steps:

  • Verify the R/3 Server connectivity.

  • Stop the iPlanet Application Server if it is running.Without stopping the application server, the installation program may not be able to overwrite files currently in use.

  • Read the iPlanet Application Server Enterprise Connector for R/3 Release Notes for any last minute updates.



Installing the iPlanet Application Server Enterprise Connector for R/3 on Windows NT

The following procedures describe how to install and uninstall the iPlanet Application Server Enterprise Connector for R/3 on Windows NT.

You must be logged in to Windows NT as the administrator to install the iPlanet Application Server Enterprise Connector for R/3.


To Install the R/3 Connector on Windows NT

  1. Read the README.txt file on the CD-ROM.

  2. Copy NT/inssap.zip from the CD-ROM into a temporary local directory.

  3. Unzip inssap.zip, then run setup.exe.

  4. Read the Welcome message and click on the Next button. See Figure 2-1.

  5. Follow the instructions on the screen to progress through the introduction.

Figure 2-1    Welcome Message

  1. Thoroughly read and understand the licensing information before installing, and accept the license agreement. See Figure 2-2.

Figure 2-2    Software License Agreement

  1. Choose your installation directory then click Next, see Figure 2-3.

Figure 2-3    Location of Installation


Note

You must install the iPlanet Application Server Enterprise Connector for R/3 in the same directory where you installed iPlanet Application Server.


  1. The Enterprise Connector for R/3 6.0 SP1 is selected see Figure 2-4. Click Next to continue.

Figure 2-4    Components to Install

  1. Type in your R/3 Host Name and System Number, and click Next.

Figure 2-5    R/3 Host Configuration

The Host Name is the R/3 Application Server Host Name.

  1. Enter the Gateway Host Configuration Parameters, see Figure 2-6, and click Next.

Figure 2-6    Gateway Configuration

Check Load Balancing if the R/3 Server is configured to use Load Balancing. If so, you will need to enter the System Name, Group Name and the Message Server.

  1. Enter the R/3 access configuration values and click Next, see Figure 2-7.

Figure 2-7    Access Configuration


Note

Consult your R/3 Guide for a list of values for the Language field.



  1. Review the configuration summary, see Figure 2-8. If it is correct, click Install.

Figure 2-8    Configuration Summary


Caution

You must restart your computer after you complete the installation.


  1. (Optional) These are the possible warning window(s) that can appear, if the installer detects that the iPlanet Application Server Enterprise Connector for R/3 is already installed. Choose Yes to overwrite the existing adapter type and all sample data source definitions shipped with the R/3 connector. User defined data sources are not overwritten. Select No if you are simply adding another iPlanet Application Server instance to an existing cluster.

    Confirm your decision.

Figure 2-9    Warning Windows

  1. Read the Completion of Installation window which is displayed when all files are installed. Click on the Finish button. The iPlanet Application Server Enterprise Connector for R/3 is now installed.

Figure 2-10    Completion of Installation Window

The machine must be rebooted and start the iPlanet Application Server before using the iPlanet Application Server Enterprise Connector for R/3.


To Uninstall the R/3 Connector from Windows NT

  1. Select Start > Programs - iPlanet Application Server 6.0 SP1 > Uninstaller. The iPLanet Uninstall Window is displayed. See Figure 2-11.

Figure 2-11    iPlanet Uninstall Window

  1. Deselect all components for iPlanet Application Server except iPlanet Application Server Enterprise Connector for R/3, then click Uninstall.

    The uninstaller checks for dependencies between subcomponents and the main component. If you try to deselect a component and its subcomponent are toggled on, a warning message appears.


To Deselect the Enterprise Connector for R/3

Deselect items in the following order:

  1. Deselect Netscape Server Family Core components.

  2. Deselect Administration Services.

  3. Deselect Netscape Directory Suite.

  4. Deselect UIF 6.0 SP1.


To Deselect the iPlanet Application Server

Deselect items as follows:

  1. Highlight the iPlanet Application Server 6.0 SP1 entry.

  2. Click the Sub Components button to display the options.

    Deselect options in the following order:

  3. Deselect Application Server 6.0 Core Binaries.

  4. Deselect Administrator Tool.

  5. Deselect Web Connector Plug-in Component.

  6. Deselect Deployment Tool.

  7. Deselect Core Server Component.

    Click the Continue button to return to the main uninstall menu.


Caution

If you do not follow the order of deselection above, alert messages are displayed and you may not be able to deselect the desired option


  1. Click Uninstall.

    A message is displayed. See Figure 2-12.

Figure 2-12    Uninstall Message

  1. Click OK to complete the uninstallation procedure.



Installing the iPlanet Application Server Enterprise Connector for R/3 on Solaris

The following procedures describe how to install and uninstall the iPlanet Application Server Enterprise Connector for R/3 on a Solaris Operating System.


Pre-installation

  1. Insert the iPlanet Application Server Enterprise Connector for R/3 Install CD-ROM into the CD-ROM drive.

  2. Mount the CD-ROM, for example, /cdrom/cdrom0.

  3. Read the README.txt file on the CD-ROM.


To Install the R/3 Connector on Solaris

  1. Copy the Solaris/inssap.tar file from the CD-ROM into a temporary local directory.

  2. Untar the inssap.tar file.

    For example: tar -xvf inssap.tar

  3. Run the ./setup command

    Follow the instructions of the installation program. During installation, press the following key sequences for:

    CTRL+B to back up to the previous screen.

    CTRL+C to cancel the installation program. This results in an incomplete installation. To install again, rerun the installation program from the beginning.

  4. Figure 2-13 is displayed. Either press enter or type Yes to continue.

Figure 2-13    Welcome Message

  1. Enter Yes.

    Figure 2-14 is displayed.

Figure 2-14    Software License Agreement

  1. Thoroughly read and understand the licensing information before installing, and then enter Yes.

    Figure 2-15 is displayed.

Figure 2-15    Component Selection

  1. Press Enter.

    Note The iPlanet Application Server and UIF must already be resident on your system. You must perform this step to proceed with the connector installation.


Figure 2-16 is displayed.

Figure 2-16    Location of Installation

  1. To accept the default shown in the brackets, press Enter.

    Otherwise, type in the required iPlanet Application Server installation directory, and then press Enter.

    Figure 2-17 is displayed.

Figure 2-17    Components to Install

  1. Press Enter.

    Figure 2-18 is displayed.

Figure 2-18    Additional Components

  1. Press Enter.

    Figure 2-19 is displayed.

Figure 2-19    Domain Name Selection

  1. Click Enter to accept the default or enter another name <host.domain.com>.

Figure 2-20 is displayed.

Figure 2-20    System User Selection

  1. To accept the default shown in brackets, press Enter.

    Figure 2-21 is displayed.

Figure 2-21    System Group Selection

  1. To accept the default shown in brackets, press Enter. Figure 2-22 is displayed. See Table 3-2 in Chapter 3 for a description of the parameters for the following screens.

Figure 2-22    Host Name Selection

  1. Enter the Host Name.

    Figure 2-23 is displayed.

Figure 2-23    System Number Selection

  1. Type in the System Number.

    Figure 2-24 is displayed.

Figure 2-24    Destination Entry

  1. Enter the destination.

    Figure 2-25 is displayed.

Figure 2-25    Gateway Host Configuration

  1. Enter the Gateway Host. The Gateway Host is an optional parameter.

    Figure 2-26 is displayed.

Figure 2-26    Gateway Service Configuration

  1. Press Enter or enter the Gateway Service.

    Figure 2-27 is displayed.

Figure 2-27    System Name Configuration:

  1. Enter the System Name. The System Name is used for the Load Balancing option.

    Figure 2-28 is displayed.

Figure 2-28    Group Name Configuration

  1. Enter the Group Name. The Group Name is used for the Load Balancing option.

    Figure 2-29 is displayed.

Figure 2-29    Message Server Configuration

  1. Enter the Message Server. The Message Server is used for the Load Balancing option.

    Figure 2-30 is displayed.

Figure 2-30    Load Balancing Option

  1. Enter Y for Load Balancing or N for no load balancing.

    Figure 2-31 is displayed.

Figure 2-31    Client Number Entry

  1. Enter the Client Number.

    Figure 2-32 is displayed.

Figure 2-32    Language Selection

  1. Enter the R/3 Language Code, for example EN for English.

    Figure 2-33 is displayed.

Figure 2-33    User ID Entry

  1. Enter the User ID to connect to R/3.

    Figure 2-34 is displayed.

Figure 2-34    Password Entry

  1. Enter the Password.

    Figure 2-35 is displayed.

Figure 2-35    Configuration Termination

  1. Press Enter to continue.

    Note

    After successful installation you can run the samples. Refer to Chapter 4 in the iPlanet Application Server Enterprise Connector for R/3 Developer's Guide.



To Uninstall the R/3 Connector from Solaris

  1. Go to the installation directory, /user/iplanet/ias6 and enter the following command:

    ./uninstall

    A list of uninstall options appears. Figure 2-36 is displayed.

Figure 2-36    Uninstalling Components.

  1. Select the specific product components you want to uninstall and click Enter. Figure 2-37 is displayed. Press Enter to uninstall all R/3 subcomponents.

Figure 2-37    Uninstalling R/3 Subcomponents.



Upgrading or Reinstalling Issues


If upgrading an earlier version or reinstalling the current version of the iPlanet Application Server Enterprise Connector for R/3, the installation procedure overwrites the currently installed files. Uninstalling the current version is not required.

Installation of multiple enterprise connectors for multiple EISs (CICS, Tuxedo, and PeopleSoft) on the same iPlanet Application Server is allowed.


Note

To avoid problems with overwriting files in use, close the iPlanet Application Server before installing any new software. Always backup the current files prior to installation including the UIF Repository content.




Post-Installation Issues


The following issues are described:


Activating the Samples through NT or Solaris

After installing the iPlanet Application Server enterprise Connector for R/3 you can verify that your installation succeeded and run the R/3 samples provided.

You can activate R/3 programs that access the R/3 management system by entering a series of commands through your operating system. For more information on how to activate and run the R/3 samples, see Chapter 4 of the iPlanet Application Server Enterprise Connector for R/3 Developer's Guide.


Copying Files in Webless Installation

In a webless installation, the web server and iPlanet Application Server reside on separate machine. In this configuration mode, the iPlanet Application Server Enterprise Connector for R/3 installation procedure will not automatically copy the index.html file pertaining to connector samples to web server document root directory.

To run the samples shipped with the R/3 Enterprise Connector, an index.html file must be copied manually from the iPlanet Application Server instance to web server instance.


To Copy Files to Run the Program Samples

  1. Create the R3Samples directory under the web server document root directory.

    For example, <iWS installdir>/docs/R3Samples.

  2. Copy the index.html file from <iASrootdir>/ias/APPS/adapters/htmldocs/sap/R3Samples directory to <iWS installdir>/docs/R3Samples directory on web server machine.


Launching the Daemon

To start working with the iPlanet Application Server Enterprise Connector for R/3, you must run the startR3worker process. The startR3worker process invokes the daemon. See High-level System Architecture.


To Launch the Daemon

  • At the terminal prompt enter the following command line:

    startR3worker.sh start

or

  • on Windows NT, select Start > iPLanet Application Server 6.0 SP1 > R/3 Connector Server > Start Worker Process.



Troubleshooting

The following problem may occur when installing the iPlanet Application Server Enterprise Connector for R/3 on the Solaris.


Problem

When the system is restarted between the installation of the iPlanet Application Server UIF and the R/3 Enterprise Connector, you may receive a segmentation fault during installation of the core components.

This may happen because the following temporary file is lost during the restart process:

/tmp/install.ini.iplanet


Workaround

Perform the following tasks:

  1. Open the following file:

    /tmp/install.ini.iplanet

  2. Add the following lines:

    [BSP]

    ServerRoot <exact path of the iplanet/ias6 directory>


Previous     Contents     Index     DocHome     Next     
Copyright © 2000 Sun Microsystems, Inc. Some preexisting portions Copyright © 2000 Netscape Communications Corp. All rights reserved.

Last Updated November 02, 2000