> For the complete documentation index, see [llms.txt](https://sealights-docs.tricentis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sealights-docs.tricentis.com/sealights-agents-and-plugins/abap-agent/install-the-abap-agent/install-watcher-and-slabapcli.md).

# 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**:

* NetWeaver RFC SDK 7.50 Patch 13 or above for Windows on X64 64Bit.
* See SAP NOTE 2573790 for download links: <https://launchpad.support.sap.com/#/notes/2573790>

{% hint style="warning" %}
If you are unable to download the SDK, your account may not have the required permissions on the SAP ONE Support Launchpad. Contact your SAP platform administrator for assistance.
{% endhint %}

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`.

{% hint style="warning" %}
Copy the files instead of moving them, so the original installation remains available as a backup until the installer upgrade is complete and verified.
{% endhint %}

1. Stop all ABAP Agent scheduled tasks in Windows Task Scheduler.
2. Copy the existing `config.toml` file to:

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

   ```toml
   [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:

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

   After copying, the target directory should contain:

   ```powershell
   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](https://agents.sealights.co/slabap/latest/SeaLights_ABAP_Agent_Setup.zip)

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

{% hint style="info" %}
The installer requires **administrator privileges**.
{% endhint %}

{% stepper %}
{% step %}

### Launch the installer

Run `SeaLights_ABAP_Agent_Setup.exe` from the extracted folder as an administrator.
{% endstep %}

{% step %}

### Choose the install directory

The default install location is:

```
C:\Program Files\Tricentis\SeaLights\ABAP Agent
```

The agent binaries are placed in the `bin` subdirectory.
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
   {% endstep %}
   {% endstepper %}

{% hint style="info" %}
After installation, run `slabapcli setup status` to verify the result. See [Validate Your Setup](/sealights-agents-and-plugins/abap-agent/command-line-interface/validate-your-setup.md).
{% endhint %}

## 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 <a href="#toc201668083" id="toc201668083"></a>

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:

{% code title="Command" overflow="wrap" %}

```powershell
.\purgeLogs.exe
```

{% endcode %}

## 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.

{% hint style="warning" %}
The ProgramData directories (config, logs, userdata) are **not removed** during uninstall to preserve pipeline data and configuration. Delete them manually if no longer needed.
{% endhint %}