An error occurred while taking a snapshot: The filename is too long.

Article ID: VMW0021 Long file names for virtual machine disks can create file names that are too long when a browsable snapshot is mounted on an ESX server.

Symptom

Live mount, live browse, or live recovery jobs fail and log the following error message:

An error occurred while taking a snapshot: The filename is too long.

Cause

ESX servers support only file names up to 128 characters.

When a disk is mounted to an ESX server for live mount, live browse, or live recovery jobs, and the disk resides on a different datastore, the datastore name, datastore folder, and VMDK name are concatenated to create a name for the browsable datastore on the ESX server. In addition, the ESX server adds characters to create names for delta and CTK disks. 

If the name of a virtual machine disk is too long, the resulting file names are longer than the maximum length supported by the ESX server.

Resolution

 

To enable the 3dfs server and VSA proxy to use short names, configure the bUseIndexNameForVMDK additional setting on the VSA proxy and 3dfs server, and set the value to 1. 

This issue is resolved in Version 11; however, the additional setting is required for backward compatibility on a VSA proxy or 3dfs server that remains on Version 10. For example:

  • If the 3dfs server is running V10 and the VSA proxy has been upgraded to V11, configure this setting on the 3dfs server. 
  • If the VSA proxy is running V10 and the 3dfs server has been upgraded to V11, configure this setting on the VSA proxy and the 3dfs server.