Issue in dispatcher_vhost.conf checksum in pom.xml

[gvishnoi]

Affects Version

4.0.5-SNAPSHOT

Component

Dispatcher

Description

Problem:
The Maven build fails on AEM Cloud Manager with the following error during the enforcer plugin execution:

[WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireTextFileChecksum failed with message:
There have been changes detected in a file which is supposed to be immutable according to https://docs.adobe.com/content/help/en/experience-manager-cloud-service/implementing/content-delivery/disp-overview.html#file-structure: src/conf.d/dispatcher_vhost.conf

Root Cause:

The enforcer plugin validates that immutable dispatcher files haven't been modified by comparing MD5 checksums. Since the file content changed but the checksum in the POM wasn't updated, the validation fails.

Impact:

• Build fails on AEM Cloud Manager
• Cannot deploy the project to cloud environments
• Workaround of using -Denforcer.skip=true is not viable in cloud builds

Current State:

• File: dispatcher_vhost.conf
• Current MD5: 83666633941ed4288340e799e45fee0c
• POM Expected MD5: b89125ba8462987cfe706dd35b69a170 (outdated)

Steps to Reproduce

1. Clone the repository at commit 308e633 or later
2. Run mvn clean install with Java 21
3. Observe the build failure at the dispatcher module with checksum validation error

Expected Behavior

The build should succeed with the enforcer plugin validating the correct checksum for dispatcher_vhost.conf.

Proposed Solution

Update the checksum in pom.xml at line 62:

File: pom.xml

Change:

<requireTextFileChecksum>
    <file>src/conf.d/dispatcher_vhost.conf</file>
    <checksum>83666633941ed4288340e799e45fee0c</checksum>  <!-- Updated from b89125ba8462987cfe706dd35b69a170 -->
    <type>md5</type>
    <message>There have been changes detected in a file which is supposed to be immutable according to https://docs.adobe.com/content/help/en/experience-manager-cloud-service/implementing/content-delivery/disp-overview.html#file-structure: src/conf.d/dispatcher_vhost.conf</message>
</requireTextFileChecksum>

Verification Command

To calculate the current MD5 checksum:

md5 -q dispatcher/src/conf.d/dispatcher_vhost.conf
# Output: 83666633941ed4288340e799e45fee0c

Related Information

• Affected File: dispatcher_vhost.conf
• POM File to Update: pom.xml

Labels

• build-failure
• dispatcher
• cloud-manager
• checksum-validation

Environment

• Java Version: 21 (required by project)
• Maven Version: 3.8.x or higher
• AEM Cloud Service

[charronadobe]

I was lucky to find this issue here, I spent quite a bit of time troubleshooting it... any ETA on when it will be updated in the code release?