source: DCWoRMS/branches/coolemall/simulator/schemas/resources/DCWormsResSchema.xsd @ 961

Revision 961, 19.7 KB checked in by wojtekp, 12 years ago (diff)
  • Property svn:mime-type set to text/plain
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
3        elementFormDefault="qualified" attributeFormDefault="unqualified">
4               
5                <xs:complexType name="pluginType">
6                <xs:annotation>
7                        <xs:documentation>Base plugin type.
8                        Plugins allow configuring and adapting the simulation framework to his/her experiment
9                        starting from modeling job performance, through method of calculating energy estimation up to implementation of scheduling policies
10                        Name of the plugin specifies the JAVA class that implements dedicated interface.</xs:documentation>
11                </xs:annotation>
12                <xs:sequence>
13                        <xs:element name="name" type="xs:string"></xs:element>
14                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
15                </xs:sequence>
16        </xs:complexType>
17       
18        <xs:complexType name="timeEstimationPluginType">
19                <xs:annotation>
20                        <xs:documentation>TimeEstimationPlugin derived from pluginType.
21                        Time estimation plugin provides means to include specific application performance models during simulations
22                        and allows introducing specific ways of calculating task execution time.</xs:documentation>
23                </xs:annotation>
24                <xs:complexContent>
25                        <xs:restriction base="pluginType">
26                                <xs:sequence>
27                                        <xs:element name="name" type="xs:string" default="ExecTimeEstimationPlugin"></xs:element>
28                                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
29                                </xs:sequence>
30                        </xs:restriction>
31                </xs:complexContent>   
32        </xs:complexType>
33       
34        <xs:complexType name="resourceType">
35                <xs:annotation>
36                        <xs:documentation>Base resource type.
37                        It allows to define simulation entities like computing resources, devices, schedulers.
38                        Attributes: class - determines the component of the architecture i.e. rack, processor, memory, storage etc.
39                        type - type of resource; for instance, continuous for memory, bandwidth, etc. and discrete for processors
40                        name - unique resource identifier, if not specified it will be generated by the simulator in the following manner: class + "_" + subsequent_natural_number
41                        </xs:documentation>
42                </xs:annotation>
43                <xs:sequence>
44                        <xs:element name="description" type="xs:string" minOccurs="0"></xs:element>
45                </xs:sequence>
46                <xs:attribute name="class" type="xs:string" use="required"/>
47                <xs:attribute name="type" type="xs:string" use="optional"/>
48                <xs:attribute name="name" type="xs:string" use="optional"/>
49        </xs:complexType>
50
51        <xs:complexType name="computingResourceType">
52                <xs:annotation>
53                        <xs:documentation> ComputingResource derived from resourceType
54                        Computing resource specifies resources that are able to perform computing operations.
55                        From the simulator point of view computing resource is everything that is/contains processing element.
56                        Hence, all entities like core, processor, computing node, as well as those which aggregate them (like shelf, rack, container etc.)
57                        should be define using this type. This way of description provides flexibility in defining system architecture
58                        and allows to build hierarchy of resources that corresponds to real world.
59                        Attributes: groupId - allows to group resources of the given class in the logical structures that can be used during binding them with schedulers
60                        count - defines number of resources of the given class</xs:documentation>
61                </xs:annotation>
62                <xs:complexContent>
63                        <xs:extension base="resourceType">
64                                <xs:sequence>
65                                        <xs:choice>
66                                                <xs:sequence>
67                                                        <xs:element name="resourceUnit" type="resourceUnitType" minOccurs="0" maxOccurs="unbounded"></xs:element>
68                                                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
69                                                        <xs:element name="profile" type="profileType" minOccurs="0" maxOccurs="1"></xs:element>
70                                                        <xs:element name="location" type="locationType" minOccurs="0" maxOccurs="1"></xs:element>
71                                                        <xs:element name="computingResource" type="computingResourceType" minOccurs="0" maxOccurs="unbounded"></xs:element>
72                                                </xs:sequence>
73                                                <xs:sequence>
74                                                        <xs:element name="templateId" type="xs:string"/>
75                                                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
76                                                        <xs:element name="location" type="locationType" minOccurs="0" maxOccurs="1"></xs:element>
77                                                </xs:sequence>
78                                        </xs:choice>
79                                </xs:sequence>
80                                <xs:attribute name="groupId" type="xs:integer" use="optional"/>                 
81                                <xs:attribute name="count" type="xs:integer" use="optional"/>
82                        </xs:extension>
83                </xs:complexContent>
84        </xs:complexType>
85       
86        <xs:complexType name="computingResourceTemplateType">
87                <xs:annotation>
88                        <xs:documentation>ComputingResourceTemplate derived from resourceType.
89                        It allows user to define model of computing resource component that may constitute other computing resources
90                        Computing resource templates can be then referred in computing resource definition</xs:documentation>
91                </xs:annotation>
92                <xs:complexContent>
93                        <xs:extension base="resourceType">
94                                <xs:sequence>
95                                        <xs:element name="resourceUnit" type="resourceUnitType" minOccurs="0" maxOccurs="unbounded"></xs:element>
96                                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
97                                        <xs:element name="profile" type="profileType" minOccurs="0" maxOccurs="1"></xs:element>
98                                        <xs:element name="computingResource" type="computingResourceType" minOccurs="0" maxOccurs="unbounded"></xs:element>
99                                </xs:sequence>
100                        </xs:extension>
101                </xs:complexContent>
102        </xs:complexType>
103
104        <xs:complexType name="schedulerType">
105                <xs:annotation>
106                        <xs:documentation>Scheduler derived from resourceType.
107                        It allows to model scheduling entity responsible for managing resources.</xs:documentation>
108                </xs:annotation>
109                <xs:complexContent>
110                        <xs:extension base="resourceType">
111                                <xs:sequence>
112                                        <xs:element name="schedulingPlugin" type="schedulingPluginType" minOccurs="0" maxOccurs="1"></xs:element>
113                                        <xs:element name="queues" type="queueListType" minOccurs="0"></xs:element>
114                                        <xs:choice minOccurs="1" maxOccurs="unbounded">
115                                                <xs:element name="scheduler" type="schedulerType"></xs:element>
116                                                <xs:element name="managedComputingResources" type="managedComputingResourcesType"></xs:element>
117                                        </xs:choice>
118                                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
119                                </xs:sequence>
120                        </xs:extension>
121                </xs:complexContent>
122        </xs:complexType>
123       
124        <xs:complexType name="schedulingPluginType">
125                <xs:annotation>
126                        <xs:documentation>SchedulingPlugin derived from pluginType.
127                        Scheduling plugins allow plugging scheduling algorithms into the simulated environment.
128                        Elements: frequency - is used to enable scheduling periodically; it specifies the time interval (in seconds by default) between subsequent scheduling invocations
129                        </xs:documentation>
130                </xs:annotation>
131                <xs:complexContent>
132                        <xs:extension base="pluginType">
133                                <xs:sequence>
134                                        <xs:element name="frequency" type="doubleValueWithUnitType" minOccurs="0" maxOccurs="1"></xs:element>
135                                </xs:sequence>
136                        </xs:extension>
137                </xs:complexContent>
138        </xs:complexType>
139       
140        <xs:complexType name="resourceUnitType">
141                <xs:annotation>
142                        <xs:documentation>Resource unit is used to define non-computing resource like memory, storage etc.
143                        Elements: amount - represents concrete amount (values) of specific resource unit</xs:documentation>
144                </xs:annotation>
145                <xs:complexContent>
146                        <xs:extension base="resourceType">
147                                <xs:sequence>
148                                        <xs:element name="amount" type="doubleValueWithUnitType"/>
149                                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
150                                </xs:sequence>
151                        </xs:extension>
152                </xs:complexContent>
153        </xs:complexType>
154
155        <xs:complexType name="doubleValueWithUnitType">
156                <xs:annotation>
157                        <xs:documentation>DoubleValueWitUnit derived from double. Allows providing units in which the given value is expressed
158                        Attributes: unit - indicates appropriate units, for instance: seconds, watts, bytes etc. </xs:documentation>
159                </xs:annotation>
160                <xs:simpleContent>
161                        <xs:extension base="xs:double">
162                                <xs:attribute name="unit" type="xs:string" use="optional"/>
163                        </xs:extension>
164                </xs:simpleContent>     
165        </xs:complexType>
166       
167        <xs:complexType name="stringValueWithUnitType">
168                <xs:annotation>
169                        <xs:documentation>StringValueWitUnit derived from string. Allows providing units in which the given value is expressed
170                        Attributes: unit - indicates appropriate units. </xs:documentation>
171                </xs:annotation>
172                <xs:simpleContent>
173                        <xs:extension base="xs:string">
174                                <xs:attribute name="unit" type="xs:string" use="optional"/>
175                        </xs:extension>
176                </xs:simpleContent>     
177        </xs:complexType>
178       
179        <xs:complexType name="queueListType">
180                <xs:annotation>
181                        <xs:documentation>Profile acts as a container for resource profiles: power and air throughput</xs:documentation>
182                </xs:annotation>
183                <xs:sequence>
184                        <xs:element name="queue" type="queueType" minOccurs="1" maxOccurs="unbounded"></xs:element>
185                </xs:sequence>
186        </xs:complexType>
187       
188        <xs:complexType name="queueType">
189                <xs:annotation>
190                        <xs:documentation>Profile acts as a container for resource profiles: power and air throughput</xs:documentation>
191                </xs:annotation>
192                <xs:sequence>
193                        <xs:element name="name" type="xs:string"></xs:element>
194                        <xs:element name="priority" type="xs:int" minOccurs="0"></xs:element>
195                        <xs:element name="reservation" type="xs:boolean" minOccurs="0" ></xs:element>
196                </xs:sequence>
197        </xs:complexType>
198       
199        <xs:complexType name="managedComputingResourcesType">
200                <xs:annotation>
201                        <xs:documentation>ManagedComputingResource type specifies computing resources controlled by scheduler.
202                        They can be provided either by listing their names or listing the group ids which they belong to.
203                        Attributes: include - specifies whether the given resource layer (listed resources) can be allocated by the scheduler
204                        In other words, false (default) value indicates that scheduler maneges only the subcomponents of the listed resources;
205                        true value determines that also listed resources will be under the control of the defined scheduler</xs:documentation>
206                </xs:annotation>
207                <xs:choice>
208                        <xs:element name="resourceName" type="xs:string" minOccurs="1" maxOccurs="unbounded"></xs:element>
209                        <xs:element name="resourceGroupId" type="xs:string" minOccurs="1" maxOccurs="unbounded"></xs:element>
210                </xs:choice>
211                <xs:attribute name="include" type="xs:boolean" default="false"/>
212        </xs:complexType>
213
214        <xs:complexType name="energyEstimationPluginType">
215                <xs:annotation>
216                        <xs:documentation>EnergyEstimationPlugin derived from pluginType.
217                        Energy estimation plugin is used to estimate energy consumption of the given computing resource.
218                        It has access to the detailed resource description including power and air throughput profiles
219                        and application characteristics running on a given resource</xs:documentation>
220                </xs:annotation>
221                <xs:complexContent>
222                        <xs:extension base="pluginType"/>
223                </xs:complexContent>
224        </xs:complexType>
225       
226        <xs:complexType name="profileType">
227                <xs:annotation>
228                        <xs:documentation>Profile acts as a container for resource profiles: power and air throughput</xs:documentation>
229                </xs:annotation>
230                <xs:sequence>
231                        <xs:element name="powerProfile" type="powerProfileType" minOccurs="0"></xs:element>
232                        <xs:element name="airThroughputProfile" type="airThroughputProfileType" minOccurs="0"></xs:element>
233                        <xs:element name="thermalProfile" type="thermalProfileType" minOccurs="0"></xs:element>
234                </xs:sequence>
235        </xs:complexType>
236       
237        <xs:complexType name="powerProfileType">
238                <xs:annotation>
239                        <xs:documentation>Power profile provides energyEstimation plugin, powerStates and other power-related parameters definition</xs:documentation>
240                </xs:annotation>
241                <xs:sequence>
242                        <xs:element name="energyEstimationPlugin" type="energyEstimationPluginType" minOccurs="0"></xs:element>
243                        <xs:element name="powerStates" type="powerStatesType" minOccurs="0"></xs:element>
244                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
245                </xs:sequence>
246        </xs:complexType>
247       
248        <xs:complexType name="powerStatesType">
249                <xs:annotation>
250                        <xs:documentation>PowerState type act as a container for power states. It contains energy-related characteristics of the computing resource</xs:documentation>
251                </xs:annotation>
252                <xs:sequence>
253                        <xs:element name="powerState" type="powerStateType" minOccurs="1" maxOccurs="unbounded"></xs:element>
254                </xs:sequence>
255        </xs:complexType>
256       
257        <xs:complexType name="powerStateType">
258                <xs:annotation>
259                        <xs:documentation>Power state defines available (for computing resource) power states.
260                        Elements: name - denotes name of the given power state
261                        powerUsage - defines power consumption in the given state
262                        transition - specifies possible power states transitions from the given power state</xs:documentation>
263                </xs:annotation>
264                <xs:sequence>
265                        <xs:element name="name" type="xs:string"></xs:element>
266                        <xs:element name="powerUsage" type="doubleValueWithUnitType" minOccurs="0" maxOccurs="1"></xs:element>
267                        <xs:element name="transition" type="powerStatesTransitionType" minOccurs="0" maxOccurs="unbounded"></xs:element>
268                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
269                </xs:sequence>
270        </xs:complexType>
271       
272        <xs:complexType name="powerStatesTransitionType">
273                <xs:annotation>
274                        <xs:documentation>Description of power states transtition
275                        Elements: to - denotes name of target power state
276                        powerUsage - defines transition cost in the form of power consumption
277                        time - specifies transition time</xs:documentation>
278                </xs:annotation>
279                <xs:sequence>
280                        <xs:element name="to" type="xs:string"></xs:element>
281                        <xs:element name="powerUsage" type="doubleValueWithUnitType"></xs:element>
282                        <xs:element name="time" type="doubleValueWithUnitType"></xs:element>
283                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
284                </xs:sequence>
285        </xs:complexType>
286       
287        <xs:complexType name="airThroughputEstimationPluginType">
288                <xs:annotation>
289                        <xs:documentation>AirThroughputEstimationPlugin derived from pluginType.
290                        Air Throughput plugin is used to estimate air flow value based on the defined air throughput states</xs:documentation>
291                </xs:annotation>
292                <xs:complexContent>
293                        <xs:extension base="pluginType"/>
294                </xs:complexContent>
295        </xs:complexType>
296       
297        <xs:complexType name="airThroughputProfileType">
298                <xs:annotation>
299                        <xs:documentation>AirThrouhputProfile provides airThroughputEstimation plugin, airThroughputStates and other airThroughput-related parameters definition</xs:documentation>
300                </xs:annotation>
301                <xs:sequence>
302                        <xs:element name="airThroughputEstimationPlugin" type="airThroughputEstimationPluginType" minOccurs="0"></xs:element>
303                        <xs:element name="airThroughputStates" type="airThroughputStatesType" minOccurs="0"></xs:element>
304                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
305                </xs:sequence>
306        </xs:complexType>
307       
308        <xs:complexType name="airThroughputStatesType">
309                <xs:annotation>
310                        <xs:documentation>AirThroughputStates type act as a container for air throughput states.</xs:documentation>
311                </xs:annotation>
312                <xs:sequence>
313                        <xs:element name="airThroughputState" type="airThroughputStateType" minOccurs="1" maxOccurs="unbounded"></xs:element>
314                </xs:sequence>
315                <xs:attribute name="name" type="xs:string" use="optional"/>
316        </xs:complexType>
317       
318        <xs:complexType name="airThroughputStateType">
319                <xs:annotation>
320                        <xs:documentation>Air througput state provides means to define air flow level.
321                        It can represent, for instance, a fan working state</xs:documentation>
322                </xs:annotation>
323                <xs:sequence>
324                        <xs:element name="name" type="xs:string"></xs:element>
325                        <xs:element name="value" type="doubleValueWithUnitType"></xs:element>
326                        <xs:element name="powerUsage" type="doubleValueWithUnitType" minOccurs="0"></xs:element>
327                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
328                </xs:sequence>
329        </xs:complexType>
330       
331        <xs:complexType name="temperatureEstimationPluginType">
332                <xs:annotation>
333                        <xs:documentation>TemperatureEstimationPlugin derived from pluginType.
334                        Temperature plugin is used to estimate temperature based on the defined resource characteristics</xs:documentation>
335                </xs:annotation>
336                <xs:complexContent>
337                        <xs:extension base="pluginType"/>
338                </xs:complexContent>
339        </xs:complexType>
340       
341        <xs:complexType name="thermalProfileType">
342                <xs:annotation>
343                        <xs:documentation>ThermalProfile provides temperatureEstimation plugin,  and other thermal-related parameters definition</xs:documentation>
344                </xs:annotation>
345                <xs:sequence>
346                        <xs:element name="temperatureEstimationPlugin" type="temperatureEstimationPluginType" minOccurs="0"></xs:element>
347                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
348                </xs:sequence>
349        </xs:complexType>
350       
351        <xs:complexType name="locationType">
352                <xs:annotation>
353                        <xs:documentation>The location type describes placement of the computing resource using 3 coordinates</xs:documentation>
354                </xs:annotation>
355                <xs:sequence>
356                        <xs:element name="horizontal" type="xs:long"/>
357                        <xs:element name="vertical" type="xs:long"/>
358                        <xs:element name="depth" type="xs:long"/>
359                        <xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"></xs:element>
360                </xs:sequence>
361        </xs:complexType>
362       
363        <xs:complexType name="parameterType">
364                <xs:annotation>
365                        <xs:documentation>Parameter of resource. Allows defining additional resource parameters.
366                        Contains a list of parameter values or a list of key-value pairs.
367                        Attribute : name - denotes parameter name</xs:documentation>
368                </xs:annotation>
369                <xs:choice>
370                        <xs:element name="value" type="stringValueWithUnitType" minOccurs="0" maxOccurs="unbounded"/>
371                        <xs:sequence>
372                                <xs:element name="property" minOccurs="0" maxOccurs="unbounded">
373                                        <xs:complexType>
374                                                <xs:annotation>
375                                                        <xs:documentation>Property of parameter. Allows defining additional properties of parameter as a list of values.
376                                                        Attribute : name - denotes property name</xs:documentation>
377                                                </xs:annotation>
378                                                <xs:sequence>
379                                                        <xs:element name="value" type="stringValueWithUnitType" minOccurs="0" maxOccurs="unbounded"/>
380                                                </xs:sequence>
381                                                <xs:attribute name="name" type="xs:string" use="required"/>
382                                        </xs:complexType>
383                                </xs:element>
384                        </xs:sequence>
385                </xs:choice>
386                <xs:attribute name="name" type="xs:string" use="required"/>
387        </xs:complexType>
388       
389        <xs:element name="environment">
390                <xs:annotation>
391                        <xs:documentation>Schema describing simulation environment</xs:documentation>
392                </xs:annotation>
393                <xs:complexType>
394                        <xs:sequence>
395                                <xs:element name="description" type="xs:string" minOccurs="0" ></xs:element>
396                                <xs:element name="timeEstimationPlugin" type="timeEstimationPluginType" minOccurs="0" maxOccurs="1"></xs:element>
397                                <xs:element name="resources">
398                                        <xs:annotation>
399                                                <xs:documentation>Description of resources</xs:documentation>
400                                        </xs:annotation>
401                                        <xs:complexType>
402                                                <xs:sequence>
403                                                        <xs:element name="description" type="xs:string" minOccurs="0" ></xs:element>
404                                                        <xs:element name="computingResource" type="computingResourceType" maxOccurs="unbounded"/>
405                                                        <xs:element name="scheduler" type="schedulerType" maxOccurs="unbounded"/>
406                                                </xs:sequence>
407                                        </xs:complexType>
408                                </xs:element>
409                                <xs:element name="templates" minOccurs="0">
410                                        <xs:annotation>
411                                                <xs:documentation>Definition of computing resource templates that can/will be used in resource description section </xs:documentation>
412                                        </xs:annotation>
413                                        <xs:complexType>
414                                                <xs:sequence>
415                                                        <xs:element name="description" type="xs:string" minOccurs="0" ></xs:element>
416                                                        <xs:element name="computingResourceTemplate" type="computingResourceTemplateType" maxOccurs="unbounded"/>
417                                                </xs:sequence>
418                                        </xs:complexType>
419                                </xs:element>
420                        </xs:sequence>
421                </xs:complexType>
422        </xs:element>
423
424</xs:schema>
Note: See TracBrowser for help on using the repository browser.