Failed to load checksum file from archive error in OpenIDM 4.x

Last updated Jan 5, 2021

The purpose of this article is to provide assistance if you encounter a "Failed to load checksum file from archive" error in OpenIDM. This error can occur during the install or upgrade process.


This article has been archived and is no longer maintained by ForgeRock.


The following error is shown when upgrading from OpenIDM 4.0:

org.forgerock.json.resource.InternalServerErrorException: Server Error {"code":500,"reason":"Internal Server Error","message":"Failed to load checksum file from archive."} at org.forgerock.json.resource.ResourceException.newResourceException( at org.forgerock.json.resource.ResourceException.getException( at at at$GetArchiveDataStepExecutor.execute( at at

You may also see an error similar to the following in the OpenIDM log:

Oct 04, 2016 11:15:27 AM org.forgerock.openidm.servlet.internal.ServletConnectionFactory$4 handleException WARNING: Resource exception: 500 Internal Server Error: "Failed to load checksum file from archive." org.forgerock.json.resource.InternalServerErrorException: Failed to load checksum file from archive. at org.forgerock.openidm.maintenance.impl.UpdateService.handleListAvailable( at org.forgerock.openidm.maintenance.impl.UpdateService.handleAction( at org.forgerock.json.resource.Router.handleAction(

Recent Changes

Installed, or upgraded to OpenIDM 4.x.


The checksum file is missing.

The checksum file is used by the OpenIDM Update mechanism. It should not be modified and contains the checksums of all the files distributed with the release, which are then used to identify modified files and/or files which do not originate from ForgeRock during the upgrade. See Installation Guide › OpenIDM Update Checksums for further information.


It is important to ensure the checksum file is deployed when installing or upgrading OpenIDM; failing to do so will prevent you updating OpenIDM in the future.


This issue can be resolved by ensuring the .checksums.csv file is located within the root of the OpenIDM installation directory. If it does not exist, you should extract the original file from the OpenIDM 4.x installation bundle and copy it to your OpenIDM installation directory.

See Also

Installation Guide › An Overview of the OpenIDM Update Process

Installation Guide › OpenIDM Update Checksums

Related Training


Related Issue Tracker IDs

OPENIDM-5290 (Archive that does not have checksums file should be listed as rejected by action=available)

Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.