> 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/upgrading-abap-agent-version.md).

# Upgrading ABAP Agent version

When a new ABAP Agent version is released, it will be available at the same download location as the original installation. See [Install WATCHER and SLABAPCLI](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/install-the-abap-agent/install-watcher-and-slabapcli.md).

Before upgrading, review the [ABAP Agent release notes](https://docs.sealights.io/knowledgebase/agent-release-notes/abap-technologies/abap-agent) for version-specific changes and authorization requirements.

### Upgrade Instructions

{% hint style="info" %}
The ABAP Agent relies on scheduled tasks using the Windows Task Scheduler. Those tasks must be stopped before upgrading. See below.
{% endhint %}

{% hint style="danger" %}
BUILDMAP tasks only run once. If they succeeded they can be removed from the Windows Task Scheduler.
{% endhint %}

{% hint style="warning" %}
If this is the first upgrade from a non-installer ABAP Agent version, prepare the existing `config.toml` file and userdata directories before running the installer. The last pre-installer version was `1.0.0.70`. See [Migrate from a Pre-Installer Version](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/install-the-abap-agent/install-watcher-and-slabapcli.md#migrate-from-a-pre-installer-version).
{% endhint %}

1. Make sure none of the ABAP agent **FOOTPRINTS** and **BUILDMODS** scheduled tasks are being used
   1. **FOOTPRINTS**: No tests are running.
   2. **BUILDMODS**: No transports are currently imported.
2. Stop all **FOOTPRINTS** and **BUILDMODS** scheduled tasks in Windows Task Scheduler
   1. Select all **FOOTPRINTS** and **BUILDMODS** tasks under the Sealights directory
   2. Click End
   3. Click Disable
3. Download the latest agent ZIP file and extract the installer. Run `SeaLights_ABAP_Agent_Setup.exe` as an administrator over the existing installation. The installer automatically migrates the configuration and applies any post-install upgrade steps.
4. Restart all **FOOTPRINTS** and **BUILDMODS** stopped tasks in Windows Task Scheduler
   1. Select all **FOOTPRINTS** and **BUILDMODS** tasks under the Sealights directory
   2. Click **Enable**
   3. Click **Run**

{% hint style="info" %}
After upgrading, run `slabapcli setup status` to verify that all components are working correctly with the new version. See [Validate Your Setup](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/command-line-interface/validate-your-setup.md).
{% endhint %}

{% hint style="success" %}
When you stop or replace a scheduled task, the agent now automatically terminates any running watcher process for that task. You no longer need to manually kill orphaned watcher processes.
{% endhint %}


---

# 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/upgrading-abap-agent-version.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.