Upgrading to OpenDJ 2.6.0 fails with an error occurring when trying to upgrade the config/upgrade folder

Last updated Jan 5, 2021

The purpose of this article is to provide assistance if you run the OpenDJ 2.6.0 Upgrade utility and an error occurs when trying to upgrade the config/upgrade folder, causing the upgrade to fail.


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


The following error is shown when running the OpenDJ Upgrade utility:

An error occurred when trying to upgrade the config/upgrade folder: null

 The upgrade.log includes multiple lines with: updateConfigUpgradeSchemaFile

and then a reference to the file being processed, where some of the files are not .ldif files.

Recent Changes



The presence of files other than .ldif files in the /path/to/opendj/config/schema directory cause the upgrade to fail as the upgrade process attempts to use all files in the /path/to/opendj/config/schema directory instead of just using the .ldif files.


This issue can be resolved by upgrading to OpenDJ 2.6.1 or later; you can download this from BackStage.


You can workaround this issue by removing all non .ldif files from the /path/to/opendj/config/schema directory where OpenDJ is installed.

See Also


Related Training


Related Issue Tracker IDs

OPENDJ-1226 (Upgrade should only consider .ldif files under config/schema)

OPENDJ-1228 (Concatenated schema may contain more than valid schema, possibly leading to further issues)

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