xref: /titanic_51/usr/src/cmd/isns/isnsd/xml_def/isnsmgmtSchema.xsd (revision fcf3ce441efd61da9bb2884968af01cb7c1452cc)

<?xml version="1.0" encoding="UTF-8"?>

<!--

        CDDL HEADER START

        The contents of this file are subject to the terms of the
        Common Development and Distribution License (the "License").
        You may not use this file except in compliance with the License.

        You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
        or http://www.opensolaris.org/os/licensing.
        See the License for the specific language governing permissions
        and limitations under the License.

        When distributing Covered Code, include this CDDL HEADER in each
        file and include the License file at usr/src/OPENSOLARIS.LICENSE.
        If applicable, add the following below this CDDL HEADER, with the
        fields enclosed by brackets "[]" replaced with your own identifying
        information: Portions Copyright [yyyy] [name of copyright owner]

        CDDL HEADER END

        Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
        Use is subject to license terms.


-->

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            targetNamespace="http://www.sun.com/schema/isnsmanagement"
            xmlns:isns="http://www.sun.com/schema/isnsmanagement"
            elementFormDefault="qualified">

    <!--
        Object type names that are asspcoated with isns Object,
        Discovery Domain, Discovery Domain Set, Node.
    -->
    <xsd:element name="isnsObjectType">
        <xsd:simpleType>
            <xsd:restriction base="xsd:string">
                <xsd:enumeration value="DiscoveryDomainSet"></xsd:enumeration>
                <xsd:enumeration value="DiscoveryDomain"></xsd:enumeration>
                <xsd:enumeration value="Node"></xsd:enumeration>
            </xsd:restriction>
        </xsd:simpleType>
    </xsd:element>

    <!--
        Association type name for Discovery Domain membership and Discovery
        Domain Set membership.
    -->
    <xsd:element name="AssociationType">
        <xsd:simpleType>
            <xsd:restriction base="xsd:string">
                <xsd:enumeration value="DiscoveryDomainMember"/>
                <xsd:enumeration value="DiscoveryDomainSetMember"/>
            </xsd:restriction>
        </xsd:simpleType>
    </xsd:element>

    <!--
        Discovery Domain object.
        Attribute name represent DD Symbolic Name defined in the iSNS spec.
        Group isnsDDAttrGroup represents other attrtibutes defined in the
        iSNS spec.
        Note that the existence of isnsDDAttrGroup is made as optional.
    -->
    <xsd:element name="DiscoveryDomain">
        <xsd:complexType>
            <xsd:group ref="isns:isnsDDAttrGroup" minOccurs="0"/>
            <xsd:attribute name="name" type="xsd:string" use="required"/>
            <xsd:attribute name="id" type="xsd:positiveInteger" use="optional"/>
            <xsd:attribute name="nodeCount" type="xsd:nonNegativeInteger" use="optional"/>
        </xsd:complexType>
    </xsd:element>
    <xsd:group name="isnsDDAttrGroup">
        <xsd:sequence>
            <xsd:element name="BootList_Enabled" type="xsd:boolean"/>
        </xsd:sequence>
    </xsd:group>

    <!--
        Discovery Domain Set object.
        Attribute name represent DD Set Symbolic Name defined in the iSNS spec.
        Group isnsDDsetAttrGroup represents other attrtibutes defined in the
        iSNS spec.
        Note that the existence of isnsDDsetAttrGroup is made as optional.
    -->
    <xsd:element name="DiscoveryDomainSet">
        <xsd:complexType>
            <xsd:group ref="isns:isnsDDsetAttrGroup" minOccurs="0"/>
            <xsd:attribute name="name" type="xsd:string" use="required"/>
            <xsd:attribute name="id" type="xsd:positiveInteger" use="optional"/>
        </xsd:complexType>
    </xsd:element>
    <xsd:group name="isnsDDsetAttrGroup">
        <xsd:sequence>
            <xsd:element name="Enabled" type="xsd:boolean"/>
        </xsd:sequence>
    </xsd:group>

    <!--
       isnsServer object for administratively configurable setting.
    -->
    <xsd:element name="isnsServer">
        <xsd:complexType>
            <xsd:group ref="isns:isnsServerAttrGroup" minOccurs="0"/>
        </xsd:complexType>
    </xsd:element>

    <xsd:group name="isnsServerAttrGroup">
        <xsd:sequence>
                <xsd:element name="datastoreLocation" type="xsd:string"></xsd:element>
                <xsd:element name="esiRetryThreshold" type="xsd:nonNegativeInteger"></xsd:element>
                <xsd:element name="managementSCNEnabled" type="xsd:boolean"></xsd:element>
                <xsd:element name="controlNodeName" type="xsd:string" nillable="true"></xsd:element>
        </xsd:sequence>
    </xsd:group>

    <!--
        Node object. Attribute name represent iSCSI name for a node
        defined in the iSNS spec.
        Group isnsNodeAttrGroup represents other attrtibutes including
        Network Entity, Portal and Portal Group Tag.
        Note that the existence of isnsNodeAttrGroup is made as optional.
    -->
    <xsd:element name="Node">
        <xsd:complexType>
            <xsd:group ref="isns:isnsNodeAttrGroup" minOccurs="0"/>
            <xsd:attributeGroup ref="isns:nodeAttrs"/>
        </xsd:complexType>
    </xsd:element>

    <!--
       Attributes for Node object.
       name and nodeType are specified.
       Both attributes are required.
    -->
    <xsd:attributeGroup name="nodeAttrs">
        <xsd:attribute name="name" type="xsd:string" use="required"/>
        <xsd:attribute name="alias" type="xsd:string"/>
        <!--
           Add support for management clients needing XML documents
           with properties representing whether or not the given node is
           assigned or not, is registered or not, and a status timestamp stating
           when the last time this information was determined.

           @todo Since these properties are client-specific, we want to factor
           them out into a separate schema that includes and extends this one.
           Since this task has proven difficult in the short term, we defer this
           until a future product cycle.
        -->
        <xsd:attribute name="assigned" type="xsd:boolean" use="optional"/>
        <xsd:attribute name="registered" type="xsd:boolean" use="optional"/>
        <xsd:attribute name="timestamp" type="xsd:string" use="optional"/>
        <xsd:attribute name="type">
            <xsd:simpleType>
                <xsd:restriction base="xsd:string">
                    <xsd:enumeration value="Target"/>
                    <xsd:enumeration value="Initiator"/>
                    <xsd:enumeration value="Control"/>
                    <xsd:enumeration value="Unknown"/>
                    <xsd:enumeration value="Control/Target"/>
                    <xsd:enumeration value="Control/Initiator"/>
                </xsd:restriction>
            </xsd:simpleType>
        </xsd:attribute>
    </xsd:attributeGroup>

    <!--
       Child elements for Node object.
    -->
    <xsd:group name="isnsNodeAttrGroup">
        <xsd:sequence>
            <xsd:element name="SCN_Subscription" minOccurs="0" maxOccurs="8">
                <xsd:simpleType>
                    <xsd:restriction base="xsd:string">
                        <xsd:enumeration value="Initiator and Self information only"/>
                        <xsd:enumeration value="Target and Self information only"/>
                        <xsd:enumeration value="Management Registration/SCN"/>
                        <xsd:enumeration value="Object Removed"/>
                        <xsd:enumeration value="Object Added"/>
                        <xsd:enumeration value="Object Updated"/>
                        <xsd:enumeration value="DD/DD-Set Member Removed"/>
                        <xsd:enumeration value="DD/DD-Set Member Added"/>
                    </xsd:restriction>
                </xsd:simpleType>
            </xsd:element>
            <!--
                Network Entity attributes
            -->
            <xsd:element name="Network_Entity">
                <xsd:complexType>
                    <xsd:sequence>
                    <xsd:element name="Entity_ID">
                        <xsd:simpleType>
                            <xsd:restriction base="xsd:string">
                                <xsd:minLength value="4"/>
                                <xsd:maxLength value="256"/>
                            </xsd:restriction>
                       </xsd:simpleType>
                    </xsd:element>
                    <xsd:element name="Entity_Protocol" type="xsd:integer" minOccurs="0"></xsd:element>
                    <xsd:element name="Management_IP_Addr" minOccurs="0">
                        <xsd:simpleType>
                            <xsd:restriction base="xsd:string">
                                <xsd:maxLength value="46"/>
                            </xsd:restriction>
                        </xsd:simpleType>
                    </xsd:element>
                    <xsd:element name="Entity_Reg_Timestamp" type="xsd:unsignedLong" minOccurs="0"/>
                    <xsd:element name="Protocol_Version_Range" minOccurs="0">
                        <xsd:complexType>
                            <xsd:sequence>
                                <xsd:element name="minVersion" type="xsd:unsignedShort"/>
                                <xsd:element name="maxVersion" type="xsd:unsignedShort"/>
                            </xsd:sequence>
                        </xsd:complexType>
                    </xsd:element>
                    <xsd:element name="Registration_Period" type="xsd:unsignedInt" minOccurs="0"/>
                </xsd:sequence>
            </xsd:complexType>
            </xsd:element>

           <!--
                Portal attributes including Portal Group Tag
           -->

            <xsd:element name="Portal" maxOccurs="unbounded" >
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element name="IP_Addr">
                            <xsd:simpleType>
                                <xsd:restriction base="xsd:string">
                                    <xsd:maxLength value="46"/>
                                </xsd:restriction>
                            </xsd:simpleType>
                        </xsd:element>
                        <xsd:element name="UDP_TCP_port">
                            <xsd:complexType>
                                <xsd:sequence>
                                    <xsd:element name="Port_Type">
                                        <xsd:simpleType>
                                            <xsd:restriction base="xsd:string">
                                                <xsd:enumeration value="TCP"/>
                                                <xsd:enumeration value="UDP"/>
                                            </xsd:restriction>
                                        </xsd:simpleType>
                                    </xsd:element>
                                    <xsd:element name="Port_Number" type="xsd:unsignedShort"/>
                                </xsd:sequence>
                            </xsd:complexType>
                        </xsd:element>
                        <xsd:element name="Group_Tag">
                            <xsd:simpleType>
                                <xsd:restriction base="xsd:nonNegativeInteger">
                                    <xsd:maxInclusive value="65535"/>
                                </xsd:restriction>
                            </xsd:simpleType>
                        </xsd:element>
                        <xsd:element name="Symbolic_Name" minOccurs="0">
                            <xsd:simpleType>
                                <xsd:restriction base="xsd:string">
                                    <xsd:maxLength value="256"/>
                                </xsd:restriction>
                            </xsd:simpleType>
                        </xsd:element>
                        <xsd:element name="ESI_Interval" type="xsd:positiveInteger" minOccurs="0"/>
                        <xsd:element name="ESI_Port" minOccurs="0">
                            <xsd:complexType>
                                <xsd:sequence>
                                    <xsd:element name="Port_Type">
                                        <xsd:simpleType>
                                            <xsd:restriction base="xsd:string">
                                                <xsd:enumeration value="TCP"/>
                                                <xsd:enumeration value="UDP"/>
                                            </xsd:restriction>
                                        </xsd:simpleType>
                                    </xsd:element>
                                    <xsd:element name="Port_Number" type="xsd:unsignedShort"/>
                                </xsd:sequence>
                            </xsd:complexType>
                            </xsd:element>
                        <xsd:element name="SCN_Port" minOccurs="0">
                            <xsd:complexType>
                                <xsd:sequence>
                                    <xsd:element name="Port_Type">
                                        <xsd:simpleType>
                                            <xsd:restriction base="xsd:string">
                                                <xsd:enumeration value="TCP"/>
                                                <xsd:enumeration value="UDP"/>
                                            </xsd:restriction>
                                        </xsd:simpleType>
                                    </xsd:element>
                                    <xsd:element name="Port_Number" type="xsd:unsignedShort"/>
                                </xsd:sequence>
                            </xsd:complexType>
                        </xsd:element>
                   </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
        </xsd:sequence>
    </xsd:group>

    <!--
        Discovery Domain Membership Association.
        Attribute DDName represents Discovery Domain name and NodeName
        a node name to indicate the association pair.
        Note that the element has only attributes.
    -->
    <xsd:element name="DiscoveryDomainMember">
        <xsd:complexType>
            <xsd:attribute name="DDName" type="xsd:string" use="required"/>
            <xsd:attribute name="NodeName" type="xsd:string" use="required"/>
        </xsd:complexType>
    </xsd:element>

    <!--
        Discovery Domain Set Membership Association.
        Attribute DDName represents Discovery Domain name and DDsetName
        Discovery Domain Set name to indicate the association pair.
        Note that the element has only attributes.
    -->
    <xsd:element name="DiscoveryDomainSetMember">
        <xsd:complexType>
            <xsd:attribute name="DDName" type="xsd:string" use="required"/>
            <xsd:attribute name="DDsetName" type="xsd:string" use="required"/>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="Association">
        <xsd:complexType>
            <xsd:choice>
                <xsd:element ref="isns:DiscoveryDomainMember"/>
                <xsd:element ref="isns:DiscoveryDomainSetMember"/>
            </xsd:choice>
        </xsd:complexType>
    </xsd:element>

    <!--
        Super element for iSNS object, Discovery Domain, Disocvery Domain
        set and Node.
    -->
    <xsd:element name="isnsObject">
        <xsd:complexType>
            <xsd:choice>
                <xsd:element ref="isns:Node"/>
                <xsd:element ref="isns:DiscoveryDomain"/>
                <xsd:element ref="isns:DiscoveryDomainSet"/>
            </xsd:choice>
        </xsd:complexType>
    </xsd:element>


    <!--
        Result element represent the response value for an isns request
        operation including status and error information.
    -->
    <xsd:element name="result">
        <xsd:complexType>
            <xsd:sequence>
                <xsd:element name="status" type="xsd:integer" minOccurs="1"/>
                <xsd:element name="message" minOccurs="0" nillable="false">
                    <xsd:simpleType>
                        <xsd:restriction base="xsd:string">
                            <xsd:whiteSpace value="preserve"/>
                        </xsd:restriction>
                    </xsd:simpleType>
                </xsd:element>
            </xsd:sequence>
        </xsd:complexType>
     </xsd:element>

     <!--
        Request operations for iSNS management applicatioin.
        Any of request can be included multiple times.
     -->
     <xsd:element name="isnsRequest">
         <xsd:complexType>
             <xsd:sequence>
                 <xsd:element name="description" type="xsd:string" minOccurs="0"/>
                 <xsd:choice maxOccurs="1">

                 <!--
                    get operation returns details of a given iSNS object instance.

                    input: an object instance.  Specifying only the name
                        attribute of an isnsObject insance will be sufficient
                        for the server to serve the request.
                        Ex) <get
                    output: an object instance with fully populated
                        isns{Node|Discveroy_Domain|Discovery_Domain_Set]AttrGroup
                        or error info when there is failure.
                 -->
                    <xsd:element name="get">
                         <xsd:complexType>
                             <xsd:choice>
                                <xsd:element ref="isns:isnsObject" maxOccurs="unbounded"/>
                                <xsd:element ref="isns:isnsServer" maxOccurs="1"/>
                             </xsd:choice>
                         </xsd:complexType>
                    </xsd:element>

                <!--
                    getAssociated operation returns a list of object
                    instances that are asscoiated with the given Association
                    type name and a given object instance.

                    input: an Association type name and an object instance.
                        Specifying the name attribute is sufficient for
                        the request.
                        Ex) <get
                    output: a list of object instances which is assciated with
                        the given object instance through the given association.

                        When there is failure for the request, error info will
                        be returned.
                -->
                     <xsd:element name="getAssociated">
                         <xsd:complexType>
                             <xsd:sequence maxOccurs="unbounded">
                                 <xsd:element ref="isns:AssociationType"/>
                                 <xsd:element ref="isns:isnsObject"/>
                             </xsd:sequence>
                         </xsd:complexType>
                     </xsd:element>

                         <!--
                    create operation either creates a new object instance
                    or modify an object instance if the name of the given object
                    instance already exists.

                    input: an object instance with fully populated
                        isns{Node|Discveroy_Domain|Discovery_Domain_Set]AttrGroup

                    output: status
                -->
                     <xsd:element name="createModify">
                         <xsd:complexType>
                             <xsd:choice>
                                 <xsd:element ref="isns:DiscoveryDomainMember" maxOccurs="unbounded" />
                                 <xsd:element ref="isns:DiscoveryDomain" maxOccurs="unbounded"/>
                                 <xsd:element ref="isns:DiscoveryDomainSetMember" maxOccurs="unbounded"/>
                                 <xsd:element ref="isns:DiscoveryDomainSet" maxOccurs="unbounded"/>
                             </xsd:choice>
                         </xsd:complexType>
                     </xsd:element>


                         <!--
                    delete operation delete the given object instance.

                    input: an object instance.  Specifying only the name
                        attribute of an isnsObject insance will be sufficient
                        for the server to serve the request.
                        Ex) <get
                    output: status
                -->
                     <xsd:element name="delete">
                         <xsd:complexType>
                             <xsd:choice>
                                 <xsd:element ref="isns:DiscoveryDomain" maxOccurs="unbounded"/>
                                 <xsd:element ref="isns:DiscoveryDomainSet" maxOccurs="unbounded"/>
                                 <xsd:element ref="isns:DiscoveryDomainMember" maxOccurs="unbounded"/>
                                 <xsd:element ref="isns:DiscoveryDomainSetMember" maxOccurs="unbounded"/>
                             </xsd:choice>
                         </xsd:complexType>
                     </xsd:element>

               <!--
                    enumerate operation returns a list of object instances for the
                    given object type.

                    input: an object type name.
                        Ex) <get
                    output: a list of object instances for the given obect type
                    or error info when there is failure.
                -->
                     <xsd:element name="enumerate">
                         <xsd:complexType>
                             <xsd:sequence>
                                 <xsd:element ref="isns:isnsObjectType"/>
                             </xsd:sequence>
                         </xsd:complexType>
                     </xsd:element>
                     </xsd:choice>
             </xsd:sequence>
         </xsd:complexType>
    </xsd:element>


   <!--
       isnsResponse returns either object instance information or
       status.

       When the request is 'get'
            the response should be fully populated an obejct instance.
       When the request is createModify or delete
            the response should be status.
       When the request is getAssociated or enumerate
            the response should be a list of an object instance
            with name attribute set.
    -->

    <xsd:element name="isnsResponse">
        <xsd:complexType>
            <xsd:sequence>
            <xsd:element name="description" type="xsd:string" minOccurs="0"/>
            <xsd:element ref="isns:result" maxOccurs="1" minOccurs="1"/>
            <xsd:choice minOccurs="0">
                <xsd:element ref="isns:isnsObject" maxOccurs="unbounded" minOccurs="0"/>
                <xsd:element ref="isns:isnsServer" maxOccurs="1" minOccurs="0"/>
                <xsd:element ref="isns:Association" maxOccurs="unbounded" minOccurs="0"/>
            </xsd:choice>
            </xsd:sequence>
        </xsd:complexType>
    </xsd:element>
</xsd:schema>