Show TOC

Integration Using the Java Proxy RuntimeLocate this document in the navigation structure

Procedure

The Java Proxy Runtime (JPR) handles the connectivity between Java proxies and the Integration Server. It converts data contained in Java proxy objects to XML messages and the other way round at runtime. For this purpose it requires information from both the exchange profile and the System Landscape Directory (SLD). More information about JPR: Java Proxy Runtime .

The JPR is installed with and integrated into the Adapter Engine. The Adapter Engine guarantees the quality of service Exactly Once (In Order) required for asynchronous messages and provides services for queuing, persistence, and monitoring of messages.

The JPR is integrated into AS Java as follows:

  • In the outbound case, an application uses proxy beans to send request messages and possibly receive response messages. The proxies in turn call the JPR to connect to the Adapter Engine which sends the messages to the Integration Server.

  • In the inbound case, a proxy server application is provided, which consists of an EJB bean handling the processing of incoming XI messages. This bean acts as a listener to the Adapter Engine, which receives the messages from the Integration Server, and in turn calls the application bean registered for the particular inbound interface.

    Note

    SAP NetWeaver AS for Java is the only Java server supported by JPR.

Settings in the Exchange Profile

The JPR uses the values of certain parameters from the exchange profile to determine system-wide settings. These values should have been set during installation of the Adapter Engine.

You access the maintenance screen at: http://<host:port>/webdynpro/dispatcher/sap.com/com.sap.xi.exprofui/XIProfileApp

The variables host and port are the hostname and connection port of the AS Java of your business system. Under Connection , the connection parameters of your Integration Server should appear. From there, all necessary profile data is copied to the AS Java Secure store.

Entries in the System Landscape Directory

In addition to the deployment of your client proxy classes on the AS Java of your business system, you have to create a business system instance in the SLD when implementing an outbound Java proxy scenario. This information is used by JPR to determine the sender service when creating an outbound message, and by the Adapter Engine to locate the address of the Integration Server when sending the message. More information: System Landscape Directory .

A JPR instance used by Java applications is represented in the SLD by a technical system of type AS Java and must be associated with a business system. The technical system is specified by a system name and the name of the AS Java host.

During installation of the Adapter Engine a technical system of type AS Java is created in the SLD. It contains the following values:

  • System Name (SID): C11

  • System Home: < your hostname >

Use the built-in wizard of the SLD to create a business system instance by specifying the following:

  • An arbitrary name

  • The type of the associated technical system ( AS Java )

  • The name of the associated technical system (to be selected from the dropdown list; C11 on < your hostname > in the above example)

  • The related Integration Server (to be selected from the dropdown list)

    Note

    This configuration data is accessible by JPR and the Adapter Engine only after the CPA cache on your AS Java has been updated.

Security Roles for the Java Proxy Runtime

  1. Use the SAP NetWeaver Administrator and choose Start of the navigation path Operations Management  Next navigation step  User and Access Management  Next navigation step  Identity Management End of the navigation path to assign the following security roles to the appropriate user groups as follows:

Security Role Assignments

Security Role

User Group

xi_jpr_register_bindings

SAP_XI_ADMINSTRATOR_J2EE

SAP_XI_DEVELOPER_J2EE

xi_jpr_list_bindings

SAP_XI_ADMINSTRATOR_J2EE

SAP_XI_DEVELOPER_J2EE

SAP_XI_CONFIGURATOR_J2EE

xi_jpr_admin

SAP_XI_ADMINSTRATOR_J2EE

SAP_XI_CONFIGURATOR_J2EE

Configuring an Inbound Service for the Java Proxy Runtime

This is an additional configuration step, which is only required if the JPR is to be used by inbound services, that is, by EJB beans implementing inbound interfaces on a Java application server.

More information: Configuring the Channel for Java Proxy Receivers .

Running a Non-Central Adapter Engine in Java Proxy Mode

The non-central Adapter Engine provides a configuration option called Java Proxy mode (JPR mode). In this mode, the adapter registration in the SLD is disabled so that the underlying system becomes a plain Java proxy application system (just like an ABAP system with ABAP proxies). The collaboration partner agreement (CPA) service no longer reads the CPA cache data from the Integration Directory.

In this case, you can use a service property to configure the user for sending messages to the Integration Server (outbound scenario). The Integration Server uses an access control list (ACL) to check receiving messages based on this configuration setting. The ACL check is always skipped when the Adapter Framework service user (usually PIAFUSER) is used for sending. More information: Service Users for Message Exchange .

To switch the Adapter Engine to JPR mode, perform the following configuration settings:

  1. Start the SAP NetWeaver Administrator.

  2. Choose Start of the navigation path Configuration Management  Next navigation step  Infrastructure Management  Next navigation step  Java System Properties  Next navigation step  Details  Next navigation step  Services End of the navigation path.

  3. Select the service XPI Service: CPA Cache .

  4. Set the value of the SLDAccess property to false .

  5. Save your settings and restart the service ( Start of the navigation path Start & Stop  Next navigation step  Java EE Services End of the navigation path).

  6. Make sure that the cacheType property still has the value DIRECTORY.

  7. Select the service XPI Adapter: XI and set the respective values (user, password, Integration Server URL, client, and language) for the properties xiadapter.isconfig.* .

  8. On the Integration Server, call transaction SMICM to ensure that you have maintained the correct Integration Server URL.

  9. On the Integration Server, call transaction SU01 to create the new user and assign it the role SAP_XI_AF_SERV_USER_MAIN. You can copy PIAFUSER for this purpose.

    Note

    If a password change is required, log on to the Integration Server with the new user and change the initial password. Otherwise the communication will fail.

  10. In the SAP NetWeaver Administrator, choose Start of the navigation path Operations Management  Next navigation step  User and Access Management  Next navigation step  Identity Management End of the navigation path to check whether the user created in the previous step is available on AS Java.

  11. Log on to the SLD and choose Start of the navigation path CIM Instances  Next navigation step  All Classes  Next navigation step  XI Adapter Framework End of the navigation path.

  12. Select your non-central Adapter Engine and remove it.