Set up the agent

Upgrading from an older agent version? The current agent requires configuration version 2. If your config.toml uses an older format, the agent will prompt you to migrate. Follow the steps in Migrate a legacy configuration to upgrade your config.toml.

Prerequisite to Agent Setup

To check connectivity to Sealights, run the following from your terminal (replace the {customerId} with your customer id beforehand):

Command Prompt

curl -I https://{customerId}.sealights.co

PowerShell

Set up the agent

To set up the ABAP agent, run the following from your terminal:

Initializes the ABAP agent by generating a machine-locked symmetric key and creating a default configuration file.

Command Prompt

Syntax

slabapcli.exe setup install

PowerShell

This command takes no parameters.

Example

Expected output (PowerShell)

.\slabapcli.exe setup install
[2025-06-17 08:15:56.388+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-17 08:15:56.389+01:00] [info] Config pathname: ../config/config.toml
[2025-06-17 08:15:56.389+01:00] [info] Install default config
[2025-06-17 08:15:56.392+01:00] [info] Installed default config
[2025-06-17 08:15:56.395+01:00] [info] Install symmetric key
[2025-06-17 08:15:56.395+01:00] [info] Create symmetric key
[2025-06-17 08:15:56.398+01:00] [info] Created symmetric key
[2025-06-17 08:15:56.399+01:00] [info] Create IV
[2025-06-17 08:15:56.399+01:00] [info] Created IV
[2025-06-17 08:15:56.400+01:00] [info] Installed symmetric key
[2025-06-17 08:15:56.401+01:00] [info] Install Windows Error Reporting
[2025-06-17 08:15:56.401+01:00] [info] Installed Windows Error Reporting
[2025-06-17 08:15:56.401+01:00] [info] Total time: 00:00:00.013

This command does the following:

• It generates a machine-locked symmetric key used to protect secrets, including RFC Destination usernames and passwords, and the SeaLights agent ID.

• It creates a default configuration file named config.toml in the ..\config directory.

Note: You cannot use the generated key on any other computer. Be sure to back up the config\config.toml file.

List the agent's settings

To list the ABAP agent's ABAP settings, run the following from your terminal:

Command Prompt

Command

slabapcli.exe settings list

PowerShell

Expected output (PowerShell)

.\slabapcli.exe settings list
[2025-06-20 10:22:48.782+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-20 10:22:48.782+01:00] [info] Config pathname: ../config/config.toml
[2025-06-20 10:22:48.785+01:00] [info] Install dir   : C:\Program Files\Tricentis\SeaLights\ABAP Agent\bin
[2025-06-20 10:22:48.786+01:00] [info] User data dir : ..\userdata
[2025-06-20 10:22:48.786+01:00] [info] Key           : 01000000d08c9ddf0115d1118c7a00c04fc297eb01000000b4f1adcc9afb9a41849a2ac77c60e16b04...c035668c57485ce5
[2025-06-20 10:22:48.786+01:00] [info] IV            : 00283e66c6697b9ddb9047a3363e06bf
[2025-06-20 10:22:48.787+01:00] [info] Total time: 00:00:00.005

The command-line interface shows encrypted keys in the settings list output.

Connect the agent to your SeaLights environment

The next step is to connect the agent to your SeaLights environment. You can do this as follows:

Copy your SeaLights agent token

First you'll need to copy your SeaLights agent token to the clipboard, as follows:

1. In a web browser, navigate to the URL for your SeaLights dashboard.

2. Select the Settings icon, and then select Agent Tokens from the Settings menu's Cockpit & Onboarding section.

3. Locate the entry for your agent token, and press the Copy token button to copy it to the clipboard. Be sure to copy a token whose status is active.

Connect the agent to SeaLights

Next, you'll need to connect the agent to SeaLights using the command-line interface. You can do this as follows:

• Run the following command from your terminal:

Connects the ABAP agent to your SeaLights environment by storing your agent token in the encrypted configuration.

Command Prompt

Syntax

slabapcli.exe sealights set

PowerShell

This command takes no parameters.

Example

Expected output (PowerShell)

.\slabapcli.exe sealights set
[2026-04-21 08:51:38.306+01:00] [info] Config pathname: ..\config\config.toml
Enter token:
Confirm token:
Token accepted (a3f***...***d2b).
Running 'sealights test' to verify the new token...
[2026-04-21 08:51:47.710+01:00] [info] Test SeaLights: customer.sealights.io
  Agent token is valid.
  Sealights connectivity check succeeded.

The token and confirmation are not displayed in the terminal window for security. Use Ctrl+V to paste your token, then press Enter. The command automatically runs sealights test to verify the token.

List the SeaLights token

To list the SeaLights token in encrypted form, run the following from your terminal:

Command Prompt

Command

slabapcli.exe sealights list

PowerShell

Expected output (PowerShell)

.\slabapcli.exe sealights list
[2025-06-17 09:03:34.867+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-17 09:03:34.867+01:00] [info] Config pathname: ../config/config.toml
Hostname: dev-abap-integration-5-gw.dev.sealights.co
Clock sync hostname: dev-staging.dev.sealights.co
Token   : ********
Customer id: SeaLights

Test the connection to SeaLights

The sealights set command above already ran a connectivity test automatically. Use sealights test only if you need to re-verify connectivity later without changing the token.

Validates the agent token against the SeaLights API. Returns a confirmation if the token is valid, or an error with troubleshooting guidance if it is not.

Command Prompt

Syntax

slabapcli.exe sealights test

PowerShell

This command takes no parameters.

Example

Expected output (PowerShell)

.\slabapcli.exe sealights test
[2026-04-21 09:11:54.006+01:00] [info] Config pathname: ..\config\config.toml
[2026-04-21 09:11:54.013+01:00] [info] Test SeaLights: customer.sealights.io
Agent token is valid.
Sealights connectivity check succeeded.

This command is also run automatically after sealights set to verify the token immediately.

Add a proxy

If connection fails your organization might be using a proxy, if that's the case use the following to set it up:

Command Prompt

Command

slabapcli.exe proxy set --server "http://proxy.example.com:8080" --auth

PowerShell

Expected output (PowerShell)

.\slabapcli.exe proxy set --server 'http://proxy.example.com:8080' --auth
Enter proxy username: user1
Enter proxy password:
[2025-10-20 13:45:22.714+02:00] [info] Proxy configuration saved successfully.

Validate your complete setup

After configuring all components (SeaLights, RFC destinations, and pipelines), run the setup status command to verify everything in one step:

Command Prompt

Command

slabapcli.exe setup status

PowerShell

For details on reading the report, see Validate Your Setup.