Failed to load checksum file from archive error in OpenIDM 4.x
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.
Archived
This article has been archived and is no longer maintained by ForgeRock.
Symptoms
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(ResourceException.java:239) at org.forgerock.json.resource.ResourceException.getException(ResourceException.java:330) at org.forgerock.openidm.shell.impl.HttpRemoteJsonResource.handle(HttpRemoteJsonResource.java:373) at org.forgerock.openidm.shell.impl.HttpRemoteJsonResource.action(HttpRemoteJsonResource.java:131) at org.forgerock.openidm.shell.impl.UpdateCommand$GetArchiveDataStepExecutor.execute(UpdateCommand.java:318) at org.forgerock.openidm.shell.impl.UpdateCommand.execute(UpdateCommand.java:194) at org.forgerock.openidm.shell.impl.RemoteCommandScope.update(RemoteCommandScope.java:199)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(UpdateService.java:151) at org.forgerock.openidm.maintenance.impl.UpdateService.handleAction(UpdateService.java:128) at org.forgerock.json.resource.Router.handleAction(Router.java:241)Recent Changes
Installed, or upgraded to OpenIDM 4.x.
Causes
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.
Caution
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.
Solution
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
N/A