Configuration (SAP Library - SAP Exchange Infrastructure (BC-XI))

Configuration

Purpose

You need to configure the available adapters so that you can use them to convert the respective message formats. Using the intended Adapter Engine, you can configure adapters individually or together as required, but always separately for inbound processing (inbound adapter) and outbound processing (outbound adapter) by the Integration Engine.

You can configure the following adapters:

Inbound File Adapter

Outbound File Adapter

Inbound JDBC Adapter

Outbound JDBC Adapter

Inbound JMS Adapter

Outbound JMS Adapter

SOAP Adapter (Inbound or Outbound)

The Adapter Engine also provides you with services that can be used by all adapters and that are also partially configurable. This includes the following:

An HTTP(S) server for browser-based configuration

Central user management

A central storage location for passwords that are required in adapter configurations

Option of displaying additional log data when searching for errors

Test screens

Access to the System Landscape Directory

An HTTP(S) server for the outbound adapter

Prerequisites

You have successfully installed the Adapter Engine and the required adapters , started the Adapter Engine and called it using you web browser and are now in the Overview section of the Adapter Engine configuration screen.

Process Flow

The Main Menu of the Adapter Engine configuration screen comprises the following menu options that you can call with a single mouse-click:

Adapters

Documentation (see below)

User Management

Password Management

Services

Traces (see below)

Test

Log Off Current User (see below)

Shutdown Adapter Engine (see below)

Documentation

Here you find the available language versions of the Adapter Engine documentation in PDF format. To open a document, ensure that you have a suitable viewer installed then click the mouse button once.

Traces

This menu option is only available for users with the Administrator role.

Choose Traces to display the internal traces of the adapter engine. The contents of these files are essentially only required by the SAP Hotline for the detailed analysis of problems and are not necessary for the day-to-day operation of the Adapter Engine. For this reason, this section is not documented.

In the standard configuration, five files are written, each 2MB in size. The current file can be identified from the time stamp. If required, the most recent 10 MB of trace information for the Adapter Engine is available here. The size or number of these files and the scope of the information is controlled by the file logging.properties in the directory tech_adapter. You must only change this file if requested to do so by the SAP Hotline.

To display a trace file, click the file name. The file is displayed as a Text/Plain document. It is displayed in a text viewer or directly in the browser, depending on the configuration of the browser.

Log Off Current User

Choose this menu option to log off the current user. Note that this action merely logs the user off the configuration screen; the adapter status remains unchanged.

Shutdown Adapter Engine

This menu option is only available for users with the Administrator role.

Choose this menu option to shutdown the Adapter Engine completely. To restart the Adapter Engine you must run the script run_adapter, as described in the installation procedure. Since you need to log on to the Adapter Engine host locally to do this, you can only shutdown the Adapter Engine from a browser started on the same host. To confirm that the Adapter Engine has been shutdown, the system displays the following text:

Adapter Engine shutdown, restart with script XXX

XXX is the script name including the complete path.

Once you have shutdown the Adapter Engine, you can no longer perform any actions in the menu options because the respective HTTP server no longer exists. Any attempt to do so triggers the following HTTP error:

The page cannot be displayed

Result

You have configured the selected adapters. To use the existing test environment to test the conversion of the respective message formats, choose Test in the Overview screen.