Set up the agent

Prerequisite to Agent Setup

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

Test-NetConnection {customerId}.sealights.io -Port 443 // confirm TCP reachability
Invoke-WebRequest https://{customerId}.sealights.io // confirm HTTPS connectivity

Set up the agent

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

PS C:\apps\SLABAPAgent\bin> .\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 PowerShell window:

PS C:\apps\SLABAPAgent\bin> .\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:\apps\SLABAPAgent\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 PowerShell window:

PS C:\apps\SLABAPAgent\bin> ./slabapcli.exe sealights set
[2025-06-17 08:51:38.306+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-17 08:51:38.307+01:00] [info] Config pathname: ../config/config.toml
Enter token:

• Use Ctrl+V to paste in your token, and then press <Enter>. Note that you won’t see the token in the PowerShell window. The command-line interface displays this:

[2025-06-17 08:57:47.710+01:00] [info] Total time: 00:06:09.404
PS C:\apps\SLABAPAgent\bin>

List the SeaLights token

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

PS C:\apps\SLABAPAgent\bin> ./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   : 67d61abc4a4dfc5a6f89be3ed36579af1f9f0c9005fa8a48b639891bd2d01fcc836de10c84dcd40364...baf266b1570db1249ef019effffcb9f4ca4d93d5dd5cea09f6b97b
Customer id: SeaLights

Test the connection to SeaLights

To test the connection to SeaLights, run the following from your PowerShell window:

PS C:\apps\SLABAPAgent\bin> ./slabapcli.exe sealights test
[2025-06-17 09:11:54.006+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-17 09:11:54.007+01:00] [info] Config pathname: ../config/config.toml
[2025-06-17 09:11:54.013+01:00] [info] Test SeaLights: dev-abap-integration-5-gw.dev.sealights.co
<Lists your SeaLights apps, branches, and builds>

Add a proxy

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

PS C:\apps\SLABAPAgent\bin> .\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.