Design time validation of systems

Abstract

In accordance with certain aspects of the design time validation of systems, a description of a system being designed and a description of an environment are received. Both of the received descriptions are used to validate the system against the environment while the system is being designed and prior to attempting to deploy the system.

Description

TECHNICAL FIELD

[0002] The invention relates to the design of systems, and more particularly to design time validation of systems.

BACKGROUND

[0003] Internet usage has exploded over the past several years and continues to grow. People have become very comfortable with many services offered on the World Wide Web (or simply “Web”), such as electronic mail, online shopping, gathering news and information, listening to music, viewing video clips, looking for jobs, and so forth. To keep pace with the growing demand for Internet-based services, there has been tremendous growth in the computer systems dedicated to hosting Websites, providing backend services for those sites, and storing data associated with the sites.

[0004] One type of distributed computer system is a data center (such as an Internet data center (IDC) or an Enterprise Data Center (EDC)), which is a specifically designed complex that houses many computers for hosting network-based services. Data centers, which may also go by the names of “Webfarms” or “server farms”, typically house hundreds to thousands of computers in climate-controlled, physically secure buildings. Data centers typically provide reliable Internet access, reliable power supplies, and a secure operating environment.

[0005] Different data centers can have different requirements that they impose on applications run in the data centers. For example, different data centers may require different types of security to be enforced, or require that applications support different communication protocols. Additionally, some data centers may change these requirements over time. These differences among data centers makes the design process of applications difficult, as the designers must be aware of these different requirements and account for them in the design of their applications in order for their applications to be able to be run on the desired data center(s).

[0006] Furthermore, currently a designer is typically only able to evaluate whether their application will run in a particular data center when they are deploying their application to the data center. If the deployment is unsuccessful because one or more of the requirements of the data center are not satisfied by the application, then the designer is required to attempt to fix the problem(s) with the application and then re-attempt deployment of the application at the data center. This process can be repeated many times, and can result in an inefficient and frustrating design process.

[0007] The design time validation of systems described herein solves these and other problems.

SUMMARY

[0008] Design time validation of systems is described herein.

[0009] In accordance with certain aspects of the design time validation of systems, a description of a system being designed and a description of an environment are received. Both of the received descriptions are used to validate the system against the environment while the system is being designed and prior to attempting to deploy the system.

BRIEF DESCRIPTION OF THE DRAWINGS

[0010] The same numbers are used throughout the drawings to reference like features.

[0011] FIG. 1 illustrates an example network setting.

[0012] FIG. 2 is a block diagram illustrating an example architecture using system definition model.

[0013] FIG. 3 illustrates an example layered setting.

[0014] FIG. 4 is a flowchart illustrating an example process for design time validation.

[0015] FIGS. 5A and 5B are a flowchart illustrating an example recursive expansion process that creates an instance space.

[0016] FIGS. 6A and 6B are a flowchart illustrating an example process for evaluating flows.

[0017] FIGS. 7A, 7B, 7C, 7D, and 7E are a flowchart illustrating an example process for evaluating constraints.

[0018] FIG. 8 illustrates an example SDM document.

[0019] FIG. 9 illustrates an example SDM definition.

[0020] FIG. 10 illustrates an example SDM member.

[0021] FIG. 11 illustrates an example setting member.

[0022] FIG. 12 illustrates an example constraint definition.

[0023] FIG. 13 illustrates an example description object.

[0024] FIG. 14 illustrates an example mapping of a web application in one layer to a web server host in another layer.

[0025] FIG. 15 illustrates an example built-in datatype hierarchy.

[0026] FIG. 16 illustrates an example of upcasting and downcasting.

[0027] FIG. 17 illustrates an example of type conversion.

[0028] FIG. 18 illustrates an example relationship tree.

[0029] FIG. 19 illustrates an example of using delegation to expose a host's implementation to a guest.

[0030] FIG. 20 illustrates an example of using delegation to expose a member's implementation to a parent.

[0031] FIGS. 21 and 22 illustrate examples of communication connectivity validation.

[0032] FIG. 23 illustrates an example of zone boundaries.

[0033] FIG. 24 illustrates an example instance space.

[0034] FIG. 25 illustrates an example general computer environment, which can be used to implement the techniques described herein.

DETAILED DESCRIPTION

[0035] The following disclosure describes a number of aspects pertaining to an architecture for design time validation of systems. The disclosure includes discussion of a system definition model (SDM), which may also be referred to as a service definition model (SDM). The SDM provides tools and a context for an application architect to design distributed computer applications and data centers in an abstract manner. The model defines a set of elements that represent functional units of the applications that will eventually be implemented by physical computer resources and software. Associated with the model elements is a schema that dictates how functional operations represented by the components are to be specified.

[0036] As used herein, the term “wire” may also be referred to as “connections”, “communication”, or “communication relationship”. Also, the term “system” may be referred to as “module” and the term “resource space” may be referred to as “resources”. Additionally, the term “application space” may also be referred to as “applications”, and the term “instance space” may also be referred to as “instances”. Further, the term “class” may also be referred to as “abstract definition”, the term “port” may also be referred to as “endpoint”, and the term “type” may also be referred to as “definition”.

[0037] FIG. 1 illustrates an example network setting 100. In setting 100, multiple (x) computing devices 102(1), 102(2), . . . , 102(x) are coupled to a network 106. Network 106 is intended to represent any of a variety of conventional network topologies and types (including wire and/or wireless networks), employing any of a variety of conventional network protocols (including public and/or proprietary protocols). Network 106 may include, for example, a local area network (LAN), a wide area network (WAN), portions of the Internet, and so forth. Setting 100 represents any of a wide variety of settings, including, for example, data centers (e.g., Internet data centers (IDCs)), office or business settings, home settings, educational or research facilities, retail or sales settings, data storage settings, and so forth.

[0038] Computing devices 102 can be any of a variety of conventional computing devices, including desktop PCs, workstations, mainframe computers, server computers, Internet appliances, gaming consoles, handheld computers, cellular telephones, personal digital assistants (PDAs), etc. One or more of devices 102 can be the same types of devices, or alternatively different types of devices. Additionally, even if multiple devices are the same types of devices, the multiple devices may still be configured differently (e.g., two devices 102 may be server computers, but may have different hardware configurations, such as different processors, different amounts of RAM, different sizes of hard disk drives, and so forth).

[0039] One or more computing devices 102 may also be re-configured after being added to setting 100. For example, a particular computing device 102 may operate for a period of time (e.g., on the order of minutes, hours, days, months, etc.) performing one function, and then an administrator may decide that a different function is desirable (e.g., change from being a server computer to a workstation computer, from a web server to a local file server, etc.).

[0040] FIG. 2 is a block diagram illustrating an example architecture 200 using the SDM. The SDM is designed to be used during the design process of systems, and may also be used for deployment and/or management of a system after the design process is complete. A system is a set of related software and/or hardware resources that can work together to accomplish a common function. One example of such a system is an application, which refers to a set of instructions that can be run or executed by a computing device to perform various functionality. Examples of applications include entertainment applications such as games, productivity applications such as word processors, reference applications such as electronic encyclopedias, distributed applications such as may be used for web services or financial analysis, and so forth. Another example of such a system is an environment on which an application (or another environment) can be deployed. An environment refers to the software and/or hardware resources on which an application (or another environment) is deployed. Such environments can be layered on top of one another.

[0041] Generally, during the design process or phase for a system (also referred to as the development process or phase), development tools leveraging the SDM are used to define a system comprised of communicating software and/or hardware components. A system definition contains all information necessary to deploy and operate a distributed system, including required resources, configuration, operational features, policies, etc. After the design phase is complete, a deployment phase can also use the system definition to automatically deploy the system and dynamically allocate and configure the software and hardware (e.g., server, storage and networking) resources required. The same system definition can be used for deployments to different host environments and to different scales.

[0042] The architecture 200 employs the SDM definition model as well as a schema that defines functional operations within the SDM definition model. The definition model includes various different kinds of data structures which are collectively referred to as “definitions”. Functionality of the SDM is exposed through one or more platform services, such as application program interfaces (APIs).

[0043] During the design phase for a system, a development component 202 generates a document that contains the system definition, such as an SDM document 204. Development component 202 can be any of a variety of development components, such as the Visual Studio® development system available from Microsoft® Corporation of Redmond, Wash. SDM document 204 defines all information (also referred to herein as knowledge) related to the deployment (and optionally management) of the system. Any knowledge necessary for or used when deploying the system or managing the system is included in SDM document 204. Although described herein as a single document, it is to be appreciated that the knowledge could alternatively be spread out and maintained in multiple documents.

[0044] A system definition defines a system in terms of one or more of resources, endpoints, relationships and subsystems. A system definition is declared in an SDM document (e.g., an XML document). Resources may be hardware resources or software resources. Endpoints represent communications across systems. Relationships define associations between systems, resources and endpoints. Subsystems can be treated as complete systems and are typically part of a larger system.

[0045] A system definition captures the basic structure of a dynamic system. It can be viewed as the skeleton on which all other information is added. This structure is typically specified during the development process, by designers and developers, and typically does not change frequently. In addition to the structure, the SDM can contain deployment information, installation processes, schemas for configuration, events and instrumentation, automation tasks, health models, operational policies, etc. Other information can be added by the operations staff, by vendors, and/or by management systems across the lifetime of a distributed system.

[0046] SDM document 204 includes one or more constraints (also referred to as requirements) of the system that an environment in which the system is to be deployed and/or run must satisfy. The environment itself is also described using an SDM document referred to as the “logical infrastructure” (LIM) document 206, or as a data center description or data center model. Analogous to SDM document 204, LIM document 206 can be a single document or alternatively made up of two or more documents. LIM document 206 can be generated using any of a variety of development components, such as a component similar to development component 202. LIM document 206 may also be developed using development component 202 (that is, the same development component may be used to generate both SDM document 204 and LIM document 206).

[0047] The environment described by LIM document 206 can be single computing devices, or alternatively collections of computing devices (e.g., data centers), application hosts, etc. Different systems, or even the same system, can be installed to different environments. For example, a data center may include fifty computing devices, and one system may be deployed to five of those computing devices, while another system may be deployed to thirty five of those computing devices. These requirements can take a variety of forms, such as: hardware requirements regarding the computing device(s) on which the system is to be deployed (e.g., a minimum processor speed, a minimum amount of memory, a minimum amount of free hard drive space, a minimum amount of network bandwidth available, particular security mechanisms available, and so forth), software requirements regarding the computing device(s) on which the system is to be deployed (e.g., a particular operating system, one or more other applications that also must be installed, specifications regarding how a particular system and/or the operating system is to be configured, a particular type of security or encryption in use, and so forth), other requirements regarding the computing device(s) on which the system is to be deployed (e.g., particular security keys available, data center policies that must be enforced, authentication that is used, environment topology, etc.). A single system as described in SDM document 204 can be validated against multiple different environments as described in different LIMs 206.

[0048] Requirements can also go in the other direction—that is, the environment can have constraints or requirements on the configuration of the system that is to be installed (e.g., to implement the standards or policies of the environment). These can be “explicit” requirements that are created by the operator of the environment, such as particular settings or configurations the system must have, particular functionality the system must provide or support, particular security mechanisms the system must support, and so forth. These can also be “implicit” requirements that arise because of a particular configuration of the environment. For example, if a host computing device in the environment is using a particular type of file system then it may not be possible for some actions to be performed using that file system (although it may be possible for those same actions to be performed using another file system).

[0049] During the design phase of the system, SDM document 204 can be used to validate the system for one or more particular environment(s) by validation component 208. This is a two-way validation: the system is validated for the environment and the environment is validated for the system. Validation component 208 can validate the environment for the system by comparing the requirements identified in the SDM document 204 with the environment as described in the LIM document 206, and determining whether all of the requirements are satisfied by the environment. Validation component 208 can validate the system for the environment by comparing the requirements identified in the LIM document 206 with the system as described in the SDM document 204 and determining whether all of the requirements are satisfied by the system. If all of the requirements are satisfied by the environment and the system, then the designer or developer knows that the system can be deployed in and will run in the environment. However, if all of the requirements are not satisfied by the environment and/or the system, then validation component 208 can inform the designer or developer of the requirements that were not satisfied, thereby informing the designer or developer of what changes should be made to the SDM document 204 (and correspondingly to the system) and/or to the environment in order for the system to be deployed and run in that environment.

[0050] The LIM document 206 can be for an actual environment or alternatively a simulated environment. For an actual environment, the LIM describes an environment that exists or that has been described but not yet created. For example, an actual environment could be a data center currently in existence, or a data center that has been designed but not actually implemented yet. For a simulated environment, the LIM describes an anticipated environment which may not necessarily exist. Various assumptions about the anticipated environment may be made, whereas for an actual environment such assumptions need not be made. Typically, during the design process for a system, the LIM document 206 describes a simulated environment. However, a LIM document 206 describing an actual environment as the environment exists at a particular point in time may alternatively be used during the design phase.

[0051] Validation component 208 can be one or more computing devices that are separate from a data center at which the system being developed will be deployed. For example, validation component 208 may be a single computing device or alternatively the validation responsibilities may be distributed across multiple devices. Alternatively, validation component 208 can be one or more of computing devices 102 of a data center at which the system being developed will be deployed.

[0052] The SDM enables the functional composition of systems across a horizontal and vertical axis. Composition along the horizontal axis is done with systems and subsystems. Composition along the vertical axis is done with “layers”. Applications, services, network topologies, and hardware fulfill a role in a distributed system, but are typically defined independently and owned by different teams or organizations. Layering is accomplished by components defining a set of constraints on a host and vice versa.

[0053] FIG. 3 illustrates an example layered setting. Four layers are illustrated in FIG. 3: layer 302, layer 304, layer 306, and layer 308. Although four layers are shown in FIG. 3, the actual number of layers can vary, and can be greater or less than four. Additionally, the content of different layers can vary in different embodiments. As can be seen in FIG. 3, the different layers are situated above and/or below other layers (e.g., layer 306 is above layer 304 but below layer 308).

[0054] Different systems and subsystems within a layer can interact with one another, and also can interact with systems and subsystems of different layers. For example, a subsystem 310 in layer 308 can interact with a subsystem 312 in layer 308, as well as a subsystem 314 in layer 306. Additionally, each layer can be viewed as the environment for the next higher layer. For example layer 306 is the environment for systems and subsystems in layer 308, while layer 304 is the environment for systems and subsystems in layer 306. Each layer 302, 304, 306, and 308 has its own associated SDM document.

[0055] The different layers 302, 304, 306, and 308 can represent different content. In certain embodiments, layer 302 is a hardware layer, layer 304, is a network topology and operating systems layer, layer 306 is an application hosts layer, and layer 308 is an applications layer. The hardware layer represents the physical devices (e.g., computing devices) on which the layered system is built (e.g., devices 102 of FIG. 1). The network topology and operating systems layer represents the network topology of the computing devices (e.g., network setting 100 of FIG. 1) as well as the operating systems installed on those computing devices. The application hosts layer represents applications installed on the computing devices that can host other applications (e.g., SQL Server, IIS, and so forth). The application layer represents applications that are installed on the computing devices that do not host other applications (e.g., entertainment applications such as games, productivity applications such as word processors, reference applications such as electronic encyclopedias, distributed applications such as may be used for web services or financial analysis, and so forth).

[0056] Returning to FIG. 2, an application developer is able to design and develop an application using development component 202. As the developer defines various parts of his or her system and how these parts relate to one another, an SDM file 204 that captures these parts and relationships is generated. The developer is able to use validation component 208 to validate the system description against the environment described in LIM file 206. This validation during the design phase is also referred to as “design time validation”.

[0057] The SDM, which is discussed in more detail below in the section “Example SDM Implementation” is designed to support description of the configuration, interaction and changes to the components in a distributed system (the modeled system). SDM is based on an object-relational model. “Objects” describe entities that exist in a system and “relationships” identify the links between the various entities. Objects and relationships are further defined to capture semantic information relevant to the SDM. In particular, objects are divided into components, endpoints and resources. Relationships are divided into the following: connections (also referred to as communication), containment, hosting, delegation and reference. Further details regarding objects and relationships are provided below.

[0058] The SDM includes “abstract definitions” that provide a common categorization of system parts, provide tool support for a wide range of systems and provide the basis for definition checking at design time. A set of abstract definitions provide a comprehensive basis for service design. “Concrete definitions” represent parts of an actual system or data center design. A concrete definition is generated by selecting an abstract definition and providing an implementation that defines the concrete definition's members and setting values for its properties. Applications are generated using collections of these concrete definitions.

[0059] The SDM also includes “constraints” that model restrictions based on the allowed set of relationships in which an instance of a relationship can participate. Constraints are useful in describing requirements that depend on the configuration of objects involved in a relationship. For example, a constraint may be used to determine whether participants on each end of a communication protocol are using compatible security settings.

[0060] The LIM file 206 and SDM file 204 are input to interface and processing layer 210 of validation component 208. Interface and processing layer 210 controls validation of SDM file 204. Validation component 208 may also be referred to as a compiler.

[0061] Interface and processing layer 210 includes a loader 212, a verifier 214, and a simulator 218. Loader 212 parses SDM file 204 and loads any referenced files or types in an in-memory type space. SDM file 204 defines SDM classes (e.g., in XML), which loader 212 translates into SDM classes in the in-memory type space. Verifier 214 checks whether there are any errors in SDM file 204, verifying that SDM file 204 is written appropriately in order for loader 212 to load SDM file 204. If verifier 214 or loader 212 encounters an error, an error is returned to development component 202, optionally including an indication of the problem that caused the error. Verifier 214 also “walks” the type space, checking setting values, types, and SDM file references. Typically, if an error is encountered by verifier 214 or loader 212, the design time validation is terminated.

[0062] Simulator 218 then simulates the environment defined by LIM document 206, invoking expansion engine 220, flow engine 222, and constraint engine 224 as discussed below. Any errors encountered by simulator 218 are returned to component 202 (e.g., as results 226), optionally including an indication of the problem that caused the error. Typically, if an error is encountered by simulator 218, an indication of the error is returned to development component 202, but the design time validation continues.

[0063] Interface and processing layer 210 invokes expansion engine 220, flow engine 222, and constraint engine 224 to perform the validation of SDM file 204. Generally, expansion engine 220 expands the set of actions to create an instance space based on SDM file 204 to add all additional instances and actions required including by-value children and relationships, or remove appropriate instances and relationships. Flow engine 222 “walks” over the instance “graph” and finds the flows defined on the instances, and sets the values in the flows to the appropriate values. Constraint engine 224 “walks” over the instance space and finds and evaluates each constraint member.

[0064] In certain embodiments, if all of the constraints are evaluated to true (that is, all of the constraints are satisfied), and validation component 208 encounters no errors when processing SDM document 204, then validation component 208 digitally signs SDM document 204. This digital signature indicates that SDM document 204 has been successfully compiled. SDM document 204 can be digitally signed in any of a variety of different manners, typically involving generating a digital signature based on the SDM document 204 and a public/private key pair associated with validation component 208. So, digitally signed SDM documents can be subsequently treated (e.g., when they are deployed) as already having been validated. The digitally signed SDM document is also referred to as a compiled SDM document.

[0065] In addition to evaluating the various constraints, validation component 208 may also update references to other SDM documents with the full name (and optionally version) of those referenced documents. So, the compiled SDM document would include the these full names. For example, an SDM document may import another SDM document and reference that other SDM document by name but not version, and when validation component 208 imports that referenced document, the version of the imported document is identified and added to the compiled SDM document.

[0066] The discussions herein make reference to various members or definitions that may be included in SDM document 204. A definition defines how particular instances are to be created in the instance space. In other words, a definition defines what is possible. A member describes a particular use or scenario based on a definition. For example, a definition describes what is possible for a particular instance, and a member describes which of those possibilities is included in a particular instance. The following table illustrates examples of members or definitions, as well as a summary description of each member or definition.

Member/Definition Description
abstract          A type that is used to
                  define the settings required
                  to act on a modeled system
                  object.
communication     Describes a communication
                  relationship between endpoint
                  members. Used to describe
                  interaction between inde-
                  pendently deployed software
                  elements.
constraint        Describes a restriction. Can
                  be used to identify restrictions
                  on setting values of members of
                  a definition or on the partici-
                  pants in a relationship.
containment       The containment relationship
                  definition declares that one
                  type can contain another type.
                  The containment relationship
                  member declares that one object
                  member contains another object
                  member.
delegation        Describes a delegation relation-
                  ship between endpoint members.
                  Used to allow one system to for-
                  ward behavior to another system.
endpoint          Describes a communication endpoint.
flow              Describes a particular transform
                  to apply to a set of setting
                  values.
hosting           Describes a hosting relationship
                  between object members. Used to
                  indicate that a guest requires a
                  host in order to be constructed
                  (e.g., a web service object
                  definition may require an IIS
                  object host).
manager           Describes a mechanism by which
                  types and relationships can in-
                  sert custom behavior. Can be used
                  to provide the implementation for
                  complex constraints and flows.
object            Describes an entity that exists
                  in the system being modeled (even
                  if a simulated environment), such
                  as system definitions used to de-
                  scribe independently deployable
                  parts of an application, or com-
                  munication endpoints that a system
                  may expose.
reference         Sets up a reference relationship
                  between object members. Used to
                  capture dependencies between
                  object members.
relationship      Describes the relationship between
                  object members when they are created.
resource          Describes specific elements that
                  can be identified as part of a
                  system definition.
subsystem         Describes a collection of data,
                  software, and/or hardware elements
                  that can be treated as complete
                  systems but are typically part of
                  a larger system.
system            Describes a collection of data,
                  software, and/or hardware elements.

[0067] The engines discussed herein make reference to a by value member, a by reference member, expansion, a listener, and a top-level definition. A by value member refers to a member for which an instance is created automatically during expansion. In certain implementations, a by value member cannot be abstract. A by reference member is a member for which an instance cannot be created automatically by the expansion engine during expansion. Rather, an external source listening for an event in the expansion engine creates the instance (e.g., interface and processing layer 210 may create the instance during simulation, or may query (e.g., through a user interface) the designer or developer to create the instance during simulation or deployment).

[0068] Expansion refers to the process where, given a root instance, the instance space is populated with respect to the root instance. All of the members of the root instance are created recursively. By reference members are not created by the expansion engine, but are created by an external source.

[0069] The listener (e.g., simulator 218) is notified when an event is triggered. An example of such an event is the need for a by reference member to be created. A top-level definition refers to a definition that is defined at the root level in the SDM document. An SDM document typically has only one top-level definition, although in alternate embodiments an SDM document may have two or more top-level definitions.

[0070] FIG. 4 is a flowchart illustrating an example process 400 for design time validation. Process 400 is implemented by validation component 208 of FIG. 2, and may be performed in software, firmware, hardware, or combinations thereof.

[0071] In response to a request to create, delete, or modify a system, the SDM document and any references associated with the SDM document are loaded (act 402), optionally verifying that the SDM document can be loaded. In certain embodiments, the LIM document(s) will have already been loaded and the instance space(s) described by the LIM document(s) already created. However, if this has not yet occurred, then the LIM document(s) is loaded and the instance space(s) described by the LIM document(s) is created in act 402. In certain embodiments, the instance space(s) described by the LIM document(s) is created by using the expansion, flow, and constraint engines as described herein prior to loading the SDM document in act 402.

[0072] A check is then made as to whether there are any errors in the SDM document (act 404) or the type space created when the SDM document is loaded. The check in act 404 refers to the structure or format of the SDM document itself, not the system being designed. For example, in act 404 a check may be made to verify that the format of the SDM document is proper (e.g., that the document is in proper XML format), or that there are no unknown elements or types in the SDM document, or that type references in the SDM document are valid, and so forth. If there are any errors, then an indication of those errors is returned (act 406) and process 400 ends. These errors can be returned to development component 202 of FIG. 2 as, for example, results 226.

[0073] However, if there are no errors, then a top-level definition in the SDM document loaded in act 402 is selected (act 408). In certain embodiments, there is only one top-level definition in the SDM document. An instance for the selected definition is then created (act 410), and the instance space is expanded (act 412). The top-level definition is used as the starting point for expansion, which is performed by expansion engine 410 of FIG. 4. The instance space is expanded by analyzing the top-level definition and creating an instance of each member of the root instance, then analyzing each of those created instances and creating instance(s) for each of their members, and so on. This process is discussed in more detail below under the heading “Expansion Engine”.

[0074] When the expansion based on the top-level definition is completed, the flows defined on the instances in the expanded instance space are identified, and the values in the flow are set to the appropriate values (act 414). This process is discussed in more detail below under the heading “Flow Engine”.

[0075] After the values from evaluating the flows are set, constraints are checked (act 416). Each constraint member in the instance space is evaluated as part of the constraint checking, as discussed in more detail below under the heading “Constraint Engine”. These constraints are typically checked against settings in the simulated environment that the system is being verified against (e.g., as described in LIM 206).

[0076] After the constraint checking is completed, a check is made as to whether there are any additional top-level definitions in the SDM document that have not yet been selected (act 418). If there are one or more additional top-level definitions in the SDM document, then one of those additional top-level definitions is selected (act 420) and processing returns to act 410 where an instance of the selected top-level definition is created.

[0077] However, if there are no top-level definitions that have not yet been selected, then a check is made as to whether any errors are detected (act 422). These errors in act 422 refer to errors and/or warnings generated during the expansion of act 412, the flow of act 414, and the constraint checking of act 416. If there are any errors or warnings, then an indication of those errors or warnings is returned (act 406) and process 400 ends. These errors can be returned to development component 202 of FIG. 2 as, for example, results 226.

[0078] However, if there are no errors, then the design time validation process of FIG. 4 was successful and an indication of success is returned (act 424). The indication of success can be returned to development component 202 of FIG. 2 as, for example, results 226.

[0079] By returning errors and/or warnings to development component 202 in act 406, or an indication of success in act 424, the result of the design time validation of the system described in SDM document 204 is returned to development component 202. These errors and/or warnings, or indication of success, can also be presented to the designer using development component 202, allowing the designer to be informed of whether the system being designed (and described in SDM document 204) has been validated, or whether there are potentially problems. By returning an indication of the specific errors and/or warnings to the designer, the designer can be better informed as to what the potential problems are and how to resolve them (or whether they even need to be resolved). This feedback can be given to the designer during the design process, not requiring the designer to attempt to deploy the system at a data center before finding out that there are problems with the designed system.

[0080] Simulation

[0081] As discussed above, interface and processing layer 210 of FIG. 2 simulates an environment as defined in LIM document 206. This allows the system described by SDM document 204 to be validated against an expected environment during design of the system, allowing errors to be identified prior to deployment of the system to the environment.

[0082] Many instances within the instance space can be created by the expansion engine, as discussed in more detail below. However, some of the instances are created by simulator 218 rather than the expansion engine. In certain embodiments, the instances created by simulator 218 are top-level definitions and by reference members. In certain implementations, each top-level definition is simulated in its own instance space.

[0083] Simulator 218 simulates two categories of definitions that are found at the root of the document being compiled (these are referred to as top-level definitions): (1) system definitions, and (2) hosting definitions in which the host and guest are system definitions. These two categories of definitions are largely stand-alone definitions for which instances can be created by simulator 218. Other definitions are generally only used in the context of other definitions and therefore are created by expansion engine 220. In certain embodiments, simulator 218 does not simulate abstract definitions, as such would typically result in little, if any, meaningful validation.

[0084] System definitions are simulated by creating an instance for the definition and adding the instance as the root instance of an instance space. The members and nested members of the instance are then instantiated by invoking expansion engine 220.

[0085] Simulation of a hosting definition provides validation between a host and guest. In certain embodiments, an instance of a hosting relationship is not used as a root instance, so a special root instance is created before the expansion engine is invoked. This special root instance is a system definition having three members: (1) a system definition for a host of the hosting relationship; (2) a system definition for a guest of the hosting relationship; and (3) a hosting definition associated with the instances of the host and guest system definitions of the first two members. Expansion engine 222 is then invoked to instantiate the members and nested members of the special root instance.

[0086] Expansion engine 220 does not create instances of by reference members because the number of instances to create is unknown and is determined by the deployment environment. Additionally, the by reference member can be abstract, so that the concrete definition used to instantiate the member is not known. Human intervention (e.g., by a system administrator) is usually employed to answer these questions during deployment. Such intervention could optionally be employed during design time validation as well. However, more typically, interface and processing layer 210 (e.g., simulator 218) simulates what the human operator might choose as follows, thereby alleviating any need for human operator intervention during the simulation. Simulator 218 creates a number of instances of the member equal to the greater of one or a minimum number of occurrences (e.g., as specified in a parameter MinOccurs for the by reference member). If the by reference member is abstract then simulator 218 will not create an instance of the member, but will return an informational warning to the user (e.g., indicating that an abstract by reference member could not be simulated).

[0087] Expansion Engine

[0088] Expansion engine 220 allows broad commands to be input to validation component 208 and expands those commands out to identify the appropriate objects and relationships affected by those commands. Typically, these broad commands are commands to create or delete particular objects or relationships (e.g., a command to create a web application, or a command to delete a web application). Expansion engine 220 expands the set of actions to create an instance space based on SDM file 204 to add all additional instances and actions required including by-value children and relationships, or remove appropriate instances and relationships.

[0089] Initially, after an instance of a top-level definition (also referred to as a top-level instance) is created during simulation, expansion engine 220 is invoked to populate the instance space. A root instance is passed to expansion engine 220 as the starting location of the expansion. The instances created by the expansion will be relative to the root instance. The first time that expansion engine 220 is invoked for a particular instance space, the root instance passed to expansion engine 220 is a top-level instance (an instance of a top-level definition). However, expansion engine 220 can be, and typically is, called recursively so that members and nested members of the top-level instance will be the root instance for such recursive calls.

[0090] Expansion engine 220 begins by creating instance(s) of each member of the root instance. As each member is instantiated, it is examined for nested members. Any members that are defined within another member are referred to as being nested within that other member. Nesting of members can occur through multiple levels (e.g., a member may have nested members defined within it, and each of those members may have nested members defined within them, which in turn may each have nested members defined within them, and so forth). The expansion process is performed recursively on each of the members and nested members until the instance space is completely created with respect to the root instance.

[0091] In certain embodiments, only a subset of the various types of members is instantiated during expansion. This subset of instances created during expansion include the following object members: Subsystem, Resource, and Endpoint. This subset of instances created during expansion also includes the following relationship members: Containment, Communication, Hosting, Delegation, and Reference. Other members that are not included in this subset are not instantiated by expansion, but rather when one of the above instances is created by expansion, the creation process examines the member or definition and automatically creates instances of child members for these other members. Examples of these other members include flow members and constraint members.

