Design Text Document (DTD)
The following example file shows the generic XML data format. This file can change with different releases. The correct version of this file is installed automatically in the following directory when you install Riverbed Modeler:
<install_dir>/<release>/sys/etc/GenericServerImport.dtd
The heading information in the file gives the version of XML and the version of the OPNET server import DTD that are valid with the current Riverbed Modeler release.
Figure 40: OPNET Server Import DTD—Example
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- ============================================================= -->
<!-- OPNET server import DTD v1.07 -->
<!-- ============================================================= -->
<!-- The top-level document -->
<!ELEMENT GenericServerImport (System, Start?, Scan*)>
<!-- ============================================================= -->
<!-- Server hardware description -->
<!-- ============================================================= -->
<!ELEMENT System (CPUCount, UTCOffset?, ServerName?, Manufacturer?, Model?,
Processor?, ProcessorSpeed?, ProcessorManufacturer?,
Network?, AttachedStorage?, DiskPartitions?, Memory?, PageSize?,
OSVersion?, OSName?, Collector?, TimeZone?)>
<!-- CPU count is a required element, all others are optional -->
<!ELEMENT CPUCount (#PCDATA)>
<!ELEMENT UTCOffset (#PCDATA)>
<!ELEMENT ServerName (#PCDATA)>
<!ELEMENT Manufacturer (#PCDATA)>
<!ELEMENT Model (#PCDATA)>
<!ELEMENT Processor (#PCDATA)>
<!ELEMENT ProcessorSpeed (#PCDATA)>
<!ELEMENT ProcessorManufacturer (#PCDATA)>
<!ELEMENT Network (NetworkInterface+)>
<!ELEMENT NetworkInterface (#PCDATA)>
<!ATTLIST NetworkInterface
technology (enet | ethcoax| atm | fr | fc | ppp) #IMPLIED
bps CDATA #REQUIRED
ipaddress CDATA #IMPLIED
>
<!ELEMENT AttachedStorage (DiskInterface+)>
<!ELEMENT DiskInterface (DiskInterfaceName, DiskInterfaceType?, Channel+)>
<!ELEMENT DiskInterfaceName (#PCDATA)>
<!ELEMENT DiskInterfaceType (#PCDATA)>
<!ELEMENT Channel (Disk+)>
<!ELEMENT Disk (DiskName, DiskManufacturer?, DiskModel?, DiskResponseTime?, DiskIOCount?)>
<!ELEMENT DiskName (#PCDATA)>
<!ELEMENT DiskManufacturer (#PCDATA)>
<!ELEMENT DiskModel (#PCDATA)>
<!ELEMENT DiskResponseTime (#PCDATA)>
<!ATTLIST DiskResponseTime
units (sec | msec | usec | nsec) #IMPLIED
>
<!ELEMENT DiskIOCount (#PCDATA)>
<!ELEMENT DiskPartitions (DiskPartition+)>
<!ELEMENT DiskPartition (DiskPartitionName,DiskPartitionResponseTime?,
DiskPartitionDisk?, DiskPartitionRAIDType?,
DiskPartitionSize?,DiskPartitionRemoteServerName?,
DiskPartitionRemoteServerPartition?,
DiskPartitionRemoteServerMethod?)>
<!ATTLIST DiskPartition
type (local | remote) #REQUIRED
>
<!ELEMENT DiskPartitionName (#PCDATA)>
<!ELEMENT DiskPartitionResponseTime (#PCDATA)>
<!ATTLIST DiskPartitionResponseTime
units (sec | msec | usec | nsec) #IMPLIED
>
<!ELEMENT DiskPartitionDisk (#PCDATA)>
<!ELEMENT DiskPartitionRAIDType (EMPTY)>
<!ATTLIST DiskPartitionRAIDType
type (RAID0 | RAID1 | RAID01 | RAID5) #IMPLIED
>
<!ELEMENT DiskPartitionSize (#PCDATA)>
<!ATTLIST DiskPartitionSize
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT DiskPartitionRemoteServerName (#PCDATA)>
<!ELEMENT DiskPartitionRemoteServerPartition (#PCDATA)>
<!ELEMENT DiskPartitionRemoteServerMethod (#PCDATA)>
<!ATTLIST DiskPartitionRemoteServerMethod
method (cifs | nfs | iscsi | fc) #REQUIRED
>
<!ELEMENT Memory (#PCDATA)>
<!ATTLIST Memory
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT PageSize (#PCDATA)>
<!ATTLIST PageSize
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT OSVersion (#PCDATA)>
<!ELEMENT OSName (#PCDATA)>
<!ELEMENT Collector (#PCDATA)>
<!ELEMENT TimeZone (#PCDATA)>
<!-- ============================================================= -->
<!-- Scan start time -->
<!-- ============================================================= -->
<!-- When present, this should be before any scan tags -->
<!ELEMENT Start (EMPTY)>
<!ATTLIST Start
time CDATA #REQUIRED
units (sec | msec | usec) #IMPLIED
>
<!-- ============================================================= -->
<!-- Server software description -->
<!-- ============================================================= -->
<!ELEMENT Scan (Globals*, DynamicDisk*, Process*)>
<!ATTLIST Scan
time CDATA #REQUIRED
units (sec | msec | usec) #IMPLIED
>
<!-- Globals are system-wide measurements unrelated to specific -->
<!-- processes. Many attributes are optional. All attributes may -->
<!-- be accumulate, or represent values since the last scan (the -->
<!-- default). -->
<!ELEMENT Globals (CPUTime, CPU?,
GlobalReads?, GlobalWrites?,
GlobalIOBytes?, GlobalReadBytes?, GlobalWriteBytes?,
GlobalIORate?, GlobalReadRate?, GlobalWriteRate?,
GlobalIOSize?, GlobalReadSize?, GlobalWriteSize?,
GlobalMinorFaults?, GlobalMajorFaults?,
PagesIn?, PageInBytes?, PageInRate?,
PagesOut?, PageOutBytes?, PageOutRate?,
PageReqs?,
GlobalSize?, GlobalRSS?)>
<!ATTLIST Globals
accumulate (yes | no) #IMPLIED
>
<!-- These elements are required for each Globals entity -->
<!-- By default the CPUTime is expressed in seconds -->
<!ELEMENT CPUTime (#PCDATA)>
<!ATTLIST CPUTime
accumulate (yes | no) #IMPLIED
units (sec | msec | usec) #IMPLIED
>
<!-- These elements are optional -->
<!-- If no CPU is specified, these global measurements apply to -->
<!-- all processes on all processors -->
<!ELEMENT CPU (#PCDATA)>
<!-- Reads and writes are physical operations only -->
<!ELEMENT GlobalReads (#PCDATA)>
<!ATTLIST GlobalReads
accumulate (yes | no) #IMPLIED
>
<!ELEMENT GlobalWrites (#PCDATA)>
<!ATTLIST GlobalWrites
accumulate (yes | no) #IMPLIED
>
<!-- I/O Size information. -->
<!-- In general, the Bytes varient describes the total of all -->
<!-- I/Os in the time period, whereas the Size varient -->
<!-- describes a single I/O operation. Only one should be -->
<!-- specified. -->
<!-- If the I/O Bytes or Size variables are described, we -->
<!-- shouldn't have the Read/Write varients. These elements -->
<!-- include both reads and writes. -->
<!-- Precludes use of GlobalIOSize, GlobalReadBytes, -->
<!-- GlobalWriteBytes, GlobalReadSize, and GlobalWriteSize -->
<!ELEMENT GlobalIOBytes (#PCDATA)>
<!ATTLIST GlobalIOBytes
units (gb | mb | kb | b) #IMPLIED
accumulate (yes | no) #IMPLIED
>
<!-- Precludes use of GlobalIOBytes, GlobalReadBytes, -->
<!-- GlobalWriteBytes, GlobalReadSize, and GlobalWriteSize -->
<!ELEMENT GlobalIOSize (#PCDATA)>
<!ATTLIST GlobalIOSize
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT GlobalIORate (#PCDATA)>
<!ATTLIST GlobalIORate
units (gb | mb | kb | b) #IMPLIED
>
<!-- Precludes use of GlobalIOBytes, GlobalIOSize, -->
<!-- GlobalReadSize -->
<!ELEMENT GlobalReadBytes (#PCDATA)>
<!ATTLIST GlobalReadBytes
units (gb | mb | kb | b) #IMPLIED
accumulate (yes | no) #IMPLIED
>
<!-- Precludes use of GlobalIOBytes, GlobalIOSize, -->
<!-- GlobalReadBytes -->
<!ELEMENT GlobalReadSize (#PCDATA)>
<!ATTLIST GlobalReadSize
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT GlobalReadRate (#PCDATA)>
<!ATTLIST GlobalReadRate
units (gb | mb | kb | b) #IMPLIED
>
<!-- Precludes use of GlobalIOBytes, GlobalIOSize, -->
<!-- GlobalWriteSize -->
<!ELEMENT GlobalWriteBytes (#PCDATA)>
<!ATTLIST GlobalWriteBytes
units (gb | mb | kb | b) #IMPLIED
accumulate (yes | no) #IMPLIED
>
<!-- Precludes use of GlobalIOBytes, GlobalIOSize, -->
<!-- GlobalWriteBytes -->
<!ELEMENT GlobalWriteSize (#PCDATA)>
<!ATTLIST GlobalWriteSize
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT GlobalWriteRate (#PCDATA)>
<!ATTLIST GlobalWriteRate
units (gb | mb | kb | b) #IMPLIED
>
<!-- Paging system information -->
<!ELEMENT GlobalMinorFaults (#PCDATA)>
<!ATTLIST GlobalMinorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT GlobalMajorFaults (#PCDATA)>
<!ATTLIST GlobalMajorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT PagesIn (#PCDATA)>
<!ATTLIST PagesIn
accumulate (yes | no) #IMPLIED
>
<!ELEMENT PageInBytes (#PCDATA)>
<!ATTLIST PageInBytes
accumulate (yes | no) #IMPLIED
>
<!ELEMENT PageInRate (#PCDATA)>
<!ELEMENT PagesOut (#PCDATA)>
<!ATTLIST PagesOut
accumulate (yes | no) #IMPLIED
>
<!ELEMENT PageOutBytes (#PCDATA)>
<!ATTLIST PageOutBytes
accumulate (yes | no) #IMPLIED
>
<!ELEMENT PageOutRate (#PCDATA)>
<!ELEMENT PageReqs (#PCDATA)>
<!ATTLIST PageReqs
accumulate (yes | no) #IMPLIED
>
<!ELEMENT GlobalSize (#PCDATA)>
<!ATTLIST GlobalSize
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT GlobalRSS (#PCDATA)>
<!ATTLIST GlobalRSS
units (gb | mb | kb | b) #IMPLIED
>
<!-- DynamicDisk values differ from the start Disk values only -->
<!-- in that they're measured on the fly istead of summarized. -->
<!ELEMENT DynamicDisk (DynamicDiskName, DynamicDiskTransfers?,
DynamicDiskResponseTime?,
DynamicDiskReads?, DynamicDiskWrites?,
DynamicDiskReadBytes?, DynamicDiskWriteBytes?)>
<!ATTLIST DynamicDisk
accumulate (yes | no) #IMPLIED
>
<!ELEMENT DynamicDiskName (#PCDATA)>
<!ELEMENT DynamicDiskResponseTime (#PCDATA)>
<!ATTLIST DynamicDiskResponseTime
units (sec | msec | usec) #IMPLIED
>
<!ELEMENT DynamicDiskTransfers (#PCDATA)>
<!ELEMENT DynamicDiskReads (#PCDATA)>
<!ELEMENT DynamicDiskWrites (#PCDATA)>
<!ELEMENT DynamicDiskReadBytes (#PCDATA)>
<!ATTLIST DynamicDiskReadBytes
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT DynamicDiskWriteBytes (#PCDATA)>
<!ATTLIST DynamicDiskWriteBytes
units (gb | mb | kb | b) #IMPLIED
>
<!-- Process information refers to either a process or a thread. -->
<!-- If it's a thread, all threads for a given process should be -->
<!-- included. Idle processes which represent non-utilization -->
<!-- should not be included. -->
<!-- As with Global measurements, these may be accumulate or -->
<!-- non-accumulate -->
<!ELEMENT Process (ProcessID, ProcessSize, ProcessName,
ProcessCPU, MinorFaults, MajorFaults, InputBlocks, OutputBlocks,
ProcessThread?, ProcessParent?, ProcessGroup?, ProcessRSS?,
ProcessUser?, ProcessApplication?, ProcessTask?,
ProcessArgs?, ProcessPriority?, Swaps?,
InputBytes?, OutputBytes?, IOBytes?, ProcessStart?)>
<!-- start/units are only used if this is a new process -->
<!ATTLIST Process
accumulate (yes | no) #IMPLIED
new (yes | no) #IMPLIED
start CDATA #IMPLIED
units (sec | msec | usec) #IMPLIED
>
<!-- The following elements are NOT optional -->
<!ELEMENT ProcessID (#PCDATA)>
<!ELEMENT ProcessSize (#PCDATA)>
<!ATTLIST ProcessSize
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT ProcessName (#PCDATA)>
<!ATTLIST ProcessName
accumulate (yes | no) #IMPLIED
>
<!ELEMENT ProcessCPU (#PCDATA)>
<!ATTLIST ProcessCPU
accumulate (yes | no) #IMPLIED
units (sec | msec | usec) #IMPLIED
>
<!ELEMENT MinorFaults (#PCDATA)>
<!ATTLIST MinorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT MajorFaults (#PCDATA)>
<!ATTLIST MajorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT InputBlocks (#PCDATA)>
<!ATTLIST InputBlocks
accumulate (yes | no) #IMPLIED
>
<!ELEMENT OutputBlocks (#PCDATA)>
<!ATTLIST OutputBlocks
accumulate (yes | no) #IMPLIED
>
<!-- The following elements are optional but highly recommened -->
<!ELEMENT ProcessThread (#PCDATA)>
<!ELEMENT ProcessParent (#PCDATA)>
<!ELEMENT ProcessGroup (#PCDATA)>
<!ELEMENT ProcessUser (#PCDATA)>
<!ELEMENT ProcessApplication (#PCDATA)>
<!ELEMENT ProcessTask (#PCDATA)>
<!ELEMENT ProcessRSS (#PCDATA)>
<!ATTLIST ProcessRSS
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT ProcessArgs (#PCDATA)>
<!ELEMENT ProcessPriority (#PCDATA)>
<!ELEMENT Swaps (#PCDATA)>
<!ATTLIST Swaps
accumulate (yes | no) #IMPLIED
>
<!ELEMENT InputBytes (#PCDATA)>
<!ATTLIST InputBytes
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT OutputBytes (#PCDATA)>
<!ATTLIST OutputBytes
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT IOBytes (#PCDATA)>
<!ATTLIST IOBytes
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!-- ProcessStart is ignored for non-incremental imports -->
<!ELEMENT ProcessStart (#PCDATA)>
<!ATTLIST ProcessStart
time CDATA #REQUIRED
units (sec | msec | usec) #IMPLIED
>
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- ============================================================= -->
<!-- OPNET server import DTD v0.08 -->
<!-- ============================================================= -->
<!-- The top-level document -->
<!ELEMENT GenericServerImport (System, Scan*)>
<!-- ============================================================= -->
<!-- Server hardware description -->
<!-- ============================================================= -->
<!ELEMENT System (CPUCount, ServerName?, Manufacturer?, Model?,
Processor?, ProcessorSpeed?, ProcessorManufacturer?,
Network?, AttachedStorage?, DiskPartitions?, Memory?)>
<!-- CPU count is a required element, all others are optional -->
<!ELEMENT CPUCount (#PCDATA)>
<!ELEMENT ServerName (#PCDATA)>
<!ELEMENT Manufacturer (#PCDATA)>
<!ELEMENT Model (#PCDATA)>
<!ELEMENT Processor (#PCDATA)>
<!ELEMENT ProcessorSpeed (#PCDATA)>
<!ELEMENT ProcessorManufacturer (#PCDATA)>
<!ELEMENT Network (NetworkInterface+)>
<!ELEMENT NetworkInterface (#PCDATA)>
<!ATTLIST NetworkInterface
technology (enet | ethcoax| atm | fr | fc | ppp) #IMPLIED
bps CDATA #REQUIRED
ipaddress CDATA #IMPLIED
>
<!ELEMENT AttachedStorage (DiskInterface+)>
<!ELEMENT DiskInterface (DiskInterfaceName, Channel+)>
<!ELEMENT DiskInterfaceName (#PCDATA)>
<!ELEMENT Channel (Disk+)>
<!ELEMENT Disk (DiskManufacturer, DiskModel, DiskName)>
<!ELEMENT DiskName (#PCDATA)>
<!ELEMENT DiskManufacturer (#PCDATA)>
<!ELEMENT DiskModel (#PCDATA)>
<!ELEMENT DiskPartitions (#PCDATA)>
<!ELEMENT Memory (#PCDATA)>
<!ATTLIST Memory
units (gb | mb | kb | b) #IMPLIED
>
<!-- ============================================================= -->
<!-- Server software description -->
<!-- ============================================================= -->
<!ELEMENT Scan (Globals*, Process*)>
<!ATTLIST Scan
Time CDATA #REQUIRED
Units (sec | msec | usec) #IMPLIED
>
<!-- Globals are system-wide measurements unrelated to specific -->
<!-- processes. Many attributes are optional. All attributes may -->
<!-- be accumulate, or represent values since the last scan (the -->
<!-- default). -->
<!ELEMENT Globals (CPUTime, CPU?,
GlobalReads?, GlobalWrites?,
GlobalReadSize?, GlobalWriteSize?,
GlobalMinorFaults?, GlobalMajorFaults?,
PagesIn?, PagesOut?,
GlobalSize?, GlobalRSS?)>
<!ATTLIST Globals
accumulate (yes | no) #IMPLIED
>
<!-- These elements are required for each Globals entity -->
<!-- By default the CPUTime is expressed in seconds -->
<!ELEMENT CPUTime (#PCDATA)>
<!ATTLIST CPUTime
accumulate (yes | no) #IMPLIED
units (sec | msec | usec) #IMPLIED
>
<!-- These elements are optional -->
<!-- If no CPU is specified, these global measurements apply to -->
<!-- all processes on all processors -->
<!ELEMENT CPU (#PCDATA)>
<!-- Reads and writes are physical operations only -->
<!ELEMENT GlobalReads (#PCDATA)>
<!ATTLIST GlobalReads
accumulate (yes | no) #IMPLIED
>
<!ELEMENT GlobalWrites (#PCDATA)>
<!ATTLIST GlobalWrites
accumulate (yes | no) #IMPLIED
>
<!ELEMENT GlobalReadSize (#PCDATA)>
<!ATTLIST GlobalReadSize
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT GlobalWriteSize (#PCDATA)>
<!ATTLIST GlobalWriteSize
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!-- Paging system information -->
<!ELEMENT GlobalMinorFaults (#PCDATA)>
<!ATTLIST GlobalMinorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT GlobalMajorFaults (#PCDATA)>
<!ATTLIST GlobalMajorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT PagesIn (#PCDATA)>
<!ATTLIST PagesIn
accumulate (yes | no) #IMPLIED
>
<!ELEMENT PagesOut (#PCDATA)>
<!ATTLIST PagesOut
accumulate (yes | no) #IMPLIED
>
<!ELEMENT GlobalSize (#PCDATA)>
<!ATTLIST GlobalSize
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT GlobalRSS (#PCDATA)>
<!ATTLIST GlobalRSS
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!-- Process information refers to either a process or a thread. -->
<!-- If it's a thread, all threads for a given process should be -->
<!-- included. Idle processes which represent non-utilization -->
<!-- should not be included. -->
<!-- As with Global measurements, these may be accumulate or -->
<!-- non-accumulate -->
<!ELEMENT Process (ProcessID, ProcessSize, ProcessName,
ProcessCPU, MinorFaults, MajorFaults, InputBlocks, OutputBlocks,
ProcessThread?, ProcessParent?, ProcessGroup?, ProcessRSS?,
ProcessUser?, ProcessApplication?, ProcessTask?,
ProcessArgs?, ProcessPriority?, Swaps?,
InputBytes?, OutputBytes?)>
<!ATTLIST Process
accumulate (yes | no) #IMPLIED
new (yes | no) #IMPLIED
>
<!-- The following elements are NOT optional -->
<!ELEMENT ProcessID (#PCDATA)>
<!ELEMENT ProcessSize (#PCDATA)>
<!ATTLIST ProcessSize
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT ProcessName (#PCDATA)>
<!ATTLIST ProcessName
accumulate (yes | no) #IMPLIED
>
<!ELEMENT ProcessCPU (#PCDATA)>
<!ATTLIST ProcessCPU
accumulate (yes | no) #IMPLIED
Units (sec | msec | usec) #IMPLIED
>
<!ELEMENT MinorFaults (#PCDATA)>
<!ATTLIST MinorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT MajorFaults (#PCDATA)>
<!ATTLIST MajorFaults
accumulate (yes | no) #IMPLIED
>
<!ELEMENT InputBlocks (#PCDATA)>
<!ATTLIST InputBlocks
accumulate (yes | no) #IMPLIED
>
<!ELEMENT OutputBlocks (#PCDATA)>
<!ATTLIST OutputBlocks
accumulate (yes | no) #IMPLIED
>
<!-- The following elements are optional but highly recommened -->
<!ELEMENT ProcessThread (#PCDATA)>
<!ELEMENT ProcessParent (#PCDATA)>
<!ELEMENT ProcessGroup (#PCDATA)>
<!ELEMENT ProcessUser (#PCDATA)>
<!ELEMENT ProcessApplication (#PCDATA)>
<!ELEMENT ProcessTask (#PCDATA)>
<!ELEMENT ProcessRSS (#PCDATA)>
<!ATTLIST ProcessRSS
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT ProcessArgs (#PCDATA)>
<!ELEMENT ProcessPriority (#PCDATA)>
<!ELEMENT Swaps (#PCDATA)>
<!ATTLIST Swaps
accumulate (yes | no) #IMPLIED
>
<!ELEMENT InputBytes (#PCDATA)>
<!ATTLIST InputBytes
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>
<!ELEMENT OutputBytes (#PCDATA)>
<!ATTLIST OutputBytes
accumulate (yes | no) #IMPLIED
units (gb | mb | kb | b) #IMPLIED
>