Installing the connector

After your WebSphere business integration system has been installed, you can install additional adapters from the product CD at any time. To do this, insert the product CD, run the installation program, and choose the adapters that you want to install.

Note:
Unless otherwise indicated, the remaining sections in this chapter apply to both Windows and UNIX installations of the connector.

The IBM WebSphere Business Integration Adapter for mySAP.com connector can be installed on a UNIX or Windows machine. The connector consists of three parts that need to be installed: the connector's application-specific component, SAP's RFC library, and any SAP transport files delivered with the product and required to support the connector.

After you have installed the required connector files, you must download and install the Java Connector (SAPJCo) files. For more information on downloading the SAPJCo files, see see Installing the SAP JCo. For more information on installing the SAPJCo files, see Installing the SAP JCo.

Installing on a UNIX system

To install the connector on a UNIX system, run the Installer for IBM WebSphere business integration adapter, and select mySAP.com IBM WebSphere Business Integration Adapter for mySAP.com. Table 1 lists the files used by the connector that runs in a UNIX environment.

Table 1. WBIA: UNIX file structure
Directory/Filename Description
connectors/SAP/bapi/client Directory containing the BAPI Module business object handler files
connectors/SAP/bapi/server Directory containing the RFC Server Module business object handler files
connectors/SAP/dependencies Directory containing all version-specific transport files
connectors/SAPmessages Directory containing the SAPConnector.txt file
connectors/SAP/samples Directory containing sample ABAP objects
connectors/SAP/utilities Directory containing the generatedfiles subdirectory, into which you can put files generated by SAPODA
connectors/SAP/CWSAP.jar Connector class files
connectors/SAP/start_SAP.sh System startup script for the connector.

This script is called from the generic connector manager script. The product installer creates a customized wrapper for this connector manager script.

When the connector works with WebSphere InterChange Server, use this customized wrapper to start and stop the connector. When the connector works with WebSphere MQ message brokers, use this customized wrapper only to start the connector; use mqsiremotestopadapter to stop the connector

repository/SAP Directory containing the sap_idoccontrol.xsd file
/lib Contains the WBIA.jar file
/bin Contains the CWConnEnv.sh file
/bin/Data/app Contains the SAPConnectorTemplate file

Before you can use the connector, you must configure the connector from the installer's Connector Configuration screen. From this screen:

Note:
For more information on installing the connector component, refer to the WebSphere Business Integration Adapters Installation Guide.

Installing on a Windows system

To install the connector on a Windows system, run Installer for IBM WebSphere Business Integration Adapter, and select mySAP.comIBM WebSphere Business Integration Adapter for mySAP.com. The installer installs standard files associated with the connector. Table 2 lists the standard files installed in a Windows environment.

Table 2. WebSphere Business Integration Adaptor: Windows file structure
Directory/filename Description
connectors\SAP\bapi\client Directory containing the BAPI Module business object handler files
connectors\SAP\bapi\server Directory containing the RFC Server Module business object handler files
connectors\SAP\dependencies Directory containing all version-specific transport files
connectors\SAPmessages Directory containing the SAPConnector.txt file
connectors\SAP\samples Directory containing sample ABAP objects
connectors\SAP\CWSAP.jar Connector class file
connectors\SAP\start_SAP.bat Batch file used to start the connector
repository\SAP Directory containing the CN_SAPSAP.txt file
\lib Contains the WBIA.jar file
\bin Contains the CWConnEvn.bat file

The installer adds a menu option for the connector's application-specific component to the IBM WebSphere business integration adapters menu. For a fast way to start the connector, create a shortcut to this component on the desktop.

Note:
For more information on installing the connector component, refer to the WebSphere Business Integration Adapters Installation Guide.

Installing the SAP JCo

After you install the connector and confirm that all the files have been installed to the appropriate directories, you must download and install the SAP JavaAPI. This is a prerequisite for the SAPODA, which is described in Generating business object definitions using SAPODA.

