Broadband Forum

TR-140 Amendment 1 Data Model Definition (changes)

Table of Contents

Data Types

The parameters defined in this specification make use of a limited subset of the default SOAP data types [SOAP1.1]. The complete set of data types, along with the notation used to represent these types, is listed in Section 3.2 / [TR-106a2]. The following named data types are used by this specification.

Data Type Base Type Description
IPAddress string All IPv4 addresses and subnet masks are represented as strings in IPv4 dotted-decimal notation. All IPv6 addresses and subnet masks MUST be represented using any of the 3 standard textual representations as defined in RFC 3513 Sections 2.2.1, 2.2.2 and 2.2.3 / [RFC3513]. Both lower-case and upper-case letters can be used. Use of the lower-case letters is RECOMMENDED. Examples of valid IPv6 address textual representations:

  • 1080:0:0:800:ba98:3210:11aa:12dd
  • 1080::800:ba98:3210:11aa:12dd
  • 0:0:0:0:0:0:13.1.68.3

Unspecified or inapplicable IP addresses and subnet masks MUST be represented as empty strings unless otherwise specified by the parameter definition.

MACAddress string All MAC addresses are represented as strings of 12 hexadecimal digits (digits 0-9, letters A-F or a-f) displayed as six pairs of digits separated by colons. Unspecified or inapplicable MAC addresses MUST be represented as empty strings unless otherwise specified by the parameter definition.

References

[SOAP1.1] Simple Object Access Protocol (SOAP) 1.1, W3C.
[TR-106a2] TR-106 Amendment 2, Data Model Template for TR-069-Enabled Devices, Broadband Forum, 2008.

StorageService:1.1 Data Model (changes)

For a given implementation of this data model, the CPE MUST indicate support for the highest version number of any object or parameter that it supports. For example, even if the CPE supports only a single parameter that was introduced in version 1.1, then it will indicate support for version 1.1. The version number associated with each object and parameter is shown in the Version column.

Name Type Write Description Object Default Version
StorageServiceNumberOfEntries unsignedInt - Number of entries in StorageService. - 1.1
StorageService.{i}. object - The Service Object for a Storage Service device. - 1.0
StorageService.{i}.LogicalVolume.{i}. object W This object provides information about each logical volume configured on this device. A logical volume can reside either on an instance of a single PhysicalMedium.{i}. or on an instance of a single StorageArray.{i}. instance, but it can not span multiple instances of either. PhysicalReference is used to define where this LogicalVolume instance resides.

Creating an instance of this object generates a disabled LogicalVolume instance. Before this new LogicalVolume instance can be enabled (via a SetParameterValues command), it MUST have the following parameters configured: Name, PhysicalReference, and Capacity. Once an instance is enabled the following parameters become immutable for the life of the instance: Name, PhysicalReference, and Capacity.

At most one enabled entry in this table can exist with a given value for Name.

- 1.0
StorageService.{i}.LogicalVolume.{i}.Folder.{i}. object W This object provides information about each top-level folder configured on this logical volume. Each top-level folder allows the configuration of quotas and access permissions.

Creating an instance of this object generates a disabled Folder instance. Before this new Folder instance can be enabled (via a SetParameterValues command), it MUST have the Name configured. Folder instances are unique per LogicalVolume.{i}. and the unique key for this object is Name which also means that once an instance is enabled Name becomes immutable for the life of the instance.

At most one enabled entry in this table can exist with a given value for Name.

- 1.0
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.UserAccess.{i}. object W This object provides information about each user account configured for access permissions on this folder.

At most one enabled entry in this table can exist with a given value for UserReference.

- 1.0
Enable boolean W Enables or disables the entry. False 1.1
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.GroupAccess.{i}. object W This object provides information about each user group configured for access permissions on this folder.

At most one enabled entry in this table can exist with a given value for GroupReference.

- 1.0
Enable boolean W Enables or disables the entry.

The factory default value MUST be False.

- 1.1

Inform and Notification Requirements

Forced Inform Parameters

Parameter

Forced Active Notification Parameters

Parameter

Default Active Notification Parameters

Parameter

Parameters for which Active Notification MAY be Denied

Parameter

Profile Definitions

Notation

The following abbreviations are used to specify profile requirements:

Abbreviation Description
R Read support is REQUIRED.
W Both Read and Write support is REQUIRED. This MUST NOT be specified for a parameter that is defined as read-only.
P The object is REQUIRED to be present.
C Creation and deletion of instances of the object via AddObject and DeleteObject is REQUIRED.
A Creation of instances of the object via AddObject is REQUIRED, but deletion is not REQUIRED.
D Deletion of instances of the object via DeleteObject is REQUIRED, but creation is not REQUIRED.

Baseline:2 Profile

The Baseline:2 profile for the StorageService:1 object is defined as the union of the Baseline:1 profile and the additional requirements defined in this table. The minimum REQUIRED version for this profile is StorageService:1.1.

Name Requirement
StorageServiceNumberOfEntries R

UserAccess:2 Profile

The UserAccess:2 profile for the StorageService:1 object is defined as the union of the UserAccess:1 profile and the additional requirements defined in this table. The minimum REQUIRED version for this profile is StorageService:1.1.

Name Requirement
StorageService.­{i}.­LogicalVolume.­{i}.­Folder.­{i}.­UserAccess.­{i}. C
Enable W

GroupAccess:2 Profile

The GroupAccess:2 profile for the StorageService:1 object is defined as the union of the GroupAccess:1 profile and the additional requirements defined in this table. The minimum REQUIRED version for this profile is StorageService:1.1.

Name Requirement
StorageService.­{i}.­LogicalVolume.­{i}.­Folder.­{i}.­GroupAccess.­{i}. C
Enable W


Generated by Broadband Forum report.pl#156 (2010/03/02 version) on 2010/03/02 at 10:15:04.