> 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-2.0/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-2.0/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-2.0/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-2.0/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/abap-agent/upgrading-abap-agent-version.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.