Default style (Cherry Eve). Switch styles (Capricorn). Atom Feed Calendar
http://blogs.sun.com/artf/date/20080717 Thursday July 17, 2008

Configuring the Sun Java System Mobile Enterprise Platform 1.0 for access to a SAP EIS backend

The Sun Java System Mobile Enterprise Platform 1.0 (MEP) is a comprehensive mobility solution that enables offline data access, data synchronization, and secure access to EIS/EAI applications, such as Siebel and SAP. See announcement here for additional info about MEP. This blog will focus on the steps needed to configure the MEP gateway for access to a SAP EIS backend. Our SAP installation was based on SAP ERP 6.0 SR3 release. The configuration requires 7 easy steps listed below. This configuration setup assumes single-tier installation.

Step 1: Download the SAP Libraries and Install into your Application Server

The SAP Java Connector toolkit (SAP JCo) is a middleware component that enables the Sun JCA Adapter for SAP to communicate directly with SAP. This component is required by the SAP BAPI OTD Wizard, which you use when you develop an Enterprise Connector that accesses a Sun JCA Adapter.

  • Log in to SAP site (http://service.sap.com/connectors) using your authorized user ID login as a SAP Licensed Customer
  • Click SAP Java Connector.
  • In the left-hand menu, click Tools and Services.
  • Download the SAP JCo archive file for your operating system.
  • Unzip the archive file into a directory of your choice. Archives are either as(.tgz or .zip) files:
    • For UNIX Tar File GZipped '.tgz': 'gunzip' followed by 'tar -xvf'
  • After you unzip the archive, you will find a JAR file named sapjco.jar. You will also find some library file(s) with '.so' or '.dll' extension based on your platform.
  • Copy all these files into the Application Server lib directory where your MEP gateway is installed. This directory is AS_HOME/lib, where AS_HOME is the directory where you installed the Sun Java Mobile Enterprise Platform 1.0:
    • On Solaris/Linux: cp sapjco.jar *.so $AS_HOME/lib
    • On Windows: cp sapjco.jar *.dll %AS_HOME%/lib

Step 2: If you are using a 64–bit JDK, add a JVM setting

NOTE: If you are not using a 64-bit JVM you can skip this step.

  • Login to GlassFish admin console (i.e. http://hostname:4848) (where hostname is either the name of the MEP host or localhost). The admin password is the one you specified for the MEP domain during installation.
  • In the tree view, select the Application Server node.
  • Click the JVM Settings tab, then click the JVM Options sub-tab.
  • Click Add JVM Option.
  • In the Value field, type -d64.
  • Click Save.
  • Stop and Restart the Application Server for these changes to take affect

Step 3: Configure a Connector Connection Pool for SAP

In order to configure a SAP Connection, using the SAP Resource Adapter for SAP, a Connector connection pool and a Connector resource needs to be created in the application server. This and the following step show how to do this:

  • Login to GlassFish admin console.
  • Click on Resources->Connectors->Connector Connection Pools->New

Fill in the connector connection pool Name and select the SAP Resource Adapter as shown in screen shot below and than click Next:




The next screen we accept all the default settings and click Finish to create this connector connection pool:



Step 4: Configure a Connector Resource for the SAP pool above

  • Click on Resources->Connectors->Connector Resources->New

Fill in the connector resource JNDI Name and Pool Name as shown in screen shot below and than click OK



Step 5: Configure CAPS connection for SAP

The following SAP Client Connection Settings are necessary for SAP configuration. All other parameters you can accept the defaults. The installation parameters which are specific to your SAP installation are marked 'Yes' in the 3rd column of the table. You will need to obtain the proper values for these installation parameters from your SAP administrator responsible for your SAP installation.

NameValueInstallation Parameters
Client Connection ModeManualNo
Application Server Hostnamemep-2Yes
System Number00Yes
Client Number001Yes
UsermepYes
PasswordmeppassYes
LanguageENYes
System IDQE1Yes

To configure these settings do:

  • Click on CAPS->Connector Connection Pools->sappool
Enter the above values for the Client Connection Settings. See the following screen shots for details:






Step 6: Create a connector Tab for SAP within the MEP gateway admin console and configure proper settings

For the MEP 1.0 release the only pre-configured connectors are MusicDb and Siebel. There is full SAP support within the product but it must be turned on. Follow the procedure below to configure the MEP gateway for the SAP connector:

  • Login to MEP gateway admin console(http://hostname:8080/sync/admin). The default user name is admin and password is syncpass.
  • Click on Connectors Tab
  • In the Local JCR Repositories panel enter SAP in the Name field and click Add
  • Click on SAP connector Tab just added to configure property settings
  • After adding correct property settings click Save

The following screen shot shows the configuration of the connector tab. The following values partially cutout from screen shot are supplied here:

  • Class/JNDI Name -> com.sun.mep.connector.jcr.DbRepository
  • business-object-provider -> com.sun.mep.connector.sapeway.customer.CustomerProvider



Step 7: Register a User for SAP to test out your SAP configuration

  • Click on Users->Create User Tab within MEP gateway admin console
  • Add an Email/User/Password for your SAP User and make sure you choose SAP Enterprise Connector
  • Click Register

If SAP is configured correctly your sap user should be created without errors. See the following screen shot for details:




That is all there is to configure MEP gateway for SAP.