SAP calls their Java API the Java Connector (SAP JCo). The connector for SAP currently supports SAP JCo V.2.1.3.

  1. Download the SAP JCo for the operating system on which your connector is running. The SAP JCo is available for download from SAP's website at http://service.sap.com/connectors. You must have an SAPNet account to access the SAP JCo (if you do not already have one, contact your local SAP Basis administrator).

    If the SAP JCo version that the connector supports is not available for download from SAP Service Marketplace, please check the most current adapter patch notes for the latest version of JCo that is supported or contact your IBM representative.

  2. Copy the following unzipped SAP JCo files into your environment:

    UNIX:

    From the zipped file, extract the executable jar file (sapjco.jar) and the runtime libraries (librfccm and libsapjcorfc).

    If you have already followed instructions for installing the adapter on the same machine on which you install SAPODA, copy these files from the \connectors\SAP directory to the \ODA\SAP directory. If you install SAPODA on a different machine from the connector, after you unzip the SAP JCo files, copy these three files to the \ODA\SAP directory.

    Windows:

    From the zip file, extract the executable jar file, (.jar extension) and the runtime libraries (.dll extension). If you have already followed instructions for installing the adapter on the same machine on which you install SAPODA, copy these files from the \connectors\SAP directory to the \ODA\SAP directory.

    If you install SAPODA on a different machine from the connector, after you unzip the SAP JCo files, copy these three files (librfc32.dll, sapjco.jar, and sapjcorfc.dll) to the \ODA\SAP directory. For Windows, the librfc32.dll requires one or more C runtime dlls. The C runtime dlls depend on the version of the SAP release being used.

Installing connectors on remote machines

You can install and run the connector on a remote machine. Install the integration broker on one machine and the connector on another machine. It is recommended but not required that both machines be on the same subnet.

Installing multiple connectors

To enable the integration broker to handle multiple business objects for SAP at the same time, you may want to install and configure multiple connector components for an SAP system and customize each connector to handle specific business objects.

Each connector component can subscribe to certain business objects depending on their type (such as Customer or Purchase Order). Because you can have multiple connectors accessing the same SAP application, each connector can process events and pass them on to the integration broker. In addition, multiple connectors can support multiple business object requests at the same time. This increases throughput and speeds up the transfer of data into and out of the SAP application.

It is recommended that you choose a unique naming convention for each connector component. For example, if you are using two connectors you could name them SAP1Connector and SAP2Connector.

To install and set up multiple connector components, do the following:

  1. Install each of the connectors as described in this chapter. This includes the connector shared library files. Give a unique name to each connector you install, and verify that you have the supporting connector files.

    If you are installing multiple connectors on the same machine, you need only make a copy of the shared library files and rename them. You do not need to install the transports again.

  2. Create a copy of the startup script:
  3. Make a copy of the connector template, rename it to match the new connector name, and then copy it to the repository directory (if IBM WebSphere MQ Integrator is the integration broker), or load it into the IBM WebSphere repository (if the IBM WebSphere InterChange Server is the integration broker).
  4. Make a copy of the connector class file, CWSAP.jarand rename it to the unique connector name, such as CWSAP1.jar.
  5. Initialize the connector configuration properties so that all connectors poll the same SAP application for events.
  6. Only if the IBM WebSphere InterChange Server is the integration broker, add map references for each connector.
  7. Specify the business objects supported by each connector.
  8. Only if WebSphere InterChange Server is the integration broker, assign collaborations to the appropriate connectors. Currently, a collaboration can be handled by only one connector. If collaborations are already set up, you may need to stop them and then rebind the ports.
  9. If you are using the ABAP Extension Module for business object handing, set up the distribution of events to each connector that you install. Use IBM CrossWorlds Station (transaction /nYXR1). See Setting up event distribution for instructions on setting up event distribution for each combination of business object, integration broker, and connector.

Important:
If a business object is not configured to go to a particular connector, the business object is sent to the next connector that polls for events. If a business object is configured to go to a particular connector, as for example during the testing phase, but the connector is not used in the production phase, the event queue for the connector fills up. To remedy this situation, delete the connector/business object configuration in the Event Distribution window (transaction YXRH).

Copyright IBM Corporation 1997, 2004. All Rights Reserved.