Avamar: Qual é a causa da mensagem de erro "WARN: <1258> XmlDocErrorHandler: Entidade: linha 1: erro do analisador: advertências xmlParseEntityRef"

A mensagem de erro vista no gsan.log:

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

A coluna gsan.log mostra que a causa raiz desse problema é uma mensagem de "encerramento" de avtar que contém conteúdo XML inválido.

Esse aviso se deve à impossibilidade de analisar o nome de um arquivo cujo backup está sendo feito na mensagem de encerramento.

A causa mais comum é um nome de arquivo com caracteres especiais no nome.

Há cinco caracteres que devem ser ignorados para que o XML analise o nome do arquivo.
(Consulte a seção Resolução para obter uma lista de caracteres.)

Neste exemplo, o caractere e comercial "&" causa o 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:               ^

O XML é inválido porque o "&" no nome do arquivo não está no escape, conforme exigido pelo XML.

Estes são os códigos de escape para os cinco caracteres em que o XML requer escape.
(Há algumas exceções que são permitidas para cotações incorporadas de diferentes tipos, mas é seguro SEMPRE ESCAPAR.)

Essa advertência pode ser ignorada de uma perspectiva do servidor, embora seja possível que o nome do arquivo dificulte a restauração desse arquivo, se necessário.