[0092] In certain embodiments, when instances of a member already exist when expansion engine 220 is called, the instances will not be created again. However, expansion engine 220 continues recursively on each instance to verify that the instance space is fully created (and will create any nested members from this recursive calling that have not been created yet).

[0093] FIGS. 5A and 5B are a flowchart illustrating an example recursive expansion process 500 that creates an instance space. The instance space is defined by an SDM document, such as SDM document 204 of FIG. 2. Process 500 is implemented by expansion engine 220 of FIG. 2, and may be performed in software, firmware, hardware, or combinations thereof.

[0094] Initially, an instance definition is accessed (act 502). When invoked, expansion engine 220 is notified of an instance definition that is to be expanded (the root instance as discussed earlier in this section), and this instance definition is accessed in act 502. Expansion engine 220 may be passed the instance definition, may be passed an identifier (e.g., a pointer) of where the instance definition is located, or may otherwise be notified of where and/or how the instance definition can be accessed. Process 500 may be invoked by simulator 218 with the instance definition being a top-level definition, or alternatively may be invoked by process 500 itself recursively.

[0095] A member of the instance definition is then selected (act 504). Members can be selected from the instance definition in any order, and typically are selected in the order in which they appear in the SDM file defining the instance space. In certain embodiments, all object members are selected prior to any relationship members being selected.

[0096] A check is then made as to whether the selected member is an object member or a relationship member (act 506), and process 500 continues based on the result of this check. If the selected member is an object member, then a check is made as to whether the correct number of instances of the selected member already exist in the instance space being created (act 508). Each member includes an indication of how many instances of the member should be created. In certain embodiments, a default value of one instance is used, so that one instance of each member is created (whether explicitly specified in the member or not) unless the member specifies that more instances are to be created.

[0097] If the correct number of instances do not already exist, then a check is made as to whether the object member is a by value member (act 510). If the object member is a by value member than the minimum number of occurrences of the object, as specified in the member definition, are created (act 512). However, if the object member is not a by value member, then it is a by reference member, so an event is triggered that allows a listener (e.g., simulator 218 of FIG. 2) to create an instance of the by reference member (act 514).

[0098] After the instance(s) of the object member is created, whether in act 512 or act 514, or if it was determined that the correct number of instances of the member already exist in act 508, process 500 continues to act 516. In act 516, process 500 is invoked for each member instance of the instance(s) created in act 512 or act 514 (or the instance(s) that were determined to have already been created in act 508). When invoking process 500 recursively, each member instance for which process 500 is invoked becomes the instance definition for the invoked process 500. Thus, process 500 is called recursively on object members until all instances are created in the instance space.

[0099] Additionally, a check is made as to whether there are additional members in the instance definition that have not been selected in act 504 (act 518). If there are one or more such additional members in the instance definition, then process 500 returns to act 504 where one of those members is selected. However, if there are no such additional members in the instance definition, then process 500 is complete for this instance definition.

[0100] Returning to act 506, if the selected member is a relationship member, process 500 identifies the number of relationship instances to create based on the number of source instances and the number of target instances involved in the relationship (act 522 of FIG. 5B). The number of relationship instances to create is determined by multiplying the number of source instances by the number of target instances, with the result being the number of relationship instances that are to be created. The identified number of instances of the relationships are then created (act 524).

[0101] Alternatively, multiplying the number of source instances by the number of target instances may result in a maximum number of relationship instances, and only a subset of that maximum number may be created in act 524. For example, if multiple possible hosts exist, then only one may be selected in act 524. Analogous to by reference members discussed above, a listener (e.g., a human operator or simulator 218) may be called upon to select the subset of relationship instances. Simulator 218 may be configured or programmed, for example, with various criteria to be used or rules to follow to determine which subset of relationship instances to create.

[0102] The relationship instances are created in different manners depending on the type of the relationship member. In certain embodiments, the following types of relationship members can be used: a containment definition member, a communication definition member, a reference definition member, a hosting definition member, and a delegation definition member. A containment definition member is a one-to-many relationship, which associates the parent with each instance of the child member. A containment definition member describes that one object member can be contained in another object member. A communication definition member is a many-to-many relationship, which associates all combinations of server and client member instances. A communication definition member describes an interaction between independently deployed software elements. A reference definition member is a many-to-many relationship, which associates all combinations of dependent to source member instances. A reference definition member is used to capture dependencies between instances (in addition to the hosting definition member). These dependencies can be used, for example, to control construction order during deployment and flow parameters between systems during installation and update. A hosting definition member is a one-to-many relationship, which associates a host with each of its guest's member instances. A hosting definition member is used to identify that a guest requires a host in order to be constructed. A delegation definition member is a one-to-one relationship that associates communication endpoints of two systems. A delegation definition member is used to forward behavior from one system to another (e.g., forwarding all interaction that would have been directed to one system to the endpoint on the other system).

[0103] For each instance of the relationship, the source and target instances are associated with the instance of the relationship (act 526). Process 500 then returns to act 518 of FIG. 5A, where a check is made as to whether there are additional members in the instance definition to be selected.

[0104] Process 500 is thus invoked recursively, with the various object and relationship instances being created as the process is recursively invoked. The recursive expansion process knows when it has completed creating the instance space when all member instances have been created.

[0105] Due to the recursive nature of the expansion process, the resultant instances are linked to one another with the top-level instance being the entry point for flow engine 222 and constraint engine 224 of FIG. 2. The instance space thus created can be viewed as an instance tree, with each node of the tree representing a member instance. Additionally, each node of the tree (except for the top-level node) is linked to a parent node that represents the member instance that invoked the expansion process to create that node of the tree. Furthermore, each node of the tree is linked to zero or more children nodes that are members of the member instance of that node of the tree. The recursive expansion process knows that it has completed creating an instance graph when the leaf members do not have any nested members (e.g., all leaf members have zero children nodes). Additionally, in order to avoid situations where the expansion process may end up infinite due to a definition having a member that is of its type, in certain embodiments the expansion process will only choose to create instances if the definition is not already instantiated as an ancestor instance. For example, if there is a definition of a directory and it has a directory in it, then the expansion engine will stop expanding this once there is a single directory.

[0106] Flow Engine

[0107] After expansion engine 220 has completed the expansion process, simulator 218 calls flow engine 222 on the instance space resulting from the expansion process. Flow engine 222 “walks” over the instance graph of the instance space and finds the flow instances defined in the instance graph. Flow engine 222 then sets the values in the flows to the appropriate values.

[0108] Settings can be declared on definitions in SDM file 204, and corresponding setting values can exist on the instances created from these definitions. Setting values can be non-calculated setting values or calculated setting values.

[0109] Non-calculated setting values are setting values that are set by a default value or initial value from a definition (e.g., in SDM file 204), or that are set by the user who sets the value explicitly. Non-calculated setting values may be restricted to being set only on creation of the SDM instance they belong to or alternatively they may be altered over the life of the SDM instance. Non-calculated setting values are not the output of a flow, but they may act as an input to a flow.

[0110] Calculated setting values are setting values that are the output of a flow. As a result, the flow can set the value of a calculated setting value, but other entities typically cannot. In certain implementations, there can only be one flow supplying the value for a particular calculated setting value. In such implementations, if multiple flows output to the same setting value instance, then an error is reported and the output of the flow is set to an error state. Calculated setting values are based on one or more inputs. These inputs can be calculated setting values and/or non-calculated setting values.

[0111] In certain embodiments, calculated setting values can be separated into two categories: configuration values and non-configuration values. Configuration values are values computed by flows that result in configuration of the SDM instance they are part of. For example, the full path to a file or a database name would be configuration values.

[0112] Non-configuration values are values that are computed by flows but that do not result in configuration. Rather, they exist only as commutated values for constraints. For example, the resulting web.config setting taking into account all the inherited web.config values would be a non-configuration value. Another example of a non-configuration value would be the resulting access control list on a file taking into account the configured access control lists on the file as well as the file's containing directories and volume.

[0113] Flow engine 222 may optionally treat configuration value and non-configuration values differently. For example, configuration values may be given a higher priority, and thus flows that set configuration values may be evaluated before flows that set non-configuration values.

[0114] Generally, flow is evaluated by identifying flow instances in the instance space, and identifying the values of the inputs to the flow instances (e.g., identifying the setting values of other instances that are sources of these inputs). A module or set of instructions is referenced by the flow instance, the module or set of instructions being able to process a flow function corresponding to the flow instance. The flow function is processed, based on the values of the inputs, and a result of the flow function is obtained. The result of the flow function is set as the output of the flow instance. A flow can have zero or more input values and one or more outputs (e.g., setting values for one or more instances may be set based on the output of the flow).

[0115] Any of a wide variety of flow functions can be used. Flow functions may be defined by the developer of the system and/or by other parties. For example, the same designer as is creating SDM file 204 may define one or more flow functions. By way of another example, the manufacturer of development component 202 or some other third-party developer may define one or more flow functions. The flow functions themselves can include any of a variety of calculations and/or operations, such as: calculations employing algebra, geometry, calculus, etc.; date and/or time based calculations; random value calculations; and so forth.

[0116] In certain embodiments, flow members defined in SDM file 204 are associated with a manager definition. The manager definition, in turn, includes a pointer to a set of instructions or code that can be executed to process the flow function. Thus, to evaluate the flow for a flow instance, the associated manager definition is identified and the associated manager is instantiated (if not instantiated already). The pointer to the set of instructions or code is obtained from the manager, which allows the set of instructions or code to be obtained and executed in order to determine the flow output.

[0117] Additionally, in certain embodiments the managers may also support type conversion. In such embodiments, the manager allows a flow to be based on two or more setting values that are of different types. For example, the input value may be a different type than the output type. The manager exposes one or more methods that allow such type conversions to be made, or alternatively includes a pointer to a set of instructions or code to be obtained and executed in order to perform the conversion. Different conversions can be supported by different managers (e.g., the manager designers can design the managers to support whatever type conversions they desire).

[0118] FIGS. 6A and 6B are a flowchart illustrating an example process 600 for evaluating flows. Process 600 is implemented by flow engine 222 of FIG. 2, and may be performed in software, firmware, hardware, or combinations thereof.

[0119] Initially, all settings on the instances in the instance space are found (act 602). These settings can be found in different manners, such as by checking each node in the instance graph for setting values. All flow instances in the instance space are then identified (act 604). Each flow instance in the instance space is marked as “dirty” and “not visited” (act 606). The marking of “dirty” indicates that the flow has not been executed or evaluated yet. The marking of “not visited” indicates that execution or evaluation of the flow has not yet begun. The marking of flow instance can be performed in a variety of different manners. For example, each flow instance may have a “dirty” flag that can be set to mark the flow instance as “dirty”, and a “not visited” flag that can be set to mark the flow instance as “not visited”. By way of another example, flow engine 222 may maintain a list, table, or other data structure(s) in which engine 222 can keep a record of flow instance and their associated markings.

[0120] The settings that receive values as a result of the flow instances are then identified (act 608). In act 608, all of the calculated setting values are identified. The settings themselves indicate whether they are calculated setting values or non-calculated setting values (e.g., they may have a flag or attribute, such as a “fixed” attribute, that can be set to indicate that they are non-calculated setting values). A dependency graph that identifies value dependencies may also optionally be generated in act 608. The dependency graph indicates, for each setting value, which other setting values it relies on (that is, the other setting values that are its inputs) and which other setting values rely on it (that is, the other setting values that use it as an input).

[0121] One of the flow instances identified in act 604 that is marked as “dirty” and “not visited” is then selected (act 610). The flow instances can be selected in any order, such as the order in which the flow instances were identified in act 604, randomly, based on number of input values, and so forth. The selected flow instance is then marked as “visited”, but remains marked as “dirty” (act 612). This indicates that evaluation or execution of the flow associated with the flow instance has begun, but that the flow has not been executed or evaluated yet (e.g., the output value for the flow has not yet been determined).

[0122] The inputs for the flow instance are then identified (act 614). Each flow instance has a parameter identifying the source (e.g., a particular setting value of another instance) for each of its inputs. A check is then made as to whether the identified inputs have been assigned values yet (act 616 of FIG. 6B). Inputs that are non-calculated setting values will have been assigned values, as will inputs that are calculated setting values calculated by flow instances that have already been evaluated. However, calculated setting values calculated by flow instances that have not yet been evaluated will not have values assigned yet (e.g., they may have a null value).

[0123] If one or more of the identified inputs do not have values assigned, then evaluation of this flow instance (selected in act 610) is paused (act 618). The evaluation is paused in order to allow the input values to be calculated. For each input that does not yet have a value, the flow instance that sets the input value is identified (act 620). Process 600 then returns to act 612 of FIG. 6a to begin evaluation of that flow instance (act 622). Evaluation of the flow instance that was paused in act 618 is then resumed when all of the inputs have values (act 624). Evaluation can be resumed, for example, at act 616 or act 626 discussed below. It should be noted that evaluation of one or more of the flow instances identified in act 620 may itself be paused due to identified inputs not yet having values.

[0124] Returning to act 616, if the identified input(s) have values, then the value(s) of the input(s) is obtained from its source(s) (act 626). The value(s) can be obtained from different sources, such as from SDM file 204, from objects instantiated based on SDM file 204, from flow instances (the output of flow), and so forth. The set of instructions or code that is to execute to evaluate the flow function for the flow member is then identified (act 628). Alternatively, rather than a set of instructions or code that are executed, the flow function may be implemented in hardware. The set of instructions or code is then executed, and the result of the executed set of instructions or code is then used as the output of the flow instance (act 630), also referred to as the output of the flow.

[0125] The flow instance is then marked as “not dirty” to indicate that the flow has been executed or evaluated (act 632). The flow instance should have already been marked as “visited” in act 612, however, if the flow instance has not already been marked as “visited” then the flow instance can also be marked as “visited” in act 632.

[0126] A check is then made as to whether there are additional flow instances identified in the instance space that are marked as “dirty” or “not visited” (act 634). If there are any such additional flow instances, then process 600 returns to act 610 of FIG. 6A, where one of such additional flow instances is selected. When all flow instances have been evaluated (e.g., none of the flow instances identified in act 604 are marked as “dirty” or “not visited”), then the flow evaluation process 600 is complete (act 636). When flow is complete, simulator 218 has a complete instance space with values for settings.

[0127] Process 600 is described in FIGS. 6A and 6B as pausing evaluation of a flow instance having inputs that do not yet have values and evaluating the flow instance(s) that set those values. However, process 600 may be implemented in alternate manners. For example, rather than evaluating the flow instance(s) that set those values, process 600 could return to act 610 of FIG. 6A where one of the flow instances is selected (without regard for whether it sets an input value for the paused flow). Evaluating flow instances in this alternate manner could result in the situation where evaluation of some flow instances is complete but evaluation of all other flow instances is paused. When this situation arises, act 616 can be repeated for each paused flow instance to determine whether the identified inputs have values. The inputs for at least one of the paused flow instances should have values, and this process of repeated act 616 can continue until all flow instances have been evaluated.

[0128] Flow engine 222 also detects circular references during the flow evaluation process of FIGS. 6A and 6B. Circular references refer to situations where one or more flow instances each rely (either directly or indirectly) on the output of the other for at least one of their inputs. For example, flow instance A has an output value that is also an input value to flow instance A. By way of another example, flow instance A has an input value that is the output from flow instance B, while flow instance B has an input value that is the output from flow instance A. By way of yet another example, flow instance A has an input value that is the output from flow instance B, flow instance B has an input value that is the output from flow instance C, and flow instance C has an input value that is the output from flow instance A. Such circular references are not evaluated, but rather are detected by flow engine 222 and the setting values in the circular references are set to an error state.

[0129] Circular references can be detected using the “dirty” and “visited” markings. When evaluation of a flow is paused in act 618 discussed above, the flow is marked as “visited” but also marked as “dirty”, and evaluation of another flow begins. Evaluation of this other flow can also be paused, and so on. If, during this pausing of flow evaluations, a flow is evaluated that was previously marked as “visited” but is still “dirty”, a circular reference has been encountered. In other words, evaluation of one or more flows is paused, and during that pause another flow is selected for evaluation that is already marked as “visited” and “dirty”, then a circular reference has been encountered because evaluation of that other flow selected for evaluation was previously paused.

[0130] Alternatively, circular references can be detected in any of a variety of other manners. For example, a dependency graph that identifies value dependencies may be created in act 608 as discussed above, and this dependency graph can be used to identify circular references.

[0131] When a circular reference is detected, all of the flows that are part of that circular reference are marked as an error (e.g., a cyclic flow error). The flow being evaluated when the circular reference is detected is part of the circular reference, as well as every other flow that receives an input from the flow being evaluated when the circular reference is detected, and every other flow that receives an input from one of those flows, and so on. Evaluation of all of the flows that are part of the circular reference then stops. These flows can optionally be marked as “visited” and “not dirty” so that evaluation of the remaining flows can continue.

[0132] It should be noted that flows can be deterministic or nondeterministic. A deterministic flow always outputs the same values any time it is called with a specific set of input values. For example, a flow may output the sum of two input values. Such a flow would be deterministic because the flow will always output the same value given a specific set of input values. A nondeterministic flow, however, may output a different value each time it is called with a specific set of input values. For example, a flow may generate a random number based on an input value. Such a flow would be nondeterministic because it could generate a different random number each time it is called with the same input value. Flow that do not have input values can be deterministic (always outputting the same value) or nondeterministic (outputting different values each time they are called).

[0133] In certain embodiments, setting values can have an error state. When in an error state, a setting value may hold error information (e.g., an error code or description of the error). If the setting value does not hold the error information, then the error information can be reported in some other manner (e.g., by the event that placed the setting into the error state). A setting value can be set to an error state in various ways. For example, flow engine 222 will set an output value of a flow to an error state when an error occurs executing the flow (e.g., because the flow returned errors; because the flow engine was unable to execute a flow, such as when the flow engine detects a circular reference or when a flow could not be run due to problems with the inputs; and so forth).

[0134] The error state will be propagated through flows such that any flow that has an input value in error state will cause the flow engine to propagate that error state to its output. Such error states can eventually be returned by flow engine 222 to development component 202 (e.g., as results 226 of FIG. 2). Alternatively, the event that causes the original error may be returned by flow engine 222 to development component 202 (e.g., as results 226 of FIG. 2), rather than returning the propagation of error states through the flow.

[0135] Additionally, in certain embodiments a flow input and/or output can refer to an instance that does not currently exist (e.g., an input or output can refer to a member that has not been created). When a flow input refers to an instance that does not currently exist, then the input is considered unset and reverts to a default, if a default is defined on the flow (e.g., it reverts to an assigned value). If there are no such assignments on the flow then it will revert to a default value for the data type for the member.

[0136] When a flow output refers to an instance that does not currently exist, then the output value is not used. If none of the outputs of the flow exist then the flow does not have to be executed as it will not set any values. However, even if all inputs do not currently exist, if at least one output exists the flow will be executed.

[0137] It may also be desirable for the design time validation to allow for inherited settings patterns. Inherited settings refer to situations where the instance space has a hierarchy of objects, and where a setting value can be applied to an object that will result in that value for the setting on all objects below it in the hierarchy. Effectively, this creates a default value for those objects below the object, unless those objects below the object have their own explicitly applied value to override the default value. These can be referred to as applied settings (the settings applied to a particular object) on an object and resulting settings. (the result of the applied settings combined with settings inherited from the parent object) on the object.

[0138] Such inherited settings can be accommodated in different manners. In certain embodiments, such inherited settings can be accommodated during the creation of SDM file 204. The designer of SDM file 204 is aware of the situations where such inherited settings exist, and accounts for them in the design of SDM file 204. For example, the designer of SDM file 204 may declare both the applied settings and the resulting settings, but constrain against just the resulting settings.

[0139] In alternate embodiments, each setting has both an applied setting value and a result setting value. Thus, each setting in an instance will in effect have two values rather than just one. The applied setting value is the value set by initialization or explicitly setting of the value. The result setting value is set by flows. By default, references to the setting will get the result setting value, unless no flow has set it, in which case they will get the applied setting value. References to a flow output, on the other hand, will refer to the result value by default. Additionally, all references can optionally add a value type qualifier to explicitly refer to one of the two setting values.

[0140] Typically, the output of a flow is replaced each time the flow is evaluated. That is, the execution of a flow results in overwriting any previous output of the flow. However, in embodiments where each setting has both an applied setting value and a result setting value, a flow can be written to take, as one of its inputs the applied settings value. Given a properly constructed flow function, this can cause the output of the flow to be the applied settings appended to the other input(s) of the flow. Thus, in these embodiments, it is possible to effectively have new inputs appended to a flow output.

[0141] Constraint Engine

[0142] Simulator 218 calls constraint engine 224 to evaluate constraints for the system defined by SDM document 204. The evaluation performed by constraint engine 224 evaluates the constraints defined in SDM document 204 against the environment (to validate that the environment satisfies the constraints set forth by SDM document 204), and/or evaluates the constraints defined by the environment (e.g., in LIM document 206) against the system defined in SDM document 204 (to validate that the system defined in SDM document 204 satisfies the constraints set forth by the environment).

[0143] Constraint engine 224 “walks” over the instance space and finds and evaluates each constraint member. Constraint engine 224 can evaluate constraint members defined by SDM document 204 as well as constraint members defined by LIM document 206). Typically, simulator 218 calls constraint engine 224 after flow engine 222 has finished evaluating the flows, so the constraint checking is performed based on the instance space resulting from the expansion and flow evaluation processes. However, in alternate embodiments constraint engine 224 may be called prior to flow engine 222 finishing evaluating the flows.

[0144] Constraints can take different forms, and in certain embodiments constraints include setting constraints, relationship constraints, and object constraints. Setting constraints constrain the settings on an object and are backed by a manager or code to perform the evaluation. Relationship constraints constrain the relationship(s) an object can participate in. Object constraints constrain the object(s) in a relationship.

[0145] A constraint definition typically identifies a target definition to which the constraint applies, and further defines what the constraint is. In the case of a setting constraint, a set of instructions or code (or alternatively a hardware module) is associated with the constraint (e.g., identified by the constraint definition) that can be executed to evaluate whether the target satisfies the constraint. In certain embodiments, the constraint definition is associated with a manager definition which points to the set of instructions or code, analogous to the manager definition discussed above with respect to evaluating flows.

[0146] FIGS. 7A-7E are a flowchart illustrating an example process 700 for evaluating constraints. Process 700 is implemented by constraint engine 224 of FIG. 2, and may be performed in software, firmware, hardware, or combinations thereof.

[0147] Initially, all constraints in the instance space are identified (act 702). This identification in act 702 includes identifying setting constraints, relationship constraints, and object constraints. The identification in act 702 can include identifying constraints defined by the system (e.g., in SDM document 204) as well as constraints defined by the environment (e.g., in LIM document 206).

[0148] One of the identified constraints is then selected (act 704). The constraints can be selected in any of a variety of different manners. For example, constraints may be selected in the order they are identified in act 702, different types of constraints may be selected before other types (e.g., setting constraints may be selected before relationship constraints), constraints may be selected randomly, and so forth. The selected constraint is then evaluated based on whether the constraint is a relationship constraint, a setting constraint, or an object constraint.

[0149] If the constraint is a setting constraint, then the appropriate value(s) from the target instance of the constraint are obtained (act 706). The constraint identifies the target instance to be evaluated (e.g., identifies, by name, an object that is the target of the constraint). The constraint also identifies which setting value(s) of the target instance are to be evaluated, and those identified setting value(s) are obtained from the target instance. The set of instructions or code that is to execute to evaluate the constraint function for the constraint is then identified (act 708). Alternatively, rather than a set of instructions or code that are executed, the constraint function may be implemented in hardware. The set of instructions or code are then executed to determine (or the hardware determines) whether the value(s) obtained in act 706 satisfy the constraint (act 710). For example, the set of instructions may compare the obtained value(s) to values in the constraint and determine that the constraint is satisfied if one or more of the obtained value(s) is the same as (matches) one or more setting values of the constraint.

[0150] The result of the constraint function is then returned (act 712). The result can be returned to development component 202 of FIG. 2 as part of results 226. The constraint can optionally include a name or other information describing the constraint that can be returned as part of the results in act 712, allowing additional information describing any errors to be presented to the designer at development component 202.

[0151] A check is then made as to whether there are any additional constraints in the instance space that have not been selected yet (act 714). If all of the constraints have been selected and evaluated, then the constraint checking process is complete (act 716). However, if one or more constraints have not been selected, then process 700 returns to act 704 to select another one of the identified constraints.

[0152] Returning to act 704, if the selected constraint is an object constraint, then a primary role and primary object definition for the target instance of the constraint are identified (act 718 of FIG. 7B). For an object constraint, the target instance of the constraint is a relationship instance. The primary object definition of the target instance refers to the name of an object(s) that the selected constraint targets. The primary role of the target instance identifies the relationship role that must match the definition identified by the primary object definition. A check is then made as to whether there is a secondary role and secondary object definition targeted by the constraint (act 720). In certain embodiments, a constraint may target multiple object(s) and/or role(s), and the secondary role and secondary object definition can be used to identify a second role and/or object definition targeted by the constraint.

[0153] If there is a secondary role and secondary object definition targeted by the constraint, then a check is made as to whether both primary and secondary roles and both primary and secondary object definitions of the constraint match the target instance (act 722). If one or more of the roles or one or more of the object definitions does not match the target instance, then a match count variable is set to zero (act 724), and process 700 continues to act 726 of FIG. 7C, discussed in more detail below.

[0154] However, if both primary and secondary roles and both primary and secondary object definitions of the constraint match the target instance, then all nested constraints for the primary object instance are evaluated (act 728). The nested constraints refer to any children instances of the constraint definition, as well as any of their children, and so forth. The nested constraints may be object constraints, relationship constraints, and/or setting constraints. If any of the nested constraints have been previously evaluated, and their results were recorded, then those results can be used in act 728. However, for any of the nested constraints that have not yet been evaluated, the constraints are evaluated by invoking process 700 and using each of the nested constraints as the selected constraint in act 704 of FIG. 7A.

[0155] Once all nested constraints are evaluated, a check is made as to whether all of the nested constraints evaluate to true (act 730). If one or more of the nested constraints does not evaluate to true, then the match count variable is set to zero (act 724). However, if all of the nested constraints evaluate to true, then the match count variable is set to one (act 732), and process 700 continues to act 726 of FIG. 7C, discussed in more detail below.

[0156] Alternatively, since act 730 is a test for whether all of the nested constraints evaluate to true, under certain circumstances not all of the nested constraints need to be evaluated. As soon as a nested constraint is evaluated to not true, then the evaluation of nested constraints can cease and process 700 can continue with act 730. For example, if there are three nested constraints and the second nested constraint that is evaluated evaluates to false or not true, then the result at act 730 will be the same (proceeding to act 724) regardless of whether the third nested constraint evaluates to true.

[0157] Returning to act 720, if there is not a secondary role and secondary object definition targeted by the constraint, then a check is made as to whether the primary role and the primary object definition of the constraint match the target instance (act 734). Act 734 is analogous to act 722, however it is performed only based on the primary role and primary object definition; there is no secondary role and secondary object definition in act 734 so only the primary role and primary object definition are considered.

[0158] If the primary role or the primary object definition does not match the target instance, then a match count variable is set to zero (act 736), and process 700 continues to act 726 of FIG. 7C, discussed in more detail below. However, if the primary role and the primary object definition of the constraint match an object instance, then process 700 continues to act 728, where all nested constraints for the primary object instance are evaluated.

[0159] Turning now to act 726 of FIG. 7C, a check is made as to whether the value of the match count is at least a minimum number and not greater than a maximum number (act 726). These minimum and maximum numbers are identified by the constraint, and can be any values. If the match count is at least the minimum number but not greater than the maximum number, then a value of true is returned for this constraint (act 738). The return value of true may also be returned to processes evaluating other instances. For example, when a nested constraint is being evaluated in act 728 of FIG. 7B, if act 738 determines that that nested constraint evaluates to true, then the true value can be returned to the process evaluating the parent node to make the determination in act 730.

[0160] The return value of true can also optionally be returned to development component 202 of FIG. 2 as part of results 226. Additionally, a name or other identifying information of the constraint that was satisfied (evaluated to true) may optionally be returned to development component 202.

[0161] However, if the match count is not at least the minimum number or is greater than the maximum number, then a check is made as to whether an error message should be generated for this constraint (act 740). The constraint has a parameter or setting that indicates whether an error message for the constraint should be returned. This parameter or setting can be set, for example, by the designer or developer of the constraint. The check of act 740 can be carried out by checking whether this parameter or setting for the constraint indicates that an error message should be generated.

[0162] If an error message is to be generated for the constraint, then an error message is generated (act 742). The error message can optionally include a name or other identifying information that would help a user (e.g., a designer or developer) identify the nature of the constraint that caused the error. A value of false is then returned (act 744) for this constraint. The value of false and/or the error message generated in act 742 can be returned to development component 202 of FIG. 2 as part of results 226. Analogous to the return value of true in act 738, the return value of false and/or the error message can also be returned to processes evaluating other instances.

[0163] After the value of true is returned in act 738, or the value of false is returned in act 744, process 700 returns to act 714 of FIG. 7A to check whether there are any additional constraints that have not yet been selected.

[0164] Returning to act 704 of FIG. 7A, if the selected constraint is a relationship constraint, then a match count variable is initialized (act 746 of FIG. 7D). The match count variable can be initialized, for example, by setting the value of the match count variable to zero. The relationship instance(s) that the target object instance of the constraint participates in is then identified (act 748), and one of the identified relationship instances is identified (act 750).

[0165] A check is then made as to whether the relationship definition and direction of the constraint match the selected relationship instance (act 752). The relationship definition refers to the type of the relationship (e.g., hosting, delegation, communication, etc.), and the direction refers to the role or direction of the relationship (e.g., whether the constraint targets a host or a guest in a hosting relationship). The relationship definition and direction of the constraint match the identified relationship instance if the relationship definition and direction of the constraint are the same as the relationship definition and direction of the selected relationship instance.

[0166] If the relationship definition and direction of the constraint do not match the selected relationship instance, then a check is made as to whether there are any additional relationships identified in act 748 that have not yet been selected (act 754). If there are one or more such additional relationships, then process 700 returns to act 750 where one of the additional relationships that has not yet been selected is selected. However, if there are no such additional identified relationships, then process 700 proceeds to act 756 of FIG. 7E, discussed in more detail below.

