Avamar: Wat is de oorzaak van de foutmelding "WARN: <1258> xmldocerrorhandler: Entity: line 1: parser error: xmlParseEntityRef warnings"

De foutmelding in de gsan.log:

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

De gsan.log geeft aan dat de hoofdoorzaak van dit probleem een inpakbericht is van avtar die ongeldige XML-inhoud bevat.

Deze waarschuwing is te wijten aan een onvermogen om de naam te parseren van een bestand waarvan een back-up wordt gemaakt in het afsluitingsbericht.

De meest voorkomende oorzaak is een bestandsnaam met speciale tekens in de naam.

Er zijn vijf tekens die moeten worden ontsnapt voordat XML de bestandsnaam kan parseren.
(Zie het gedeelte Resolutie voor een lijst met tekens.)

In dit voorbeeld veroorzaakt het teken "&" van het ampersand-teken het probleem.

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:               ^

De XML is ongeldig omdat de "&" in de bestandsnaam niet wordt escaped, zoals vereist door XML.

Dit zijn de escapecodes voor de vijf tekens waarbij XML escape vereist.
(Er zijn een paar uitzonderingen die zijn toegestaan voor verschillende soorten ingesloten aanhalingstekens, maar het is veilig om ALTIJD TE ONTSNAPPEN.)

Deze waarschuwing kan worden genegeerd vanuit het perspectief van de server, hoewel het mogelijk is dat de bestandsnaam het moeilijk maakt om dat bestand te herstellen, indien nodig.