Installation guide
These documents contain definitions of states and configurations for the guests. These
documents are automatically generated and should not be edited manually. Errors in these
documents contain the file name of the broken document. The file name is valid only on the
host machine defined by the URI, which may refer to the machine the command was run on.
Errors in files created by lib virt are rare. However, one possible source of these errors is a
downgrade of lib virt — while newer versions of lib virt can always read XML generated by
older versions, older versions of lib virt may be confused by XML elements added in a
newer version.
B.17.2. XML synt ax errors
Syntax errors are caught by the XML parser. The error message contains information for identifying
the problem.
This example error message from the XML parser consists of three lines — the first line denotes the
error message, and the two following lines contain the context and location of the XML code
containing the error. The third line contains an indicator showing approximately where the error lies
on the line above it:
error: (name_of_guest.xml):6: StartTag: invalid element name
<vcpu>2</vcpu><
-----------------^
In f o rmat io n co n t ain ed in t h is messag e:
( name_of_guest.xml)
This is the file name of the document that contains the error. File names in
parentheses are symbolic names to describe XML documents parsed from
memory, and do not directly correspond to files on disk. File names that are not
contained in parentheses are local files that reside on the target of the connection.
6
This is the line number in the XML file that contains the error.
St art Tag : in valid elemen t n ame
This is the error message from the lib xml2 parser, which describes the specific
XML error.
B.1 7 .2 .1 . St ray < in t he do cume nt
Symp t o m
The following error occurs:
error: (name_of_guest.xml):6: StartTag: invalid element name
<vcpu>2</vcpu><
-----------------^
In vest ig at io n
This error message shows that the parser expects a new element name after the < symbol
on line 6 of a guest's XML file.
Common libvirt errors and t roublesh oot ing
151