[0167] Returning to act 752, if the relationship definition and direction of the constraint do match the selected relationship instance, then a check is made as to whether there is a target object definition in the constraint (act 758). A target object definition is optional in the constraint, and refers to the object instance that is on the other side of the relationship instance being evaluated. For example, if the relationship instance is a hosting relationship and the target object instance is the host, then the object instance on the other side of the hosting relationship would be the guest instance. If there is a target object definition in the constraint, then a check is made as to whether the target object definition in the constraint matches the instance at the other end of the relationship instance (act 760). The target object definition in the constraint matches the instance at the other end of the relationship instance if the target object definition in the constraint and the instance at the other end of the relationship instance are the same.

[0168] If the target object definition in the constraint does not match the instance at the other end of the relationship instance, then process 700 proceeds to act 754 to check whether there are any additional identified relationships that have not been selected yet.

[0169] However, if the target object definition in the constraint does match the instance at the other end of the relationship instance, or if there is not target object definition in the constraint, then process 700 proceeds to evaluate all nested constraints for the relationship instance (act 762 of FIG. 7E). Process 700 then proceeds based on whether all of the nested constraints evaluate to true (act 764). The evaluation and checking of acts 762 and 764 are analogous to the evaluation and checking of acts 728 and 730 of FIG. 7B.

[0170] If all of the nested constraints do not evaluate to true, then process 700 returns to act 754 of FIG. 7D to check whether there are any additional identified relationships that have not been selected yet. However, if all of the nested constraints evaluate to true, then the match count variable is incremented (act 766). The match count variable can be incremented by different amounts, such as by a value of one. Process 700 then returns to act 754 of FIG. 7D to check whether there are any additional identified relationships that have not been selected yet.

[0171] A check is then made as to whether the value of the match count is at least a minimum number and not greater than a maximum number (act 756), analogous to act 726 of FIG. 7C. If the value of the match count is at least a minimum number and not greater than a maximum number, then a value of true is returned (act 768), analogous to act 738 of FIG. 7C. However, if the value of the match count not is at least a minimum number and not greater than a maximum number, then a check is made as to whether to generated an error for the constraint (act 770), analogous to act 740 of FIG. 7C. If an error is to be generated, then an error message is generated (act 772), analogous to act 742 of FIG. 7C. When the error message is generated, or if no error message is to be generated, then a value of false is returned (act 774), analogous to act 744 of FIG. 7C.

[0172] Additionally, it should be noted that the constraint check process can be carried out on groups of constraints as well. In order to evaluate a group of constraints, each constraint is individually evaluated using process 700, and the result of the group is dependent on the results of the individual constraint evaluations. In certain embodiments, if at least one constraint in the group evaluates to true, then the group evaluates to true.

[0173] By returning values indicating successful constraint validation (e.g., a value of true) or unsuccessful constraint validation (e.g., a value of false), as well as error messages, to development component 202 in process 700, the result of the design time validation of the system described in SDM document 204 is returned to development component 202. These indications and/or error messages can also be presented to the designer using development component 202, allowing the designer to be informed of whether the system being designed (and described in SDM document 204) has been validated, or whether there are potentially problems. By returning error messages, the designer can be better informed as to what the potential problems are and how to resolve them. This feedback can be given to the designer during the design process, not requiring the designer to attempt to deploy the system at a data center before finding out that there are problems with the designed system.

[0174] Example Error Implementation

[0175] This section illustrates an example implementation of how errors and warnings can be reported by validation component 208 of FIG. 2. Errors and warnings can be in any of a variety of formats, such as the example XML format discussed in this section. If the validation component 208 is used through the CLR (Common Language Runtime), then classes with equivalent information to the XML formats discussed in this section may be returned.

[0176] This section identifies values that will be common to a class of errors. It does not preclude additional values.

[0177] Errors that occur during the validation of the type space (parse and resolution errors) will block the compiled SDM document from being written out. However, errors that occur during instance space validation (flow and constraint errors) will not block the compiled SDM document from being written out.

[0178] Base Error Format

[0179] The base error contains the error information common to all errors. An example XML format for the base error format is:

<xs:complexType name=“DocumentError”>
<xs:attribute name=“category” type=“Severity” use=“required”/>
<xs:attribute name=“code” type=“xs:string” use=“required”/>
<xs:attribute name=“description” type=“xs:string” use=“required”/>
<xs:attribute name=“sdmFile” type=“xs:string” use=“required” />
</xs:complexType>

[0180] The attributes or elements of the base error format are described in the following table.

Attribute/element Description
category          Error or warning (not localized)
code              The error code (not localized)
description       A description of the error
                  (localized)
sdmFile           The name of the sdm file in
                  which the error occurred.
                  (file name not namespace name)

[0181] Parse Error

[0182] A parse error will result from a failure when trying to load the SDM document. This error will include a line and column number. An example XML format for the parse error format is:

<xs:complexType name=“DocumentParseError”>
<xs:complexContent>
<xs:extension base=“DocumentError”>
<xs:attribute name=“lineNumber” type=“xs:int”/>
<xs:attribute name=“columnNumber” type=“xs:int”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0183] The attributes or elements of the parse error format are described in the following table.

Attribute/element Description
lineNumber        The line number in the file
                  identified by the sdmFile
                  attribute.
columnNumber      The column number that
                  identifies the start of
                  the error.

[0184] Resolution Error

[0185] A resolution error will result from a failure while loading and resolving types in a file. This class of errors covers failures to resolve imports, failures to resolve types, members and paths. At this stage there is a fully parsed object model, so reference can be made to the parts that raise an error in terms of the object model rather than the line and column numbers from the file. An example XML format for the resolution error format is:

<xs:complexType name=“DocumentResolutionError”>
<xs:complexContent>
<xs:extension base=“DocumentError”>
<xs:attribute name=“statement” type=“documentPath”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0186] The attributes or elements of the resolution error format are described in the following table.

Attribute/element Description
statement         An path to the statement
                  that caused the error

[0187] Flow Error

[0188] A flow error occurs when the flow executes and returns errors for one or more of its inputs or outputs. The flow member is identified, as is its type and the context in which the failure occurred including the current set of input and output values along with the destination setting members. An example XML format for the flow error format is:

<xs:complexType name=“DocumentFlowError”>
<xs:complexContent>
<xs:extension base=“DocumentError”>
<xs:sequence>
<xs:element name=“inputValue” type=“flowInput”
minOccurs=“0” maxOccurs=“unbounded”/>
<xs:element name=“outputValue” type=“flowOutput”
minOccurs=“0” maxOccurs=“unbounded”/>
</xs:sequence>
<xs:attribute name=“flowType” type=“documentPath”/>
<xs:attribute name=“flowMember” type=“documentPath”/>
<xs:attribute name=“memberContext”
type=“containmentPath”/>
<xs:attribute name=“flowErrorID” type=“xs:int”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0189] The attributes or elements of the flow error format are described in the following table.

Attribute/element Description
InputValue        A description of the source
                  setting, flow setting and
                  value for the flow
OuputValue        A description of the destina-
                  tion setting, flow setting
                  and value for the flow
flowType          The type that the flow member
                  resolved to
flowMember        The declaration of the flow
                  member
memberContext     The containment hierarchy
                  in which this flow was
                  evaluated. The root of this
                  hierarchy will be the target
                  type that we are simulating,
                  the intermediate nodes will
                  be the members between the
                  root and the flow member.
flowErrorID       A custom error id returned
                  from a flow that is used to
                  look up an error description
                  from the design data section.

[0190] An example XML format for a description of a flow input format is:

<xs:complexType name=“flowInput”>
<xs:sequence>
<xs:element name=“value” type=“xs:anyType”
minOccurs=“0”/>
</xs:sequence>
<xs:attribute name=“setting” type=“sdm:simpleName”/>
<xs:attribute name=“source” type=“documentPath”/>
</xs:complexType>

[0191] The attributes or elements of the description of a flow input format are described in the following table.

Attribute/element Description
Value             The value of the input
Setting           The flow setting on the flow
                  type that this is an input for
Source            The setting member that we are
                  sourcing the value from

[0192] An example XML format for a description of a flow output format is:

<xs:complexType name=“flowOutput”>
<xs:sequence>
<xs:element name=“value” type=“xs:anyType”
minOccurs=“0”/>
</xs:sequence>
<xs:attribute name=“setting” type=“sdm:simpleName”/>
<xs:attribute name=“destination” type=“documentPath”/>
</xs:complexType>

[0193] The attributes or elements of the description of a flow output format are described in the following table.

Attribute/element Description
Value             The value of the output
Setting           The flow setting that pro-
                  vides the output value
Destination       The setting member that we
                  are flowing the value to.

[0194] Constraint Error

[0195] A constraint error occurs when a setting constraint is evaluated and returns an error, when a guard fails its cardinality constraint or when at least one member of a constraint group fails to evaluate to true.

[0196] When a setting constraint fails the constraint member declaration is returned, along with the constraint type, the context in which the constraint executed and the set of input values for the constraint. The constraint can also return a custom error id, which can be then be used to look up additional error information. An example XML format for the such a constraint error format is:

<xs:complexType name=“DocumentConstraintError”>
<xs:complexContent>
<xs:extension base=“DocumentError”>
<xs:sequence>
<xs:element name=“inputValue”
type=“constraintInput”/>
</xs:sequence>
<xs:attribute name=“constraintMember”
type=“ documentPath”/>
<xs:attribute name=“constraintType”
type=“ documentPath”/>
<xs:attribute name=“memberContext”
type=“containmentPath”/>
<xs:attribute name=“constraintErrorID” type=“xs:int”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0197] The attributes or elements of such a constraint error format are described in the following table.

Attribute/element Description
inputValue        A list of input values
                  for the constraint
constaintMember   A path to the declaration
                  of the constraint member
constraintType    The constraint type that
                  the constraint member
                  resolved to
Member context    The containment hierarchy
                  in which this constraint was
                  evaluated. The root of this
                  hierarchy will be the target
                  type that we are simulating,
                  the intermediate nodes will
                  be the members between the
                  root and the constraint
                  member.

[0198] An example XML format for a description of a constraint input format is:

<xs:complexType name=“constraintInput”>
<xs:sequence>
<xs:element name=“value” type=“xs:anyType”/>
</xs:sequence>
<xs:attribute name=“setting” type=“sdm:simpleName”/>
<xs:attribute name=“source” type=“ documentPath”/>
</xs:complexType>

[0199] The attributes or elements of the description of a flow input format are described in the following table.

Attribute/element Description
Value             The value of the input
Setting           The constaint setting
                  that the value is for
Source            The source member for
                  the input value.

[0200] When a guard or group fails, the constraint member is identified along with the member context and the evaluation context. The evaluation context differs from the member context for nested constraints when the evaluation context identifies the type or relationship that the nested constraint was evaluated against. An example XML format for the such a constraint error format is:

<xs:complexType name=“constraintGuardOrGroupError”>
<xs:attribute name=“constraintMember” type=“ documentPath”/>
<xs:attribute name=“evaluationContext” type=“containmentPath”/>
<xs:attribute name=“memberContext” type=“containmentPath”/>
</xs:complexType>

[0201] The attributes or elements of such a constraint error format are described in the following table.

Attribute/element Description
ConstraintMember  The declaration of the
                  guard (type constraint or
                  relationship constraint)
                  or group (type constraint
                  group or relationship con-
                  straint group).
EvaluationContext The member path from the
                  root to the member that
                  the constraint was
                  evaluated against
memberContext     The member path from the
                  root to the member that the
                  constraint is declared on.

[0202] Document Path

[0203] This is a path to a particular SDM element within an SDM document. An example XML format for the a document path format is:

<xs:simpleType name=“documentPath”>
<xs:restriction base=“xs:string”>
</xs:restriction>
</xs:simpleType>

[0204] The path will generally have the form:

[0205] namespace/root_type (/nested_type)*/member (/nested_member)*

[0206] Well known settings for relationships and constraints are treated as nested members.

[0207] Containment Path

[0208] A containment path identifies a sequence of members from the root to a particular member. The path navigates the members from the root simulation component through their members and so on until the member that raised the error is reached. An example XML format for the a document path format is:

<xs:simpleType name=“containmentPath”>
<xs:restriction base=“xs:string”>
</xs:restriction>
</xs:simpleType>

[0209] The path will generally have the form:

[0210] Namespace/rootType (/nested_type) * member (/nested_member)*

[0211] Examples of Errors

[0212] The compiler will return errors and warnings from the compilation that will be displayed to the user. Errors caught during compilation of an SDM document may have different levels of severity. Most errors are fatal, but there are some that are likely to cause other errors or are safe to ignore. Example details on the severity for each of the levels is as follows.

[0213] Error: Errors in this category are fatal and have the following implications:

[0214] An output sdm file (.sdmDocument) cannot be created from the compilation

[0215] Errors will cause the compiler to complete the current stage of compilation and then terminate. For example, if an XML parse error occurs the document will not be loaded. If a load error occurs, more load errors may be found, but will not continue with flow and constraint checking.

[0216] Warning 1 (W1): Warnings do not prevent the SDM document from being compiled. Guidelines for warning 1 include:

[0217] Likely to cause an error in future stages of the compilation. For example, if a reference file is not found, errors will occur during load of the target SDM file if any types are used from that reference.

[0218] Errors during instance space simulation.

[0219] Warning 2 (W2): Warning 2 is the lowest severity error. For example, an extra attribute is found in the XML file. Guidelines for Warning 2 are:

[0220] Warning 2 is safe to ignore

[0221] Recommended to fix in order to clean up the SDM.

[0222] Warning 3 (W3): Warning 3 is an informational message.

[0223] Warning 3 is informational.

[0224] By default, these warnings are not reported.

[0225] The following table lists examples of errors that may be reported by validation component 208 of FIG. 2. Separate tables are used to show examples of general compiler errors, document load errors, definition space verification errors, flow errors, and constraint errors. A description of the errors and their level are included in the following tables. A format for each of the errors is also identified (e.g., the error (base error) format, the parse format, the resolution format, the flow format, and the constraint format).

General Compiler Errors
Format	Level	Description	Rule
Error	Error	Unexpected Exception	An exception was thrown during
			compilation
Error	Error	SDM file not found
Error	W1	Reference file	When the references are loaded before
		not found	compiling the target file, the reference
			is not found.
Error	Error	Failed to load	A parse error occurred during the load that
		the SDM file	caused this document to fail to load.
Error	Error	Compilation aborted.	More than 100 errors were detected
		Too many errors	during compilation
		detected
Error	W1	Invalid reference	The reference file is not a compiled
		file	sdm document.
Error	Error	The source file	The source file cannot be the same as a
		was loaded as	reference file.
		a reference
Error	Error	Failed to take the	The file listed in the Sdm must exist
		hash of a file	and needs to have read access for taking
			its hash.
Error	W3	The sdm file is	Sdm files should be fully signed, not
		delay signed	just delay-signed.
Resolution	Error	The Source setting	A resource member of type
		value is missing	System.OperatingSystem.FileSystem:File
		from the file	must contain a setting value
		resource.	“Source” so the file can be
			located during the build.
Resolution	Error	The file in a	The file could not be found in the path
		resource was not	specified by the “Soruce” setting
		found.	value for a resource member of type
			System.OperatingSystem.FileSystem:File
Error	Error	The key file does	The keyFile variable is invalid. Either
		not exist, is	the file does not exist, the key file is
		corrupted, or the	corrupt, or the private key is not found
		private key is not	and delaySign = false.
		found and the target
		is being fully
		signed
Error	Error	The key container	The keyContainer variable is invalid
		does not exist
Error	Error	The key file could	If keyFile is a file (not a container), it
		not be accessed to	must be accessible
		extract the public
		and/or private key

[0226]

Document Load Errors
Format	Level	Description	Rule
Parse	Error	Invalid XML	The xml document was not a valid xml
		document	document or did not conform to the
			xsd schema. For example:
			Missing attribute/element
			Unknown attribute/element
			Invalid value for attribute/element
Parse	Error	Invalid Setting	Validation on the setting value failed.
		Values schema
Resolution	Error	Unknown object	Unknown object found when parsing
		found	the types
Resolution	Error	Unknown member	Unknown member found when parsing
			members
Resolution	Error	Unknown roles list	Unknown roles list value found
		value
Resolution	Error	Type name already	There is a single namespace for setting,
		defined	component, port and resource types,
			relationships, constraint and flow types,
			and managers within a single sdm
			document
Resolution	Error	Member name	Type, relationship, constraint, flow
		already defined	members and setting declarations are all
		within the current	part of a single namespace within a
		type.	type.
Resolution	Error	Constraint already	Only one constraint for a given name
		exists	can exist
Resolution	Error	Setting value	Only one setting value in a type or
		already exists	member for a given name can exist

[0227]

Definition Space Verification Errors
Format	Level	Description	Rule
Resolution	Error	Failed to resolve the type of	Members and types must
		this object	refer to valid types
Resolution	Error	Failed to resolve the host of the	Members must refer to valid
		hosting relation-	types. This includes setting
		ship	declarations, type,
Resolution	Error	Failed to resolve the guest of	relationship, flow and
		the hosting relationship	constraint members.
Resolution	Error	Failed to resolve the dependent
		member of the reference relationship
Resolution	Error	Failed to resolve the source
		member of the reference
		relationship
Resolution	Error	Failed to resolve the child
		member of the containment
		relationship
Resolution	Error	Failed to resolve the parent
		member of the containment
		relationship
Resolution	Error	Failed to resolve the server
		member of the communication
		relationship
Resolution	Error	Failed to resolve the client
		member of the communication
		relationship
Resolution	Error	Failed to resolve the proxy
		member of the delegation
		relationship
Resolution	Error	Failed to resolve the delegate
		member of the delegation
		relationship
Resolution	Error	Failed to resolve the child	Relationship types must refer
		type of the containment	to valid types.
		relationship
Resolution	Error	Failed to resolve the parent
		type of the containment
		relationship
Resolution	Error	Failed to resolve the host
		type of the hosting
		relationship
Resolution	Error	Failed to resolve the guest
		type of the hosting
		relationship
Resolution	Error	Failed to resolve the dependent
		type of the reference
		relationship
Resolution	Error	Failed to resolve the source
		type of the reference
		relationship
Resolution	Error	Failed to resolve the server
		type of the communication
		relationship
Resolution	Error	Failed to resolve the client
		type of the communication
		relationship
Resolution	Error	Failed to resolve the proxy
		type of the delegation
		relationship
Resolution	Error	Failed to resolve the delegate
		type of the delegation
		relationship
Resolution	Error	Failed to resolve the base of the	The relationship must have a
		relationship	valid implemented or
			extended type
Resolution	Error	Setting declaration type not	The type of the setting
		found for this setting value.	declaration is invalid
Resolution	Error	Invalid setting declaration type	The type of the setting
			declaration is invalid.
Resolution	Error	Failed to resolve the manager	If an object has a manager it
			must resolve.
Resolution	Error	Member declaration referenced	Members must refer to valid
		type that does not match member	types. This includes setting
		declaration type.	declarations, type,
			relationship, flow and
			constraint members.
Resolution	Error	Member name already defined	A base type's members
		in base type	cannot be overridden by
			a derived type
Resolution	Error	Failed to resolve import	All import statements must
		statement	resolve to an sdm document
Resolution	Error	Failed to resolve base type	The base type for a
Resolution	Error	Invalid base type	component must be
			resolvable and must be of
			the same type as the component
Resolution	Error	Setting type declaration used	Setting types must be derived
		unsupported base type	from a limited set of xsd
			types defined in the SDM
			schema
Resolution	Error	Setting namespace includes do	The namespaces included in
		not match sdm includes	the setting schema must
			match the sdm namespaces
			imported into the sdm
			document that includes the
			settings schema
Resolution	W2	Complex setting type too complex	The display can only support
		for UI to display	complex types that have no
			attributes and only contain a
			sequence of singleton
			elements derived from
			simple types.
Resolution	Error	Failed to resolve path	All elements on the path
Resolution	Error	Path type mismatch	must resolve to a member of
Resolution	Error	Input path targets write-only	the type associated with the
		setting	previous element on the path
Resolution	Error	Output path targets fixed	or the root context of the
		setting	path. The type associated
			with the final element must
			be compatible with the
			destination of the path.
Resolution	Error	No conversion available	We only support a small
		between flow input type and	number of lossless
		source setting type	conversions between base
Resolution	Error	No conversion available	data types.
		between flow output type and
		destination setting type
Resolution	Error	No conversion available
		between constraint input type
		and source setting type
Resolution	Error	The setting value can only be	This setting value is marked
		specified during deployment	for deployment time.
		time.
Resolution	Error	Setting value did not conform	All setting values must
		to setting type	conform to the setting type
Resolution	Error	Setting value is not nillable	Setting value is blank and is
			not the target of a flow value
Resolution	Error	Failed to resolve manager	The manager identified by a
Resolution	Error	Failed to load manager	type must resolvable and
			loadable by the compiler and
			runtime.
Resolution	Error	More than one input declaration	Only one input path is
		provided for a single flow	allowed for flow or
		input	constraint inputs
Resolution	Error	More than one input declaration
		provided for a single constraint
		input.

[0228]

Flow Errors
Format	Level	Description	Rule
Flow	Error	Required input not	All required inputs for a flow must be
		defined	defined before the flow can be
			evaluated.
Flow	Error	Flow output did not	The value generated by the flow did not
		conform to target	conform to the output type declared by
		setting type	the flow.
Flow	Error	Flow failed - see	When executed, the flow returned an
		flow type for detail	error.

[0229]

Constraint Errors
Format	Level	Description	Rule
Constraint	Error	Required constraint	A constraint declaration did not meet its
		did not evaluate true	minimum cardinality.
Constraint	Error	Bounded constraint	A constraint exceeded its maximum
		exceeded upper	cardinality.
		bound
Constraint	Error	Illegal constraint	A constraint with a maximum
		evaluated true	cardinality of zero evaluated to true.
Constraint	Error	No constraint in	At least one constraint in a constraint
		constraint group	group must evaluate to true.
		evaluated true
SettingConstraint	Error	Required input not	All required inputs to a constraint must
		defined	be provided before the constraint can be
			evaluated.
SettingConstraint	Error	Constraint Failed -	A constrain was evaluated and returned
		see constraint for	an error
		details	(should we differentiate a failure during
			execution from a false return?)
Constraint	W3	Could not check the	Not enough information is available to
		constraint	check the constraint.

EXAMPLE SDM IMPLEMENTATION

[0230] The following is an example implementation of the SDM. This example SDM implementation includes a Definitions section (section 1), an Architectural Overview section (section 2), and an Implementation Details section (section 3). It is to be appreciated that various specific values and requirements are described in this example implementation, and that not all implementations are limited to these specific values and requirements.

[0231] 1 Definitions

Term               Definition
Change Request     A declarative document that describes a set of changes
                   to a modeled system
Object definition  An object definition captures the configuration of an
                   element of the modeled system.
Relationship       A definition that is used to describe the interaction
definition         between modeled system elements
System Definition  An xml document that contains definitions for objects,
Model (SDM)        relationships, settings, flow and constraints.
Document
Software           The combination of a set of SDM documents and the
Distribution Unit  associated binary information (files) required to deploy
(SDU)              those types to an SDM managed system
SDM Instance space A set of concrete type and relationship instances that
                   represent the modeled system

[0232] 2 Architectural Overview

[0233] The System Definition Model (SDM) supports description of the configuration of and interaction between the elements of a connected system that we will refer to as the modeled system.

[0234] SDM is based on an object-relational model. We use objects to describe elements that exist in the modeled system and relationships to identify the links between them. The SDM further refines objects and relationships to capture semantics that are important to the SDM. In particular, we divide objects into systems, endpoints and resources and we divide relationships into communication, containment, hosting, delegation, and reference.

[0235] We use abstract object definitions to provide a common categorization of system parts allowing tool support for a wide range of applications and providing the basis for type checking at design time. We expect the set of abstract definitions to provide a comprehensive basis for system design and we expect that they will change slowly over time.

[0236] We then use the abstract definitions as a basis for defining concrete definitions that represent parts of an actual application or datacenter design. We take an abstract definition and provide an implementation that defines the concrete type's members and setting values for its properties. We then build systems from collections of these definitions.

[0237] Constraints are used to model restrictions over the allowed set of relationships in which an instance can participate. We use constraints to capture fine grained requirements that depend on the configuration of objects involved in a relationship. For example, a constraint may be used to validate that participants on each end of a communication protocol are using compatible security settings.

[0238] In order to effect change on the target system, a declarative description of the required changes called a change request can be used. SDM defines the process that is used to expand, validate and execute a change request as part of the SDM execution model.

[0239] The instance space captures both the desired and current state of the managed application. We can track changes in the instance space and associate them with the change request that initiated the change.

[0240] Managers are used to both provide customized behavior to the runtime and to support interaction between the runtime and the modeled system.

[0241] 2.1 Objects

[0242] Objects are used to represent both logical and physical aspects of the modeled system. For example, they can be used to represent files, directories and the configuration within IIS. They can also be used to represent an application or distributed system boundary.

[0243] We separate objects into three categories. Each represents aspects of the modeled system that we believe should be exposed and understood as part of the SDM model itself rather than through attribution or an imposed inheritance structure over particular models instances.

[0244] 2.1.1 Resources

[0245] Resources represent the fundamental units of behavior that can be combined to create a system model. Resources may be used to group other resources together to add structure to a system model. Each resource may express dependencies on other resources that it may require in order to perform its modeled behavior. In order to create an instance of a resource a host environment must be identified for the resource.

[0246] Examples of resources include files, directories and registry keys and values as part of operating system, web directories and web files as part of IIS and tables, rows and stored procedures as part of a database.

[0247] 2.1.2 Systems

[0248] Systems are used either to represent a collection of resources that perform a well defined task or to represent a collection of systems that interact to perform a well defined task. Resources within a system boundary cannot express dependencies on resources outside that boundary. At the same time, we do not require resources to document the mechanisms that they use to communicate with other resources within the same system boundary.

[0249] This means that interaction between systems must be explicitly modeled using communication relationships. It also means that in general a system is the smallest unit of deployment. Since resources may have undocumented interactions with other resources, we cannot guarantee that they will work if they are deployed independently.

[0250] Examples of systems include the operating system, web applications hosted in IIS and databases hosted by SQL.

[0251] 2.13 Endpoints

[0252] Endpoints are used to define the interfaces that a system exposes to support communication with other systems. Since we do not allow resources to have dependencies that cross system boundaries, endpoints must be used to model the interaction that is required in order to allow a system to operate correctly.

[0253] Examples of endpoints include Http, Tcpip and Soap endpoints.

[0254] 2.2 Relationships

[0255] We use relationship to capture aspects of the interactions that occur between objects. All relationships are binary and directed. As well as capturing the interaction between objects, relationship can place constraints on the objects that participate in the relationship and can flow configuration information between the participants.

[0256] Once again, we identify a set of relationships that are understood by the SDM model in order to attach particular semantics to those relationships. This allows us to reason about the runtime behavior of the model system.

[0257] In particular the aspects that we need to describe about a particular object instance are:

[0258] a) its lifetime

[0259] b) who can interact with it

[0260] c) where it appears in the structure of a system

[0261] d) who it communicates with

[0262] e) who it depends on to do its work

[0263] f) what environment it should execute in

[0264] g) whether it is operating correctly and is available

[0265] We also use relationships to define the allowable structure of an application. These aspects include:

[0266] a) What objects another object can contain

[0267] b) Which endpoints can be connected together

[0268] c) What environments can host a particular object

[0269] Each of the following relationships captures part of one or more of the above aspects.

[0270] 2.2.1 Containment

[0271] Containment relationships are used to define the containment structure of an SDM model. The existence of a containment relationship is used to indicate that one object can contain another object. This information is used at design time to guide the design environment when it exposes options to the developer or architect about how they can associate systems, resources and endpoints.

[0272] Containment relationships are defined in order to limit the structure of an SDM model. For example, an architect may design a web application model that can contain web directories, file system directories and files. Another architect may extend the model to allow it to contain web sites. By understanding the underlying structure of these models, operators and tool builders can reason about what environment instances of the model may require and what effect a particular model may have on the system that it is deployed into. For example, in the first model defined above, the operator supplies a web site to enable the application to be deployed.

[0273] Containment relationships define the lifetime of an object, the owner of an object and where an object appears in the structure of a modeled system. If there is a single parent container for an object then the lifetime of the parent bounds the lifetime of the contained object. A parent is also said to own the contained object. This means that the parent has control over the visibility of the object and can determine whether to expose the object or parts of the object to its parents. Finally, a parent provides contextual information for the object. This contextual information can be used to help a developer communicate the structure of their application to other developers or to users of the application. For example, when localizing errors in a running application, the containment chain can provide rich contextual information, indicating in detail which part of an application failed.

[0274] Uses of containment relationships include representing the structure of the virtual directories of a web application and the structure of files and directories deployed by the web application. Containment would also be used to describe the relationship between the web application and the connected system model of which it is a part.

[0275] 2.2.2 Hosting

[0276] Hosting relationships are used to model the containment structure of the environment that is being modeled. These relationships capture the functional restrictions on the environment. For example, the restriction that files must be contained in a directory or that web directories must be contained in a website.

[0277] A hosting relationship defines both an object's lifetime and the environment in which it executes. In order to exist, an object should have at least one host. This means that the lifetime of its host bounds the lifetime of the object and if its host is marked as offline, then it should also be marked as offline.

[0278] The hosting relationship is responsible for creating and maintaining an instance of an object within the environment defined by its host. This factoring places the responsibility of creating an instance of a guest on a host with the relationship rather than with either the guest or the host. By providing a range of hosting relationships, a guest can be supported by multiple host environments.

[0279] The existence of a hosting relationship indicates that it is possible to place a guest object on a host object. For a system that contains many resources to be hosted on another system, all the resources in the guest system should have hosting relationships to at least one resource in the host system.

[0280] 2.2.3 Communication

[0281] Communication relationships are used to model the communication that occurs between subsystems of a connected system. Since they are expressed between endpoint objects, they can only be established between systems that expose endpoints. If a system contains nested systems that also expose endpoints, these endpoints are exposed through proxy endpoints on the outer system that are in turn delegated to the endpoints of the inner system.

[0282] If a communication relationship does not exist between a set of endpoints then a connection cannot be established between those endpoints.

[0283] If a system is marked as offline, then all the clients of that system are updated to reflect the fact that the system is unavailable. This is done by propagating the change through the communication relationships that reference the system.

[0284] 2.2.4 Reference

[0285] Reference relationships are used to capture dependencies between resources or systems that are required in order to achieve correct operation but are not considered part of the execution environment of the dependent object.

[0286] For example, a web directory needs a reference to either a local directory or a remote share in order to expose web content to consumers of the web service. This would be expressed as a dependency relationship between the web directory and either the local directory or the remote share.

[0287] 2.2.5 Delegation

[0288] A delegation relationship is used to forward interaction with a proxy to an object instance that implements the behavior exposed by the proxy. A commonly used example of delegation is forwarding a communication relationship from an endpoint on a parent system to an endpoint on a contained system.

