B Additional Information for SAP ABAP ERP Adapter

This appendix describes the privileges that are required for connecting to SAP System, how you can test the connection outside of ODI using a standalone java utility, and how to uninstall SAP components.

This appendix includes the following sections:

For more information about the SAP ERP KMs see Connectivity and Knowledge Modules Guide for Oracle Data Integrator.

B.1 SAP ABAP ERP Required Privileges

An SAP dialog user is required for connecting to the SAP system, for the RKM installation and for the LKM execution during development. A SAP RFC user is not sufficient.

During development, this user must have a developer license key. License keys can be retrieved from http://service.sap.com. Any execution attempts without this developer license key will lead to failure and may cause the need for clean-up operations.

For RKM and LKM execution in production, an SAP RFC user is sufficient.

These SAP user types can be used for the following operations:

Table B-1 Required SAP User Types

Operation Required SAP User Type

RKM: Setup

SAP Dialog user

RKM: Reverse Engineering

SAP Dialog user or SAP RFC user

LKM: Development

SAP Dialog user or SAP RFC user

LKM: Production

SAP Dialog user or SAP RFC user


The following tables list the privileges required for using SAP ABAP Knowledge Modules:

B.1.1 Important points to consider

Consider the following points while configuring the SAP privilieges:

  • S_DATASET is an authorization object that controls access to physical file, so you need to provide access to SAP directories & folder mounted path. The values provided here are sample paths, you need to provide your landscape directories path or provide *(all).

  • NR or (NR) means NOT REQUIRED.

B.1.2 Authorizations Required for RKM SAP ERP Upload

The following SAP authorizations are required for first time installation of the RKM SAP ERP.

Note:

Developer key is required in this authorization.

Object Field Name Value (4.6c) Value (4.7) Value (ECC 5) Value (ECC 6)

S_RFC

ACTVT

16

     
 

RFC_NAME

RFC1, SDIFRUNTIME, SUTL,SYST, ZODI_FGR

     
 

RFC_TYPE

FUGR

     

S_TCODE

TCD

SU53,SE38

     

S_ADMI_FCD

S_ADMI_FCD

MEMO,SM02

 

SM02 (NR)

NR

S_CTS_ADMI

CTS_ADMFCT

TABL

     

S_DATASET

ACTVT

34

     
 

FILENAME

\\HYPTEST01\sapmnt*

     
 

PROGRAM

SAPLSLOG, SAPLSTRF

     

S_TABU_DIS

ACTVT

03

   

NR

 

DICBERCLS

MA

   

NR

S_DEVELOP

ACTVT

01,02,03

   

16

 

DEVCLAS

$TMP, ZODI_LKM_PCKG, ZODI_RKM_PCKG

     
 

OBJNAME

Z$$$XRFC, ZODI_FGR, ZODI_FGR_PROD, ZODI_LKM_PCKG, ZODI_RKM_PCKG

     
 

OBJTYPE

DEVC,FUGR,PROG

     
 

P_GROUP

       

S_TRANSPRT

ACTVT

01,03

03 (NR)

   
 

TTYPE

DTRA,TASK

     

B.1.3 Authorizations Required for RKM SAP ERP Execution

The following SAP authorizations are required for reverse engineering the SAP models using RKM SAP ERP.

Object Field Name Value (4.6c) Value (4.7) Value (ECC 5) Value (ECC 6)

S_RFC

ACTVT

16

     
 

RFC_NAME

RFC1,SDIF,SYST,ZODI_FGR

SDIFRUNTIME, SDIF(NR)

SDIFRUNTIME, SDIF(NR)

SDIFRUNTIME, SDIF(NR)

 

RFC_TYPE

FUGR

     

S_TCODE

TCD

SU53

     

S_TABU_DIS

ACTVT

03

     
 

DICBERCLS

MA

 

CA,SC

 

B.1.4 Authorizations Required for LKM SAP ERP Upload (Background mode)

The following SAP authorizations are required for running mappings using the SAP ERP LKMs in a SAP development environment when LKM option BACKGROUND_PROCESSING is set to true (recommended default).

Note:

Developer Key is required in this authorization.

Object Field Name Value (4.6c) Value (4.7) Value (ECC 5) Value (ECC 6)

S_RFC

ACTVT

16

     
 

RFC_NAME

RFC1, SDIF, SLST, SYST, ZODI*, ZODI_FGR, ZODI_FGR_PROD*

SDIFRUNTIME, SDIF (NR)

SDIFRUNTIME, SDIF (NR)

SDIFRUNTIME, SDIF (NR)

 

RFC_TYPE

FUGR

     

S_TCODE

TCD

SU53

SE38

SE38

NR

S_BTCH_ADM

BTCADMIN

Y

     

S_BTCH_JOB

JOBACTION

RELE

     
 

JOBGROUP

'

     

S_CTS_ADMI

CTS_ADMFCT

TABL

     

