ONTAP 9 Manuals ( CA08871-402 )

How ONTAP handles multi-byte file, directory, and qtree names

Support for 4-byte UTF-8 encoded names enables the creation and display of file, directory, and tree names that include Unicode supplementary characters outside the Basic Multilingual Plane (BMP). In earlier releases, these supplementary characters did not display correctly in multiprotocol environments.

To enable support for 4-byte UTF-8 encoded names, a new utf8mb4 language code is available for the vserver and volume command families.

  • You must create a new volume in one of the following ways:

  • Setting the volume -language option explicitly:

    volume create -language utf8mb4 {…}

  • Inheriting the volume -language option from an SVM that has been created with or modified for the option:

    vserver [create|modify] -language utf8mb4 {…}``volume create {…}

  • If you are using ONTAP 9.7, you cannot modify existing volumes for utf8mb4 support; you must create a new utf8mb4-ready volume, and then migrate the data using client-based copy tools.

    If you are using ONTAP 9.7P1 or later, you can modify existing volumes for utf8mb4 with a support request.

    You can update SVMs for utf8mb4 support, but existing volumes retain their original language codes.

    LUN names with 4-byte UTF-8 characters are not currently supported.
  • Unicode character data is typically represented in Windows file systems applications using the 16-bit Unicode Transformation Format (UTF-16) and in NFS file systems using the 8-bit Unicode Transformation Format (UTF-8).

Unicode characters are allowed in qtree names.

  • You can use either the volume qtree command family or ONTAP System Manager to set or modify qtree names.

  • qtree names can include multi-byte characters in Unicode format, such as Japanese and Chinese characters.

  • In 9.7 and later releases, 4-byte characters are supported in qtree names, provided that the qtree is in a volume enabled for utf8mb4.

Top of Page