KB-102 – Disaster Recovery¶
Disaster Recovery Validation¶
Validation Date¶
2026-06-25
Objective¶
Validate the recovery process of the ADempiere application layer using the certified backup generated for BLACK ERP.
Backup Used¶
blackerp_application_v1.tar.gz
Scope¶
The validation covered the restoration of the ADempiere application runtime, including:
- Apache Tomcat
- ADempiere Web Applications
- Shared Runtime Libraries
- Tomcat Configuration
- Startup Scripts
The database was not restored as part of this validation because the objective was to verify the application layer.
Initial Result¶
An initial restoration using only the tomcat/webapps directory was performed.
This approach produced multiple startup failures, including:
- HTTP 404 responses
- HTTP 500 responses
- Web applications failing to deploy
- Filter initialization failures
- Missing runtime classes
- Context startup failures
The analysis demonstrated that the ADempiere runtime is composed of multiple interdependent components and that restoring only the deployed applications is not sufficient.
Root Cause¶
The runtime depends on the complete Tomcat environment:
tomcat/
bin/
conf/
lib/
webapps/
Restoring only one of these components leaves the runtime in an inconsistent state.
Certified Recovery Procedure¶
The application server was successfully restored after recovering the following directories from the certified backup:
- tomcat/bin
- tomcat/conf
- tomcat/lib
- tomcat/webapps
The Tomcat cache directories (work and temp) were cleared before starting the service.
Validation Results¶
The restored environment successfully returned:
| Endpoint | Expected | Result |
|---|---|---|
| /webui | HTTP 200 | PASS |
| /admin | HTTP 200 | PASS |
| /wstore | HTTP 200 | PASS |
| / | HTTP 302 → /admin | PASS |
The graphical interfaces were also verified manually using a web browser.
Conclusion¶
The Disaster Recovery test was successful.
The certified application backup is valid and can be used to restore the ADempiere application layer.
This validation confirms that the backup generated for BLACK ERP is functional, provided that the complete Tomcat runtime is restored as a single unit.
Lessons Learned¶
- Never restore only
webapps. - The Tomcat runtime must be treated as a single logical unit.
- Every infrastructure change should be documented in the Knowledge Base after successful validation.
- Every recovery procedure should be validated before being considered certified.
Validation Status
✅ Certified
Validated By
BLACK ERP Technical Team
Date: 2026-06-25