Avamar: ¿Cuál es la causa del mensaje de error "ADVERTIR: <1258> xmldocerrorhandler: Entidad: línea 1: error del analizador: xmlParseEntityRef warnings"

El mensaje de error que se ve en el gsan.log:

WARN: <1258> xmldocerrorhandler: Entity: line 1: parser error : xmlParseEntityRef

La variable gsan.log muestra que la causa raíz de este problema es un mensaje de "conclusión" de avtar que contiene contenido XML no válido.

Esta advertencia se debe a la incapacidad de analizar el nombre de un archivo que se está respaldando en el mensaje de conclusión.

La causa más común es un nombre de archivo con caracteres especiales en el nombre.

Hay cinco caracteres que se deben escapar para que XML analice el nombre de archivo.
(Consulte la sección Resolución para obtener una lista de caracteres).

En este ejemplo, el carácter "&" y comercial causa el problema.

2021/11/14-19:04:56.64046 {0.0} [srvm-563941198#srv:2709] WARN: <1258> xmldocerrorhandler: Entity: line 1: parser error : xmlParseEntityRef: no name 
2021/11/14-19:04:56.65398 {0.0} [srvm-563941198#srv:2709] WARN: <1258> xmldocerrorhandler: L\localhost\Policies\User\Documents & 
2021/11/14-19:04:56.65402 {0.0} [srvm-563941198#srv:2709] WARN: <1258> xmldocerrorhandler:               ^

El XML no es válido porque "&" en el nombre de archivo no tiene escape, como lo requiere XML.

Estos son los códigos de escape para los cinco caracteres en los que XML requiere escape.
(Hay algunas excepciones que están permitidas para comillas incrustadas de diferentes tipos, pero es seguro ESCAPAR SIEMPRE).

Esta advertencia se puede ignorar desde la perspectiva del servidor, aunque es posible que el nombre del archivo dificulte la restauración de ese archivo, si es necesario.