Update checksums for emails support feature fails to process and update checksums for message files within a container file.

Problem

After certain upgrades of eDiscovery Platform (eDP), where Microsoft Office is upgraded to a newer version, the administrator will be required to run the System->Support Features->Update checksum for emails tool in order to update the checksums stored in the database.  When this is required, a red error message is seen at the top of the case, see Figure 1 below.

Error Message

Figure 1:

Error message says "The digital fingerprint of emails processed into this case has to be updated because of the upgrade to Notes 10 or Office 2016/Office 2019. Please initiate the upgrade by navigating to "Update checksum for emails" within System / Support."

Figure 2 - Job log shows the following.  Also highlighted is the path to the Remote Job Log:

Figure 3 - Remote Job Log shows this error:
2025-07-29 17:42:15,178 WARN  [common.containerfile.ContainerResolverImpl] (RPC-thread-1 - eDp-Appliance.edp.lab:2595:1433682247167083895:[]) Container item resolution issue : 
com.teneo.esa.common.containerfile.ContainerExtractionException: [#80092] Error extracting container - Unable to extract contained file TEST Employee Data from \\EDP-FILESERVER\eDP\SA\CaseSources\Test Case with Zip file\onedrive_5_12-16-2022-250729153339.zip
    at com.teneo.esa.common.containerfile.ContainerResolverImpl.resolveContainedFile(ContainerResolverImpl.java:311) ~[classes/:?]
    at com.teneo.esa.common.containerfile.ContainerResolverImpl.resolve(ContainerResolverImpl.java:139) ~[classes/:?]
    at com.teneo.esa.common.repository.MsgCrawlerRetriever.fetchContainedMessage(MsgCrawlerRetriever.java:379) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.getEmailSourceFiles(EmailChecksumUpdaterSourceFileStatus.java:483) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.populate(EmailChecksumUpdaterSourceFileStatus.java:283) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.initialize(EmailChecksumUpdaterSourceFileStatus.java:188) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.<init>(EmailChecksumUpdaterSourceFileStatus.java:111) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterJob.process(EmailChecksumUpdaterJob.java:201) ~[classes/:?]
    at com.teneo.esa.jobmanager.remote.RemoteJobCapsule.call(RemoteJobCapsule.java:100) [classes/:?]
    at com.teneo.esa.jobmanager.remote.RemoteJobCapsule.call(RemoteJobCapsule.java:45) [classes/:?]
    at com.teneo.esa.common.remote.ServerSideRemoteExecutor$CancelHandler.callNested(ServerSideRemoteExecutor.java:575) [classes/:?]
    at com.teneo.esa.common.remote.ServerSideRemoteExecutor$CancelHandler.call(ServerSideRemoteExecutor.java:551) [classes/:?]
    at java.util.concurrent.FutureTask.run(FutureTask.java:266) [?:1.8.0_452]
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) [?:1.8.0_452]
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) [?:1.8.0_452]
    at java.lang.Thread.run(Thread.java:750) [?:1.8.0_452]
2025-07-29 17:42:15,196 INFO  [jobmanager.remote.lifecycle] (RPC-thread-1 - eDp-Appliance.edp.lab:2595:1433682247167083895:[]) Remote Processing ended with error for job id 1.5.17.9097462566606602281
java.lang.NullPointerException: null
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.getEmailSourceFiles(EmailChecksumUpdaterSourceFileStatus.java:485) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.populate(EmailChecksumUpdaterSourceFileStatus.java:283) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.initialize(EmailChecksumUpdaterSourceFileStatus.java:188) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterSourceFileStatus.<init>(EmailChecksumUpdaterSourceFileStatus.java:111) ~[classes/:?]
    at com.teneo.esa.processing.emailchecksumupdater.EmailChecksumUpdaterJob.process(EmailChecksumUpdaterJob.java:201) ~[classes/:?]
    at com.teneo.esa.jobmanager.remote.RemoteJobCapsule.call(RemoteJobCapsule.java:100) [classes/:?]
    at com.teneo.esa.jobmanager.remote.RemoteJobCapsule.call(RemoteJobCapsule.java:45) [classes/:?]
    at com.teneo.esa.common.remote.ServerSideRemoteExecutor$CancelHandler.callNested(ServerSideRemoteExecutor.java:575) [classes/:?]
    at com.teneo.esa.common.remote.ServerSideRemoteExecutor$CancelHandler.call(ServerSideRemoteExecutor.java:551) [classes/:?]
    at java.util.concurrent.FutureTask.run(FutureTask.java:266) [?:1.8.0_452]
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) [?:1.8.0_452]
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) [?:1.8.0_452]
    at java.lang.Thread.run(Thread.java:750) [?:1.8.0_452]

Cause

The case was originally created in an older version of eDP and migrated to a newer eDP server.  The email checksums therefore needed to be upgraded.  The source files were also located at a different path so the tool Source Locator Modifier was also used prior to using the Update email checksum tool.  Once the path has been changed, the data looks fine in the Analysis & Review page.  But the red error as seen in Figure 1 remains until the Update email checksum tool has been successfully completed.  Upon inspection of the source data it was found that there was a zip file with 5 MSG files inside the container that was not being properly updated in the database.

Solution

This issue is currently under investigation by Veritas Technologies LLC. Pending the outcome of the investigation, this issue may be resolved by way of a patch or hotfix in current or future revisions of the software. However, this particular issue is not currently scheduled for any release.  If you feel this issue has a direct business impact for you and your continued use of the product, please contact your Veritas Sales representative or the Veritas Sales group to discuss these concerns.