ETS XML Package Overview

The XML package provides a rich mechanism for exporting and importing network models to a structured ASCII format—eXtended Markup Language (XML).

The XML import/export capability centers around a schema (or “Document Type Definition”) that defines the format of documents that define valid models. The Riverbed model DTD is called network.dtd and is located in the <reldir>/sys/etc directory.

As long as external programs output data that conforms to network.dtd, they can write XML files to describe network models and import them into Riverbed analysis software via the XML import function. Similarly, an Riverbed application can export existing network models to an XML file and guarantee that the resulting file conforms to the network.dtd specification.

The XML import/export functionality is structured to allow custom extensions.

For export, a base XML “skeleton” is generated first and then user code can be executed to flesh out the base XML data with additional characteristics and/or tags. This is accomplished via the XML postprocessing library and function. A sample postprocessing library is provided that extends the base skeleton, including the intended attribute values on network objects. It also exports annotation objects and other elements.

Similar functionality exists for import. First, the XML file is parsed and a skeleton model is generated containing the network elements found in the XML file. A post-processing function can then read additional information in the XML file to add object attribute values to the generated network objects.