S_DATASET

ACTVT

06,33,34

     
 

FILENAME

\\HYPTEST01\sapmnt*

     
 

PROGRAM

SAPLSLOG, SAPLSTRF, SAPLZODI*, ZODI*

     

S_DEVELOP

ACTVT

01

02,03,06,16

02,03,06,16

 
 

DEVCLASS

       
 

OBJNAME

ZODI_FGR_PROD*

ZANU*

ZANU*

 
 

OBJTYPE

FUGR

 

PROG

 
 

P_GROUP

       

S_PROGRAM

P_ACTION

NR

EDIT, SUBMIT, VARIANT

 

NR

 

P_GROUP

NR

   

NR

S_TRANSPRT

ACTVT

01,02,03

 

03 (NR)

03 (NR)

 

TTYPE

DTRA,TASK

     

B.1.5 Authorizations Required for LKM SAP ERP Execution (Background mode)

The following SAP authorizations are required for running mappings using the SAP ERP LKMs in a SAP production environment when LKM option BACKGROUND_PROCESSING is set to true (recommended default).

Object Field Name Value (4.6c) Value (4.7) Value (ECC 5) Value (ECC 6)

S_RFC

ACTVT

16

     
 

RFC_NAME

RFC1, SDIFRUNTIME, SYST, ZODI_FGR_PROD*

SLST

SLST

SLST

 

RFC_TYPE

FUGR

     

S_TCODE

TCD

SU53

     

S_BTCH_ADM

BTCADMIN

Y

     

S_BTCH_JOB

JOBACTION

RELE

     
 

JOBGROUP

''

     

S_DATASET

ACTVT

06,33,34

     
 

FILENAME

\\HYPTEST01\sapmnt*

     
 

PROGRAM

SAPLSLOG, SAPLSTRF, SAPLZODI*, ZODI*

(SAPLSLOG, SAPLSTRF, SAPLZODI*) NR

(SAPLSLOG, SAPLSTRF, SAPLZODI*) NR

(SAPLSLOG, SAPLSTRF, SAPLZODI*) NR


B.1.6 Authorizations Required for LKM SAP ERP Upload (Dialog mode)

The following SAP authorizations are required for running mappings using the SAP ERP LKMs in a SAP development environment when LKM option BACKGROUND_PROCESSING is set to false (non-default).

Note:

Developer Key is required in this authorization.

Object Field Name Value (4.6c) Value (4.7) Value (ECC 5) Value (ECC 6)

S_RFC

ACTVT

16

     
 

RFC_NAME

RFC1, SDIFRUNTIME, SYST, ZODI_FGR, ZODI_FGR_PROD*

     
 

RFC_TYPE

FUGR

     

S_TCODE

TCD

SU53,SE38

     

S_DATASET

ACTVT

06,33,34

     
 

FILENAME

\\HYPTEST01\sapmnt*

     
 

PROGRAM

SAPLSLOG, SAPLSTRF, SAPLZODI*, ZODI*

     

S_DEVELOP

ACTVT

01

02,03,06

02,03,06

 
 

DEVCLASS

       
 

OBJNAME

ZODI_FGR_PROD*

     
 

OBJTYPE

FUGR

PROG

   
 

P_GROUP

       

S_PROGRAM

P_ACTION

NR

EDIT, SUBMIT, VARIANT

EDIT, SUBMIT, VARIANT

NR

 

P_GROUP

NR

     

S_TRANSPRT

ACTVT

01

     
 

TTYPE

DTRA,TASK

     

B.1.7 Authorizations Required for LKM SAP ERP Execution (Dialog mode)

The following SAP authorizations are required for running mappings using the SAP ERP LKMs in a SAP production environment when LKM option BACKGROUND_PROCESSING is set to false (non-default).

Object Field Name Value (4.6c) Value (4.7) Value (ECC 5) Value (ECC 6)

S_RFC

ACTVT

16

     
 

RFC_NAME

RFC1,SDIF,SYST,ZODI*

SDIFRUNTIME, SDIF (NR)

SDIFRUNTIME, SDIF (NR)

SDIFRUNTIME, SDIF (NR)

 

RFC_TYPE

FUGR

     

S_TCODE

TCD

SU53

     

S_DATASET

ACTVT

06,33,34

     
 

FILENAME

*\\DEL-7TMK2BS\odiagentbox*, \\DEL-7TMK2BS\odiagentbox

     
 

PROGRAM

SAPLSLOG*, SAPLSTRF*, SAPLZODI*

     

B.2 SAP Connection Test

This connection test should be performed after configuring the SAP ABAP data server in the topology.

This test preforms the following operations:

  • It establishes a test connection to the configured SAP system.

  • It validates the proper setup of SAP JCo by displaying the About dialog.

This test is performed using an RKM called RKM SAP ERP Connection Test. This KM does not perform any reverse operation. It simply runs the connection test.

