Health Check Error: deletedFilesReferenced

Overview

The Health Check wizard must be run when upgrading in order to evaluate your instance's ability to move to the target version. During the health check, various types of issues may be detected which can affect your ability to upgrade. This article will cover how to resolve a "deletedFilesReferenced" error reported by the health check.

Symptoms

This error generates an output similar to the following in health check:

Note: This error is known to occur along with the Vendor files inclusion error in the health check.  

Resolution

The following type of statements will generate this health check error:

• Include()
• Include_once()
• Require()
• Require_once()

In this example, the Require_once() statement identified in the health check error is referenced in ./custom/modules/Accounts/Ext/Ex1.php file. The line of code referencing this hook is as follows:

require_once('include/Smarty/plugins/function.sugar_help.php');

The file referenced in this Require_once() statement will be moved to ./include/SugarSmarty/plugins/function.sugar_help.php during the upgrade, which will break the reference to the deleted files.

Manually change the reference as follows to resolve this health check error and point the reference to the appropriate post-upgrade file:

require_once('include/SugarSmarty/plugins/function.sugar_help.php'); 

Once the necessary change has been made, please navigate to Admin > Repair and perform a "Quick Repair and Rebuild" to ensure that the changes are synced between the application and database. Then, perform the health check again to confirm that the error is no longer reported.