> For the complete documentation index, see [llms.txt](https://docs.sealights.io/knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent.md).

# Set up the agent

{% hint style="warning" %}
**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](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent/migrate-a-legacy-configuration.md) to upgrade your `config.toml`.
{% endhint %}

## Prerequisite to Agent Setup

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

{% tabs %}
{% tab title="Command Prompt" %}
{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}
{% endtab %}
{% endtabs %}

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

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe setup install
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe setup install
```

{% endcode %}
{% endtab %}
{% endtabs %}

This command takes no parameters.

## Example

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

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

{% hint style="warning" %}
**Note**: You cannot use the generated key on any other computer. Be sure to back up the `config\config.toml` file.
{% endhint %}

## List the agent's settings

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

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}

```batch
slabapcli.exe settings list
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe settings list
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

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

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

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.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe sealights set
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe sealights set
```

{% endcode %}
{% endtab %}
{% endtabs %}

This command takes no parameters.

## Example

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

{% hint style="info" %}
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.
{% endhint %}

## List the SeaLights token

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

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}

```batch
slabapcli.exe sealights list
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe sealights list
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

## Test the connection to SeaLights

{% hint style="info" %}
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.
{% endhint %}

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.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe sealights test
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe sealights test
```

{% endcode %}
{% endtab %}
{% endtabs %}

This command takes no parameters.

## Example

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

{% hint style="info" %}
This command is also run automatically after `sealights set` to verify the token immediately.
{% endhint %}

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

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}

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

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe proxy set --server 'http://proxy.example.com:8080' --auth
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

## Validate your complete setup

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

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}

```batch
slabapcli.exe setup status
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe setup status
```

{% endcode %}
{% endtab %}
{% endtabs %}

For details on reading the report, see [Validate Your Setup](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/command-line-interface/validate-your-setup.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.