To run the connection test:

  1. Create an SAP ERP Model based on the SAP ABAP technology and on the SAP ABAP logical schema using the standard procedure, as described in "Creating a Model" of the Developer's Guide for Oracle Data Integrator.

  2. In the Reverse Engineer tab of the SAP ERP Model, select the RKM SAP ERP Connect Test.

  3. Save the model.

  4. Click Reverse-Engineer to start the reverse.

Within a few seconds, the SAP JCo About dialog should appear. If not, review the session execution log in the Operator Navigator. Please verify that the output of task "Test SAP Connection" contains Successfully connected to SAP System. If not, the connection test has failed and the connection problem must be analyzed.

B.3 SAP Stand-Alone Connection Test

In addition to the Connection Testing, a test can be performed outside of ODI using a standalone java utility. This utility is available with the Standalone agent.

To use a standalone java utility to test the connection:

  1. Open a command window.

  2. Go to the <ODI_HOME>/odi/sdk/lib directory.

  3. Make sure that JAVA_HOME points to a supported JVM.

  4. Make sure that you have installed SAP Java Connector and that the sapjco3.jar and the sapjco3 library are in the <ODI_HOME>/odi/sdk/lib directory.

  5. Launch the utility using the following command:

    On Windows:

    java -cp sapjco3.jar;odi-sap.jar oracle.odi.sap.km.test.JCoTest

    On Linux/UNIX:

    java -cp sapjco3.jar:odi-sap.jar oracle.odi.sap.km.test.JCoTest

    This command generates a ODI_SAP_CON_POOL.jcoDestination file in the folder <ODI_HOME>/odi/sdk/lib folder.

    For more information, see "Appendix C, SAP Stand-Alone Connection Test" in the Getting Started with SAP ABAP ERP Adapter for Oracle Data Integrator.

  6. Use a text editor to open the ODI_SAP_CON_POOL.jcoDestination file. This file should look as follows:

    #for tests only!
    jco.client.lang=EN
    jco.destination.peak_limit=10
    jco.client.client=800
    jco.client.passwd=<SAP Password>
    jco.client.user=<SAP User>
    jco.client.sysnr=00
    jco.destination.pool_capacity=5
    jco.client.ashost=<SAP Application Server>
    
  7. Enter you SAP connection information, which you have received from your SAP administrator.

  8. Launch the utility using the same command. The utility uses the file that you have edited, and outputs the test results or the possible issues.

    In addition to just testing the SAP connection, the utility will also validate the existence of certain Function Modules required for the RKM. These are installed during first execution of the RKM (UPLOAD_ABAP_BASE and UPLOAD_ABAP_CODE set to true).

  9. Delete the ODI_SAP_CON_POOL.jcoDestination file after execution, as it contains the SAP login credentials.

B.4 Updating ODI SAP Components

During first-time installation the RKM installs some ODI objects into the SAP system. This installation consists of two parts: some base objects and some RFCs. When the RKM options UPLOAD_ABAP_BASE and UPLOAD_ABAP_CODE are both set to true, the base objects and the RFCs are installed. Such full installation requires that no ODI SAP objects are installed in the SAP system.

See Uninstalling ODI SAP Components for information about how to uninstall ODI SAP Components if needed.

If the ODI objects installed into your SAP systems have been installed by RKM SAP ERP v32 or later, or RKM SAP BW v23 or later, there is no need for reinstalling the base objects and it is sufficient to update just the RFCs. Reinstalling the RFCs is achieved by executing a reverse engineering with the RKM option UPLOAD_ABAP_BASE set to false and RKM option UPLOAD_ABAP_CODE set to true.

B.5 Uninstalling ODI SAP Components

For removing ODI connectivity from the SAP system, please follow the steps described in this section.

Please note that this will delete ALL components including generated extractor programs.

To upgrade to a newer ODI SAP Connector release or to permanently remove the ODI connectivity:

  1. Start the SAP GUI.

  2. Connect to the SAP systems you want to uninstall.

  3. Go to the transaction SE80.

  4. Select the package or development class option from the drop down box.

  5. Enter ZODI_RKM_PCKG in the package or development class field. Note that for older installations the package name is ZODI_DEVCLASS.

  6. Right-click the ZODI_RKM_PCKG object below the object name tab.

  7. Select Delete in the drop down menu and delete the development class.

    If it does not allow deleting the development class individually, delete all the objects one by one and then delete the development class.

  8. Go to transaction SE10. Select Modifiable and Workbench Requests. Click Display.

  9. Select the transport requests which have the ODI Objects and Release them.

  10. Now repeat the steps 3 to 7 to delete Development Class.

  11. Go to transaction SE01. Select Modifiable and Workbench Requests. Click Display. Release the Transport Request which has ZODI_DEVCLASS.

  12. Repeat the above steps for package name ZODI_LKM_PCKG. This applies only to the installations done by RKM SAP ERP v32 or later.