Specifications
B-28
Cisco Internet Streamer CDS 2.0-2.3 Software Configuration Guide
OL-13493-04
Appendix B Creating Manifest Files
Manifest File Structure and Syntax
item
The <item> </item> tag set identifies the specific content that is to be acquired. The <item> tag names
a single piece of content or a content object on the origin server, such as a graphic, MPEG video, or
RealAudio sound file. Content items can be listed individually or grouped using the <item-group> tag.
The <item> tag must be enclosed within the <CdnManifest> tag set and can also be enclosed within
<item-group> tags.
Attributes
• src
The src attribute is required and identifies the URL from which to fetch the content. The URL can
be a full URL or a relative URL. A full URL has the following format:
proto://username:password@/domain-name:port/file-path/file-name
Protocols supported in the src attribute are HTTP, HTTPS, FTP, and SMB. For SMB, the URL must
be written in UNC format (\\SMBserver\directory\file).
If a relative path is used, the <server> and <host> tags are required to specify origin server
information, as shown in this example:
<item src="http://user:password@www.cisco.com/HR/index.html" />
<server name="ftp-server" >
<host name="ftp://ftp-server" user="johw" password="wwww" />
</host>
<item src="data/video.asf" />
Note A URL containing a question mark (?) is not supported. A Manifest file parsing error will
occur if you specify a URL that contains a question mark.
Note A URL containing a pound sign (#) will be modified. All characters that follow a pound sign
will be discarded, including the pound sign itself.
• host
The host attribute specifies the hostname if the source URL of the src attribute is a relative URL.
• server
The server attribute is optional and refers to the server name in the <server> tag. If the server
attribute is omitted, the server listed in the closest <server> tag is used. If there is no <server> tag
close to this item, the Manifest file server is used.
• cdn-url
The cdn-url attribute is optional and is used when content needs to be acquired from one URL (the
content acquisition URL) and published using another URL (the publishing URL). The cdn-url
attribute is the relative CDS network URL that end users use to access this content. If no cdn-url
attribute is specified, then the src attribute is used as the relative CDS network URL.
In the following sample Manifest file, the content item being acquired contains the file path
/RemAdmin/InternalReview/firstpage.htm. By specifying a new file path
(RemAdmin/Production/firstpage.htm) using the cdn-url attribute, the publishing URL disguises the
fact that the content originated from an “Internal Review.”
<CdnManifest>