[0289] 2.3 Definitions

[0290] Object and relationship definitions are used to create reusable configurations that can be instantiated to create instances of that configuration. These instances then share the common characteristics identified by the definition.

[0291] An abstract definition cannot be instantiated directly as it is incomplete. To complete it, another definition extends it to add the missing elements.

[0292] We use abstract definitions to create building blocks that we can use when building a model of a real system. The relationships between abstract definitions define the allowable structure of the definitions that extend the abstract definition. This allows a design surface to use an abstract definition to define the actions that a user of the surface may perform. For example, the containment relationships in which an abstract web application participates guide the structure of web applications that extend the abstract definition.

[0293] In essence, the combination of abstract object definitions and relationship definitions defines a schema for modeling the target system. The role of a concrete object definition is to use a subset of the abstract definition space to create a reusable configuration based on one or more abstract definitions. As a simple analogy, the abstract definition space can be compared to the schema for database; the concrete object definition would then represent a reusable template for a set of rows in the database. The rows are only created in the database when an instance of the concrete object is created. To perform design time validation we can validate a concrete object definition against the abstract definition space in the same way that we would validate the rows in the database against the constraints of the schema (for example foreign keys, etc).

[0294] Setting definitions are used to create simple value elements. These values elements can then be used to store configuration information.

[0295] 2.4 Members

[0296] A definition can contain members that reference other definitions. Members allow one definition to reuse another definition in a way that is customized to its particular application.

[0297] Setting members are used to identify configuration information that is associated with the definition. Setting members are based on setting definitions

[0298] Object members are used to create instances of a particular object definition. Settings flow can be used to provide values for the object. When declaring an object member, the user can decide whether the object member is created at the same time the outer system is created (value semantics) or is created by an explicit new operation that occurs at some later time (reference semantics).

[0299] Relationship members define the relationships that object members will participate in when they are created. If an object member is contained by its parent, then a containment relationship member will be declared between the member and the containing definition. If the object member is delegated, then a delegation relationship member would be defined between the object member and a source object member. Communication relationship members can be declared between endpoints that communicate. Dependency relationship members (reference and hosting) can be declared the dependent and source object members.

[0300] Constraint members are used to narrow the set of relationships that a particular object is willing to participate or the set of objects that can participate in a particular relationship. They identify constraints on an object or relationship that may target the settings of that object or relationship or may constraint the interactions associated with that object or relationship.

[0301] Flow members are used to define the flow of configuration between members. They collect input values from settings on members, perform some processing on that information and then distribute the results to settings on members.

[0302] 2.5 Instances

[0303] The instance space reflects the current state of the modeled system. A complete record of the instances that have been created and the relationships between these instances may also be maintained. Each instance has an associated version history where each version is linked to a change request.

[0304] The process of creating new instances is initiated by a change request. The change request defines a set of create, update and delete requests for types and relationships associated with specific members of an existing instance; the root is a special case.

[0305] The change request is expanded by the runtime, verified against all constraints, and then constructed. The expansion process identifies object and relationship instances that are constructed implicitly as part of the construction request of the containing object and then settings flow is then evaluated across all relationships. The verification step checks that all required relationships exist and that the relationships fulfill all constraints. Finally, the construction process determines an appropriate ordering over the deployment, update or removal of each instance and then in the correct sequence passes each instance to an instance manager to perform the appropriate action.

[0306] 2.6 The Object Model

[0307] The following uml diagrams capture the broad interactions between the objects in the SDM model. For simplicity, some of these interactions have been defined between base types where the actual interactions exist between derived types and as a result are more specialized.

[0308] An SDM document contains information that describes the document, managers for the definitions in the document, import statements that reference other documents and a set of definitions for the objects and relationships described by the document. Many SDM elements can also contain design data, which allows the design surface to attribute the SDM elements with information that is specific to the display and manipulation of that element within the design surface.

[0309] FIG. 8 illustrates an example SDM document.

[0310] All SDM definitions derive from a common base definition as shown in FIG. 9. Definitions may contain a description, a set of members, a set of setting values and design data. We specialize definitions into object, relationship, constraint, flow and setting definitions. Object definitions are then further specialized into System, Resource and Endpoint definitions. Relationship definitions are further specialized into Hosting, Communication, Delegation, Reference and Containment definitions.

[0311] Members are used to associate a name with a particular instance or array of instances as shown in FIG. 10. All members refer to a definition. Each member may contain a set of setting values, a description and design data. Members are then specialized based on the kind of definition that they reference. Flow and constraint members add the ability to define inputs that source setting values from setting members within the containing definition. Flow members also add outputs that allow the processed flow values to be forwarded to setting members within the containing definition.

[0312] An example setting member is shown in FIG. 11. Setting members reference a setting definition that can either represent a complex or a simple setting definition. A complex setting definition can contain nested setting members. A simple definition defines a single value field. Input and output objects are used to define a transfer of a setting value between setting members.

[0313] An example constraint definition is shown in FIG. 12. Constraints are used place restrictions on setting values and on the structure of an SDM model. A constrain definition targets a particular object or relationship definition. The constraint definition may place structural constraints on the relationships that the object participates in or the objects that participate in a relationship. These structural definitions may also be added directly to the object or relationship definition.

[0314] Description objects are used to provide human readable descriptions of SDM elements, as shown in FIG. 13. These elements should be localizable which is the responsibility of a manager. Design data elements contain structured data that is defined by the design surface that edits the SDM document.

[0315] 2.7 Layering

[0316] A goal of the SDM model is to allow a separation of concerns between the developers of applications, the designers of the software infrastructure and the architects of the datacenter. Each of these groups focuses on particular services and has a differing set of dependencies.

[0317] For example, developers mainly care about the configuration and connectivity between the hosts that they depend on such as SQL, IIS and the CLR. Designers of the host configuration care about the network topology and the OS configuration, while the architects developing the network topology, OS configuration and storage mapping need to know about the hardware that exists in the datacenter.

[0318] To support this separation of concerns, SDM exposes a concept of layering. Layering is enabled by the use of hosting relationships. By defining hosting relationships between the operating system, a host such as sql and the services that slq provides eg databases, we allow an application developer to define an application that contains a database while an architect defines a system that contain the sql host. We layer combine these separate systems by connecting the hosting relationships between the guest system and the host system,

[0319] A layer boundary can occur wherever a hosting relationship exists. In order to simplify the choice of where to place layer boundaries we define four basic layers as part of the SDM model. We then associate systems with one of these layers. The four layers are:

[0320] The application layer.

[0321] The application layer supports the construction of applications in a constrained context. The context is defined by the configuration of the hosts identified in the host layer

[0322] Examples of system definitions in the application layer include web services, databases and biztalk schedules.

[0323] The host layer

[0324] Build datacenters out of software components. Configure the connections between components. Some of these components act as hosts for the application layer.

[0325] Examples of system definitions in this layer—IIS, SQL, AD, EXCHANGE, DNS and Biztalk.

[0326] The Network/OS/Storage layer

[0327] Build data center networks and platforms. Configure the network security model and the operating system platform configuration. Add storage to operating system configurations.

[0328] Examples of system definitions in this layer—VLAN, Windows, Filter, Storage.

[0329] The Hardware layer

[0330] The hardware layer identifies the types of machines that exist in the datacenter and the physical connections that exist between these machines.

[0331] FIG. 14 shows an example mapping of a layer 4 web application to a layer 3 web server host. The outer box at each layer represents a system, the boxes on the boundary represent endpoints and the boxes on the inside represent resources. We map each of these elements via a hosting relationship to a host at the layer below.

[0332] 3 Implementation Details

[0333] 3.1 Naming

[0334] There are a number of places in the SDM where we need a strong naming system for identifying objects. The following naming system allows the creator of an SDM document to sign the document in such a way that users of the definitions in the document can be sure that they are the same as the ones that developer originally published.

[0335] The following header is an example of an identifier for an SDM document:

<SystemDefinitionModel Name=“System.OperatingSystem.FileSystem”
Version=“0.1.0.0”
DocumentLanguage=“en”
xmlns=
“http://schemas.microsoft.com/SystemDefinitionModel/2003/10”
Version=“0.1.0.0”
PublicKeyToken=“AAAABBBBCCCCDDDD”
Culture=“neutral”
Platform=“neutral”
>
</ SystemDefinitionModel >

[0336] To reference a type in another namespace you import the namespace:

<Import Alias=“FileSystem” Name=“System.OperatingSystem.FileSystem” Version=“0.1.0.0”/>

[0337] Then you can use the alias to refer to definitions within the namespace:

FileSystem:File

[0338] 3.1.1 Identity

[0339] SDM names are scoped by the namespace in which they are defined. A namespace is identified by a name, version, language and a public key token and is contained within a single file.

[0340] The base form of identity includes name, version, culture, platform and a public key token.

<xs:attributeGroup name=“Identity”>
<xs:attribute name=“Name” type=“Path” use=“required”/>
<xs:attribute name=“Version” type=“FourPartVersionType” use=
“required”/>
<xs:attribute name=“PublicKeyToken” type=“PublicKeyTokenType”
use=“optional”/>
<xs:attribute name=“Culture” type=“CultureNeutral” use=
“optional”/>
<xs:attribute name=“Platform” type=“xs:string” use=“optional”/>
</xs:attributeGroup>

[0341]

Attribute/
element	Description	Default
Name	The name of the SDM file is a friendly	NA
	name that a developer can use to
	reference the contents of the file. The
	name in combination with the public
	key token provides a strong name for
	the file.
Version	Version is used to identify the version	NA
	of the contents of the file. All elements
	of the file adopt the same version
	number
PublicKeyToken	Public key token is a short name for	Nil
	the public key associated with the file.
Culture	The culture of the binaries.	neutral
Platform	The supported platform for the	×86
	binaries.

[0342] The base identity can be used in conjunction with a signature and a public key, to create a new strong identity called a Namespace Identity. This identity is used to identify an SDM document. To create the identity the document will be signed using the private key, allowing the user of the document to verify its contents using the public key.

[0343] A public key token is a 16 character hex string that identifies the public part of a public/private key pair. This is not the public key; it is simply a 64 bit hash of the public key.

<xs:simpleType name=“PublicKeyTokenType”>
<xs:restriction base=“xs:string”>
<xs:pattern value=“([0-9]|[a-f]|[A-F]){16}”/>
</xs:restriction>
</xs:simpleType>

[0344] The document language is specified using a culture identifier that consists of two lower case letters defining the language and then two or three uppercase letters defining the country or region.

<xs:simpleType name=“Culture”>
<xs:restriction base=“xs:string”>
<xs:pattern value=“[a-z]{2}((−[A-Z]{2})?|(−[A-Z]{3})?)”/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name=“CultureNeutral”>
<xs:union memberTypes=“Culture”>
<xs:simpleType>
<xs:restriction base=“xs:string”>
<xs:enumeration value=“neutral”/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>

[0345] 3.1.2 Version

[0346] A file version is defined by a four part number of the form N.N.N.N where 0<=N<65535. By convention, the numbers refer to Major.Minor.Build.Revision. The version number identifies the version of all the definitions contained within the document. This means that a document becomes the unit of versioning as all definitions within the document are upgraded together.

<xs:simpleType name=“FourPartVersionType”>
<xs:restriction base=“xs:string”>
<xs:pattern value=“([0-9]{1,4}|[0-5][0-9]{4}|64[0-9]{3}|
655[0-2][0-9]|6553[0-5])(\.([0-9]{1,4}|[0-5][0-
9]{4}|64[0-9]{3}|655[0-2][0-9]|6553[0-5])){3}”/>
</xs:restriction>
</xs:simpleType>

[0347] 3.1.3 Simple Names

[0348] Simple names are made up of alpha-numeric characters and limited punctuation. The name starts with a non-numeric character.

<xs:simpleType name=“SimpleName”>
<xs:restriction base=“xs:string”>
<xs:pattern value=“[a-z,A-Z,_]{1}([0-9,a-z,A-Z,_])*”/>
</xs:restriction>
</xs:simpleType>

[0349] We plan to conform to the C# definition for identifiers; the appropriate section has been inserted below in the following table. Note we will not support “@” prefixed names in the SDM model.

The rules for identifiers given in this section correspond exactly to those
recommended by the Unicode Standard Annex 15, except that underscore is
allowed as an initial character (as is traditional in the C programming
language), Unicode escape sequences are permitted in identifiers, and the “@”
character is allowed as a prefix to enable keywords to be used as identifiers.
identifier:
available-identifier
@ identifier-or-keyword
available-identifier:
An identifier-or-keyword that is not a keyword
identifier-or-keyword:
identifier-start-character identifier-part-charactersopt
identifier-start-character:
letter-character
_(the underscore character U+005F)
identifier-part-characters:
identifier-part-character
identifier-part-characters identifier-part-character
identifier-part-character:
letter-character
decimal-digit-character
connecting-character
combining-character
formatting-character
letter-character:
A Unicode character of classes Lu, Ll, Lt, Lm, Lo, or Nl
A unicode-escape-sequence representing a character of classes Lu, Ll,
Lt, Lm, Lo, or Nl
combining-character:
A Unicode character of classes Mn or Mc
A unicode-escape-sequence representing a character of classes Mn or
Mc
decimal-digit-character:
A Unicode character of the class Nd
A unicode-escape-sequence representing a character of the class Nd
connecting-character:
A Unicode character of the class Pc
A unicode-escape-sequence representing a character of the class Pc
formatting-character:
A Unicode character of the class Cf
A unicode-escape-sequence representing a character of the class Cf
For information on the Unicode character classes mentioned above, see The
Unicode Standard, Version 3.0, section 4.5.
Examples of valid identifiers include “identifier1”, “_identifier2”, and “@if”.
An identifier in a conforming program should be in the canonical format
defined by Unicode Normalization Form C, as defined by Unicode Standard
Annex 15. The behavior when encountering an identifier not in Normalization
Form C is implementation-defined; however, a diagnostic is not required.
The prefix “@” enables the use of keywords as identifiers, which is useful
when interfacing with other programming languages. The character @ is not
actually part of the identifier, so the identifier might be seen in other languages
as a normal identifier, without the prefix. An identifier with an @ prefix is
called a verbatim identifier. Use of the @ prefix for identifiers that are not
keywords is permitted, but strongly discouraged as a matter of style.
The example:
class @class
{
public static void @static(bool @bool) {
if (@bool)
System.Console.WriteLine(“true”);
else
System.Console.WriteLine(“false”);
}
}
class Class1
{
static void M( ) {
cl\u0061ss.st\u0061tic(true);
}
}
defines a class named “class” with a static method named “static” that takes a
parameter named “bool”. Note that since Unicode escapes are not permitted in
keywords, the token “cl\u0061ss” is an identifier, and is the same identifier as
“@class”.
Two identifiers are considered the same if they are identical after the following
transformations are applied, in order:
The prefix “@”, if used, is removed.
Each unicode-escape-sequence is transformed into its corresponding
Unicode character.
Any formatting-characters are removed.
Identifiers containing two consecutive underscore characters
(U+005F) are reserved for use by the implementation. For example,
an implementation might provide extended keywords that begin
with two underscores.

[0350] 3.1.4 Reserved Names

[0351] The following is a list of reserved names that we will prevent users from using when creating names for members in an SDM definition. Within certain contexts, certain names will be reserved. The compiler will detect uses of these names and return an error to the user.

Context                          Name
All definitions                  this
Hosting Relationship definitions Guest, Host
Containment relationship definitions Parent, Member
Communication relationship definitions Client, Server
Reference relationship definitions Source, Dependent
Delegation relationships definitions Proxy, Delegate

[0352] 3.1.5 References to Other Namespaces

[0353] We allow namespaces to reference other namespaces by importing them into the current namespace and then associating an alias with the namespace. The imported namespace is referenced by name, version and public key token.

<xs:complexType name=“Import”>
<xs:attribute name=“Alias” type=“SimpleName” use=“required”/>
<xs:attributeGroup ref=“Identity”/>
</xs:complexType>

[0354]

Attribute/
element  Description
Alias    The alias used to reference the external SDM file within
         the scope of the current SDM file.
Identity The group of attributes defined in section 3.1.1

[0355] 3.1.6 Qualified Names

[0356] Qualified names are names that refer to definitions or managers defined in the current namespace or in an aliased namespace. If the name does not include an alias or a “dot separator” then it is unqualified and should be resolved based on the scoping rules. Unqualified paths may resolve to different definitions based on the context in which they are evaluated. This is because nested definitions may hide definitions in a wider scope. See section 3.1.7.

[0357] Any path that includes a “dot separator” should be fully qualified and will be resolved from the document root. This means a user cannot create a partially qualified name that contains a more than one type name but can only be resolved from the declaration context.

[0358] [<alias>:]<simpleName>(.<simpleName>)*

[0359] The alias is defined in an import statement.

<xs:simpleType name=“QualifiedName”>
<xs:restriction base=“xs:string”>
<xs:pattern value=“[a-z,A-Z,_]{1}([0-9,a-z,A-Z,_])*(:
[a-z,A-Z,_]{1}([0-9,a-z,A-Z,_])*)?(\.[a-z,A-Z,_]
{1}([0-
9,a-z,A-Z._])*)*”/>
</xs:restriction>
</xs:simpleType>

[0360] 3.1.7 Name Scoping

[0361] Names of definitions are scoped by the context in which they are defined. The broadest scope is the document. If a definition is nested, then its name is scoped by that definition. This means that it may hide names in a parent scope. It also means that a reference to a definition from outside the scope in which it is defined should be qualified by the name of its parent scope. A fully qualified name includes all the names from the document root to the nested definition.

[0362] 3.1.8 Member Paths

[0363] A member path is a sequence of names that correspond to members of the definitions that are crossed. A path should begin with a member name that is defined in the context in which the path is declared.

[0364] Some member names are added automatically to a definition. We call these well-known names. Examples of well-known names include “this” in a definition or reference declaration, “Host” and “Guest” in a hosting relationships declaration, or a “Target” defined within a constraint declaration. The setting target also identifies the setting on the associated flow definition that will be used as either the source value or destination setting of setting identified by the path.

[0365] Member names are dot separated.

<simpleName>(.<simpleName>)*
<xs:simpleType name=“Path”>
<xs:restriction base=“xs:string”>
<xs:pattern value=“[a-z,A-Z]{1}([0-9,a-z,A-Z,_])*
(\.[a-z,A-Z]{1}([0-9,a-z,A-Z,_])*)*”/>
</xs:restriction>
</xs:simpleType>

[0366] 3.1.9 Instance Paths

[0367] Paths in the instance space are based on xpaths where the element names in the xpath correspond to member names and attributes in the xpath correspond to settings.

[0368] 3.1.10 Signature

[0369] A compiled SDM document is signed using a key in order to provide a mechanism to validate the document's contents and to associate a strong name with the document. The signature mechanism uses the DSIG standard (http://www.w3.org/2000/09/xmldsig#) to sign the document.

[0370] A signature node similar to the following is embedded in a signed document.

<Signature xmlns=“http://www.w3.org/2000/09/xmldsig#”>
<SignedInfo>
<CanonicalizationMethod Algorithm=“http://www.w3.org/TR/2001/REC-xml-c14n-20010315”/>
<SignatureMethod Algorithm=“http://www.w3.org/2000/09/xmldsig#rsa-sha1”/>
<Reference URI=“”>
<Transforms>
<Transform Algorithm=“http://www.w3.org/TR/2001/REC-xml-c14n-20010315”/>
<Transform Algorithm=“http://www.w3.org/2000/09/xmldsig#enveloped-signature”/>
</Transforms>
<DigestMethod Algorithm=“http://www.w3.org/2000/09/xmldsig#sha1”/>
<DigestValue>Dn9BN6rKnnzzgGxaWl3j0aW8/1g=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>JaNLAktv2+n4Xz3p0jM8zqwmUc8T91AOtwasKOVBwHgvYAGijRFl0U1kcVfHbDJoi8ln33prn
S5lTNj46rGYRn/UK11vjvpprfgz2a+Ql7G4o7hBwO0SZzLLPO7/y7+GKw0Cr6zaoDmOFSdP8lAATuVJC40pZhbDm
cmHJduaXm0=</SignatureValue>
<KeyInfo>
<KeyValue xmlns=“http://www.w3.org/2000/09/xmldsig#”>
<RSAKeyValue>
<Modulus>wxxlClOui6J77CZcnzLOcBBxl/3uuFrUBEyFivVklRtTTzQpgirdaNouQ9ziCAK6aipeM6RjgYAoDPs/i
WFnrHmtDoxgP2H4/W9lttXO5EjQDb76XAZRPSvthJYtreKEGE0d6L6iTRdg25hYGFkyY/yS0s0ONh3+5VO0Wxq+
Fx0=</Modulus>
<Exponent>AQAB</Exponent>
</RSAKeyValue>
</KeyValue>
</KeyInfo>
</Signature>

[0371] The node is a root node in the document that should occur before any other contents in the document. We declare this element using the ‘any’ tag but we will only recognize and process a “Signature” node at this location.

<xs:any namespace=“http://www.w3.org/2000/09/xmldsig#” processContents=“skip” minOccurs=“0”/>

[0372] 3.1.11 Defining, Referencing and Resolving Namespace Names

[0373] In this section, we describe the process that we use to match a namespace reference to a particular namespace. As defined in section 3.1.1, a namespace identity consists of five attributes:

[0374] Simple name

[0375] Public key token

[0376] Version

[0377] Language

[0378] Platform

[0379] These attributes are used by the consumer of a namespace to identify a required namespace (a namespace reference) and the developer of a namespace to provide a well known identity for a namespace (a namespace definition). The interpretation of each of these attributes may be different depending on whether they are part of a namespace reference or a namespace definition.

[0380] 3.1.11.1 Namespace Definition

[0381] When a developer wishes to create and publish a new namespace the developer:

[0382] provides a simple name for the namespace

[0383] provides a version for the namespace

[0384] The developer can optionally:

[0385] sign the namespace with a cryptographic key

[0386] identify a specific culture for the namespace (defaults to culture neutral)

[0387] Identify a specific platform for the namespace (defaults to platform neutral)

[0388] If the namespace is not signed, then there will be no public key token and the namespace will have a weak name. A namespace can be delay signed which allows the developer to separate the signing process from the compilation process. A delay signed namespace that has been compiled but not yet signed can be referenced during compilation but can not be used at runtime.

[0389] 3.1.11.2 Namespace Reference

[0390] When a consumer references (imports) a namespace in an SDM file, they:

[0391] provide the name of the referenced namespace

[0392] They can optionally provide additional information including:

[0393] the public key token of the referenced namespace

[0394] the minimum version of the referenced namespace

[0395] the culture of the referenced namespace or a wildcard (*)

[0396] the platform of the referenced namespace or a wildcard (*)

[0397] All the attributes that are not provided default to a wildcard that will match any value for the attribute.

[0398] 3.1.11.3 Matching a Reference to a Definition

[0399] The following algorithm is used to match a namespace reference to namespace definition. This algorithm is used both when compiling a namespace and when resolving references between compiled namespaces.

[0400] There is one slight difference between the compilation and post compilation scenarios: at compile time the version field of the namespace reference is ignored, but a runtime it must be present. The compilation process will update a namespace reference to add additional information from the namespace that a reference was resolved to during compilation. It will always add the version from the namespace. If the public key token was not provided and it exists on the resolved namespace, it will be added to the namespace reference.

[0401] Logically, the resolution algorithm works as follows:

[0402] 1. Find all namespaces with names that matches the name in the reference.

[0403] 2. If the reference provides a public key token then select only the namespaces that also match the provided public key token.

[0404] 3. If a specific language has been provided by the reference, then remove all namespaces that don't match the language. If the language attribute was set to wildcard not provided, then keep all namespaces

[0405] 4. If a specific platform has been provided then remove all namespaces that don't match the platform. If platform attribute was set to wildcard or not provided, then keep all namespaces

[0406] 5. Then use versioning policy to select a particular namespace from the set of possible namespaces.

[0407] The following sections define these steps in more detail.

[0408] 3.1.11.3.1 Matching Namespace Name

[0409] The name match is an exact string match. The name is case sensitive.

[0410] 3.1.11.3.2 Matching Public Key Token

[0411] The token is an exact match.

[0412] 3.1.11.3.3 Matching Language

[0413] There are three scenarios for language matching:

[0414] 1. Reference=*, Definition=specific language.

[0415] 2. Reference=specific language, Definition=*.

[0416] 3. Reference=specific language, Definition=specific language.

[0417] For the first and second cases, the definition is a match for the reference. In the third case, the definition is only a match for the reference if the language is an exact match.

[0418] 3.1.11.3.4 Matching Platform

[0419] There are three scenarios for platform matching.

[0420] 1. Reference=*, Definition=specific platform.

[0421] 2. Reference=specific platform, Definition=*.

[0422] 3. Reference=specific platform, Definition=specific platform.

[0423] For the first and second cases, the definition is a match for the reference. In the third case, the definition is only a match for the reference if the platform is an exact match.

[0424] 3.1.11.3.5 Matching Version

[0425] The version match is dependent on the versioning policy that is being used by the compiler or runtime.

[0426] 3.2 Settings

[0427] All definitions can expose settings members, called setting declarations within the XML schema. These members are used to describe the configuration values that are associated with the definition. Values are provided using SettingValue statements. These can be used by:

[0428] a) The definition that declares the setting member to define the default values for the setting.

[0429] b) By a definition that extends another definition to provide default or fixed values for the base definition.

[0430] c) By members that reference a definition and through member paths that terminate in the member that references the definition.

[0431] d) Through flow along relationships.

[0432] To define a setting you first need to define the definition of the setting using xsd.

<SettingDefinitions>
<xs:schema targetNamespace=“System.OperatingSystem.Registry”
xmlns=“System.OperatingSystem.Registry”
xmlns:xs=“http://www.w3.org/2001/XMLSchema”>
<xs:simpleType name=“PathType”>
<xs:restriction base=“xs:string”/>
</xs:simpleType>
<xs:simpleType name=“RegistryValueType”>
<xs:restriction base=“xs:NMTOKEN”>
<xs:enumeration value=“binary”/>
<xs:enumeration value=“integer”/>
<xs:enumeration value=“long”/>
<xs:enumeration value=“expandString”/>
<xs:enumeration value=“multiString”/>
<xs:enumeration value=“string”/>
</xs:restriction>
</xs:simpleType>
</xs:schema>
</SettingDefinitions>

[0433] You can then declare a setting that uses the definition and includes a set of attributes to define the behavior of the setting.

<SettingDeclaration Name=“Definition” Definition=“RegistryValueType” Access=“Readwrite”Required=“true”/>

[0434] Once you have a setting declaration you can provide a value for the setting.

<SettingValue Name=“Definition” Fixed=“true”>long</SettingValue>

[0435] 3.2.1 Setting Definitions

[0436] We use XSD schemas to define the setting definitions used by setting members. We only support the use of simple and complex types from a schema though other schema elements may exist to support the definition of those types.

[0437] The settings definition section should contain a complete xml schema including namespace declaration and namespace imports. We will check that the imports in the xsd schema match the imports in the SDM file with the exception of the xsd schema namespace. This means that all referenced types should be defined in another SDM file; the schema cannot reference types that are defined in arbitrary xsd files.

[0438] The target namespace of the schema has to match the name of the SDM document. We will add the public key for the document to the namespace name when we sign the document in order to guarantee that the namespace name is unique. So the compiler will change targetNamespace=“System” to targetNamespace=“System/AAAABBBBCCCCDDDD”.

[0439] When a setting definition schema references the namespace from another document they will use the full namespace name: xmlns:system=“System/AAAABBBBCCCCDDDD”.

<xs:complexType name=“SettingDefinitions”>
<xs:sequence>
<xs:any namespace=
“http://www.w3.org/2001/XMLSchema”/>
</xs:sequence>
<xs:attribute name=“Manager” type=“QualifiedName”
use=“optional”/>
<xs:attribute name=“ClrNamespace” type=“xs:string”
use=“optional”/>
</xs:complexType>

[0440]

Attribute/
element      Description
xs:any       A schema in the http://www,w3,ore/2001/XMLSchma
             namespace.
Manager      The clr assembly that contains helper classes for
             this schema
ClrNamespace The clr namespace in which these classes are
             defined. All setting type will resolve to a clr
             based on their mapping through CLR serialization.

[0441] Settings are resolvable from three separate namespaces:

[0442] a) The SDM namespace—when we refer to setting types within system, resource, endpoint, relationship, constraint or flow types.

[0443] b) The clr namespace—when we refer to settings using strongly typed classes within the clr and when setting types are built on other setting types.

[0444] c) The XSD namespace—when setting types are built using other setting types.

[0445] For this to work, we place a number of restrictions on the way we declare settings:

[0446] a) All settings must be in the same groupings within each of the clr, SDM and xsd namespaces. That is, if two settings are together in one namespace, they must be together in all three namespaces.

[0447] b) Imported namespaces within an xsd schema definition must match the imported namespaces in an SDM file and the imported namespaces in the associated helper assembly.

[0448] c) With the exception of the xsd namespace, all imported namespaces in an xsd schema must be defined within an SDM file.

[0449] XSD types from imported SDM documents are accessible using QNames:

<alias>:<type-name>

[0450] The following example uses the type defined in the registry example above. The document imports the registry document that includes the setting definition.

<Import Alias=“Registry” Name=“System.OperatingSystem.Registry” Version=“0.1.0.0”
PublicKeyToken=AAAABBBBCCCCDDDD”/>

[0451] The setting definitions schema can then also reference the System.Operatingsystem.Registry namespace.

<SettingDefinitions>
<xs:schema targetNamespace=“ http://DocumentExamples”
xmlns=“http://DocumentExamples”
xmlns:reg=“System.OperatingSystem.Registry/
AAAABBBBCCCCDDDD”
xmlns:xs=“http://www.w3.org/2001/XMLSchema”>
<xs:simpleType name=“UsesReg”>
<xs:restriction base=“reg:RegistryValueType”>
<xs:enumeration value=“guid”/>
</xs:restriction>
</xs:simpleType>
</xs:schema>
</SettingDefinitions>

[0452] 3.2.2 Built in Simple Data Types

[0453] The SDM supports a limited set of built in data types that are an intersection of the XSD and C# namespaces. These types are supported natively by the SDM runtime and are defined in the following table. In addition to these types, users are free to construct and use their own mapping between xsd and cls types.

Type	Description	XSD Type	C# Type
String	A string is a	string	String
	sequence of
	Unicode characters
Int	32-bit signed	int	System.Int32
	integral type
UnsignedInt	32-bit unsigned	unsignedInt	System.UInt32
	integer
Long	64-bit signed	long	System.Int64
	integral type
