Command-line interface

You configure the SeaLights ABAP Agent using a command-line interface program (slabapcli.exe) installed to the agent's bin directory. You can use the command-line interface program to do the following:

• Set up the agent
• Connect the agent to SeaLights
• Define resources
• Create an Initial Build Map
• Create Build Modifications
• Create Footprints

Run the command-line interface

To display the command-line interface's help file, open a terminal as an Administrator and change to the agent's bin directory (default: C:\Program Files\Tricentis\SeaLights\ABAP Agent\bin).

Command Prompt

cd "C:\Program Files\Tricentis\SeaLights\ABAP Agent\bin"

PowerShell

cd "C:\Program Files\Tricentis\SeaLights\ABAP Agent\bin"

Then run the following:

Command Prompt

Command

slabapcli.exe --help

PowerShell

Command

.\slabapcli.exe --help

Expected output (PowerShell)

.\slabapcli.exe --help
usage: slabapcli [-h|--help] [-c|--config <config pathname>] [-l|--log_level <log_level>] <resource> <command> [args]
resource:
  setup:
    install   : install
    uninstall : uninstall
    migrate   : migrate config to the latest supported version
    status    : aggregated agent / Sealights / RFC connectivity health report
  settings:
    list : list settings
  sealights:
    list : list sealights configuration
    test : test sealights configuration
    set  : set sealights configuration
  rfc:
    list : list rfc configurations
    test : test rfc configuration
    del  : delete rfc configuration
    set  : set rfc configuration
    phd  : import performance history data
  pipeline:
    list : list pipelines
    set  : set pipeline
  proxy:
    list : list proxy configuration
    set  : set proxy configuration
  buildmap:
    run : configure one-time collection of initial build map
  buildmods:
    run : configure regular collection of build mods
    stop: stop collection of build mods
  footprints
    run : configure regular collection of footprints
    stop: stop collection of footprints
  testexecution
    list  : list open test executions
    open  : open test execution
    close : close test execution
  security
    decrypt : decrypt config file and all sqlite db files

slabapcli <resource> help for resource specific help

You can run slabapcli.exe <resource> help to display the help for a specific resource.

Command Prompt

Command

slabapcli.exe settings help

PowerShell

Command

.\slabapcli.exe settings help

Expected output (PowerShell)

.\slabapcli.exe settings help
[2025-06-13 16:14:16.590+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-13 16:14:16.590+01:00] [info] Config pathname: ../config/config.toml
settings <command>:
command:
  help : settings command help
  list : list settings

Prerequisites

Before you set up the Agent, the first step is to test your machine's connection to SeaLights. Open a terminal as an Administrator and run the following commands:

Command Prompt

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

PowerShell

Test-NetConnection {customerId}.sealights.co -Port 443
Invoke-WebRequest https://{customerId}.sealights.co

In each case, replace {customerId} with your SeaLights Customer ID.

Decrypt configuration

To decrypt the config.toml file and all SQLite database files in the userdata\private directory, run the following from your terminal:

Command Prompt

Command

slabapcli.exe security decrypt --config "..\config\config.toml"

PowerShell

Command

.\slabapcli.exe security decrypt --config '..\config\config.toml'

Don't decrypt your files unless Tricentis Support asks you to.