> For the complete documentation index, see [llms.txt](https://sealights-docs.tricentis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sealights-docs.tricentis.com/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](/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](/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](/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 %}