App Control: Host Package Install Fails Due to System.Xml.XMLException Error

Products

• Carbon Black App Control (formerly Cb Protection)

Issue/Introduction

• Host Package install fails from the console with no description given
• Install log under C:\Users\USERNAME\appdata\local\temp shows the following error:

  Unhandled Exception: System.Xml.XmlException: '.', hexadecimal value 0x00, is an invalid character. Line 1, position 1.
     at System.Xml.XmlTextReaderImpl.Throw(Exception e)
     at System.Xml.XmlTextReaderImpl.Throw(String res, String[] args)
     at System.Xml.XmlTextReaderImpl.ThrowInvalidChar(Char[] data, Int32 length, Int32 invCharPos)
     at System.Xml.XmlTextReaderImpl.ParseRootLevelWhitespace()
     at System.Xml.XmlTextReaderImpl.ParseDocumentContent()
     at System.Xml.XmlTextReaderImpl.Read()
     at System.Xml.XmlReader.MoveToContent()
     at System.Xml.Linq.XElement.Load(XmlReader reader, LoadOptions options)
     at System.Xml.Linq.XElement.Load(String uri, LoadOptions options)
     at ServerTools.UpgradeXmlModifierTool.UpgradeXml(String upgradeXmlFile, String replacementXmlFile, Platform p)
     at ServerTools.UpgradeXmlModifierTool.Main(String[] args)

Environment

• App Control Server: 8.1.4+
• Microsoft Windows: All Supported Versions

Cause

A corrupt upgrade.xml file is causing parsing errors

Resolution

1. Make a backup copy of the Upgrade.XML file from the folder C:\Program Files (x86)\Bit9\Parity Server\Upgrade\
2. Verify each version of agent you have installed under https://SERVERNAME/InstallerVersions.php
3. Stop the App Control Server and Reporter services
4. Delete the existing Upgrade.XML file from the Upgrade folder
5. Rebuild the file by installing the Host Packages for the items listed in Step 2 or upgrade to the newest release of the agent packages.