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 (sender adapter) and outbound processing (receiver adapter) by the Integration Engine.
You can configure the following adapters:
● SOAP adapter (sender or receiver)
The Adapter Engine also provides you with services that can be used by all adapters and that are also partially configurable. These changes are:
● 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
● A test environment
●
Access to the
SAP System
Landscape Directory
● An HTTP(S) server for the receiver 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:
● Adapter
● Documentation (see below)
● Services
● Traces (see below)
● Test Environment).
● About the Adapter Engine
● 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.
Log Files
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.
About the Adapter Engine
Here information about the installed version of the Adapter Engine and the Java runtime environment used is displayed.
Users with the role Administrator can set the default setting for the way that the graphical user interface of the Adapter Engine is displayed. You can choose between SAP Web and SAP GUI. The setting you make here becomes the standard view for all other users provided that a different user interface has not been selected in the user settings.
Changes to the graphical user interface take immediate effect. However, depending on the browser cache settings, certain parts of the old display may remain visible until they are loaded again, or until the browser is restarted.
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 or Restart Adapter Engine
This menu option is only available for users with the Administrator role.
● Shutdown Adapter Engine
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
● Restart Adapter Engine
This cancels the current Adapter Engine process and starts a new process.
The adapters have the same status as if they had been stopped. Previously initialized and stopped adapters are initialized; previously started adapters are restarted.
After the restart of the Adapter Engine, log on for the first action in the browser.
To restart the Adapter Engine, you must be running the Adapter Engine with the delivered script run_adapter.bat or run_adapter.sh. The scripts execute the restart, not the Adapter Engine process itself.
If you start the Adapter Engine with other scripts or as a Windows service, for example, the restart function is not available and is not displayed on the interface.
Result
You have configured the selected adapters. To use the existing test environment to test the conversion of the respective message formats, choose Test Environment in the Overview screen.