UnsignedLong	64-bit unsigned	unsignedLong	System.UInt64
	integer
Float	Single-precision	float	float
	floating point type
Double	Double-precision	double	double
	floating point type
Boolean	a boolean value is	boolean	bool
	either true or false
	(accepted values are
	“true”, “false”, 0
	and 1)
Any	The base type of all	anyType	object
	other types
DateTime	A simple date	date	dateTime
Guid	A globally unique	String (with	System.Guid
	identifier	pattern)
Duration	A time interval	Duration	System.Timespan
Version	A version number	String pattern:=	System.Version
		“([0-9]{1,4}|[0-
		5][0-9]{4}|64[0-
		9]{3}|655[0-2][0-
		9] 6553[0-
		5])(\.([0-9]{1,4}|[0-5][0-
		9]{4}|64[0-
		9]{3}|655[0-2][0-
		9]|6553[0-
		5])){3}”/>
Culture	A culture identifier	String pattern:=	System.CultureInfo

[0454] These types can be flowed to compatible derivations of these types in the c# and xsd type spaces. For example a value for string can be flowed to an xsd type that defined a restriction on string and any value can be flowed to a setting that accepts type-“any”.

[0455] 3.2.2.1 XSD Built in Types

[0456] FIG. 15 illustrates an example built-in datatype hierarchy. In FIG. 15, the all complex types are derived by extension or restriction. The NMTOKENS, IDREFS, and ENTITIES types are derived by list. All other types shown in FIG. 15 are derived by restriction.

[0457] 3.2.2.2 C# Data Types

Type	Description	Example
object	The ultimate base type of all other types	object o = null;
string	String type; a string is a sequence of	string s = “hello”;
	Unicode characters
sbyte	8-bit signed integral type	sbyte val = 12;
short	16-bit signed integral type	short val = 12;
int	32-bit signed integral type	int val = 12;
long	64-bit signed integral type	long val1 = 12;
		long val2 = 34L;
byte	8-bit unsigned integral type	byte val1 = 12;
ushort	16-bit unsigned integral type	ushort val1 = 12;
uint	32-bit unsigned integral type	uint val1 = 12;
		uint val2 = 34U;
ulong	64-bit unsigned integral type	ulong val1 = 12;
		ulong val2 = 34U;
		ulong val3 = 56L;
		ulong val4 = 78UL;
float	Single-precision floating point type	float val = 1.23F;
double	Double-precision floating point type	double val1 = 1.23;
		double val2 = 4.56D;
bool	Boolean type; a bool value is either	bool val1 = true;
	true or false	bool val2 = false;
char	Character type; a char value is a	char val = ‘h’;
	Unicode character
decimal	Precise decimal type with 28	decimal val = 1.23M;
	significant digits

[0458] 3.2.2.3 Supported Conversions

[0459] These are the conversions that exist between xsd types and cls types.

XML Schema (XSD) type .NET Framework type
anyURI                System.Uri
base64Binary          System.Byte[ ]
Boolean               System.Boolean
Byte                  System.SByte
Date                  System.DateTime
dateTime              System.DateTime
decimal               System.Decimal
Double                System.Double
duration              System.TimeSpan
ENTITIES              System.String[ ]
ENTITY                System.String
Float                 System.Single
gDay                  System.DateTime
gMonthDay             System.DateTime
gYear                 System.DateTime
gYearMonth            System.DateTime
hexBinary             System.Byte[ ]
ID                    System.String
IDREF                 System.String
IDREFS                System.String[ ]
int                   System.Int32
integer               System.Decimal
language              System.String
long                  System.Int64
month                 System.DateTime
Name                  System.String
NCName                System.String
negativeInteger       System.Decimal
NMTOKEN               System.String
NMTOKENS              System.String[ ]
nonNegativeInteger    System.Decimal
nonPositiveInteger    System.Decimal
normalizedString      System.String
NOTATION              System.String
positiveInteger       System.Decimal
QName                 System.Xml.XmlQualifiedName
short                 System.Int16
string                System.String
time                  System.DateTime
timePeriod            System.DateTime
token                 System.String
unsignedByte          System.Byte
unsignedInt           System.UInt32
unsignedLong          System.UInt64
unsignedShort         System.Uint16

[0460] 3.23 Setting Members

[0461] The settings declaration section uses the setting definitions from the previous section to create named settings. The setting definition within the xsd schema is referenced using a qualified name that includes the alias for the document that contains the setting (not required if the setting definition is in the current document) and then the name of the setting. We do not use the xsd namespace when referring to a setting definition.

[0462] Attributes are used to provide further information about each setting member.

<xs:complexType name=“SettingMember”>
<xs:complexContent>
<xs:extension base=“Member”>
<xs:attribute name=“List” type=“xs:boolean”/>
<xs:attributeGroup ref=“SettingsAttributes”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0463]

Attribute/element  Description
SettingsAttributes The set of attributes
                   that can be applied to an
                   individual setting decla-
                   ration See section 3.2.5
List               This attribute is used to
                   indicate that this setting
                   is a list of values rather
                   than a single value.

[0464] 3.2.4 List Support

[0465] In order to support manipulation of multi-valued settings, we support simple lists of setting values. A list is a sequence of values of the same definition as the setting declaration. Lists can be flowed to other lists that that they can either replace or append to. We do not support duplicate detection when appending values to a list as this can be done more flexibly using settings flow and we do not guarantee any form of ordering.

[0466] A list declaration includes an attribute list set to true:

<SettingDeclaration Name=“roles” Definition=“String” List=“true”/>

[0467] Values are then provided using a settingValueList. When providing the list, the user can specify whether to replace or append to the previous values.

<SettingValueList Path=“roles” Fixed=“true” Replace=“true”>
<Value>staticContent</Value>
<Value>aspPages</Value>
</SettingValueList>

[0468] The SDM supports simple manipulation of lists of values. When a path from a flow member targets a setting declaration, then the resulting behavior is dependent of the definitions at either end of the path.

	Source	Destination	Result
	Element	List	replace = false - element
			is added to the list
			replace = true - list
			with single element
	List	List	replace = false - source
			and destination lists are merged
			replace = true - source list
	List	Element	The SDM cannot resolve which
			element to select from the list
			so this combination is not sup-
			ported. Use flow to make this work.

[0469] 3.2.5 Setting Attributes

[0470] Setting attributes are used by the runtime to describe the behavior of a particular setting.

<xs:attributeGroup name=“SettingsAttributes”>
<xs:attribute name=“Access”>
<xs:simpleType>
<xs:restriction base=“xs:string”>
<xs:enumeration value=“Readwrite”/>
<xs:enumeration value=“Readonly”/>
<xs:enumeration value=“Writeonly”/>
</xs: restriction
</xs:simpleType>
</xs:attribute>
<xs:attribute name=“Secure” type=“xs:boolean”/>
<xs:attribute name=“DeploymentTime” type=“xs:boolean”/>
<xs:attribute name=“Dynamic” type=“xs:boolean”/>
<xs:attribute name=“Required” type=“xs:boolean”/>
<xs:attribute name=“KeyValue” type=“xs:boolean”/>
<xs:attribute name=“Nillable” type=“xs:boolean”/>
</xs:attributeGroup>

[0471]

Attribute Name	Description	Default
Access	The access attribute of a setting specifies	readWrite
	whether reading and writing the setting's value is
	permitted; providing SDM runtime access
	control and display/editing rules to designers.
	Attribute	Meaning in SDM	Display/Editing
	Value	Runtime	Rules
	readwrite	Indicates that a setting	Value is
		value can be read and	displayed and
		written.	can be edited.
	readonly	Indicates that a setting	Value is
		value can be read, but	displayed, but
		not written. This value	cannot be
		cannot be a target for	edited.
		flow.
		In general a readonly
		setting will be one that
		is calculated or
		provided by the real
		world instance.
		Example: A value that
		represents the number
		of connections on a
		server
	writeonly	Indicates that a setting	Value is
		value can be written,	masked, but can
		but not read. This value	be edited.
		cannot be a source for
		flow.
		Example: a password
		for a service account
DeploymentTime	A value that can only be provided as part of the	False
	deployment process for an instance. Design time
	constraints cannot be evaluated against this value.
	A definition or member cannot supply a fixed value
	for this setting.
Required	If required is true, a value must be provided for this	False
	setting before an instance is deployed. This setting
	cannot be readonly.
Dynamic	If dynamic is true, the instance manager supports	True
	changes to this value after an instance has been
	deployed.
KeyValue	Keyvalue is used to Indicate that a setting is unique	False
	within its hosting scope. The instance manager will
	use this setting in paths to identity object instances
	and to detect collisions with existing instances.
Secure	The secure attribute of a setting specifies whether	False
	the value of a setting should be encrypted (true or
	false) when stored to an SDM document. Also
	indicates whether tools should log this value during
	manipulations such as installs.
Nillable	The Nillable attribute of a setting indicates whether	false
	a setting value is valid if does not contain any
	value.

[0472] 3.2.6 Setting Values

[0473] Depending on whether the setting has been declared as a single value or a list, the value for the setting can be provided using either a setting value element or a setting value list element.

[0474] 3.2.6.1 Setting Value

[0475] A setting value statement is used to provide a value for a particular setting declaration. The value must match the definition associated with the declaration of must be able to be cast or converted to the definition associated with the setting declaration. If the value is declared fixed, then the provided value will be used in all derived definitions or referencing members depending on the point at which the value is fixed. Once a value is fixed, it cannot be overridden.

<xs:complexType name=“SettingValue” mixed=“true”>
<xs:sequence>
<xs:any processContents=“skip” minOccurs=“0”
maxOccurs=“unbounded”/>
</xs:sequence>
<xs:attribute name=“Path” type=“Path”
use=“required”/>
<xs:attribute name=“Fixed” type=“xs:boolean”
use=“optional”/>
<xs:attribute name=“Nil” type=“xs:boolean”/>
<xs:attribute name=“Definition” type=“QualifiedName”
use=“optional”/>
</xs:complexType>

[0476]

Attribute/
element    Description
Path       The path to the setting
           declaration that this value
           will apply to.
Fixed      The fixed attribute
           controls whether the value
           provided can subsequently
           be overridden by new values
           A fixed value of true
           indicates that the value
           provided for a setting
           cannot be overridden
           If the value of fixed is
           true on a concrete defini-
           tion member's setting value,
           it is fixed in all deploy-
           ments of that member. Other-
           wise, if the value of fixed
           is false it is override-able
           in each deployment of that
           member. If the value of
           fixed is true on a concrete
           definition's setting value,
           it is fixed for all members
           (i.e., uses) of that con-
           crete definition. Other-
           wise, if the value of
           fixed is false, it may
           vary with each member
           (i.e., use) of that
           concrete definition.
           If the value of fixed
           is true on an abstract
           definition's setting value,
           it is fixed for concrete
           definitions that implement
           or abstract objects that
           extend that abstract
           definition. Otherwise, if
           the value of fixed is false,
           it may be overridden by a
           concrete definition, in a
           derived abstract definition
           or in a member declaration.
Nil        Finally, a setting value
           is considered valid
           without content if it has
           the attribute Nill with
           the value true. An element
           so labeled must be
           empty, but can carry attri-
           butes if permitted by
           the setting definition.
Definition The definition attribute
           can contain a reference to
           a setting definition. If
           it is provided then the
           setting value is typed
           with this definition. If
           it is not provided then
           the setting definition of
           the setting declaration
           at the end of the path is
           used to type the setting
           value.

[0477] 3.2.6.2 Setting Value List

[0478] A setting value list is used to provide one or more values for a setting declared as a list. When declaring the values the user can decide to merge with previous values or to overwrite all previous values.

<xs:complexType name=“SettingValueList”>
<xs:sequence>
<xs:element name=“Value” minOccurs=“0”
maxOccurs=“unbounded”>
<xs:complexType mixed=“true”>
<xs:sequence>
<xs:any processContents=“skip”
minOccurs=“0” maxOccurs=“unbounded”/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name=“Path” type=“SimpleName” use=“required”/>
<xs:attribute name=“Fixed” type=“xs:boolean” use=“optional”/>
<xs:attribute name=“Replace” type=“xs:boolean” use=“optional”/>
<xs:attribute name=“Definition” type=“QualifiedName”
use=“optional”/>
</xs:complexType>

[0479]

Attribute/
element    Description
Path       The name of the setting
           declaration that this
           value will apply to.
Fixed      The fixed attribute con-
           trols whether the value
           provided can subsequently
           be overridden by new
           values A fixed value of
           true indicates that the
           value provided for a
           setting cannot be over-
           ridden If the value of
           fixed is true on a con-
           crete definition member's
           setting value, it is fixed
           in all deployments of that
           member. Otherwise, if the
           value of fixed is false it
           is override-able in each
           deployment of that member.
           If the value of fixed is
           true on a concrete
           definition's setting value,
           it is fixed for all members
           (i.e., uses) of that concrete
           definition. Otherwise, if the
           value of fixed is false, it
           may vary with each member
           (i.e., use) of that concrete
           definition. If the value of
           fixed is true on an abstract
           definition's setting value,
           it is fixed for concrete
           definitions that implement
           or abstract objects that
           extend that abstract defini-
           tion. Otherwise, if the value
           of fixed is false, it may be
           overridden
           by a concrete definition,
           in a derived abstract
           definition or in a member
           declaration.
Replace    The replace attribute is
           used to indicate whether
           the new value for a setting
           should replace or merge
           with any previous non-fixed
           values for a setting. If
           replace is true then all
           previous values will be
           ignored. If replace is
           false, then the new and
           the previous values will
           be combined into a single
           list. Duplicates will NOT
           be detected during the
           merge process.
Definition The definition attribute
           can contain a reference to
           a setting definition. If
           it is provided then each of
           the setting values are
           typed with this definition.
           If it is not provided then
           the setting definition of
           the setting declaration
           at the end of the path is
           used as the type for each
           setting value.

[0480] 3.2.7 Settings Inheritance

[0481] Settings inheritance means that a derived definition implicitly contains all the settings declarations from the base definition. Some important aspects of settings inheritance are:

[0482] Settings inheritance is transitive. If C is derived from B, and B is derived from A, then C inherits the settings declared in B as well as the settings declared in A.

[0483] A derived definition can add new settings declarations to those it inherits from the base definition it extends, but it cannot remove or change the definition of an inherited setting.

[0484] 3.2.8 Setting Instances

[0485] The setting instance in the instance space holds the actual value for a setting member. The value for a setting instance is initially assigned through setting value statements in the definition space. Then setting flow is evaluated, updating the values for setting instances that are the targets of flow.

[0486] In some scenarios, we need to differentiate between the setting value derived from setting value statements and any values later provided through flow. We call the former the “assigned” value and the latter the “resultant” value.

[0487] 3.2.9 Value Transfer

[0488] In order to pass setting values into or out of a flow or constraint we use value transfers. An Input transfer is evaluated before the definition associated with the member is evaluated, and an Output transfer is evaluated after the definition associated with the member is evaluated.

[0489] Each value transfer identifies through the Name attribute the setting on the definition that will be used as either the destination for an Input or the source for an Output. The path attribute identifies a setting declaration that is the source for an Input or the destination for an Output.

<xs:complexType name=“ValueTransfer”>
<xs:attribute name=“Name” type=“SimpleName”/>
<xs:attribute name=“Path” type=“Path”/>
</xs:complexType>

[0490]

Attribute/
element Description
Name    The name of the setting on
        the flow or constraint
        definition that is the source
        or destination of the setting
        identified by the path.
Path    Path to the source or
        destination setting relative
        to the context in which the
        member is defined. The path
        identifies a single setting -
        this implies that the maximum
        cardinality of all the
        members on the path should be
        one or zero.

[0491] 3.2.9.1 Input

[0492] An input statement identifies an input value that will be transferred before the flow or constraint is executed. The input can use the ValueSource element to select whether the “assigned” or the “resultant” setting value is used as the input (see section XX for definition of assigned/resultant).

<xs:complexType name=“Input”>
<xs:complexContent>
<xs:extension base=“ValueTransfer”>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0493] 3.2.9.2 Output

[0494] Output is a variation on the value transfer that supports the semantics for fixing and replacing the target values.

<xs:complexType name=“Output”>
<xs:complexContent>
<xs:extension base=“ValueTransfer”>
<xs:attribute name=“Fix” type=“xs:boolean”
use=“optional”/>
<xs:attribute name=“Replace” type=“xs:boolean”
use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0495]

Attribute/
element Description
Fix     This will declare the
        target value to be fixed.
        This means that any
        attempts to subsequently
        modify the value will
        result in an error.
Replace When a list is the tar-
        get of the path, we can
        choose to either merge
        or replace the current
        contents of the list.
        The default behavior is
        to merge with the current
        contents.

[0496] 3.2.10 Casting

[0497] We support casting up and down the setting definition inheritance tree. When a source definition is derived from the destination definition, the cast from the source to the destination definition is called an upcast. When the destination definition is derived from the source definition, the cast from the source to the destination is called a downcast. Since the root of the tree is always the Any definition, all definitions can be upcast to Any.

[0498] FIG. 16 illustrates an example of upcasting and downcasting. In FIG. 16, the User definition extends the base definition Any. The ExtendedUser definition in turn extends the base definition User. By constructing this definition hierarchy we are indicating that an ExtendedUser definition can be provided anywhere a User definition is required and that a both an ExtendedUser and a User definition can be provided anywhere an Any definition is required.

[0499] The following setting declaration statements use the definitions from FIG. 16, and will be used in the examples in the following sections.

<SettingDeclaration Name=“First” Definition=“ExtendedUser”/>
<SettingDeclaration Name=“Second” Definition=“Any”/>
<SettingDeclaration Name=“Third” Definition=“User”/>

[0500] 3.2.10.1 Upcasts

[0501] In FIG. 16, an upcast would occur when an instance of the ExtendedUser definition is assigned to a setting declaration that requires a definition of either User or Any. An example of an upcast would be a transfer of a value from the setting declaration First to the setting declaration Second. This might occur as part of a flow input declaration.

[0502] Upcasts are supported automatically. Any value can be cast to one of its base definitions without the need for any special interaction on the part of the developer. When a setting instance is upcast, the actual definition of the instance is kept with the setting value.

[0503] 3.2.10.2 Downcasts

[0504] In FIG. 16, a downcast would occur when a user transfers a setting value from a setting declaration marked as Any to a setting declaration marked as User. In this case, the assignment can only occur if the definition associated with the instance is User or ExtendedUser. This implies that setting instance may have definitions that are different from the setting declaration that they are currently associated with. We track this in the instance space by passing a reference to the actual definition of the instance around with the instance itself.

[0505] An example of a downcast might occur when we pass a setting instance from Second to Third assuming that the instance initially came from First. In this case, the setting instance is an instance of the ExtendedUser definition. This example may occur when a setting instance is transferred out of a flow definition.

[0506] Downcasts are explicitly requested by the developer and will fail if the runtime definition of the instance is not equal to or derived from the target definition. To request a downcast the developer sets the Cast attribute on the associated transfer operation (input or output) to true. If a cast is requested then the user will receive a compile time error if the destination definition is not a derivation of the source definition, and will receive a runtime error if the definition of the setting instance is not the same as or derived from the destination definition.

[0507] 3.2.11 Conversions

[0508] Type conversions are required when a user wishes to transfer a setting instance to a setting declaration that has a different definition from the instance and the setting declaration's definition is not a base definition of the instance's definition.

[0509] FIG. 17 illustrates an example of type conversion. As illustrated in FIG. 17, type conversion may occur between definitions that are in different branches of the inheritance tree and when the destination definition is below the source definition within a branch of the inheritance tree.

[0510] Type conversions are handled by setting managers. Both the source and target managers can expose conversion support. This means that given the definitions in FIG. 17 and an assignment from a User definition to a String definition, the manager for User could expose a conversion to String or the manager for String could expose a conversion from User.

[0511] The runtime will first ask the source manager to convert the instance, then the target manager, and finally return an error if there is no available conversion.

[0512] To request a type conversion the developer marks the attribute Convert as true on the setting transfer (input or output). If Convert is not specified and the source definition is not the same as or derived from the target definition then the compiler will return an error. If Convert is specified, the compiler will check if there is an available conversion between the two types by asking both managers whether they support the conversion.

[0513] If the instance is of a definition that is a derivation of the definition associated with the setting declaration, we will first try to convert the derived definition to the destination definition before falling back to upcasting and then converting the value. Note, if we do upcast, we may lose information as part of the conversion process. For example if we specified a conversion between User and String and the actual instance was an ExtendedUser, then we would first attempt to convert ExtendedUser to String before falling back to converting User to String.

[0514] 3.2.12 CLR to SDM Type Mapping

[0515] In the SDM model, all setting definitions have corresponding CLR types. These types are defined by the manager associated with the SettingDefinitions element in the SDM model.

[0516] When a flow, constraint or deployment manager acts on behalf of an SDM definition it does so by acting on instances of CLR types rather than on instances of SDM Setting definitions. This provides a more natural programming model for the developer but also means that the SDM runtime should be able to map from SDM definition to CLR type in order to pass information from the SDM runtime to a manager and should be able to map from CLR type to SDM definition in order to accept information back from a manager.

[0517] For example, in an SDM model, a developer may define the following setting definition:

<xs:simpleType name=“AppPoolIdentityType”>
<xs:restriction base=“xs:string”>
<xs:enumeration value=“LocalSystem”/>
<xs:enumeration value=“LocalService”/>
<xs:enumeration value=“NetworkService”/>
<xs:enumeration value=“UserDefined”/>
</xs:restriction>
</xs:simpleType>

[0518] Then the developer may write a manager that processes a value associated with that setting definition that takes an instance of the following CLR type:

public enum AppPoolIdentityType
{
LocalSystem,
LocalService,
NetworkService,
UserDefined,
}

[0519] There are two parts to this problem: the first is being able to map from definition to type and back, the second is being able to map from SDM instance to clr instance and back.

[0520] 3.2.12.1 Mapping Definition to Type

[0521] To map from setting definition to a clr type we use the manager declaration, the setting definition namespace and the setting definition name. From the manager declaration identified by the Manager attribute on the SettingDefinitions element we can obtain a strong name and location for the assembly that contains the type, from the ClrNamespaceName attribute on the SettingDefinitions element we can obtain the name of the namespace that contains the type. Finally, we can append the name of the setting definition to the namespace name to retrieve the clr type from the assembly.

[0522] The reverse process uses the same information to map from a clr type to an SDM definition. First, we get the assembly name from the type information provided by the runtime. We then find the manager declarations that reference the assembly, giving us one or more model files. From the setting definitions sections in the model files we then find a matching pair of namespace name and type name.

[0523] 3.2.12.2 Converting Instance Values

[0524] To convert setting instances from their SDM representation in XML to a Clr object instance and back we again use the manager associated with SettingDefinitions element. In this case, the Clr class that implements the translation is identified by the combination of the ClrClassName attribute and the assembly information from the manager declaration identified by the Manager attribute.

[0525] The Clr class implements the ISettingSerialization interface described in the Manager Interface Specification (ref). This interface supports both conversion from SDM Xml representation to a Clr instance and conversion from a Clr object instance to an SDM Xml representation. The same developer that creates the setting definition within the Model file is responsible for writing the code that performs the conversion.

[0526] The Clr class should support conversion for all setting definitions within the SettingDefinitions element.

[0527] 3.3 Attributes

[0528] Many of the objects in the SDM can be attributed to capture behavior that is orthogonal to core behavior of the object. We use a general attribution model defined as follows:

[0529] 3.4 Definitions

[0530] Definitions are used to create reusable configurations of resources and systems. They are analogous to classes in an object oriented language.

[0531] 3.4.1 Definition

[0532] Definition is the base from which object, relationship, constraint and flow definitions are derived. All definitions can include a description, setting members, setting values, and design surface data. Each definition is identified by a simple name and references a manager. The manager is responsible for providing support to the SDM runtime for this particular definition through the class identified by the definition.

[0533] The name of the definition should be unique for all definitions within the scope that contains the definition. The scope may be either an SDM document or another definition.

<xs:complexType name=“Definition”>
<xs:sequence>
<xs:element name=“Description” type=“Description”
minOccurs=“0”/>
<xs:element name=“DesignData” type=“DesignData”
minOccurs=“0”/>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“SettingDeclaration”
type=“SettingMember”/>
<xs:element name=“SettingValue”
type=“SettingValue”/>
<xs:element name=“SettingValueList”
type=“SettingValueList”/>
</xs:choice>
</xs:sequence>
<xs:attribute name=“Name” type=“SimpleName”
use=“required”/>
<xs:attribute name=“Manager” type=“QualifiedName”
use=“optional”/>
<xs:attribute name=“ClrClassName” type=“xs:string”
use=“optional”/>
</xs:complexType>

[0534]

Attribute/
element            Description
SettingDeclaration The declaration of a setting
SettingValue       A value for a setting on the
                   definition or its base definition.
                   A value can only be provided once
                   for a setting declaration within
                   an definition.
SettingValueList   A list of values for a writable
                   list setting on the definition
                   or its base definition.
DesignData         Design surface specific data
Name               A name for this definition that
                   is unique within the scope of
                   the containing SDM file.
Manager            A reference to the manager
                   declaration for this definition.
                   See section: 3.5 for a definition
                   of the manager.
ClrClassName       The name of the clr class that
                   supports this definition in the
                   runtime. The class should exist
                   in the assembly identified by
                   the manager. The manager attri-
                   bute should be present if this
                   attribute is present.
Description        A text description of the
                   definition.

[0535] 3.4.2 Object Definitions

[0536] An abstract object definition exposes a set of setting declarations, can contain constraints on the relationships that it participates in and has an associated manager in the runtime.

[0537] The following is an abstract system definition for a web server. The web server has two settings and has a relationship constraint that requires it to contain at least on vsite type.

<SystemDefinition Abstract-true
Name=“WebServer”
ClrClassName=“micorosft.sdm.IISSupportClass”
Manager=“IISSupportCode”>
<SettingDeclaration Name=“serverName” Definition=“String”/>
<SettingDeclaration Name=“category” Definition=“String”/>
<SettingDeclaration Name=“roles” Definition=“String” List=“true”/>
<RelationshipConstraint Name=“containsVsites”
RelationshipDefinition=“containmentRelationship”
TargetRole=“Member”
TargetObjectDefinition=“vsite”
MinOccurs=“1”
MaxOccurs=“unbounded”/>
</SystemDefinition>

[0538] The vsite is an abstract endpoint definition that contains server binding information.

<EndpointDefinition Abstract=“true” Name=“vsite”>
<SettingDeclaration Name=“ipAddress” Definition=“ipaddress”
required=“true”/
<SettingDeclaration Name=“port” Definition=“Int”/>
<SettingDeclaration Name=“domainName” Definition=“Int”/>
<SettingDeclaration Name=“securityModel”
Definition=“securityModelEnum”/>
</EndpointDefinition>

[0539] A concrete system definition for a frontend webserver identifies the webserver category as static content, contains a single byReference endpoint member which can represent between 1 and 100 endpoint instances. The concrete endpoint definition for the endpoint is nested inside the system definition and it defines the ip Endpoint for the vsite to be Endpoint 80.

<SystemDefinition Name=“FrontendWebServer”
Extends=“WebServer”>
<SettingValue Path=“serverName”
Fixed=“true”>myFEServer</SettingValue>
<SettingValueList Path=“roles” Fixed=“true” Replace=“true”>
<Value>staticContent</Value>
<Value>aspPages</Value>
</SettingValueList>
<EndpointDefinition Name=“port80Vsite” Extends=“vsite”>
<SettingValue Path=“port”
Fixed=“true”>80</SettingValue>
</EndpointDefinition>
<Endpoint Name=“contentOnlyVsite” Definition=“port80Vsite”
Reference=“true” MinOccurs=“1”
MaxOccurs=“100”/>
</SystemDefinition>

[0540] 3.4.2.1 Object Definition

[0541] Abstract and concrete object extend the following base object definition. In addition to the elements of the base type Definition, they share the ability to constrain the relationships that the objects participate in.

<xs:complexType name=“ObjectDefinition”>
<xs:complexContent>
<xs:extension base=“Definition”>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“Flow” type=“FlowMember”
minOccurs=“0” maxOccurs=“unbounded”/>
<xs:element name=“RelationshipConstraintGroup”
type=“RelationshipConstraintGroup”/>
<xs:element name=“RelationshipConstraint”
type=“RelationshipConstraint”/>
<xs:element name=“Constraint”
type=“ConstraintMember”/>
</xs:choice>
<xs:attribute name=“Visibility” type=“VisibilityEnum”
use=“optional”/>
<xs:attribute name=“Layer” type=“xs:string”
use=“optional”/>
<xs:attribute name=“Extends” type=“QualifiedName”
use=“optional”/>
<xs:attribute name=“Abstract” type=“xs:boolean”
use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0542]

Attribute/element           Description
Flow                        A flow members declaration
RelationshipConstraint      Constraints on the
                            relationships that these
                            types can participate in.
RelationshipConstraintGroup A group of constraints on
                            the relationships that
                            these types can participate
                            in. At least one member of
                            the group should evaluate
                            to true.
Layer                       The layer attribute
                            identifies the layer at
                            which this abstract object
                            definition can be used. If
                            it, is not provided, the
                            abstract object definition
                            can be used at any layer.
Extends                     Identifies the base object
                            definition that this object
                            definition derives from.
Abstract                    Indicates whether this
                            object can be instantiated.
                            If it is marked as abstract,
                            then the definition must be
                            extended in order to complete
                            the missing elements. The
                            default is false.
Visibility                  Indicates whether the members
                            of this class default to public or
                            private. The default is public.

[0543] Abstract object definitions are used to define building blocks that the design surface exposes and from which all concrete objects are derived: a concrete object definition implements an abstract object definition.

[0544] Abstract object definitions extend SDM object by adding simple inheritance: the “extends” attribute is used to identify a base object definition for an abstract object definition. The abstract object definition then inherits the settings and relationship constraints from that base object definition. Through inheritance, the object definition can extend the settings and constraints of the abstract object definition by adding new settings and constraints.

[0545] Abstract object definitions can also add constraints on the relationships that they wish to participate in. For example, an abstract object definition may require the existence of certain relationships, may constrain the object definitions that may be placed on the other end of the relationship or may constrain the settings on the instances that participate in a given relationship.

[0546] Object definitions can also contain declarations of nested definitions. These definitions can be used for members within the scope of the containing definitions and referenced in constraints outside the scope of the definition.

[0547] Concrete object definitions provide an implementation for an abstract object definition. The implementation is constructed from object and relationship members, values for the settings of implemented abstract definition, new settings declarations, flow between members and constraints on members.

