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.

Before upgrading, review the ABAP Agent release notes for version-specific changes and authorization requirements.

Upgrade Instructions

The ABAP Agent relies on scheduled tasks using the Windows Task Scheduler. Those tasks must be stopped before upgrading. See below.

BUILDMAP tasks only run once. If they succeeded they can be removed from the Windows Task Scheduler.

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.

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

After upgrading, run slabapcli setup status to verify that all components are working correctly with the new version. See Validate Your Setup.

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.