Unable to disable backup mode after upgrade in AEM Forms JEE 6.5.23
After upgrading AEM Forms JEE to version 6.5.23, backup mode fails to disable The issue affects both the Administrative Console and the LCBackupMode command-line tool across supported platforms and application servers. To fix this issue, use the command-line workaround by correcting library dependencies and updating the script configuration in AEM Forms JEE.
Description description
Environment
- Product: AEM Forms JEE
- Version: 6.5.23 (including hotfixes 0100 and 0109)
- Operating system: Windows 64‑bit / Linux
- Application server: WebSphere, JBOSS, WebLogic
- Previous working version: 6.5.21
Issue/Symptoms
- Disabling backup mode through Administrative Console fails.
- Error displayed: An error has occurred. Please see error log for details. Return to core system configuration.
- Backend logs show exception indicating backupReservation is NULL.
- Running
LCBackupMode.cmdreturns error code ALC-DSC-099-000. - The issue occurs regardless of upgrade path or installation history.
Resolution resolution
Follow these steps to disable backup mode in AEM Forms JEE 6.5.23 by using the LCBackupMode command‑line tool:
-
Make sure the required Axis library file is present in the correct directory. If the Axis jar is missing or incompatible, copy the working Axis library from AEM 6.5.21 and place it under:
C:\Adobe\Adobe_Experience_Manager_Forms\sdk\client-libs\thirdpartyUpdate the jar name in the
LCBackupMode.cmd(or .sh) script in:D:\Adobe\Adobe_Experience_Manager_Forms\sdk\misc\Foundation\BackupRestoreCommandline. -
Confirm that all jar versions listed in the
LCBackupModescript exist in the file system. -
Verify and correct the ADOBE_LIVECYCLE path (for example, C:\Adobe\Adobe_Experience_Manager_Forms) and the APPSERVER_CLIENT_JAR_PATH (for example, %ADOBE_LIVECYCLE%\jboss\bin\client) inside the script. Update these values if the AEM installation directory differs.
-
Open Command Prompt as Administrator and go to:
D:\Adobe\Adobe_Experience_Manager_Forms\sdk\misc\Foundation\BackupRestoreCommandline. -
Run the command to disable backup mode:
LCBackupMode leaveThe default script already contains host, port, user, and password values. Update them only if your system uses different settings.
-
After the command completes, check the system status and confirm that backup mode is disabled. The GDS folder should start cleaning again, which confirms that the backup reservation is cleared.
Additional information
- The workaround applies only to the command‑line tool. The Web UI cannot disable backup mode due to a regression introduced in Service Pack 23 (Struts changes).
- The workaround steps work with JDK8 and not JDK11.
- This issue is now fixed, and the fix will be available with 6.5.25.0.
- The issue is reported to Adobe Product Engineering for a permanent fix in a future release.
- Keeping backup mode enabled for long can block GDS and database synchronization, which affects backup and disk‑space management.
Related reading
Backing up the Adobe Experience Manager (AEM) Forms data