The follwing section contains an overview of the BOARD Connector server.

The server performs two main tasks:

  • Run extractions stored in the Config directory.
  • Make extractions stored in the Config directory available to the designer.

1. Run Extraction on the Server #

Execution is triggered by an HTTP request. The HTTP request is triggered from the target environment.

Tip: The process can be traced in the Extraction Log.

  1. Server checks the authentication and authorization of the request.
  2. The target environment is prepared for writing the extracted data (e.g. establish database connection, create file).
  3. The license is checked.
  4. A connection to the SAP system defined in the source is established.
  5. The data of the defined extraction type is requested.
  6. Each extracted data package is written to the target environment.
  7. After all packages are received, the connection to the SAP system is terminated and the target environment is informed that the extraction is complete.

2. Access the Settings using the Designer #

  1. BCConfigServer.exe checks the authentication and authorization of the request.
  2. Designer requests a certain setting, e.g., list of all extractions.
  3. BCConfigServer.exe reads the requested settings from the Config directory and sends these settings to the Designer.
  4. The user changes the settings in the Designer (e.g., destination settings).
  5. Designer sends the changed settings back to BCConfigServer.exe. BCConfigServer.exe saves the changed settings in the Config directory.

Server Architecture #

The server runs as a Windows Service and the main process of the XU Service is BCService.exe. The Windows Service can be managed via the Windows Services administration or the Task Manager. BCService.exe starts two listener processes:

  • BCWebServer.exe
  • BCConfigServer.exe

Tip: The BCService.exe logs its actions in ServiceLog.txt The log file is located in the logs subdirectory of the program directory: ‘C:ProgramFiles\BOARDConnector\logs’ (default).

The both listener processes listen on the Ports defined in the Server Settings.

BCConfigServer.exe waits for new connection requests from the designer.

Tip: The BCConfigServer.exe logs its actions in log files. The log files are located in the logs subdirectory of the program directory: ‘C:ProgramFiles\BOARDConnector\logs\server\config’ (default).

BCWebServer.exe waits for HTTP requests.

For each TCP connection the BCWebServer.exe starts a new instance of BCRun.exe, which processes all HTTP requests coming in over this TCP connection.

Tip: The BCRun.exe logs its actions in the log subdirectory. The log files are located in the logs subdirectory of the program directory:C:ProgramFiles\BOARDConnector\logs\server\run (default) These are also the logs that can be displayed in the Designer under [Server]>[Logs].

The following HTTP requests are possible:

  • Executing an extraction
  • Emptying the result cache of an extraction
  • Canceling all runs of an extraction
  • REST API requests e.g., Logs, Metadata etc.

Tip: The XtractWebServer.exe logs its actions in log files. The log files are located in the logs subdirectory of the program directory: ‘C:ProgramFiles\BOARDConnector\logs\server\web’ (default).

More information about the server can be found in the following sections:

Start Server

Ports

Server Settings