Specifications

B-17
Cisco Internet Streamer CDS 2.0-2.3 Software Configuration Guide
OL-13493-04
Appendix B Creating Manifest Files
Manifest File Structure and Syntax
• CORRECT—Contains possible syntax irregularities but is syntactically valid and ready for
deployment on your CDS network
• INCORRECT—Contains syntax errors and is unsuitable for deployment on your CDS network
Syntax Errors
The Manifest Validator issues syntax errors only when it cannot identify a source file for a listed content
item, either because it is not listed or because it is listed using improper syntax. Files containing syntax
errors are marked INCORRECT.
Syntax errors are identified in the output with the ERROR label. In addition to the label, the line and
column number containing the error are provided, as well as the Manifest file attribute for which the
error was issued. An error appears in the following example:
ERROR (/state/dump/tmp.xml.1040667979990 line: 23 col: 1 ):No character data is allowed by
content model
In the error example:
• /state/dump/tmp.xml.1040667979990 is the Manifest file name
• line: 23 col: 1 is the Manifest file line and column number where the error occurs
• No character data is allowed by content model describes the type of Manifest file error
Syntax Warnings
The Manifest Validator issues syntax warnings for a wide variety of irregularities in the Manifest file
syntax. Files containing syntax warnings may be marked CORRECT or INCORRECT, depending on
whether or not syntax errors have also been issued.
Syntax warnings are identified in the output with the WARNING label. In addition to this warning label,
the line number for which the warning is issued is provided, as well as the Manifest file attribute, valid
options, and the default value for that attribute for which the warning was issued.
Correcting Manifest File Syntax
Once you have identified syntax warnings, errors, and messages using the output from the Manifest
Validator, you can correct your Manifest file syntax and then rerun the Manifest Validator on the
corrected file to verify its correctness.
It is a good idea to review every warning and error in your Manifest file. Some warnings, although they
still allow the Manifest Validator to find your Manifest file syntax to be correct, can be the source of
problems when you deploy the identified content to your CDS network.
Manifest File Structure and Syntax
The Cisco Manifest file provides powerful features for representing and manipulating CDS network data
that can be easily edited using any simple text editor. Table B-4 provides a summary list of the Manifest
file tags, their corresponding attributes and subelements, and a brief description of each tag. Table B-5
shows an example of how tags are nested in a Manifest file. The sections that follow provide a more
detailed description of the Manifest file tags, the data they contain, and their attributes.