Appendix F: Prerequisites Schema

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2, Windows Server 2008, Windows Server Update Services

The prerequisites.xml file is used to define the prerequisites for an installation. The schema is described in the following section

Prerequisites Schema

The elements of the prerequisites schema are listed in the following table.

Schema Element Description

PrereqResults

Root element.

Result

The result of a single prerequisite check. There may be 0…nResult elements, one for each prerequisite.

Status

The localized description of the status code.

Check

The product or component to be checked.

Components

The component(s) for which this is a prerequisite. There may be 0…nComponent elements in a Components element.

Component

One of the component(s) for which this is a prerequisite.

Description

The description of the problem.

Resolution

The way the customer may resolve the problem.

In addition, the Result element has an attribute StatusCode. The possible values of StatusCode are 0 (success), 1 (error), 2 (warning).

Example

The following is an example of a prerequisites.xml file.

<?xml version="1.0" encoding="utf-8"?>
<PrereqResults>
    <Result StatusCode="0">
        <Status>Passed</Status>
        <Check> Microsoft Windows Server 2003 Server </Check>
        <Components>
            <Component>Windows Server Update Services</Component>
        </Components>
    </Result>
    <Result StatusCode="1">
        <Status>Failed</Status>
        <Check>SQL Server 2005</Check>
        <Components>
            <Component>Windows Server Update Services</Component>
        </Components>
        <Description>SQL Server 2005 or later not detected</Description>
        <Resolution>Download the required version from https://www.microsoft.com/downloads/</Resolution>
    </Result>
    <Result StatusCode="1">
        <Status>Warning</Status>
        <Check>SQLINSTANCE_NAME</Check>
        <Components>
            <Component>Windows Server Update Services</Component>
        </Components>
       <Description>This database version can not be upgraded.  Version is too old.</Description>
        <Resolution>Choose another location for the database to keep this one otherwise this database will be overridden.</Resolution>
    </Result>
    …
</PrereqResults>