[0548] 3.4.2.2 Implicit Base Definitions

[0549] All object definitions that do not extend another object definition implicitly extend one of the endpoint, system or resource base definitions. These base definitions form a root for each of the trees that can be used in relationship and constraint declarations. This allows the relationship or constraint to indicate that any of the types derived from the root can be used in place of the identified root definition. These root types are always abstract and cannot be instantiated directly.

[0550] The definitions of these types include base constraints that control their instantiation within the model.

[0551] 3.4.2.3 Endpoint Definition

[0552] Endpoint definitions extend the base object definition by adding the ability to declare nested resource types, resource members and host, containment and reference relationship members.

<xs:complexType name=“EndpointDefinition”>
<xs:complexContent>
<xs:extension base=“ObjectDefinition”>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“ResourceDefinition”
type=“ResourceDefinition”/>
<xs:element name=“Resource”
type=“ResourceMember”/>
<xs:element name=“Hosting”
type=“HostingMember”/>
<xs:element name=“Containment”
type=“ContainmentMember”/>
<xs:element name=“Reference”
type=“ReferenceMember”/>
</xs:choice>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0553]

Attribute/element  Description
ResourceDefinition A nested resource definition
                   that can be used by type
                   members within the scope of
                   the outer type definition.
Resource           A resource member declaration
                   that references a resource
                   type.
Hosting            A hosting relationship
                   member declaration.
Containment        A containment relationship
                   member declaration.
Reference          A reference relationship
                   member declaration.

[0554] 3.4.2.4 System Definition

[0555] A system type extends the base type by adding support for: nested endpoint, system and resource types; endpoint, system, and resource members and host, containment, connection, delegation and reference relationships.

<xs:complexType name=“SystemDefinition”>
<xs:complexContent>
<xs:extension base=“ObjectDefinition”>
<xs:choice minOccurs=“0”
maxOccurs=“unbounded”>
<xs:element name=“EndpointDefinition”
type=“EndpointDefinition”/>
<xs:element name=“SystemDefinition”
type=“SystemDefinition”/>
<xs:element name=“ResourceDefinition”
type=“ResourceDefinition”/>
<xs:element name=“Endpoint”
type=“EndpointMember”/>
<xs:element name=“Subsystem”
type=“SystemMember”/>
<xs:element name=“Resource”
type=“ResourceMember”/>
<xs:element name=“Hosting”
type=“HostingMember”/>
<xs:element name=“Containment”
type=“ContainmentMember”/>
<xs:element name=“Connection”
type=“CommunicationMember”/>
<xs:element name=“Delegation”
type=“DelegationMember”/>
<xs:element name=“Reference”
type=“ReferenceMember”/>
</xs:choice>
<xs:attribute name=“SimulationRoot” type=“xs:boolean”
use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0556]

Attribute/element  Description
EndpointDefinition A nested endpoint definition
                   that can be used by members
                   within the scope of the outer
                   system definition
ResourceDefinition A nested resource definition
                   that can be used by members
                   within the scope of the outer
                   system definition.
SystemDefinition   A nested system definition
                   that can be used by members
                   within the scope of the outer
                   system definition
Endpoint           An endpoint member declaration
                   that references an endpoint
                   definition.
Subsystem          A subsystem member declaration
                   that references a system
                   definition.
Resource           A resource member declaration
                   that references a resource
                   definition.
Containment        A containment relationship
                   member declaration.
Hosting            A hosting relationship member
                   declaration.
Connection         A connection relationship
                   member declaration.
Delegation         A delegation relationship
                   member declaration.
Reference          A reference relationship
                   member declaration.
SimulationRoot     Specifies weather the definition
                   should have a root instance of
                   it simulated during compilation
                   of the SDM document to do design
                   time checking. If this attribute
                   is not specified then the default
                   compiler rules for simulation
                   apply. This attribute is needed
                   when simulation would never pass
                   cleanly but real usages of the
                   definition would work fine.

[0557] 3.4.2.5 Resource Definition

[0558] A resource type may contain nested resource type definitions, resource members, and host, containment and reference relationship members.

<xs:complexType name=“ResourceDefinition”>
<xs:complexContent>
<xs:extension base=“ObjectDefinition”>
<xs:choice minOccurs=“0”
maxOccurs=“unbounded”>
<xs:element name=“ResourceDefinition”
type=“ResourceDefinition”/>
<xs:element name=“Resource”
type=“ResourceMember”/>
<xs:element name=“Hosting”
type=“HostingMember”/>
<xs:element name=“Containment”
type=“ContainmentMember”/>
<xs:element name=“Reference”
type=“ReferenceMember”/>
</xs:choice>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0559]

Attribute/element  Description
ResourceDefinition A nested resource definition
                   that can be used by members
                   within the scope of the outer
                   resource definition.
Resource           A resource member declaration
                   that references a resource
                   defintion.
Hosting            A hosting relationship
                   member declaration.
Containment        A containment relationship
                   member declaration.
Reference          A reference relationship
                   member declaration.

[0560] 3.4.2.6 Relationship Rules

[0561] For a particular instance of an object definition the following tables identify the cardinality associated with each of the roles that the instance can play.

[0562] 3.4.2.6.1 System Rules

Definition	Role	System	Endpoint	Resource
System	Parent(0 . . . *)	Contains	Contains	Contains
	Member(1 . . . 1)	ContainedBy	Not	Not
			Allowed	Allowed
	Proxy(0 . . . *)	Not Allowed	Not	Not
			Allowed	Allowed
	Delegate(0 . . . *)	Not Allowed	Not	Not
			Allowed	Allowed
	Client(0 . . . *)	Not Allowed	Not	Not
			Allowed	Allowed
	Server(0 . . . *)	Not Allowed	Not	Not
			Allowed	Allowed
	Guest(1 . . . 1)	HostedBy	HostedBy	HostedBy
			(??)
	Host(0 . . . *)	Hosts	Hosts	Hosts
	Source(0 . . . *)	Provides	Not	Not
			Allowed	Allowed
	Dependent(0 . . . *)	Consumes	Not	Not
			Allowed	Allowed

[0563] 3.4.2.6.2 Endpoint Rules

	Role	System	Endpoint	Resource
Endpoint	Parent(0 . . . *)	Not Allowed	Not	Contains
			Allowed
	Member(1 . . . 1)	ContainedBy	Not	Not
			Allowed	Allowed
	Proxy(0 . . . *)	Not Allowed	DelegatesTo	Not
				Allowed
	Delegate(0 . . . *)	Not Allowed	Implements	Not
				Allowed
	Client(0 . . . *)	Not Allowed	ConnectsTo	Not
				Allowed
	Server(0 . . . *)	Not Allowed	ProvidesService	Not
				Allowed
	Guest(1 . . . 1)	HostedBy	HostedBy	HostedBy
	Host(0 . . . *)	Hosts	Hosts	Hosts
	Source(0 . . . *)	Not Allowed	Provides	Provides
	Dependent(0 . . . *)	Not Allowed	Consumes	Consumes

[0564] 3.4.2.6.3 Resource Rules

	Role	System	Endpoint	Resource
Resource	Parent(0 . . . *)	Not	Not Allowed	Contains
		Allowed
	Member(1 . . . 1)	ContainedBy	ContainedBy	ContainedBy
	Proxy(0 . . . *)	Not	Not Allowed	Not Allowed
		Allowed
	Delegate(0 . . . *)	Not	Not Allowed	Not Allowed
		Allowed
	Client(0 . . . *)	Not	Not Allowed	Not Allowed
		Allowed
	Server(0 . . . *)	Not	Not Allowed	Not Allowed
		Allowed
	Guest(1 . . . 1)	HostedBy	HostedBy	HostedBy
	Host(0 . . . *)	Hosts	Hosts	Hosts
	Source(0 . . . *)	Not	Provides	Provides
		Allowed
	Dependent(0 . . . *)	Not	Consumes	Consumes
		Allowed

[0565] 3.4.2.6.4 Notes

[0566] Every instance should participate in exactly one containment relationship and at least one hosting relationship.

[0567] This means that:

[0568] A) non-reference (by-value) members should identify a containment relationship in the same definition

[0569] b) in order to be constructed a reference member should identify a containment relationship

[0570] 3.4.3 Relationship Definitions

[0571] Relationships are used to identify possible interactions between types. They are binary and directed, each identifying the type of the instances that can participate in the relationship. Relationships can also constrain the settings of the instances that participate in the relationship and can flow setting values across the relationship.

[0572] The following is a possible hosting relationship for a webApplication on the webserver described in the types section. The relationship contains a constraint that verifies that the security models of the two systems are compatible and it contains a settings flow member that copies the server name from the vsite to the vdir.

<HostingDefinition Name=“vsiteHostsVdir” GuestDefinition=“vdir”
HostDefinition=“vsite”>
<ObjectConstraint Name=“checkCompatibility”
PrimaryRole=“Guest” PrimaryObjectDefinition=“vdir”>
<Constraint Name=“constrainSecurityModel”
Definition=“SimpleOperatorComparison”>
<SettingValue Path=“operator”>=</SettingValue>
<Input Name=“LHS” Path=“host.securityModel”/>
<Input Name=“RHS” Path=“guest.securityModel”/>
</Constraint>
</ObjectConstraint>
<Flow Definition=“copy” Name=“copyServerToVdir”>
<Input Name=“source” Path=“host.server”/>
<Output Name=“desination” Path=“guest.server”/>
</Flow>
</HostingDefinition>

[0573] A relationship is used by declaring a relationship member that identifies the type members that will participate in the relationship.

<SystemDefinition Name=“TestSystemt”
Extends=“DistributedApplication”>
<Resource Name=“myVdir” Definition=“vdir”
Reference=“false”/>
<Resource Name=“myVsite” Definition=“vsite”
Reference=“false”/>
<Hosting Name=“HostMyVsite” Definition=“vsiteHostsVdir”
GuestMember=“myVdir”
HostMember=“myVsite”/>
</SystemDefinition>

[0574] 3.4.3.1 Relationship Definition

[0575] The base relationship definition adds object constraints and flow to definitions . Object constraints are statements about the setting values for the object instances that participate in an instance of this relationship. For example, a communication relationship that represents a DCOM connection may check that the security settings for client and server are compatible. In this case, there is a strict relationship between settings that could easily be captured as part of the design process; there are four factorial setting combinations over the relationship but a much smaller number of valid combinations.

[0576] Flow gives the ability for the relationship developer to forward values from one instance to another. This allows the object definitions to be developed separately from their possible interactions and allows the instance to stand alone as a reference point for information rather than requiring a subset of the relationship graph in order to fully describe a particular instance.

[0577] Concrete relationships are relationships between two concrete object definitions. Each concrete relationship should implement an abstract relationship. The abstract relationship should be between a matching pair of abstract objects definitions that are directly or indirectly (through inheritance) implemented by the concrete object definitions.

[0578] The name for the relationship should be unique within the namespace that contains the relationship.

<xs:complexType name=“RelationshipDefinition”>
<xs:complexContent>
<xs:extension base=“Definition”>
<xs:choice minOccurs=“0”
maxOccurs=“unbounded”>
<xs:element name=“ObjectConstraintGroup”
type=“ObjectConstraintGroup”/>
<xs:element name=“ObjectConstraint”
type=“ObjectConstraint”/>
<xs:element name=“Flow”
type=“FlowMember”/>
</xs:choice>
<xs:attribute name=“Extends” type=“QualifiedName”
use=“optional”/>
<xs:attribute name=“Abstract” type=“xs:boolean”
use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0579]

Attribute/element Description
ObjectConstraint  Constraints on the instances
(group)           that participate in this
                  relationship. See section: 3.7
Flow              Flow between the instances
                  that participate in this
                  relationship.
Extends           Identifies the base definition that
                  this definition derives from.
Abstract          Indicates whether this relation-
                  ship can be instantiated. If it
                  is marked as abstract, then the
                  definition should be extended
                  in order to complete the missing
                  elements. The default is false.

[0580] 3.4.3.2 Communication Relationship

[0581] Communication relationships are used to capture possible communication links between endpoint definitions. They are used to describe interaction between independently deployed software elements. The communication relationship schema extends the base relation schema by adding client and server endpoint references.

<xs:complexType name=“CommunicationDefinition”>
<xs:complexContent>
<xs:extension base=“RelationshipDefinition”>
<xs:sequence>
<xs:element name=“Connection”
type=“HostingMember” minOccurs=“0”
maxOccurs=“unbounded”/>
</xs:sequence>
<xs:attribute name=“ClientDefinition”
type=“QualifiedName” use=“required”/>
<xs:attribute name=“ServerDefinition”
type=“QualifiedName” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0582]

Attribute/
element          Description
ClientDefinition The definition of the client
                 instance involved in the
                 communication relationship
ServerDefinition The type of the server
                 instance involved in the
                 relationship

[0583] The following combinations of abstract type pairs are valid for communication relationships:

Client Type Server Type
Endpoint    Endpoint

[0584] 3.4.3.3 Hosting Relationship

[0585] Hosting relationships are used to capture the fact that a guest requires a host in order to be constructed. Since there can be more than one possible host for a guest, this implies that the hosting relationship is also responsible for the construction of the guest on a host. So in order to create an instance of an object, a hosting relationship should exist from a guest to a compatible host.

[0586] For example, a hosting relationship may exist between a Webservice object definition and an IIS object definition. In this case, the relationship indicates that it may be possible to create an instance of system MyWebservice on an instance of system MyIIS using the manager on the hosting relationship assuming MyWebservice and MyIIS implement webservice and IIS respectively. We do not know whether it will be possible to create the relationship until we have evaluated constraints that exist on both the systems and the relationship.

[0587] When we deploy an application to a datacenter we need to resolve all the outstanding hosting relationships for the systems within the application. To do this the operator would need to create hosting members for each of the required hosting relationships. To simplify the task of the operator and to allow the developer to guide the deployment process, the developer can instead create a concrete hosting relationship. The concrete hosting relationship is used to group a set of hosting relationship members in such a way that the operator need only declare a single hosting member when deploying the application.

A guest can be bound to a host iff
For each guestMember in Guest
There exists one or more hostMember in Host where
guestMember.Type has a hosting relation with hostMember.type
and guestMember.hostConstraints validate against hostMember.settings
and hostMember.guestConstraints validate against guestMember.settings
and for each member of guestMember there exists a binding to a
member of hostMember

[0588] For example the following concrete relationship binds a layer three system (Bike) to a layer two host (operating System). In this case, we define a setting for the hosting relationship with the default value of “system folder”. We flow this setting to one of three hosting members that define the hosting relationship between systems of the layer 3 application and systems of the layer 2 host.

<HostingDefinition Name=“DefaultBikePlacement” GuestDefinition=“Bike”
HostDefinition=“OperatingSystem;OperatingSystem”>
<SettingDeclaration Name=“fileLocationRelativeToRoot” Definition=“xs:sting” Access=“Readwrite” />
<SettingValue Path=“dirPath”>systemFolder</SettingValue>
<Flow Name=“copyPath” Definition=“copy”>
<Input Name=“source” Path=“dirPath”/>
<Output Name=“destination” Path=“bikeExecutableHost.hostRelativePath”/>
</Flow>
<Hosting Name=“bikeExecutableHost” Definition=“fileDirectoryHost” GuestMember=“guest.bikeFile”
HostMember=“host.FileSystem”/>
<Hosting Name=“bikeEventKeyHost” Definition=“registryKeyRegistryKeyHost”
GuestMember=“guest.bikeEventKey”
HostMember=“host.Registry.ApplicationEventKey”/>
<Hosting Name=“bikeSoftwareKeyHost” Definition=“registryKeyRegistryKeyHost”
GuestMember=“guest.bikeSoftwareKey” HostMember=“host.Registry.HKLM”/>
</HostingDefinition>
<xs:complexType name=“HostingDefinition”>
<xs:complexContent>
<xs:extension base=“RelationshipDefinition”>
<xs:sequence>
<xs:element name=“Hosting” type=“HostingMember” minOccurs=“0”
maxOccurs=“unbounded”/>
</xs:sequence>
<xs:attribute name=“GuestDefinition” type=“QualifiedName” use=“required”/>
<xs:attribute name=“HostDefinition” type=“QualifiedName” use=“required”/>
<xs:attribute name=“SimulationRoot” type=“xs:boolean” use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0589]

Attribute/element Description
GuestDefinition   Identifies the definition of the guest instance.
HostDefinition    Identifies the definition of the host instance.
SimulationRoot    Specifies weather the definition should have a
                  root instance of it simulated during compilation
                  of the SDM document to do design time
                  checking. If this attribute is not specified then the
                  default compiler rules for simulation apply. This
                  attribute is needed when simulation would never
                  pass cleanly but real usages of the definition
                  would work fine.

[0590] The following combinations of abstract definition pairs are valid for hosting relationships:

Guest Type Host Type
Endpoint   Endpoint
Resource   Resource
Resource   System
System     Resource
System     System

[0591] 3.4.3.4 Containment Relationship

[0592] A containment relationship between two abstract objects captures the fact that a concrete type based on the parentType can contain members based on the memberType. Containment implies that the parent instance can control the lifetime of the member instance and can delegate behavior to the member instance.

<xs:complexType name=“ContainmentDefinition”>
<xs:complexContent>
<xs:extension base=“RelationshipDefinition”>
<xs:sequence>
<xs:element name=“Containment”
type=“HostingMember” minOccurs=“0”
maxOccurs=“unbounded”/>
</xs:sequence>
<xs:attribute name=“ParentDefinition”
type=“QualifiedName” use=“required”/>
<xs:attribute name=“MemberDefinition”
type=“QualifiedName” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0593]

Attribute/element Description
ParentDefinition  Identifies the definition of the instance that will
                  contain the member.
MemberDefinition  Identifies the definition of the instance that will
                  be the contained member

[0594] The following combinations of abstract definition pairs are valid for containment relationships:

Parent Type Member Type
System      Endpoint
System      Resource
System      System
Endpoint    Resource
Resource    Resource

[0595] 3.4.3.5 Delegation Relationship

[0596] Delegation is used to forward behavior from an outer system to a contained system. The way we do this is by delegating the endpoints on the outer system to endpoints on the inner system. This effectively forwards all interaction that would have been directed to the outer system to the endpoint on the inner system. Delegation can be chained, allowing the inner system to further delegate its behavior to another system.

[0597] A delegation relationship defines pairs of abstract endpoint definitions that can participate in the delegation. Each relationship identifies an abstract endpoint definition that can act as a proxy and an abstract endpoint definition to which it can delegate behavior.

<xs:complexType name=“DelegationDefinition”>
<xs:complexContent>
<xs:extension base=“RelationshipDefinition”>
<xs:sequence>
<xs:element name=“Delegation”
type=“HostingMember” minOccurs=“0”
maxOccurs=“unbounded”/>
</xs:sequence>
<xs:attribute name=“ProxyDefinition”
type=“QualifiedName” use=“required”/>
<xs:attribute name=“DelegateDefinition”
type=“QualifiedName” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0598]

Attribute/element  Description
ProxyDefinition    Identifies the definition of the outer endpoint that
                   delegates its behavior to the inner endpoint
DelegateDefinition Identifies the definition of the inner endpoint that
                   provides the required behavior.

[0599] The following combinations of abstract type pairs are valid for delegation relationships:

Proxy Type Delegate Type
Endpoint   Endpoint

[0600] We may allow resource and system delegation to support binding between layers. For example, to allow IIS to expose part of the file system without having to deploy it.

[0601] 3.4.3.6 Reference Relationship

[0602] We use reference relationships to capture strong dependencies between instances that are in addition to the hosting relationship dependency. These dependencies are used to control construction order during deployment and flow parameters between systems during installation and update. Because reference relationships indicate a strong dependency, we cannot allow a reference relationship to cross a system boundary. This means that resources within one system cannot have dependencies on resources in another system. This would make the system no longer an independent unit of deployment. Where dependencies exist between systems, we use communication relationships. Communication relationships can change over time without requiring reinstallation of the system.

<xs:complexType name=“ReferenceDefinition”>
<xs:complexContent>
<xs:extension base=“RelationshipDefinition”>
<xs:sequence>
<xs:element name=“Reference”
type=“HostingMember” minOccurs=“0”
maxOccurs=“unbounded”/>
</xs:sequence>
<xs:attribute name=“DependentDefinition”
type=“QualifiedName” use=“required”/>
<xs:attribute name=“SourceDefinition”
type=“QualifiedName” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0603]

Attribute/element   Description
DependentDefinition The definition of the instance that depends on the
                    source instance
SourceDefinition    The definition of the source instance. This
                    instance is not required to be aware of the
                    dependency.

[0604] The following combinations of abstract type pairs are valid for reference relationships:

Dependent Type Source Type
System         System
Resource       Resource
Resource       Endpoint
Endpoint       Resource
Endpoint       Endpoint

[0605] 3.4.3.7 Implicit Base Relationships

[0606] All abstract relationships implicitly extend one of the base relationships definitions. These definitions form a root for each of the relationship trees. FIG. 18 illustrates an example relationship tree. By doing this we can refer to the root definition from within constraint definitions and we can inherit common type constraints from the root type.

[0607] 3.5 Members

[0608] 3.5.1 Member

[0609] Members are used to identify instances of a particular definition that can exist at runtime. All members are identified by a name that is unique within the set of members in the scope of the definition that contains the member. A member can provide settings for the definition that it references. It can also contain design surface specific data.

<xs:complexType name=“Member”>
<xs:sequence>
<xs:element name=“Description” type=“Description”
minOccurs=“0”/>
<xs:element name=“DesignData” type=“DesignData”
minOccurs=“0”/>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“SettingValue”
type=“SettingValue”/>
<xs:element name=“SettingValueList”
type=“SettingValueList”/>
</xs:choice>
</xs:sequence>
<xs:attribute name=“Name” type=“SimpleName”
use=“required”/>
<xs:attribute name=“Definition” type=“QualifledName”
use=“required”/>
<xs:attribute name=“Visibility” type=“VisibilityEnum”
use=“optional”/>
</xs:complexType>

[0610]

Attribute/element Description
Description       A description of the members
DesignData        Design surface specific information about the
                  member
SettingValue      Values for settings that correspond to writeable
                  settings on the referenced type. If these values
                  are marked as fixed then they should be used
                  when an instance is created for the member, if
                  they are not fixed, then the values can be
                  overridden by deployment or flowed parameters.
SettingValueList  A list of values for a writable list setting on the
                  referenced type.
Name              A unique name for the member within the scope
                  of the containing type.
Definition        The name of the definition that this member
                  references.
Visibility        The visibility attribute is used to indicate
                  whether the member is public or private. If is it
                  private then it can only be references from within
                  the definition that contains the member. If it is
                  public then it can be referenced from outside the
                  definition. The default behavior is defined by the
                  visibility attribute on the definition.

[0611] 3.5.2 Object Member

[0612] Objects members should reference either an abstract or concrete object definition. They can represent an array of instances in which case they can define the upper and lower bounds for the array. If they are a reference member, then the user instantiating the object should explicitly construct an instance for the member. If they are not a reference member, then the runtime will create an instance at the same time as the outer object is created.

<xs:complexType name=“ObjectMember”>
<xs:complexContent>
<xs:extension base=“Member”>
<xs:attribute name=“MinOccurs”
type=“MinOccurs” use=“optional”/>
<xs:attribute name=“MaxOccurs”
type=“MaxOccurs” use=“optional”/>
<xs:attribute name=“Reference”
type=“xs:boolean” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0613]

Attribute/element Description
MinOccurs         Lower bound on the number
                  of instances associated
                  with this member. If it is
                  zero, then the member is
                  optional. Default is one.
MaxOccurs         Upper bound on the number
                  of instances associated
                  with this member. Should
                  be one or greater. Default
                  is one.
Reference         If this value is true, then
                  the instance associated
                  with the member should be
                  explicitly created by the
                  operator or referenced in
                  another type. If it is
                  false, then the instance
                  is created when the type
                  is created.

[0614] In an SDM model we need to differentiate members that get created when the parent is constructed and destroyed when the parent is destroyed from those that may have lifetimes independent from the parent. We use the IsReference attribute for this purpose. A simple analogy is with C++ declarations that allow stack based and heap based construction based on whether “new” is used to create an instance. If a member is marked as IsReference then an explicit new operation is required on the part of the operator to create an instance and associate it with the member.

[0615] There are a number of reasons that we do this:

[0616] 1. When an operator constructs a system, we only expose the ability to construct isReference members. This greatly simplifies the operator experience.

[0617] 2. When we process an SDM document we have clear boundaries at which the instance space of the document can vary from that of the concrete definition space.

[0618] 3.5.3 Relationship Member

[0619] Relationship members identify the relationships that will exist between object members when they are created. Relationship instances are either explicitly created by the operator or implicitly created by runtime. Examples of the former are hosting relationships between instances, the latter, communication relationships between systems.

<xs:complexType name=“RelationshipMember”>
<xs:complexContent>
<xs:extension base=“Member”/>
</xs:complexContent>
</xs:complexType>

[0620] 3.5.4 Endpoint Member

<xs:complexType name=“EndpointMember”>
<xs:complexContent>
<xs:extension base=“ObjectMember”/>
</xs:complexContent>
</xs:complexType>

[0621] 3.5.5 System Member

<xs:complexType name=“SystemMember”>
<xs:complexContent>
<xs:extension base=“ObjectMember”/>
</xs:complexContent>
</xs:complexType>

[0622] 3.5.6 Resource Member

<xs:complexType name=“ResourceMember”>
<xs:complexContent>
<xs:extension base=“ObjectMember”/>
</xs:complexContent>
</xs:complexType>

[0623] 3.5.7 Hosting Member

[0624] Host members are used to declare a hosting relationship between two object members. The object members may be direct members of the containing definition or nested members that have a membership relationship with the definition. There should be a membership chain between the referenced member and the containing definition.

<xs:complexType name=“HostingMember”>
<xs:complexContent>
<xs:extension base=“RelationshipMember”>
<xs:attribute name=“GuestMember”
type=“Path” use=“required”/>
<xs:attribute name=“HostMember”
type=“Path” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0625]

Attribute/element Description
GuestMember       Identifies a member
                  that has a definition
                  compatible with the
                  guest of the relationship.
                  Member can be nested.
HostMember        Identifies a member
                  that has a definition
                  compatible with the
                  host of the relationship.
                  Member can be nested.

[0626] 3.5.8 Communication Member

[0627] A communication member is used to declare a communication relationship between endpoint members of immediate system members of the definition.

<xs:complexType name=“CommunicationMember”>
<xs:complexContent>
<xs:extension base=“RelationshipMember”>
<xs:attribute name=“ClientMember”
type=“Path” use=“required”/>
<xs:attribute name=“ServerMember”
type=“Path” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0628]

Attribute/element Description
ClientMember      Identifies an endpoint member
                  that has a definition
                  compatible with the client
                  definition of the relation-
                  ship. Endpoint member should
                  be a member of an immediate
                  system member of the
                  definition.
ServerMember      Identifies an endpoint member
                  that has a definition
                  compatible with the server
                  definition of the relation-
                  ship. Endpoint member should
                  be a member of an immediate
                  system member of the
                  definition.

[0629] 3.5.9 Containment Member

[0630] A containment member is used to declare that a type member is contained by the type. Each type member can either be contained or delegated. The containment member automatically sets the parent value of the containment relationship to be the this pointer of the relationship.

<xs:complexType name=“ContainmentMember”>
<xs:complexContent>
<xs:extension base=“RelationshipMember”>
<xs:attribute name=“ChildMember”
type=“Path” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0631]

Attribute/element Description
ChildMember       Identifies an immediate
                  object member that will
                  be contained by the parent.

[0632] 3.5.10 Delegation Member

[0633] A delegation member is used to set up a delegation relationship between an endpoint definition member on the outer type and an endpoint definition member on an immediate system member of the outer type.

<xs:complexType name=“DelegationMember”>
<xs:complexContent>
<xs:extension base=“RelationshipMember”>
<xs:attribute name=“ProxyMember”
type=“Path” use=“required”/>
<xs:attribute name=“DelegateMember”
type=“Path” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0634]

Attribute/element Description
ProxyMember       Proxy identifies an
                  immediate endpoint member
                  on the system that does
                  not have a containment
                  relationship to the
                  system. The definition
                  of the member should
                  match the definition of
                  the proxy on the
                  delegation relationship.
DelegateMember    Delegate identifies an
                  endpoint member on an
                  immediate member of the
                  type. The type of the
                  endpoint member should
                  match the delegate type
                  on the delegation
                  relationship.

[0635] 3.5.11 Reference Member

[0636] A reference member is used to set up a reference relationship between two immediate or nested members of the outer definition.

<xs:complexType name=“ReferenceMember”>
<xs:complexContent>
<xs:extension base=“RelationshipMember”>
<xs:attribute name=“DependentMember”
type=“Path” use=“required”/>
<xs:attribute name=“SourceMember”
type=“Path” use=“required”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0637]

Attribute/element Description
dependentMember   The object member that
                  depends on the source
                  member. Should match
                  the definition of the
                  dependent object in the
                  reference relationship.
sourceMember      The source object member.
                  Should match the definition
                  of the source object in the
                  reference relationship.

[0638] 3 .6 Flow

[0639] Settings flow is used to pass parameters between members of an object definition and between participants in relationships. As part of a flow, the user can use transformations to combine or separate setting values and to calculate new setting values.

[0640] All settings flow members use a flow definition to implement the transform. The following is a flow definition that parses a url.

<FlowDefinition Name=“urlToComponents”>
<SettingDeclaration Name=“url”
Definition=“url” Access=“Writeonly”/>
<SettingDeclaration Name=“protocol”
Definition=“String” Access=“Readonly”/>
<SettingDeclaration Name=“server”
Definition=“String” Access=“Readonly”/>
<SettingDeclaration Name=“Path”
Definition=“String” Access=“Readonly”/>
<SettingDeclaration Name=“file”
Definition=“String” Access=“Readonly”/>
</FlowDefinition>

[0641] A flow member is then declared within an object or relationship. The flow member provides the input for the flow definition and then directs the output from the flow to the target settings.

<Flow Name=“deconstructUrl” Definition=“urlToComponents”>
<Input Name=“url” Path=“webservice.url”/>
<Output Name=“server” Path=“webservice.server” Replace=“false”/>
</Flow>

[0642] 3.6.1 Flow Definition

[0643] We use a flow definition to define a particular transform that we wish to apply to a set of setting values. The flow definition exposes a setting schema that defines the input settings (write-only settings) and the output settings (read-only settings), a DesignData section for design surface specific information such as an input interface for defining the transform and a description for use when browsing the SDM file. The flow definition is identified by name within the namespace in which it is defined. The definition also identifies a manager that will support the runtime when it evaluates the flow.

