SAP Disclosure Management 10.1 – Installation / Configuration of Task Engine

Introduction

The Task Engine is used to perform long-running and resource-consuming tasks in SAP Disclosure Management. The task engine is a Microsoft Windows service that enables you to decouple resource-consuming tasks from the SAP Disclosure Management server application running on IIS, thus avoiding performance impairments when working with SAP Disclosure Management.

Installation

1. Installation file

From the initial downloaded files (see Installing SAP Disclosure Management 10.1) go to the \DATA_UNITS\DM_SERVER_APPL_SERVER_10_1 subfolder and execute the file

2. Installation wizard welcome screen

Ensure you are installing the Task Engine

3, The prerequisites

4. The installation folder

By default, the Task Engine will be installed in C:\Program Files\SAP\SAP Disclosure Management TaskEngine\

5. Specify the database that the TaskEngine will use

Note: this obviously has to be the same as the main DM application server is using

6. Define user/password for access to the database

It is recommended to use the same user and password as the DM application server is using

7. Installation completes successfully

What has been installed?

1. The required files are installed (C:\Program Files\SAP\SAP Disclosure Management TaskEngine\)

Within this folder, there is a configuration file, called “SAP.DM.TaskEngine.Console.exe.config”

This has a BaseAddress (URL to be used later)

2. In the Windows Services, the Task Engine is listed (and should be started)

3. The Task Engine uses the DM web-services

These web-services were installed by the DM application server installation. You can check in IIS, under the DM website there is a folder called Webservices and this contains 1 subfolder called PublicAPI.

Within this, there is one WCF service file called “DataImport.svc”

If you browse this file, you should get the following page – this indicates the web-services are running

Configuring the Task Engine

In the DM application, some settings need to be configured for the Task Engine

1. System configuration

In Administration, System configuration, open the ‘Miscellaneous’ tab

Specify the Task Engine web services URL (see step 1 of the previous section)

Note: the 2605 port is not mandatory, you can change this (both in the “SAP.DM.TaskEngine.Console.exe.config” file and in this tab)

2. Landscape

Specify the IP (server name or FQDN) and port

3. Check the logs

In the Administration, Log files, you should have access to the “Log files task engine”

Note: the log files are physically stored on the application server and you can control this by setting the path in the “Log.config” (in C:\Program Files\SAP\SAP Disclosure Management TaskEngine)

Verifying the Task Engine

To test that the Task Engine is working correctly, you must perform an operation that uses the Task Engine. One of these is the “publish period” function.

1. Setup ‘publishing

In Administration, System Config, open the “Publishing” tab

Define a folder (and option password) where the published archives will be stored