ConfigurationManagement:2 Service Template Version 1 ConfigurationManagement:2 Service Template Version

Embed Size (px)

Text of ConfigurationManagement:2 Service Template Version 1 ConfigurationManagement:2 Service Template...

  • ConfigurationManagement:2 Service Template Version 1.01 For UPnP Version 1.0 Status: Standardized DCP (SDCP) Date: March 4th, 2013

    This Standardized DCP has been adopted as a Standardized DCP by the Steering Committee of the UPnP Forum, pursuant to Section 2.1(c)(ii) of the UPnP Forum Membership Agreement. UPnP Forum Members have rights and licenses defined by Section 3 of the UPnP Forum Membership Agreement to use and reproduce the Standardized DCP in UPnP Compliant Devices. All such use is subject to all of the provisions of the UPnP Forum Membership Agreement.

    THE UPNP FORUM TAKES NO POSITION AS TO WHETHER ANY INTELLECTUAL PROPERTY RIGHTS EXIST IN THE STANDARDIZED DCPS. THE STANDARDIZED DCPS ARE PROVIDED "AS IS" AND "WITH ALL FAULTS". THE UPNP FORUM MAKES NO WARRANTIES, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE STANDARDIZED DCPS, INCLUDING BUT NOT LIMITED TO ALL IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT AND FITNESS FOR A PARTICULAR PURPOSE, OF REASONABLE CARE OR WORKMANLIKE EFFORT, OR RESULTS OR OF LACK OF NEGLIGENCE.

    © 2012 UPnP Forum. All Rights Reserved.

    Authors Company

    André Bottaro France Telecom Group

    Enrico Grosso Telecom Italia

    Levent Gurgen France Telecom Group

    William Lupton 2Wire / Pace

    Davide Moreo (Editor) Telecom Italia

    François-Gaël Ottogalli France Telecom Group

    Xavier Roubaud France Telecom Group

    Kiran Vedula Samsung Electronics * Note: The UPnP Forum in no way guarantees the accuracy or completeness of this author list and in no way implies any rights for or support from those members listed. This list is not the specifications’ contributor list that is kept on the UPnP Forum’s website.

  • ConfigurationManagement:2 Service Template Version 1.01 2

    Copyright UPnP Forum © 2012. All rights reserved.

    Contents

    1.  OVERVIEW AND SCOPE .................................................................................................................. 6 

    1.1.  INTRODUCTION ................................................................................................................................. 6  1.2.  REFERENCES..................................................................................................................................... 7  1.3.  GLOSSARY ........................................................................................................................................ 8  1.4.  NOTATION ........................................................................................................................................ 8 

    1.4.1.  Data Types ............................................................................................................................... 9  1.4.2.  Strings Embedded in Other Strings ......................................................................................... 9 

    1.5.  DERIVED DATA TYPES ................................................................................................................... 10  1.5.1.  Comma Separated Value (CSV) Lists .................................................................................... 10  1.5.2.  Embedded XML Documents .................................................................................................. 12 

    1.6.  MANAGEMENT OF XML NAMESPACES IN STANDARDIZED DCPS ................................................... 12  1.6.1.  Namespace Names, Namespace Versioning and Schema Versioning ................................... 14  1.6.2.  Namespace Usage Examples ................................................................................................. 16 

    1.7.  VENDOR DEFINED EXTENSIONS ..................................................................................................... 17 

    2.  SERVICE MODELING DEFINITIONS .......................................................................................... 18 

    2.1.  SERVICETYPE ................................................................................................................................. 18  2.2.  KEY CONCEPTS .............................................................................................................................. 18 

    2.2.1.  Data Model Management Basics ........................................................................................... 18  2.2.2.  Security .................................................................................................................................. 19  2.2.3.  Alarming ................................................................................................................................ 19 

    2.3.  SYNTAX FOR PARAMETER NAMES ................................................................................................... 20  2.3.2.  Attributes ............................................................................................................................... 24  2.3.3.  Instance Nodes as Primary Keys and Unique Keys Extension .............................................. 34  2.3.4.  Time stamps ........................................................................................................................... 35 

    2.4.  SECURITY FEATURE........................................................................................................................ 35  2.4.1.  ACLs ...................................................................................................................................... 35  2.4.2.  Hierarchy of ACLs ................................................................................................................. 36  2.4.3.  ACLs for Instance and InstanceAlias Nodes ......................................................................... 37  2.4.4.  Dynamic creation of ACLs for Instance Nodes ..................................................................... 39  2.4.5.  Requirements for ACLs .......................................................................................................... 40  2.4.6.  Roles for the examples ........................................................................................................... 42  2.4.7.  Representations of ACL ......................................................................................................... 43  2.4.8.  Device Requirements ............................................................................................................. 47 

    2.5.  STATE VARIABLES ......................................................................................................................... 48  2.5.1.  ConfigurationUpdate ............................................................................................................. 50  2.5.2.  CurrentConfigurationVersion ............................................................................................... 51  2.5.3.  SupportedDataModelsUpdate ............................................................................................... 51  2.5.4.  SupportedParametersUpdate ................................................................................................ 52  2.5.5.  AttributeValuesUpdate .......................................................................................................... 52  2.5.6.  InconsistentStatus .................................................................................................................. 53  2.5.7.  AlarmsEnabled ...................................................................................................................... 54  2.5.8.  A_ARG_TYPE_StructurePath ............................................................................................... 55  2.5.9.  A_ARG_TYPE_StructurePathList ......................................................................................... 55  2.5.10.  A_ARG_TYPE_PartialPath ................................................................................................... 56  2.5.11.  A_ARG_TYPE_ParameterValueList ..................................................................................... 56  2.5.12.  A_ARG_TYPE_NodeAttributeValueList ................................................................................ 57  2.5.13.  A_ARG_TYPE_ParameterInitialValueList ............................................................................ 58  2.5.14.  A_ARG_TYPE_Filter............................................................................................................. 59  2.5.15.  A_ARG_TYPE_SupportedDataModels ................................................................................. 60  2.5.16.  A_ARG_TYPE_SearchDepth ................................................................................................. 63  2.5.17.  A_ARG_TYPE_ChangeStatus ............................................................................................... 63 

  • ConfigurationManagement:2 Service Template Version 1.01 3

    Copyright UPnP Forum © 2012. All rights reserved.

    2.5.18.  A_ARG_TYPE_InstancePathList ........................................................................................... 63  2.5.19.  A_ARG_TYPE_ContentPathList ........................................................................................... 64  2.5.20.  A_ARG_TYPE_MultiInstancePath ........................................................................................ 65  2.5.21.  A_ARG_TYPE_InstancePath................................................................................................. 65  2.5.22.  A_ARG_TYPE_NodeAttributePathList ............