[0644] We expect that the runtime will include several standard flow definitions to simplify the construction of flow elements where straightforward transformations are required. Examples might include copy, merge and string substitution. Since flow definitions can be parameterized, we also expect there to be one or more simple transformations that perform different actions based on configuration parameters.

<xs:complexType name=“FlowDefinition”>
<xs:complexContent>
<xs:extension base=“Definition”/>
</xs:complexContent>
</xs:complexType>

[0645] 3.6.2 Flow Member

[0646] Each flow member identifies one or more input settings, one or more destination settings, can provide fixed setting values and should identify a flow definition. When the flow is evaluated, source data is collected from the inputs, combined with fixed setting values and passed to the flow definition for transformation. The output from the definition is passed to the destination settings according to the outputs listed in the flow member.

[0647] Re-evaluation of the flow will be triggered whenever one of the source values changes. For this reason, we need to avoid circular flows that cause values to flip flop. If the value remains constant then the loop will terminate. The runtime will detect and terminate infinite loops by keeping track of the stack depth.

[0648] It is an error for the outputs from separate flow members to target the same setting member on an object instance.

<xs:complexType name=“FlowMember”>
<xs:complexContent>
<xs:extension base=“Member”>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“Input” type=“SettingTarget”/>
<xs:element name=“Output” type=“OutputPath”/>
</xs:choice>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0649]

Attribute/element Description
Input             A list of paths to setting
                  values that are used as
                  input to the flow. Each
                  input should identify a
                  write only setting on
                  the flow definition.
Output            A list of paths to settings
                  that will be set as a result
                  of this flow. Each output
                  should identify a read only
                  setting on the flow definition.

[0650] 3.7 Constraints

[0651] Constraints are used to identify restrictions on setting values of members of a definition or on the participants in a relationship. These restrictions are evaluated in the instance space at both design time and at deployment time.

[0652] All setting constraints use a constraint definition to evaluate the setting values. The constraint definition uses settings declarations to identify the values it constrains. The following constraint definition implements a simple comparison function that takes two arguments and an operator, then evaluates the constraint and finally returns success or error.

<ConstraintDefinition Name=“SimpleOperatorComparison”>
<SettingDeclaration Name=“LHS” Definition=“Any”
Access=“Writeonly”/>
<SettingDeclaration Name=“operator” Definition=“operator”
Access=“Writeonly”/>
<SettingDeclaration Name=“RHS” Definition=“Any”
Access=“Writeonly”/>
</ConstraintDefinition>

[0653] A constraint member then used to provide the values to the constraint type for evaluation.

<Constraint Name=“constraintSecurityMode”
Definition=“SimpleOperatorComparison”>
<SettingValue Path=“operator”>=</SettingValue>
<SettingValue Path=“RHS”>basicAuth</SettingValue>
<Input Name=“LHS” Path=“webservice.securityMode”/>
</Constraint>

[0654] 3.7.1 Constraint Definition

[0655] A constraint definition defines a constraint that acts on a set of input values. The constraint can be parameterized to select custom behavior or to support for a simple constraint engine that uses parameters to define its behavior. We expect that a set of standard constraint definitions will be written for simple parameter value constraints and a set of complex constraints to support known relationships between abstract objects.

<xs:complexType name=“ConstraintDefinition”>
<xs:complexContent>
<xs:extension base=“Definition”>
<xs:choice minOccurs=“0”
maxOccurs=“unbounded”>
<xs:element name=“RelationshipConstraint”
type=“RelationshipConstraint”/>
<xs:element name=“RelationshipConstraintGroup”
type=“RelationshipConstraintGroup”/>
<xs:element name=“ObjectConstraint”
type=“ObjectConstraint”/>
<xs:element name=“ObjectConstraintGroup”
type=“ObjectConstraintGroup”/>
</xs:choice>
<xs:attribute name=“TargetDefinition”
type=“QualifiedName” use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0656]

Attribute/element Description
TargetDefinition  Identifies a target
                  definition to which this
                  constraint can be applied.
                  If this is not supplied,
                  then the constraint is
                  assumed to be applicable
                  to any object or relation-
                  ship definition.

[0657] 3.7.2 Constraint Member

[0658] A constraint member identifies a set of input values for a particular constraint definition. The member can identify static values for settings and can use input statements to bind a constraint setting to a path.

<xs:complexType name=“ConstraintMember”>
<xs:complexContent>
<xs:extension base=“Member”>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“Input” type=“Input”/>
</xs:choice>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0659]

Attribute/element Description
input             A list of inputs to the
                  constraint. An input
                  identifies a path to the
                  source setting value that
                  will be passed to the
                  constraint and constraint
                  setting that will be set
                  as a result. The source
                  setting definition and
                  the constraint setting
                  definition should be
                  compatible.

[0660] 3.7.3 Structural Constraints

[0661] We use object and relationship constraints to define the topology of the concrete space and to constrain the settings of objects when used in particular relationships.

[0662] For example within an abstract object definition (A) we may want to identify that implementations of this abstract definition should contain one instance of another abstract object definition (B). Assuming that at least one appropriate containment relationship already exists, to do this we would use a relationship constraint within A that looked as follows:

<RelationshipConstraint name=“AContainsB”
relationship=“ContainmentDefinition”
myRole=“parent”
targetType=“B”
minOccurs=“1”
maxOccurs=“1”/>

[0663] The constraint identifies that there should exist a containment relationship in which the implementation of A plays the role of parent and the type at the other end of the relationship (the member) is of type B. If we want more control over the configuration of B we can add a constraint on the settings of type B as follows:

<RelationshipConstraint Name=“AContainsB”
RelationshipDefinition=“containementRelationship”
TargetRole=“Member”
TargetObjectDefinition=“B” MinOccurs=“1”
MaxOccurs=“1”>
<Constraint Definition=“simpleValueConstraint”
Name=“BValueConstraint”>
<SettingValuePath=“operator”>=</SettingValue>
<SettingValuePath=“RHS”>myPort</SettingValue>
<Input Path=“member.Name” Name=“LHS”/>
</Constraint>
</RelationshipConstraint>

[0664] In this case, we added a constraint that required the name of the member to equal the string “myPort”.

[0665] We can also add constraints to relationships; we call these object constraints. From within a relationship we constrain the objects that participate in the relationship. For each role in the relationship, we can identify a object definition and then we can add setting constraints to those object definitions. From the relationship perspective the cardinality is always minOccurs=1 and maxOccurs=1 so this does not appear in the constraint declaration.

<ObjectConstraint Name=“allowedPair”
PrimaryRole=“Host”
PrimaryObjectDefinition=“IIS”
SecondaryRole=“Guest”
SecondaryObjectDefinition=“webApp”/>

[0666] Finally, we can nest constraints. This gives us the ability to chain constraints together; the outer constraint sets the context for the inner constraint. The following is an example of an IIS system that hosts webapp systems that it then constrains the webApp only containendpoints of a specific type.

[0667] In this case, we use a group of object constraints to specify a set of possibilities of which at least one should be true.

<SystemDefinition Name=“test”>
<RelationshipConstraint Name=“WebAppHostConstraint”
RelationshipDefinition=“HostingDefinition”
TargetRole=“Guest”
TargetObjectDefinition=“webApp”>
<RelationshipConstraint Name=“WebAppContainsPort1”
RelationshipDefinition=“containmentRelationship”
TargetRole=“Member”
TargetObjectDefinition=“EndpointDefinition”
MinOccurs=“1”
MaxOccurs=“unbounded”>
<ObjectConstraintGroup>
<ObjectConstraint Name=“hasWebPort” PrimaryRole=“Member”
PrimaryObjectDefinition=“webPort”/>
<ObjectConstraint Name=“hasSqlPort” PrimaryRole=“Member”
PrimaryObjectDefinition=“sqlPort”/>
</ObjectConstraintGroup>
</RelationshipConstraint>
</RelationshipConstraint>

[0668] The nested constraints form a path that we can evaluate from the outside in. Each constraint on the path can access the settings of previous instances on the path as well as the current instance. The evaluation of nested constraints is conducted as if the constraint had been defined within the identified system.

[0669] From the perspective of foo the following two scenarios should be equivalent. In the first foo places a nested constraint on a contained system bar, in the second, the type bar already contains the constraint.

Scenario 1:
< SystemDefinition name=“foo”>
<RelationshipConstraint Name=“containsBar”
RelationshipDefinition=“containment”
TargetRole=“Member”
TargetObjectDefinition=“bar”
MinOccurs=“1”>
<RelationshipConstraint Name=“containsX”
RelationshipDefinition=“containment”
TargetRole=“Member”
TargetObjectDefinition=“X”
MinOccurs=“1”/>
</ RelationshipConstraint >
</ SystemDefinition >
< SystemDefinition name=“bar”/>

[0670]

Scenario 2:
<SystemDefinition Name=“foo”>
<RelationshipConstraint Name=“containsBar”
RelationshipDefinition=“containment”
TargetRole=“Member”
TargetObjectDefinition=“bar”
MinOccurs=“1”/>
</SystemDefinition>
<SystemDefinition Name=“bar”>
<RelationshipConstraint Name=“containsX”
RelationshipDefinition=“containment”
TargetRole=“Member”
TargetObjectDefinition=“X”
MinOccurs=“1”/>
</SystemDefinition>

[0671] 3.7.3.1 Constraint Model

[0672] There are two parts to the constraint model: guards and predicates. We use guards to define the context in which we execute the predicate. For example within a relationship, we use guards to identify a particular combination of types for which we want to execute a predicate. Within a object, we use guards to identify a set of relationship to other objects.

[0673] Predicates are then executed when the requirement of their guards have been met. We have two forms of predicate: setting constraints that validate setting values and group constraints that validate a set of constraints.

[0674] We can nest guards within guards, in which case the inner guard is only checked when the outer guard is satisfied. This allows us to build paths that support verification of a relationship structure.

[0675] The combination of a guard and its predicates can have a cardinality that indicates the number of times that the guard should match and the predicate evaluate to true.

[0676] More formally,

Guard := = ObjectConstraint(ObjectDefintion, ObjectDefintion
,required)
{ (Guard | predicate) * } |
RelationshipConstraint(RelationshipDefinition,
TargetObject,lBound,uBound)
{ (Guard | predicate) * }

[0677] A guard is defined as either a ObjectConstraint or a RelationshipConstraint. Object constraints identify two object definitions that are associated with either end of the relationships. Relationship constraints identify a relationship definition and a target object definition. An object constraint can be optional or required while a relationship constraint has a lower bound and an upper bound. This difference in cardinality reflects the fact that a relationship can only ever identify two types while a type can participate in multiple relationships.

[0678] Predicate:==settingsconstraint(rule)|group{(guard)*}

[0679] A predicate is either a settings constraint that contains a rule or a group that contains a set of guards. The predicate is evaluated in the context of the guard. In the case of a settings constraint, the predicate can identify settings from the owner of the root guard and the context identified by each nested guard. Groups are used to identify a set of guards of which at least one should match and evaluate to true.

[0680] Examples:

1. RelationshipConstraint(containmentRelationship,webapp,0,1){
   }

[0681] This example shows a guard that evaluates to true whenever there is a containment relationship to a webapp. This guard can evaluate true at most one time. Further matches will result in the return of an error to the user.

2. RelationshipConstraint(containmentRelationship,webapp,0,1)
   {
   SettingsConstraint(webapp.name=2)
   }

[0682] This example adds a predicate to the guard. The guard will only evaluate to true when the relationship and target definitions match and the setting constraint evaluates to true. If the relationship and target definition match and the setting constraint is not true then an error will be returned to the user. If the relationship and target type match and the setting constraint evaluates true more than once, then an error is returned to the user.

3. RelationshipConstraint(containmentRelationship,webapp,0,1)
   {
   RelationshipConstraint(containmentRelationship,vdir,0,1)
   }

[0683] In this example, we nest a guard within a guard. When the outer guard is true (the type that contains the constraint also contains a webapp), we then evaluate the inner guard in the context of the outer guard. That means the inner relationship constraint will be evaluated in the context of a webapp instance. The inner constraint will return true if the webApp contains zero or one vdirs, if it contains more than one vdir then the constraint will return an error to the user.

4. ObjectConstraint(webapp,iis,0,1)
   {
   RelationshipConstraint(containmentRelationship,systemType,0,1)
   {
   ObjectConstraint(webapp,vdir,0,1)
   }
   }

[0684] The context of the object constraint is the primary object definition (the first object definition). This means that the relationship constraint will be evaluated in the context of webapp. The relationship constraint defines two possible contexts, the first is the relationship, which will be the context for object constraints, and the second is the target object defintion which is the context for relationship constraints.

5. RelationshipConstraint(containmentRelationship,webapp,0,1)
   {
   group
   {
   RelationshipConstraint(containmentRelationship,vdir,0,1)
   RelationshipConstraint(containmentRelationship,directory,0,1)
   }
   }

[0685] In this example, we use a group to contain two relationships constraints that will both be evaluated in the context of the Webapp. The group will raise an error unless at least one of the relationships fire and return true. In this case, the Webapp should contain either a Vdir or a directory.

[0686] 3.7.3.2 Base Constraint

[0687] All structural constraints derive from a common base constraint called StructuralConstraint. Each structural constraint can contain both a description element and design data. The description element will be returned as error messages when a required constraint fails. Each constraint also has a name and a flag indicating whether the constraint is required or is simply a test that forms part of a larger constraint. Finally the evaluate element of a constraint can be used to indicate when the constraint should be evaluated. See section 3.7.3.7 for more information on constraint evaluation.

<xs:complexType name=“StructuralConstraint”>
<xs:sequence>
<xs:element name=“Description” type=“Description”
minOccurs=“0”/>
<xs:element name=“DesignData” type=“DesignData”
minOccurs=“0”/>
</xs:sequence>
<xs:attribute name=“Name” type=“SimpleName” use=“required”/>
<xs:attribute name=“Evaluate” type=“ConstraintEvaluation”
use=“optional”/>
<xs:attribute name=“Required” type=“xs:boolean” use=“optional”/>
</xs:complexType>

[0688]

Attribute/element Description
Name              Name of this constraint
DesignData        Design surface specific
                  information about this
                  constraint
Description       A textural description
                  of the constraint.
Evaluation        Information about when
                  to evaluate the constraint.
                  Default is Design time.
Required          Flag indicating whether
                  a message should be
                  returned to the user
                  when this constraint
                  fails. Default is true;

[0689] 3.7.3.3 Object Constraint

[0690] An object constraint describes a constraint to one or both of the roles of relationship. The constraint has a name to aid identification of the constraint in the case that it fails. An object may contain nested relationship constraints or constraint members that will be evaluated if the roles match the instances participating in the relationship.

[0691] The constraint is evaluated as follows:

[0692] a) Does the primary role and primary definition match an object instance, and if provided, does the secondary role and secondary definition match an object instance. If these don't match, then set matches=0 and skip to c)

[0693] b) Evaluate all nested constraints in the context of the primary object instance. If these all evaluate to true, set matches=1, otherwise set matches=0.

[0694] c) If matches>MinOccurs and matches<MaxOccurs set result=true, else set result=false.

[0695] d) If required is true and result is false return a message to the user

[0696] e) Return result to the parent context

<xs:complexType name=“ObjectConstraint”>
<xs:complexContent>
<xs:extension base=“StructuralConstraint”>
<xs:choice minOccurs=“0”
maxOccurs=“unbounded”>
<xs:element name=“Constraint”
type=“ConstraintMember”/>
<xs:element name=“RelationshipConstraint”
type=“RelationshipConstraint”/>
<xs:element name=“RelationshipConstraintGroup”
type=“RelationshipConstraintGroup”/>
</xs:choice>
<xs:attribute name=“PrimaryRole” type=“RolesList”
use=“required”/>
<xs:attribute name=“PrimaryObjectDefinition”
type=“QualifiedName” use=“required”/>
<xs:attribute name=“SecondaryRole” type=“RolesList”
use=“optional”/>
<xs:attribute name=“SecondaryObjectDefinition”
type=“QualifiedName” use=“optional”/
<xs:attribute name=“MinOccurs” type=“MinOccurs”
use=“optional”/>
<xs:attribute name=“MaxOccurs” type=“MaxOccurs”
use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0697]

Attribute/element           Description
Constraint                  A list of constraint
                            members that are nested
                            in this constraint.
RelationshipConstraint      A nested relationship
                            constraint. The relation-
                            ship is evaluated as if
                            it had been declared on
                            the definition associated
                            with the primary role.
RelationshipConstraintGroup A nested relationship
                            group - the relationships
                            in the group are evaluated
                            as if it had been declared
                            on the definition
                            associated with the primary
                            role.
PrimaryRole                 The name of a role in the
                            relationship that this
                            constraint targets.
PrimaryObjectDefinition     The name of the object
                            definition associated
                            with the primary role.
SecondaryRole               The name of the other
                            role on the relationship
                            that this constraint
                            targets. (optional)
SecondaryObjectDefinition   The name of the object
                            definition associated
                            with the secondary role
                            on the relationship.
                            This is required if a
                            secondary role is
                            specified.
MaxOccurs                   The maximum number of
                            times this constraint
                            can match the objects
                            on a relationship.
MinOccurs                   The minimum number of
                            times this constraint
                            can match the objects
                            on a relationship.
Required                    If required is true then
                            the constraint will
                            generate an error when
                            it evaluates to false.
                            Default is true.

[0698] 3.7.3.4 Object Constraint Group

[0699] An object constraint group allows sets of object constraints to be grouped together so that they can be evaluated using at-least-one semantics. The group will return a false unless at least one of the constraints in the group evaluates to true. The constraint group is evaluated as follows:

[0700] a) Evaluate each nested constraint in turn. If at least one evaluates to true then set result=true otherwise set result=false.

[0701] b) If result=false and Required=true, then raise an error

[0702] c) Return result to the parent context.

<xs:complexType name=“ObjectConstraintGroup”>
<xs:complexContent>
<xs:extension base=“Constraint”>
<xs:sequence>
<xs:element name=“ObjectConstraint”
type=“ObjectConstraint” maxOccurs=“unbounded”/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0703]

Attribute/element Description
ObjectConstraint  A list of object
                  constraints nested
                  within the group

[0704] 3.7.3.5 Relationship Constraint

[0705] Relationship constraints are used to constrain the relationships in which an object can participate. A relationship constraint identifies the relationship definition, optionally the object definition of the instance at the other end of the relationship and the cardinality of the relationship. The constraint is given a name so that it can be identified in error messages. The body of the relationship constraint contains nested constraints that further refine this constraint.

[0706] Relationship constraints can be used for a number of purposes: simply using the cardinality without additional predicates, they can be used to identify relationships that should be provided for an instance to operate correctly, with predicates they can be used narrow the set of configurations for instances that this object is willing to interact with.

[0707] A relationship constraint is evaluated as follows:

[0708] a) Set matches=0

[0709] b) For each relationship instance that the object instance participates in

[0710] a. Does the relationship definition match the definition of the relationship instance, does the relationship direction match the direction identified by the target role and if provided does the target object definition match the definition of the instance at the other end of the relations. If these don't match then skip to the next relationship.

[0711] b. Evaluate all nested constraints in the context of the relationship instance. If these all evaluate to true, set matches=matches+1

[0712] c) If matches>MinOccurs and matches<MaxOccurs set result=true, else set result=false.

[0713] d) If required is true and result is false return a message to the user

[0714] e) Return result to the parent context

<xs:complexType name=“RelationshipConstraint”>
<xs:complexContent>
<xs:extension base=“StructuralConstraint”>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“Constraint”
type=“ConstraintMember”/>
<xs:element name=“RelationshipConstraint”
type=“RelationshipConstraint”/>
<xs:element name=“RelationshipConstraintGroup”
type=“RelationshipConstraintGroup”/>
<xs:element name=“ObjectConstraint”
type=“ObjectConstraint”/>
<xs:element name=“ObjectConstraintGroup”
type=“ObjectConstraintGroup”/>
</xs:choice>
<xs:attribute name=“RelationshipDefinition”
type=“QualifiedName” use=“required”/>
<xs:attribute name=“TargetRole” type=“RolesList”
use=“required”/>
<xs:attribute name=“TargetObjectDefinition”
type=“QualifiedName” use=“optional”/>
<xs:attribute name=“MinOccurs” type=“MinOccurs”
use=“optional”/>
<xs:attribute name=“MaxOccurs” type=“MaxOccurs”
use=“optional”/>
<xs:attribute name=“DelegationAware”
type=“xs:boolean” use=“optional”/>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0715]

Attribute/element           Description
Constraint                  Constraints on the values
                            of settings within the
                            relationship or on objects
                            at the other end of the
                            relationship.
RelationshipConstraint      This element defines a
                            relationship constraint
                            that will be evaluated
                            in the context of the
                            target object instance.
RelationshipConstraintGroup This element defines a
                            relationship group that is
                            evaluated in the context
                            of the target object
                            instance.
ObjectConstraint            This element defines an
                            object constraint that is
                            evaluated in the context
                            of the matched relation-
                            ship instance.
ObjectConstraintGroup       This element defines an
                            object constraint group
                            that is evaluated in the
                            context of the matched
                            relationship instance.
Name                        Unique name for the
                            constraint within the scope
                            of the containing definition
RelationshipDefinition      The definition of the
                            relationships that will
                            be matched.
TargetRole                  The target role is used
                            to identify the direction
                            of the relationship. It
                            is the name of the role
                            in which the instance at
                            the other end of the
                            relationship participates.
TargetObjectDefinition      Optional name of the
                            definition of the object
                            instance that is on the
                            other side of the
                            relationship
MaxOccurs                   The maximum number of
                            relationship instances
                            that this constraint can
                            match.
MinOccurs                   The minimum number of
                            relationship instances
                            that this constraint can
                            match.
Required                    If required is true then
                            the constraint will generate
                            an error when it evaluates
                            to false. Default is true.
DelegationAware             Indicates that the
                            constraint is delegation
                            aware. Default is false.
                            See section 3.8 for more
                            information.

[0716] 3.7.3.6 Relationship Constraint Group

[0717] A relationship constraint group allows sets of relationship constraints to be grouped together so that they can be evaluated as a predicate with at-least-one semantics. The constraint group is evaluated as follows:

[0718] d) Evaluate each nested constraint in turn. If at least one evaluates to true then set result=true otherwise set result=false.

[0719] e) If result=false and Required=true, then raise an error

[0720] f) Return result to the parent context.

<xs:complexType name=“RelationshipConstraintGroup”>
<xs:complexContent>
<xs:extension base=“StructuralConstraint”>
<xs:sequence>
<xs:element name=“RelationshipConstraint”
type=“RelationshipConstraint”
maxOccurs=“unbounded”/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>

[0721]

Attribute/element      Description
RelationshipConstraint A relationship
                       constraint nested
                       within the group

[0722] 3.7.3.7 Constraint Evaluation

[0723] There are three distinct times that a constraint can be evaluated: during the design process, during deployment of an application and then once an application has been deployed at any time that an operator wants to check or update the configuration of an application.

[0724] The time at which a constraint is evaluated changes the set of information that is available to the constraint. Constraints that are evaluated at design time cannot depend on values that will only be supplied during deployment or will only be available after deployment. Constraints that are evaluated at deployment time cannot depend on values that will only be available after deployment. Constraints that are evaluated after deployment can access any setting in the application.

[0725] We allow a constraint developer to mark their constraint according to when it should run. This information is used to avoid errors that will occur if we try to run a constraint when inputs are not available. The compiler can then check that a design constraint does not depend on values that it knows will not be available until deployment or validation, similarly it can check that a deployment constraint does not depend on values that it knows will not be available until after deployment. If the compiler had complete knowledge of when settings will be available, then the time at which a constraint could run could be computed, but unfortunately, this is unlikely to be the case. The time at which a value may be provided for a setting can change, for example, a directory name could be known in advance or could be created during deployment using an algorithm that generated a unique identifier.

[0726] Constraints can be marked as follows:

[0727] a) Design—indicating that it can be run at design time, deployment time or during validation,

[0728] b) Deployment—indicating that it can be run at deployment or during validation,

[0729] c) Validation—indicating that it can only be run during validation, or

[0730] d) Never—indicating that it will never be executed.

[0731] The following enumeration is used to capture these options:

<xs:simpleType name=“ConstraintEvaluation”>
<xs:restriction base=“xs:string”>
<xs:enumeration value=“Design”/>
<xs:enumeration value=“Deployment”/>
<xs:enumeration value=“Validate”/>
<xs:enumeration value=“Never”/>
</xs:restriction>
</xs:simpleType>

[0732] The evaluation behavior of a constraint can be set on both structural constraints and on constraint members. In both cases, it applies to all nested constraints with either the structural constraint or the constraint member.

[0733] Constraints by default are marked as design time constraints and can be executed at any time.

[0734] 3 .8 Delegation

[0735] The purpose of delegation is to allow a developer of a model to expose specific behavior from a host or from a contained component to a guest or parent. This allows the developer to design a component that reuses existing implementations and provides a more comprehensive implementation for its clients. FIG. 19 illustrates an example of using delegation to expose a host's implementation to a guest.

[0736] In FIG. 19, the Application Platform component uses a delegation relationship to expose the file system from its host, the operating system component, to its guest, the application. By doing this, the application platform can control what parts of the operating system are available to its guest without having to implement them directly.

[0737] FIG. 20 illustrates an example of using delegation to expose a member's implementation to a parent. In FIG. 20, the client application exposes the Booking service's endpoint to the ticketing application. This allows the ticketing application to then connect the endpoint to the Server application, which in turn delegates its endpoint to the UserData application.

[0738] 3.8.1 Principles

[0739] The following principals guide the design of the delegation model.

[0740] The proxy does not exist in the target system. The proxy is a convenience for the model and will not have a physical manifestation. If this were not true, then the use of delegation would have side effects on the target system.

[0741] The proxy cannot change the behavior of the delegate unless the change is supported by the delegate. Since the proxy does not exist in the target system, the proxy can only change the modeled, not actual system behavior. If the delegate exposes settings that affect its behavior, then like other relationships, the delegation relationship can change those settings through flow.

[0742] From an external user's perspective, the user should not have to know whether a particular instance is a proxy or an actual implementation. If this were not true, then constraint and flow authors would have to cover both cases leading to complex and fragile code.

[0743] A user should be able to explicitly target proxies as part of a constraint expression. This is required in order to implement constraints that control the exposure of behavior through a component boundary.

[0744] 3.8.2 Scenarios

[0745] The following are two scenarios that illustrate the issues associates with using delegates in a system

[0746] 3.8.2.1 Communication Connectivity Validation

[0747] In order to validate that a client port can connect to a server port, a communication relationship contains a constraint that walks to the server, then to the server's host, then back along a communication relationship at layer 3, then up the hosting relationship to the layer 4 client and finally back to the communication relationship. This is illustrated in FIG. 21.

[0748] It is likely that delegation relationships will exist between the clients and servers at both layers due to the existence of containment boundaries. An example of this is illustrated in FIG. 22. In order to write the constraint that follows this path, the user should then be able to cope with an arbitrary number of these relationships, which would complicate the description of the constraint and reduce the usability of the constraint language.

[0749] To avoid this we need the user to be able to write the constraint without knowing in advance, whether there will be proxies and how many there might be.

[0750] 3.8.2.2 Zone Boundaries

[0751] In datacenters, zones are often used to differentiate systems with different security requirements or behaviors. When a communication relationship crosses a zone boundary, the user may wish to place constraints on the behavior of that relationship. For example, a user may wish to only allow http communication over a certain port to the backend servers. In order to do this, the user should be able to identify the communication relationships as they cross the zone boundary: the proxy is the only way they can do this. FIG. 23 illustrates an example of zone boundaries.

[0752] In FIG. 23, if the developer may wished to constrain outgoing communication from zone1 to zone 2, then they would do they by constraining the endpoints that were delegated to the zone boundary. For example, they may write a constraint that only allows incoming http and outgoing sql communication flows. This constraint would fire for each proxy endpoint exposed by the zone.

[0753] To constrain a proxy, it should be visible to the constraint. This means that the constraint should be able to target the relationships that the proxy participates in separately from the delegate that implements the behavior. This complicates the behavior expected for the previous scenario as in some scenarios the proxy be not be transparent to the user.

[0754] 3.8.3 Interaction with Other Parts of the Model

[0755] The rules for delegates are illustrated using an example instance space illustrated in FIG. 24.

[0756] 3.8.3.1 Proxy and Delegate

[0757] The proxy should be the same or a base class of the delegate. In the example in FIG. 24, b, which acts as a proxy, should be the same or a base definition of c, the delegate. This is required because the proxy b can only expose the behavior of c. If the types were allowed to differ, then the exposed behavior of b could be different from the behavior of c but there would be no physical manifestation of b that could implement the required behavior.

[0758] In the instance space, a proxy instance can only have one delegate i.e. there can only be one delegation relationship from b where b acts as the proxy in the relationship. This constraint is required because without it, it would not be possible to return setting values or member collections from a delegate—the runtime would not know which delegate to choose as the source for the values.

[0759] 3.8.3.2 Relationships Roles

[0760] A proxy can participate in the following relationship roles:

Hosting	Host	Yes	When a hosting relationship
			targets a proxy, the guest is re-
			routed to the delegate. The
			outcome is as if the guest had
			been hosted directly on the
			delegate.
	Guest	No	This is not allowed. It would
			imply that either the proxy
			existed in the modeled system or
			that the delegate was deployed
			based on the configuration of the
			proxy.
Containment	Parent	No	The proxy cannot participate as a
			parent in a containment
			relationship. If it did, it would be
			changing the members of the
			delegate, which is not allowed.
	Member	Yes	The proxy exists in the
			containment structure of the
			application, so it should be able to
			participate as a member in a
			containment relationship.
Delegation	Proxy	Yes	A proxy should participate in a
			delegation relationship in order to
			be able to forward requests to the
			delegate.
	Delegate	Yes	A proxy can act as a delegate for
			another delegation relationship.
			This allows delegation to be
			chained, exposing an instance
			through multiple layers of
			containment.
Reference	Source	Yes	The proxy can act as a source for
			a reference relationship. Requests
			for the source are redirected to
			the delegate.
	Dependent	No	The proxy cannot act as a
			dependent in a reference
			relationship as this would imply
			that the delegate required the
			reference, thus changing the
			behavior of the delegate.
Communication	Client	Yes	Since we use delegation to
			expose endpoints through
			containers, a proxy should be
			able to act as a client.
	Server	Yes	Since we use delegation to
			expose endpoints through
			containers, a proxy should be
			able to act as a server.

[0761] 3.8.3.3 Member Filtering and Path Resolution

