3 Configuring the Topology

This chapter describes how to configure the topology by using a practical example.

This project will integrate the following source and target data:

Source tables T005T and T005U are the tables from SAP containing geographical information.

Target W_GEO_DS is a dimension table in an Oracle database that needs to be loaded from the SAP Sources. This table contains geographical information such as Continent name, Country name, Region, State, County, City and Zip code.

This chapter includes the following sections:

Configuring the File Server for SAP ABAP

Perform the following operations after installing or upgrading your Oracle Data Integrator version:

  1. Connect to Topology Manager.

  2. If this SAP ABAP technology does not exist in your Master Repository, import the SAP ABAP technology in Synonym INSERT_UPDATE mode from the /impexp folder.

  3. Perform an upgrade of the Master Repository. Refer to the Installing and Configuring Oracle Data Integrator for more information on the Master Repository upgrade process.

  4. In Topology Manager, open the JavaBeanShell technology and check on the Language tab that the JYTHON language is listed. If not, add it.

  5. Create a File data server pointing to an existing FTP/file server into which the extraction file will be pushed from SAP and picked up for SQL*Loader. For use with FTP transfer, set the following parameters. For use with shared folder transfer, the settings on this data server do not matter.

    • Host (Data Server): FTP server IP host name or IP address.

    • User: Username to log into FTP server.

    • Password: Password for the user.

  6. For use with "LKM SAP ERP to SQL" these additional parameters must be configured:

  7. In this File data server create a Physical Schema representing the folder in the File server to which the extraction file will be pushed. For use with FTP transfer, see details below. For use with shared folder transfer and for more details, see "Transfer using a Shared Directory (recommended)" of Application Adapters Guide for Oracle Data Integrator.

    • Data Schema: Path on the FTP server to upload or download extraction files from the remote location. This path is used when uploading extraction files from the SAP ERP system into the FTP server. It is also used by a remote agent to download the extraction files. Note that this path must use slashes and must end with a slash character.

    • Work Schema: Local path on the FTP server's machine. This path is used by an agent installed on this machine to access the extraction files without passing via the FTP server. This access method is used if the FTP_TRANSFER_METHOD parameter of the LKM SAP ERP to Oracle (SQLLDR)/ LKM SAP ERP to SQL is set to NONE. As Work Schema is an OS file name, slashes/ backslashes should be used according to OS.

      Path names need to end on slash/ backslash. Path names given on Data and Work schemas are not necessarily the same: the FTP service may provide access to a FTP directory named /sapfiles while the files can be stored locally in c:\inetpub\ftproot\sapfiles.

    Refer to "File Transfer Considerations" of Application Adapters Guide for Oracle Data Integrator.

  8. If the corresponding Logical Schema called File Server for SAP ABAP does not exist yet, create it. This Logical Schema name is fixed and must be mapped to the Physical Schema created in the previous step.

Configuring the Target Data Server

This section describes how to setup an Oracle Data Server. Please use respective settings when configuring a non-Oracle Target Data Server for use with LKM SAP ERP to SQL.

  1. Connect to Topology Manager.

  2. In the Physical Architecture tree view, expand the Technologies node and select the Oracle technology.

  3. Right-click and select New Data Server.

  4. Enter the data server Definition as shown below:

    Description of image004.jpg follows
    Description of the illustration image004.jpg

  5. Select the JDBC tab, and enter the JDBC connection information to your data server as shown below:

    Description of image006.jpg follows
    Description of the illustration image006.jpg

    Make sure to change the URL to match your Oracle instance configuration.

  6. Click Test Connection to test the connection to this data server.

  7. From File menu, click Save.

  8. Right-click the data server you created and select New Physical Schema.

  9. In the Physical Schema windows that appears, select the ODI_SAP_DEMO for both Schema and Work Schema.

    If you already have a Work Schema for ODI defined for this data server, you can use it instead of the ODI_SAP_DEMO Schema.

  10. Go to the Context tab.

  11. Click Add and enter in the Logical Schema field the value ODI_SAP_DEMO.

  12. From the File menu, click Save.

Configuring the SAP Source Server

The following topics describe how to configure the SAP source server:

Configuring the Data Server

Except for the data server name, all the parameters that you provide while defining the SAP Data server should be provided by the SAP Administrators. See "Setting Up the SAP System" for more information.

The SAP Adapter requires privileges to perform set up and execution operations. Please provide your administrators with the list of privileges listed in B1. SAP ABAP ERP Required Privileges in Application Adapters Guide for Oracle Data Integrator. These privileges are required for the SAP user that they will provide you to login the SAP System.

See "Gathering SAP Connection Information" for more information about these parameters.

  1. In the Physical Architecture tree view, expand the Technologies node, select the SAP ABAP technology.

  2. Right-click and select New Data Server.

  3. Enter the data server definition. Set the parameters for this data server as follows:

    • Name: SAP_ERP. The name of the data server as it will appear in ODI.

    • Host (Data Server): SAP ERP System IP Address or Hostname.

    • User: SAP User, as provided by the SAP Administrator.

    • Password: This user's SAP Password. This password is case-sensitive.

  4. Set the Flexfield values for this data server in the Flexfields tab:

    • SAP Language: Code of the language used when logging in. For example EN for English, DE for German.

    • SAP Client Number: The three-digit number assigned to the self-contained unit which is called Client in SAP. A Client can be a training, development, testing or production client or represent different divisions in a large company.

    • SAP System Number: The two-digit number assigned to a SAP instance which is also called Web Application Server or WAS.

    • SAP System ID: The three-character, unique identifier of a SAP system in a landscape.

    • SAP Character Set: The character set is only required if your SAP system is not a UNICODE system. For a complete list of character sets, see "Locale Data" in the Oracle Database Globalization Support Guide. For example, EE8ISO8859P2 for Croatian Data. For UNICODE systems, use UTF8.


      This FlexField is only used with "LKM SAP to Oracle (SQLLDR)". For use with "LKM SAP to SQL" please define the character set using the ENCODING parameter in the file driver URL, as described in "Configuring the File Server for SAP ABAP" for non-UNICODE SAP systems.
    • SAP ABAP Version: Enter the SAP ABAP version as follows:

      • For SAP 4.6C enter 46C

      • For SAP 4.7 enter 620

      • For SAP ECC 5.0 enter 640

      • For SAP ECC 6.0 enter 700

    • SAP BW Version & SAP ERP Version: unused in SAP ERP Connector.

    • SAP Transport Layer Name: This transport layer is used by ODI to create any new transport requests. The default transport layer name is SAP. If the SAP system uses a different transport layer, this FlexField must be updated accordingly. Otherwise, any TR creation will fail.

  5. From the File menu, click Save.


    The Test Connection button for validating SAP Connection definition is not supported for this connection.

Configuring the Logical Schema

  1. In the Physical Schema window, do not edit the Definition tab.

  2. Select the Context tab, click Add and enter the Logical Schema name LOGICAL_SAP_ERP.

    Description of image016.jpg follows
    Description of the illustration image016.jpg

  3. From the File menu, click Save.