Health Check Error: File System Maximum Path Length Exceeded

Overview

The Health Check wizard must be run when upgrading 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 "File system maximum path length exceeded" error reported by the health check.

Symptoms

This error generates the warning, "File system maximum path length exceeded", in health check.

Resolution

This health check error indicates that your instance's file system has exceeded the maximum path length of 260 characters for Windows. As of Windows 10 version 1607, the maxiumum path length limit has been removed. But, you will need to enable the long path support for your system by setting the appropriate registry value and importing the file to Sugar.

Use the following steps to :

1. Create a file 'EnableLongPathSupport.reg' with the following content:
   

   Windows Registry Editor Version 5.00
   
   [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem]
   "LongPathsEnabled"=dword:00000001

2. Import this file to your machine where Sugar is running.
3. If upgrading via Upgrade Wizard, restart IIS. This step is not required if upgrading via Silent Upgrader.

For additional information and alternative ways to enable long path support, refer to the Maximum Path Length Limitation article on the Microsoft site.