[0762] The proxy only exposes the members from the delegate that are defined as part of the proxy's definition. In the case where the proxy and delegate's definitions are the same, all the members of the delegate will be exposed by the proxy. When the proxy definition is a base definition of the delegate's definition then the proxy will only expose those members that are common to both definitions.

[0763] Given the following definitions for B and C in FIG. 24:

<Definition Name=“B”>
<SettingDeclaration Name=“height” Definition=“Int”/>
</Definition>
<Definition Name=“C” Extends=“B”>
<SettingDeclaration Name=“weight” Definition=“Int”/>
</Definition>

[0764] Then the proxy b will only expose the height setting and not the weight setting.

[0765] When a setting value is set on a proxy, the action is forwarded through the delegation relationship to the delegate: the new setting value is recorded directly on the delegate and is visible to any other proxies that target that delegate.

[0766] When a setting value is retrieved from a proxy, the request is forwarded to the delegate and the setting value is returned directly from the delegate.

[0767] Object and relationship member filtering works the same way as setting filtering. Only the public members that are declared as part of the proxy's definition are exposed by the proxy. Changes to members immediately affect the members of the delegate and are visible to all proxies that target that delegate.

[0768] When a member path references a member on a proxy then the path is automatically resolved to the member on the delegate. This means that the path syntax does not change depending on whether a member is a proxy or a delegate.

[0769] 3.8.3.4 Relationship Filtering

[0770] Each object instance participates in a set of relationships. These relationships are used to evaluate both constraints and flow and are also used to control the instantiation process. Both the proxy and the delegate participate in sets of relationships that should be combined together in order to present a coherent picture of both the proxy and the delegate to the user.

[0771] From the proxy we need to expose a subset of the delegate's relationships in combination with the proxy's relationships. If we are hiding implementation then the proxy needs to return its own containment relationships to the user and possibly only a small subset of the delegate's relationships. If we want the proxy to be completely transparent then we expose all the delegate's relationships and hide the relationships of the proxy.

[0772] From the delegate we need to expose its direct relationships in conjunction with a subset of the relationships that its proxies participate in. That is, if a proxy has a communication relationship with another endpoint then it should appear as though the delegate participates directly in this relationship. On the other hand, we do not wish to expose the proxy's containment relationship as part of the delegate. The roll up behavior for constraints is described in section 3.8.3.6.

[0773] 3.8.3.4.1 Proxy Identity and Relationship Filtering

[0774] We have two types of proxy—transparent proxies and opaque proxies. A transparent proxy is used when the developer wishes to expose the implementation of the delegate to clients of the proxy and an opaque proxy is used when the developer wishes to hide the implementation of the delegate from clients of the proxy.

[0775] 3.8.3.4.1.1 Transparent Proxy

[0776] A transparent proxy is used to expose the implementation of the delegate to a client. A typical example would be shown in FIG. 23, where the zones are purely for modeling purposes and should not hide the systems that they contain. In this case, a developer that is communicating with the Sql system in zone 2 should be aware that the implementation of the delegated endpoint is a Sql server rather than a zone.

[0777] A transparent proxy returns all identifying information from the delegate rather than the client. This means that the instance ID, definition, version and containment information are all sourced from the delegate rather than the proxy.

[0778] When queried, a transparent proxy will also return the set of relationships that the delegate participates in rather than those of the proxy.

[0779] 3.8.3.4.1.2 Opaque Proxy

[0780] An opaque proxy is used to hide the implementation of the delegate so that the developer is free to change that implementation without breaking the client. For example in FIG. 19, the IIS system may use an opaque proxy to hide the file system implementation so that guests of IIS do not depend on the operating system that implements the file system.

[0781] An opaque proxy will return instance ID, definition and version and containment information from the proxy rather than the delegate.

[0782] When queried, an opaque proxy will only return relationships that it participates in directly not including its delegation relationship.

[0783] 3.8.3.5 Flow

[0784] Flow that targets a proxy will automatically be redirected to the delegate without any need for the flow to be aware that the target is a proxy rather than the real implementation. Because proxies forward all requests for members to the instances associated with the delegate, the affects of the flow are forwarded directly to the delegate by the proxy.

[0785] Flow that is declared as part of a proxy will not be evaluated. This is because the flow will also be evaluated as part of the delegate since the delegate should be the same or a derivation of the proxy's definition. If it were evaluated, we would always have a duplicate flow error on the delegates setting values.

[0786] 3.8.3.6 Constraints

[0787] Constraints can either be written to be delegation aware or not. If a constraint is delegation aware then it will be evaluated on each proxy instance without the any rollup of the relationships that the proxy participates in. Delegation relationships will be exposed to the constraint.

[0788] For example, a delegation aware communication constraint written from x targeting b in FIG. 24 would see the proxy b and the relationships that it participates with x, c, d, e and i. Then assuming it followed the delegation relationship to c, it would see the relationships from c to b, f, h and g.

[0789] If a constraint is not marked as delegation aware, then the constraint engine will automatically skip over transparent proxies when evaluating relationships that target a proxy. If the target instance of the constraint is a proxy, then the constraint engine will replace that by the delegate. The constraint will never see delegation relationships.

[0790] If the same constraint were evaluated without being delegation aware, it would not see b at all. Instead, it would only be evaluated against c. When evaluating c it would see relationships between c and x, d, f, h, g and i. Note that in this case we have rolled up all the relationships from b except for its containment relationship and we have hidden the delegation relationships.

[0791] A constraint is marked as delegation aware by setting the DelegationAware attribute to true on a structural constraint (either object or relationship constraint—see section 3.7.3).

[0792] Constraints that are declared as part of a proxy's definition will not be evaluated on the proxy. This is because the constraints will also be evaluated against the delegate since they should be common to both the proxy's and the delegate's definitions.

[0793] 3.9 Manager

[0794] Managers are the mechanism by which types and relationships insert custom behavior into the runtime environment. There are several roles that a manager can support for each type that it manages: it can participate in the installation of the type, it can provide a CLR representation of the type, it can be involved in policy decisions about how bindings between types are resolved and it can provide the implementation for complex constraints and flow.

[0795] All object managers roles exposed through the CLR as entry points into strongly named classes. Object managers are packaged and versioned in the same manner as other types in the SDM; they are distributed in system distribution units and their version and strong name is derived from the SDM file in which they are declared.

<xs:complexType name=“ManagerDeclaration”>
<xs:sequence>
<xs:element name=“Description” type=“Description”
minOccurs=“0”/>
</xs:sequence>
<xs:attribute name=“Name” type=“SimpleName” use=“required”/>
<xs:attribute name=“AssemblyName” type=“xs:string”
use=“required”/>
<xs:attribute name=“Version” type=“FourPartVersionType”
use=“optional”/>
<xs:attribute name=“PublicKeyToken” type=“PublicKeyTokenType”
use=“optional”/>
<xs:attribute name=“Culture” type=“CultureNeutral”
use=“optional”/>
<xs:attribute name=“Platform” type=“xs:string” use=“optional”/>
<xs:attribute name=“SourcePath” type=“xs:string” use=“optional”/>
</xs:complexType>

[0796]

Attribute/
element        Description
Name           A unique name for this
               manager in the scope of
               the containing SDM file.
Description    A text description of
               the manager
AssemblyName   The assembly name
Version        The assembly version
PublicKeyToken The public key token
               for the assembly
Culture        The culture of the
               assembly
Platform       The platform of the
               assembly
SourcePath     The path to the assembly
               within the SDU

[0797] 3.9.1 Roles

[0798] An object manager can support one or more roles for each type that it supports. These roles include:

[0799] a) Evaluating constraints for the type or relationship

[0800] b) Evaluating flow for the type or relationship

[0801] c) Construction/destruction/update support for a type

[0802] d) Exposing an object representation for the settings on the type or relationship

[0803] e) Performing discovery for the type or relationship.

[0804] f) Supporting design surface specific UI around a type or relationship

[0805] 3.9.2 Notes

[0806] Managers may have dependencies on other managers but these dependencies should be reflected in the import statemenst in the SDM files that the user the manager. If these dependencies are not described, then the other managers that a particular manager depends on will not be loaded by the runtime and the manager will fail to execute.

[0807] 3.10 Design Data and Descriptions

[0808] A description contains text that describes the associated SDM element. The text is in the language of the document identified by the DocumentLanguage attribute. To support localization of the text, a resource identifier can be provided. The runtime will ask either the manager identified on the description or if that is not supplied, the default manager for the document for the localized text associated with the description.

<xs:complexType name=“Description” mixed=“true”>
<xs:attribute name=“ResourceId” type=“xs:string” use=“optional”/>
<xs:attribute name=“Manager” type=“QualifiedName”
use=“optional”/>
</xs:complexType>
A design data type contains structured data that defined by
a design surface. Each design
surface should use their own schema to identify and to
structure the data.
<xs:complexType name=“DesignData”>
<xs:sequence>
<xs:any namespace=“##other” processContents=“lax”
minOccurs=“0” maxOccurs=“unbounded”/>
</xs:sequence>
</xs:complexType>

[0809] 3.11 SDM Document Structures

[0810] An SDM document provides a strong identity, versioning and localization information for a set of relationships, objects and managers.

<xs:element name=“SystemDefinitionModel”>
<xs:complexType>
<xs:sequence>
<xs:element name=“Information” type=“Information”
minOccurs=“0”/>
<xs:element name=“Import” type=“Import” minOccurs=“0”
maxOccurs=“unbounded”/>
<xs:element name=“DesignData” type=“DesignData”
minOccurs=“0”/>
<xs:element name=“SettingDefinitions”
type=“SettingDefinitions”
minOccurs=“0”/>
<xs:choice minOccurs=“0” maxOccurs=“unbounded”>
<xs:element name=“CommunicationDefinition”
type=“CommunicationDefinition”/>
<xs:element name=“ContainmentDefinition”
type=“ContainmentDefinition”/>
<xs:element name=“DelegationDefinition”
type=“DelegationDefinition”/>
<xs:element name=“ReferenceDefinition”
type=“ReferenceDefinition”/>
<xs:element name=“HostingDefinition”
type=“HostingDefinition”/>
<xs:element name=“EndpointDefinition”
type=“EndpointDefinition”/>
<xs:element name=“ResourceDefinition”
type=“ResourceDefinition”/>
<xs:element name=“SystemDefinition”
type=“SystemDefinition”/>
<xs:element name=“ConstraintDefinition”
type=“ConstraintDefinition”/>
<xs:element name=“FlowDefinition”
type=“FlowDefinition”/>
<xs:element name=“Manager”
type=“ManagerDeclaration”/>
</xs:choice>
</xs:sequence>
<xs:attributeGroup ref=“NamespaceIdentity”/>
<xs:attribute name=“DocumentLanguage” type=“Culture”/>
</xs:complexType>
</xs:element>

[0811] 3.11.1 Information

[0812] The information section of an SDM document contains human readable information to support identification and management of SDM documents.

<xs:complexType name=“Information”>
<xs:annotation>
<xs:documentation>Human readable information about
the SDM Definition
library.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name=“FriendlyName” type=“xs:string”
minOccurs=“0”/>
<xs:element name=“CompanyName” type=“xs:string”
minOccurs=“0”/>
<xs:element name=“Copyright” type=“xs:string”
minOccurs=“0”/>
<xs:element name=“Trademark” type=“xs:string”
minOccurs=“0”/>
<xs:element name=“Description” type=“Description”
minOccurs=“0”/>
<xs:element name=“Comments” type=“xs:string”
minOccurs=“0”/>
</xs:sequence>
</xs:complexType>

[0813] Example Computer Environment

[0814] FIG. 25 illustrates a general computer environment 800, which can be used to implement the techniques described herein. The computer environment 800 is only one example of a computing environment and is not intended to suggest any limitation as to the scope of use or functionality of the computer and network architectures. Neither should the computer environment 800 be interpreted as having any dependency or requirement relating to any one or combination of components illustrated in the exemplary computer environment 800.

[0815] Computer environment 800 includes a general-purpose computing device in the form of a computer 802. Computer 802 can be, for example, a computing device 102 of FIG. 1, or implement development system 202 or validation component 208 of FIG. 2. The components of computer 802 can include, but are not limited to, one or more processors or processing units 804, a system memory 806, and a system bus 808 that couples various system components including the processor 804 to the system memory 806.

[0816] The system bus 808 represents one or more of any of several types of bus structures, including a memory bus or memory controller, a peripheral bus, an accelerated graphics port, and a processor or local bus using any of a variety of bus architectures. By way of example, such architectures can include an Industry Standard Architecture (ISA) bus, a Micro Channel Architecture (MCA) bus, an Enhanced ISA (EISA) bus, a Video Electronics Standards Association (VESA) local bus, and a Peripheral Component Interconnects (PCI) bus also known as a Mezzanine bus.

[0817] Computer 802 typically includes a variety of computer readable media. Such media can be any available media that is accessible by computer 802 and includes both volatile and non-volatile media, removable and non-removable media.

[0818] The system memory 806 includes computer readable media in the form of volatile memory, such as random access memory (RAM) 810, and/or non-volatile memory, such as read only memory (ROM) 812. A basic input/output system (BIOS) 814, containing the basic routines that help to transfer information between elements within computer 802, such as during start-up, is stored in ROM 812. RAM 810 typically contains data and/or program modules that are immediately accessible to and/or presently operated on by the processing unit 804.

[0819] Computer 802 may also include other removable/non-removable, volatile/non-volatile computer storage media. By way of example, FIG. 25 illustrates a hard disk drive 816 for reading from and writing to a non-removable, non-volatile magnetic media (not shown), a magnetic disk drive 818 for reading from and writing to a removable, non-volatile magnetic disk 820 (e.g., a “floppy disk”), and an optical disk drive 822 for reading from and/or writing to a removable, non-volatile optical disk 824 such as a CD-ROM, DVD-ROM, or other optical media. The hard disk drive 816, magnetic disk drive 818, and optical disk drive 822 are each connected to the system bus 808 by one or more data media interfaces 826. Alternatively, the hard disk drive 816, magnetic disk drive 818, and optical disk drive 822 can be connected to the system bus 808 by one or more interfaces (not shown).

[0820] The disk drives and their associated computer-readable media provide non-volatile storage of computer readable instructions, data structures, program modules, and other data for computer 802. Although the example illustrates a hard disk 816, a removable magnetic disk 820, and a removable optical disk 824, it is to be appreciated that other types of computer readable media which can store data that is accessible by a computer, such as magnetic cassettes or other magnetic storage devices, flash memory cards, CD-ROM, digital versatile disks (DVD) or other optical storage, random access memories (RAM), read only memories (ROM), electrically erasable programmable read-only memory (EEPROM), and the like, can also be utilized to implement the exemplary computing system and environment.

[0821] Any number of program modules can be stored on the hard disk 816, magnetic disk 820, optical disk 824, ROM 812, and/or RAM 810, including by way of example, an operating system 826, one or more application programs 828, other program modules 830, and program data 832. Each of such operating system 826, one or more application programs 828, other program modules 830, and program data 832 (or some combination thereof) may implement all or part of the resident components that support the distributed file system.

[0822] A user can enter commands and information into computer 802 via input devices such as a keyboard 834 and a pointing device 836 (e.g., a “mouse”). Other input devices 838 (not shown specifically) may include a microphone, joystick, game pad, satellite dish, serial port, scanner, and/or the like. These and other input devices are connected to the processing unit 804 via input/output interfaces 840 that are coupled to the system bus 808, but may be connected by other interface and bus structures, such as a parallel port, game port, or a universal serial bus (USB).

[0823] A monitor 842 or other type of display device can also be connected to the system bus 808 via an interface, such as a video adapter 844. In addition to the monitor 842, other output peripheral devices can include components such as speakers (not shown) and a printer 846 which can be connected to computer 802 via the input/output interfaces 840.

[0824] Computer 802 can operate in a networked environment using logical connections to one or more remote computers, such as a remote computing device 848. By way of example, the remote computing device 848 can be a personal computer, portable computer, a server, a router, a network computer, a peer device or other common network node, and the like. The remote computing device 848 is illustrated as a portable computer that can include many or all of the elements and features described herein relative to computer 802.

[0825] Logical connections between computer 802 and the remote computer 848 are depicted as a local area network (LAN) 850 and a general wide area network (WAN) 852. Such networking environments are commonplace in offices, enterprise-wide computer networks, intranets, and the Internet.

[0826] When implemented in a LAN networking environment, the computer 802 is connected to a local network 850 via a network interface or adapter 854. When implemented in a WAN networking environment, the computer 802 typically includes a modem 856 or other means for establishing communications over the wide network 852. The modem 856, which can be internal or external to computer 802, can be connected to the system bus 808 via the input/output interfaces 840 or other appropriate mechanisms. It is to be appreciated that the illustrated network connections are exemplary and that other means of establishing communication link(s) between the computers 802 and 848 can be employed.

[0827] In a networked environment, such as that illustrated with computing environment 800, program modules depicted relative to the computer 802, or portions thereof, may be stored in a remote memory storage device. By way of example, remote application programs 858 reside on a memory device of remote computer 848. For purposes of illustration, application programs and other executable program components such as the operating system are illustrated herein as discrete blocks, although it is recognized that such programs and components reside at various times in different storage components of the computing device 802, and are executed by the data processor(s) of the computer.

[0828] Various modules and techniques may be described herein in the general context of computer-executable instructions, such as program modules, executed by one or more computers or other devices. Generally, program modules include routines, programs, objects, components, data structures, etc. that perform particular tasks or implement particular abstract data types. Typically, the functionality of the program modules may be combined or distributed as desired in various embodiments.

[0829] An implementation of these modules and techniques may be stored on or transmitted across some form of computer readable media. Computer readable media can be any available media that can be accessed by a computer. By way of example, and not limitation, computer readable media may comprise “computer storage media” and “communications media.”

[0830] “Computer storage media” includes volatile and non-volatile, removable and non-removable media implemented in any method or technology for storage of information such as computer readable instructions, data structures, program modules, or other data. Computer storage media includes, but is not limited to, RAM, ROM, EEPROM, flash memory or other memory technology, CD-ROM, digital versatile disks (DVD) or other optical storage, magnetic cassettes, magnetic tape, magnetic disk storage or other magnetic storage devices, or any other medium which can be used to store the desired information and which can be accessed by a computer.

[0831] “Communication media” typically embodies computer readable instructions, data structures, program modules, or other data in a modulated data signal, such as carrier wave or other transport mechanism. Communication media also includes any information delivery media. The term “modulated data signal” means a signal that has one or more of its characteristics set or changed in such a manner as to encode information in the signal. By way of example, and not limitation, communication media includes wired media such as a wired network or direct-wired connection, and wireless media such as acoustic, RF, infrared, and other wireless media. Combinations of any of the above are also included within the scope of computer readable media.

[0832] Alternatively, portions of the framework may be implemented in hardware or a combination of hardware, software, and/or firmware. For example, one or more application specific integrated circuits (ASICs) or programmable logic devices (PLDs) could be designed or programmed to implement one or more portions of the framework.

[0833] Conclusion

[0834] Although the invention has been described in language specific to structural features and/or methodological acts, it is to be understood that the invention defined in the appended claims is not necessarily limited to the specific features or acts described. Rather, the specific features and acts are disclosed as exemplary forms of implementing the claimed invention.

Claims

1. A method comprising: receiving a description of a system being designed; receiving a description of an environment; and using both of the received descriptions to validate the system against the environment while the system is being designed and prior to attempting to deploy the system.

2. A method as recited in claim 1, the description of the system comprising an SDM document.

3. A method as recited in claim 1, the description of the environment comprising a LIM document.

4. A method as recited in claim 1, the system comprising a software application, and the environment comprising a data center.

5. A method as recited in claim 1, the environment comprising an environment where the system is expected to be deployed.

6. One or more computer readable media having stored thereon a plurality of instructions that, when executed by one or more processors, causes the one or more processors to: access a system description that describes a system in the process of being designed by a program running on the one or more processors; and validate the system, using the system description, against a simulated environment.

7. One or more computer readable media as recited in claim 6, the plurality of instructions further causing the processor to: receive, from a requester, a request to validate the system; and return, to the requestor, a result of the validation.

8. One or more computer readable media as recited in claim 6, wherein the instructions that cause the one or more processors to validate the system against the simulated environment further cause the one or more processors to: select a top-level definition from the system description; generate an appropriate instance, as described by the top-level definition, for an instance space; select an additional definition nested within the top-level definition; generate an appropriate instance, as described by the additional definition, for the instance space based on whether the selected definition defines an object or a relationship; and continue the selection of an additional definition and the generation of an appropriate instance, as described by the additional definition, until instances for all of the definitions nested within the top-level definition have been generated for the instance space.

9. One or more computer readable media as recited in claim 6, wherein the instructions that cause the one or more processors to validate the system against the simulated environment further cause the one or more processors to: identify one or more flows in an instance space, the instance space describing the system; for each of at least one of the one or more flows: identify one or more input values for the flow, the input values being obtained from other instances of the instance space; and generate, based at least in part on the input values, an output value for the flow.

10. One or more computer readable media as recited in claim 6, wherein the instructions that cause the one or more processors to validate the system against the simulated environment further cause the one or more processors to: identify one or more constraints in an instance space, the instance space describing the system; check whether the one or more constraints are satisfied; and return, for each of the one or more constraints, a value indicating whether the constraint is satisfied.

11. An apparatus comprising: a loader configured to load one or more documents describing a system, the system being designed when the one or more documents are loaded; a simulator configured to simulate an environment of a data center and validate the system against the environment; and the apparatus being separate from the data center.

12. An apparatus as recited in claim 11, further comprising: an expansion engine to identify a top-level definition from one of the one or more documents and expand the top-level definition to populate an instance space by instantiating members nested in the top-level definition.

13. An apparatus as recited in claim 12, further comprising: a flow engine to identify flows in the instance space, identify the values of inputs to the flows, and setting an output of the flow based on the inputs to the flows.

14. An apparatus as recited in claim 13, further comprising: a constraint engine to identify and evaluate constraints in the instance space.

15. One or more computer readable media having stored thereon a plurality of instructions that, when executed by one or more processors, causes the one or more processors to: access a document that describes a system being designed to be used in an environment of a data center; select a top-level definition from the document; generate an appropriate instance, as described by the top-level definition, for an instance space; select an additional definition nested within the top-level definition; generate an appropriate instance, as described by the additional definition, for the instance space based on whether the selected definition defines an object or a relationship; and continue the selection of an additional definition and the generation of an appropriate instance, as described by the additional definition, until instances for all of the definitions nested within the top-level definition have been generated for the instance space.

16. One or more computer readable media as recited in claim 15, wherein the instructions that cause the one or more processors to generate an appropriate instance, as described by the additional definition, when the selected definition defines a relationship further cause the one or more processors to: identify a number of relationship instances to create based on a number of source instances and a number of target instances involved in the defined relationship; create the identified number of relationship instances; and for each of the created relationship instances, associate source and target instances with the relationship instance.

17. One or more computer readable media as recited in claim 16, the selected definition defining a containment relationship that describes that one instance can be contained in another instance.

18. One or more computer readable media as recited in claim 16, the selected definition defining a communication relationship that describes an interaction between independently deployed software elements.

19. One or more computer readable media as recited in claim 16, the selected definition defining a reference relationship used to capture dependencies between instances.

20. One or more computer readable media as recited in claim 16, the selected definition defining a hosting relationship that associates a host with one or more of its guest member instances.

21. One or more computer readable media as recited in claim 16, the selected definition defining a delegation relationship that associates communication endpoints of two systems.

22. One or more computer readable media as recited in claim 15, wherein the instructions that cause the one or more processors to generate an appropriate instance, as described by the additional definition, when the selected definition defines an object further cause the one or more processors to: identify a minimum number of occurrences of the object as identified in the selected definition; identify a number of instances of the selected definition to generate based on the identified minimum number of occurrences and how many instances of the selected definition have already been generated; and generate the identified number of instances of the selected definition.

23. One or more computer readable media as recited in claim 15, wherein the instructions that cause the one or more processors to generate an appropriate instance, as described by the additional definition, when the selected definition defines an object further cause the one or more processors to: trigger an event that allows a listener to create the appropriate instance as described by the additional information.

24. One or more computer readable media as recited in claim 15, wherein the instructions that cause the one or more processors to generate an appropriate instance, as described by the additional definition, when the selected definition defines a relationship further cause the one or more processors to: trigger an event that allows a listener to create the appropriate instance as described by the additional information.

25. One or more computer readable media as recited in claim 15, wherein the instructions are to be executed prior to beginning deployment of the system in the data center.

26. One or more computer readable media having stored thereon a plurality of instructions that, when executed by one or more processors, causes the one or more processors to: identify one or more flows in an instance space, the instance space describing a system being designed to be used in an environment of a data center; for each of at least one of the one or more flows: identify one or more input values for the flow, the input values being obtained from other instances of the instance space; and generate, based at least in part on the input values, an output value for the flow.

27. One or more computer readable media as recited in claim 26, wherein the instructions that cause the one or more processors to identify one or more input values for the flow further cause the one or more processors to: identify whether the input values have been assigned yet; if the input values have been assigned then obtain the input values from the other instances; if at least one of the input values has not been assigned yet then, for each of the input values that has not been assigned yet: identify one other flow that sets the input value; identify one or more input values for the other flow, the input values being obtained from other instances of the instance space; and generate, based at least in part on the input values, an output value for the other flow.

28. One or more computer readable media as recited in claim 26, wherein the instructions that cause the one or more processors to generate, based at least in part on the input values, the output value for the flow further cause the one or more processors to: identify a set of instructions associated with the flow that can be executed to generate a result; execute the identified set of instructions; and use the generated result as the output value for the flow.

29. One or more computer readable media as recited in claim 26, the system comprising an application to be deployed in the environment.

30. One or more computer readable media as recited in claim 26, the environment comprising a hardware description of a data center.

31. One or more computer readable media as recited in claim 26, wherein the instructions are to be executed prior to beginning deployment of the system in the environment.

32. One or more computer readable media having stored thereon a plurality of instructions that, when executed by one or more processors, causes the one or more processors to: identify one or more constraints in an instance space, the instance space describing a system being designed to be used in an environment of a data center; check whether the one or more constraints are satisfied; and return, for each of the one or more constraints, a value indicating whether the constraint is satisfied.

33. One or more computer readable media as recited in claim 32, the one or more constraints including a setting constraint, a relationship constraint, and an object constraint.

34. One or more computer readable media as recited in claim 32, wherein the instructions that cause the one or more processors to check whether the one or more constraints are satisfied further cause the one or more processors to, for one of the constraints: identify a set of instructions associated with the constraint that can be executed to generate a result; execute the identified set of instructions; and use the generated result as the value returned indicating whether the constraint is satisfied.

35. One or more computer readable media as recited in claim 32, wherein the instructions that cause the one or more processors to check whether the one or more constraints are satisfied further cause the one or more processors to, for one of the constraints: identify a role and an object definition for a target instance of the constraint; check whether the role and the object definition of the constraint match the role and the object definition of the target instance; and generate, based on whether the role and the object definition of the constraint match the role and the object definition of the target instance, the value returned indicating whether the constraint is satisfied.

36. One or more computer readable media as recited in claim 35, wherein the instructions that cause the one or more processors to check whether the one or more constraints are satisfied further cause the one or more processors to, for the one of the constraints: identify a secondary role and a secondary object definition for the target instance of the constraint; check whether the secondary role and the secondary object definition of the constraint match the role and the object definition of the target instance; and generate, based on whether the role and the object definition of the constraint match both the role and the object definition of the target instance and the secondary role and the secondary object definition of the target instance, the value returned indicating whether the constraint is satisfied.

37. One or more computer readable media as recited in claim 35, wherein the instructions that cause the one or more processors to check whether the one or more constraints are satisfied further cause the one or more processors to, for the one of the constraints: evaluate one or more nested constraints for the target instance; receive one or more return values for the nested constraints, the one or more return values indicating whether the one or more nested constraints are satisfied; and generate, based on the one or more return values for the nested constraints, the value returned indicating whether the constraint is satisfied.

38. One or more computer readable media as recited in claim 32, wherein the instructions that cause the one or more processors to return, for each of the one or more constraints, a value indicating whether the constraint is satisfied further cause the one or more processors to, for one of the constraints: if a value indicating that the constraint is not satisfied is to be returned, then check whether an error message is to be generated for the constraint; and if the error message is to be generated, then generate the error message including information identifying the constraint.

39. One or more computer readable media as recited in claim 32, wherein the instructions that cause the one or more processors to check whether the one or more constraints are satisfied further cause the one or more processors to, for one of the constraints: initialize a match count variable; identify one or more relationship instances that the target instance of the constraint participates in; evaluate, for each of the one or more relationship instances, whether the relationship instance satisfies the constraint; increment the match count variable for each of the one or more relationship instances that satisfies the constraint; and generate, based on the value of the match count variable after the one or more relationship instances have been evaluated, the value returned indicating whether the constraint is satisfied.

40. One or more computer readable media as recited in claim 39, wherein the instructions that cause the one or more processors to evaluate, for each of the one or more relationship instances, whether the relationship instance satisfies the constraint further cause the one or more processors to, for the one of the constraints: check whether a relationship definition of the constraint matches a relationship definition of the relationship instance; check whether a direction of the constraint matches a direction of the relationship instance; check whether all nested constraints for the relationship instance are satisfied; and return a value indicating that the constraint is satisfied only if the relationship definition of the constraint matches the relationship definition of the relationship instance, the direction of the constraint matches the direction of the relationship instance, and all nested constraints for the relationship instance are satisfied.

41. One or more computer readable media as recited in claim 39, wherein the instructions that cause the one or more processors to evaluate, for each of the one or more relationship instances, whether the relationship instance satisfies the constraint further cause the one or more processors to, for the one of the constraints: check whether a target object of the constraint matches an instance at the other end of the relationship instance; and return a value indicating that the constraint is satisfied only if the relationship definition of the constraint matches the relationship definition of the relationship instance, the direction of the constraint matches the direction of the relationship instance, all nested constraints for the relationship instance are satisfied, and the target object of the constraint matches the instance at the other end of the relationship instance.

42. One or more computer readable media as recited in claim 39, wherein the instructions that cause the one or more processors to generate, based on the value of the match count variable after the one or more relationship instances have been evaluated, the value returned indicating whether the constraint is satisfied further cause the one or more processors to, for one of the constraints: check whether the match count variable is at least a minimum value of the constraint but is not greater than a maximum value of the constraint; and generate the value returned indicating that the constraint is satisfied if the match count variable is at least the minimum value of the constraint but is not greater than the maximum value of the constraint, otherwise generate the value returned indicating that the constraint is not satisfied.

43. One or more computer readable media as recited in claim 32, wherein the instructions are to be executed prior to beginning deployment of the system in the environment.