For the complete documentation index, see llms.txt. This page is also available as Markdown.

Install WATCHER and SLABAPCLI

WATCHER is a program that watches for ABAP changes and reports them to SeaLights. SLABAPCLI is a command-line interface program that lets you configure the ABAP Agent and connect it to SeaLights. You can install these on a Windows server or a standalone machine.

Prerequisites

Before running the installer, download the SAP NW RFC SDK:

Extract the SDK to a temporary directory. You will need to point the installer to the sapnwrfc.dll file during installation.

Migrate from a Pre-Installer Version

If you are upgrading from an older ABAP Agent version that was not installed with SeaLights_ABAP_Agent_Setup.exe, prepare the existing configuration and userdata directories before you run the installer for the first time. The last pre-installer version was 1.0.0.70.

  1. Stop all ABAP Agent scheduled tasks in Windows Task Scheduler.

  2. Copy the existing config.toml file to:

    C:\ProgramData\Tricentis\SeaLights\ABAP Agent\config\config.toml
  3. Edit the copied config.toml file and update the [settings] paths:

    [settings]
    install = 'C:\Program Files\Tricentis\SeaLights\ABAP Agent\bin'
    userdata = 'C:\ProgramData\Tricentis\SeaLights\ABAP Agent'

    Do not change the key or iv values.

  4. Copy the existing public and private directories from the current userdata directory to:

    C:\ProgramData\Tricentis\SeaLights\ABAP Agent\

    After copying, the target directory should contain:

    C:\ProgramData\Tricentis\SeaLights\ABAP Agent\public
    C:\ProgramData\Tricentis\SeaLights\ABAP Agent\private
  5. Continue with the installer steps below.

Run the Installer

Download the agent ZIP file: SeaLights_ABAP_Agent_Setup.zip

Extract the ZIP file and locate SeaLights_ABAP_Agent_Setup.exe inside it.

The installer requires administrator privileges.

1

Launch the installer

Run SeaLights_ABAP_Agent_Setup.exe from the extracted folder as an administrator.

2

Choose the install directory

The default install location is:

The agent binaries are placed in the bin subdirectory.

3

Select the SAP NW RFC DLL

The installer prompts you to browse to your sapnwrfc.dll file. It validates that the DLL is:

  • x64 (64-bit)

  • At or above the minimum supported version

All DLLs from the selected folder are copied into the agent's bin directory automatically.

4

Installation completes

The installer:

  1. Copies agent binaries to the install directory.

  2. Creates the ProgramData directory tree (config, logs, userdata).

  3. Grants NETWORK SERVICE modify access to the ProgramData directories.

  4. Copies all SAP NW RFC SDK DLLs to the bin directory.

  5. Runs slabapcli setup migrate to migrate any existing configuration to the current version.

  6. Runs slabapcli setup upgrade to apply any post-install setup steps.

After installation, run slabapcli setup status to verify the result. See Validate Your Setup.

Directory Layout

The installer creates the following standardized directory structure:

Directory
Path
Purpose

Install

%ProgramFiles%\Tricentis\SeaLights\ABAP Agent\bin

Agent binaries and SAP NW RFC SDK DLLs.

Config

%ProgramData%\Tricentis\SeaLights\ABAP Agent\config

config.toml and lock files.

Logs

%ProgramData%\Tricentis\SeaLights\ABAP Agent\public\Logs

Watcher and CLI log files.

Public userdata

%ProgramData%\Tricentis\SeaLights\ABAP Agent\public

Pipeline data visible to operators.

Private userdata

%ProgramData%\Tricentis\SeaLights\ABAP Agent\private

Internal data (SQLite databases).

The NETWORK SERVICE account has modify access to the config, logs, and userdata directories so the Watcher (which runs as a scheduled task under NETWORK SERVICE) can write logs and data.

Log Files

The ABAP Agent stores log files for the WATCHER program in:

  • %ProgramData%\Tricentis\SeaLights\ABAP Agent\public\Logs\<Pipeline name>

To purge log files older than 14 days, start Windows PowerShell as an Administrator and run the following from the agent's bin directory:

Uninstall

To uninstall the ABAP Agent, use Add or Remove Programs in Windows Settings, or run the uninstaller from the install directory. The uninstaller runs slabapcli setup uninstall and removes agent binaries and SDK DLLs.

Last updated

Was this helpful?