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.
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.
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
Before you can use the connector, you must configure the connector from the installer's Connector Configuration screen. From this screen:
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.
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.
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.
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.
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.
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:
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.