TR-069 Device:1.2 Root Object errata and clarificationstr-140-1-1-0.xml |
|||
DATA MODEL DEFINITION |
License
Copyright (c) 2017, Broadband Forum
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The above license is used as a license under copyright only. Please reference the Forum IPR Policy for patent licensing terms https://www.broadband-forum.org/ipr-policy.
Any moral rights which are necessary to exercise under the above license grant are also deemed granted under this license.
Data Types
The Parameters defined in this specification make use of a limited subset of the default SOAP data types [SOAP1.1]. These data types and the named data types used by this specification are described below.
Note: A Parameter that is defined to be one of the named data types is reported as such at the beginning of the Parameter’s description via a reference back to the associated data type definition (e.g. [MACAddress]). However, such parameters still indicate their SOAP data types.
Data Type | Base Type | Description |
---|---|---|
boolean | - | Boolean, where the allowed values are 0 or 1 (or equivalently, true or false). |
string | - | For strings, a minimum and maximum allowed length can be indicated using the form string(Min:Max), where Min and Max are the minimum and maximum string length in characters. If either Min or Max are missing, this indicates no limit, and if Min is missing the colon can also be omitted, as in string(Max). Multiple comma-separated ranges can be specified, in which case the string length will be in one of the ranges. |
unsignedInt | - | Unsigned integer in the range 0 to 4294967295, inclusive. For some unsignedInt types, a value range is given using the form unsignedInt(Min:Max) or unsigned(Min:Max step Step), where the Min and Max values are inclusive. If either Min or Max are missing, this indicates no limit. If Step is missing, this indicates a step of 1. Multiple comma-separated ranges can be specified, in which case the value will be in one of the ranges. |
References
[IANA-uri-schemes] | IANA Uniform Resource Identifier (URI) Schemes Registry, Uniform Resource Identifier (URI) Schemes, IANA. |
[IEEE_EUI64] | Guidelines for 64-bit Global Identifier (EUI-64) Registration Authority, Guidelines for 64-bit Global Identifier (EUI-64) Registration Authority, IEEE, March 1997. |
[RFC3986] | RFC 3986, Uniform Resource Identifier (URI): Generic Syntax, IETF. |
[RFC4007] | RFC 4007, IPv6 Scoped Address Architecture, IETF. |
[RFC4122] | RFC 4122, A Universally Unique IDentifier (UUID) URN Namespace, IETF, 2005. |
[RFC4291] | RFC 4291, IP Version 6 Addressing Architecture, IETF, 2006. |
[RFC4632] | RFC 4632, Classless Inter-domain Routing (CIDR): The Internet Address Assignment and Aggregation Plan, IETF, 2006. |
[RFC7159] | RFC7159, The JavaScript Object Notation (JSON) Data Interchange Format, IETF, March 2014. |
[RFC7230] | RFC 7230, Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing, IETF, June 2014. |
[RFC7252] | RFC 7252, The Constrained Application Protocol (CoAP), IETF, June 2014. |
[RFC8141] | RFC 8141, Uniform Resource Names (URNs), IETF, April 2017. |
[SOAP1.1] | Simple Object Access Protocol (SOAP) 1.1, W3C. |
[TR-069] | TR-069 Amendment 6, CPE WAN Management Protocol, Broadband Forum, April 2018. |
[TR-106] | TR-106 Amendment 8, Data Model Template for CWMP Endpoints and USP Agents, Broadband Forum, May 2018. |
[ZigBee2007] | ZigBee 2007 Specification, ZigBee 2007 Specification, ZigBee Alliance, October 2007. |
Legend
Object definition. |
Parameter definition. |
StorageService:1.1 Data Model
For a given implementation of this data model, the Agent MUST indicate support for the highest version number of any object or parameter that it supports. For example, even if the Agent supports only a single parameter that was introduced in version 1.4, then it will indicate support for version 1.4. The version number associated with each object and parameter is shown in the Version column.
Name | Type | Write | Description | Object Default | Version |
---|---|---|---|---|---|
StorageService.{i}. | object(0:) | R | The Service Object for a Storage Service device. | - | 1.0 |
Enable | boolean | W | Enables or Disables the entire Storage mechanism. | - | 1.0 |
PhysicalMediumNumberOfEntries | unsignedInt | R | The number of instances of PhysicalMedium.{i}.. | - | 1.0 |
StorageArrayNumberOfEntries | unsignedInt | R | The number of instances of StorageArray.{i}.. | - | 1.0 |
LogicalVolumeNumberOfEntries | unsignedInt | R | The number of instances of LogicalVolume.{i}.. | - | 1.0 |
UserAccountNumberOfEntries | unsignedInt | R | The number of instances of UserAccount.{i}.. | - | 1.0 |
UserGroupNumberOfEntries | unsignedInt | R | The number of instances of UserGroup.{i}.. | - | 1.0 |
StorageService.{i}.Capabilities. | object | R | The overall capabilities of a Storage Service device. This is a constant read-only object, meaning that only a firmware upgrade will cause these values to be altered. Note that when TR-140 was originally published there was a typo in this object name, which has been corrected. | - | 1.0 |
FTPCapable | boolean | R | Does this device contain an FTP server allowing clients to access the data via an FTP client? | - | 1.0 |
SFTPCapable | boolean | R | Does this device contain an SSH FTP server allowing clients to access the data via an SFTP client? | - | 1.0 |
HTTPCapable | boolean | R | Does this device contain an HTTP server allowing clients to access the data via an HTTP client? | - | 1.0 |
HTTPSCapable | boolean | R | Does this device contain an HTTPS server allowing clients to access the data via an HTTPS client? | - | 1.0 |
HTTPWritable | boolean | R | Does this device contain an HTTP server that supports creating files via an HTTP PUT/POST mechanism that would allow an HTTP client to upload files via HTTP? This is also sometimes referred to as “WebDAV” support. | - | 1.0 |
SupportedNetworkProtocols | string[] | R | Comma-separated list of strings. Supported application-level network protocols. Each list item is an enumeration of:
|
- | 1.0 |
SupportedFileSystemTypes | string[] | R | Comma-separated list of strings. Supported FileSystems Types. Each list item is an enumeration of:
|
- | 1.0 |
SupportedRaidTypes | string[] | R | Comma-separated list of strings. Supported RAID types. Each list item is an enumeration of:
|
- | 1.0 |
VolumeEncryptionCapable | boolean | R | Does this device have the ability to encrypt and decrypt Logical Volumes as they are stored and retrieved? | - | 1.0 |
StorageService.{i}.NetInfo. | object | R | This object provides general LAN network information about this device. | - | 1.0 |
HostName | string(:64) | W | Logical name which identifies the device on the local network. This is the first segment of a fully qualified domain name (FQDN). Combining HostName, a “.” and the DomainName will result in a fully qualified domain name. | - | 1.0 |
DomainName | string(:255) | W | Domain name for the device on the local network. Combining HostName, a “.” and DomainName will result in a fully qualified domain name (FQDN). For example, if the HostName contains “myLaptop” and the DomainName contains “dsl.sp1.com”, then the FQDN would be “myLaptop.dsl.sp1.com”. | - | 1.0 |
StorageService.{i}.UserGroup.{i}. | object(0:) | W | This object provides information about each user group configured on this device, which allows the grouping of user accounts for easier maintenance of permissions. At most one enabled entry in this table can exist with a given value for GroupName. |
- | 1.0 |
Enable | boolean | W | Enables or disables this group. | false | 1.0 |
GroupName | string(:64) | W | The unique name of the group. | <Empty> | 1.0 |
StorageService.{i}.UserAccount.{i}. | object(0:) | W | This object provides information about each user configured on this device, which provides a means for controlling access to the device. At most one enabled entry in this table can exist with a given value for Username. |
- | 1.0 |
Enable | boolean | W | Enables or disables this user. | false | 1.0 |
Username | string(:64) | W | The unique name of the user. Also used for authentication. | <Empty> | 1.0 |
Password | string(:64) | W | Password used to authenticate the user when connecting to the Storage Service Device. When read, this parameter returns an empty string, regardless of the actual value. |
- | 1.0 |
UserGroupParticipation | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of a row in the UserGroup. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Represents a User Group that this User Account is a member of. Each UserGroup.{i}. referenced by this parameter MUST exist within the same StorageService instance. | <Empty> | 1.0 |
AllowFTPAccess | boolean | W | Enables or disables access via FTP (including SSH FTP access) for this user. | false | 1.0 |
AllowHTTPAccess | boolean | W | Enables or disables access via HTTP (including HTTPS access) for this user. | false | 1.0 |
StorageService.{i}.NetworkServer. | object | R | This object allows the control of network layer protocols authorization enforcement. | - | 1.0 |
AFPEnable | boolean | W | Enables or disables the AFP network protocol. | - | 1.0 |
NFSEnable | boolean | W | Enables or disables the NFS network protocol. | - | 1.0 |
SMBEnable | boolean | W | Enables or disables the SMB network protocol. | - | 1.0 |
NetworkProtocolAuthReq | boolean | W | If this parameter is set to false then the device MUST NOT attempt to request login credentials or authenticate access from network layer protocols such as AFP, NFS, and SMB. If this parameter is set to true then the device MUST attempt to request login credentials or authenticate access from network layer protocols such as AFP, NFS, and SMB by using an instance of UserAccount.{i}. found on this device. | - | 1.0 |
StorageService.{i}.FTPServer. | object | R | This object allows the configuration of the FTP server. | - | 1.0 |
Enable | boolean | W | Enables or disables the FTP server. | - | 1.0 |
Status | string | R | The current status of this FTP server. Enumeration of:
|
- | 1.0 |
MaxNumUsers | unsignedInt(1:32) | W | Maximum number of users allowed to log in to the device at once via FTP. | - | 1.0 |
IdleTime | unsignedInt(0:600) | W | Maximum amount of time in seconds that the FTP socket will remain open without any activity. If set to 0 an infinite timeout will apply. | - | 1.0 |
PortNumber | unsignedInt(0:65535) | W | The port number that the FTP server is listening on. The factory default value MUST be 21. |
- | 1.0 |
StorageService.{i}.FTPServer.AnonymousUser. | object | R | This object allows the configuration of anonymous FTP access. | - | 1.0 |
Enable | boolean | W | Enables or disables support for anonymous access into the FTP server | - | 1.0 |
StartingFolder | string(:256) | W | The value MUST be the Path Name of a row in the LogicalVolume.{i}.Folder. table. Represents the home directory for anonymous FTP access. The LogicalVolume.{i}.Folder.{i}. referenced by this parameter MUST exist within the same StorageService instance. | - | 1.0 |
ReadOnlyAccess | boolean | W | If this is set to true, then the anonymous user is limited to only retrieval of files from the Storage Service (no deletions, copies, creations or uploads). If this is set to false, then the anonymous user has full permissions within the folder specified in StartingFolder. This SHOULD default to True. | - | 1.0 |
StorageService.{i}.SFTPServer. | object | R | This object allows the configuration of the SSH FTP server. | - | 1.0 |
Enable | boolean | W | Enables or disables the SSH FTP server. | - | 1.0 |
Status | string | R | The current status of this SSH FTP server. Enumeration of:
|
- | 1.0 |
MaxNumUsers | unsignedInt(1:32) | W | Maximum number of users allowed to log in to the device at once via SFTP. | - | 1.0 |
IdleTime | unsignedInt(0:600) | W | Maximum amount of time in seconds that the SFTP socket will remain open without any activity. If set to 0 an infinite timeout will apply. | - | 1.0 |
PortNumber | unsignedInt(0:65535) | W | The port number that the SSH FTP server is listening on. The factory default value MUST be 115. |
- | 1.0 |
StorageService.{i}.HTTPServer. | object | R | This object allows the configuration of the HTTP server. | - | 1.0 |
Enable | boolean | W | Enables or disables the HTTP server. | - | 1.0 |
Status | string | R | The current status of this HTTP server. Enumeration of:
|
- | 1.0 |
MaxNumUsers | unsignedInt(1:32) | W | Maximum number of users allowed to log in to the device at once via HTTP. | - | 1.0 |
IdleTime | unsignedInt(0:600) | W | Maximum amount of time in seconds that the HTTP socket will remain open without any activity. If set to 0 an infinite timeout will apply. | - | 1.0 |
HTTPWritingEnabled | boolean | R | Is support for the HTTP PUT/POST mechanism (WebDAV) enabled? | - | 1.0 |
PortNumber | unsignedInt(0:65535) | W | The port number that the HTTP server is listening on. The factory default value MUST be 80. |
- | 1.0 |
AuthenticationReq | boolean | W | If true, HTTP will require login prior to access (basic or digest authentication). | - | 1.0 |
StorageService.{i}.HTTPSServer. | object | R | This object allows the configuration of the HTTPS server. | - | 1.0 |
Enable | boolean | W | Enables or disables the HTTPS server. | - | 1.0 |
Status | string | R | The current status of this HTTPS server. Enumeration of:
|
- | 1.0 |
MaxNumUsers | unsignedInt(1:32) | W | Maximum number of users allowed to log in to the device at once via HTTPS. | - | 1.0 |
IdleTime | unsignedInt(0:600) | W | Maximum amount of time in seconds that the HTTPS socket will remain open without any activity. If set to 0 an infinite timeout will apply. | - | 1.0 |
HTTPWritingEnabled | boolean | R | Is support for the HTTP PUT/POST mechanism (WebDAV) enabled? | - | 1.0 |
PortNumber | unsignedInt(0:65535) | W | The port number that the HTTPS server is listening on. The factory default value MUST be 443. |
- | 1.0 |
AuthenticationReq | boolean | W | If true, HTTPS will require login prior to access (basic or digest authentication). | - | 1.0 |
StorageService.{i}.PhysicalMedium.{i}. | object(0:) | R | This object provides information about each physical medium connected to this device. At most one entry in this table can exist with a given value for Name, or with the same values for all of Vendor, Model and SerialNumber. |
- | 1.0 |
Name | string(:64) | W | A user-friendly name for this physical storage medium. | - | 1.0 |
Vendor | string(:64) | R | The vendor of this physical storage medium. | - | 1.0 |
Model | string(:128) | R | The model name/number of this physical storage medium. | - | 1.0 |
SerialNumber | string(:64) | R | The serial number of this physical storage medium. | - | 1.0 |
FirmwareVersion | string(:64) | R | The firmware version for firmware contained within the physical medium’s controller. | - | 1.0 |
ConnectionType | string | R | The method of connection to this storage device. Enumeration of:
|
- | 1.0 |
Removable | boolean | R | Is this physical storage medium removable? Removable storage implies that the removal action is part of normal operations and is expected to leave the data on the removable storage intact. | - | 1.0 |
Capacity | unsignedInt | R | The formatted capacity of the physical storage medium in MB. | - | 1.0 |
Status | string | R | The general activity status of this physical storage medium. Enumeration of:
|
- | 1.0 |
Uptime | unsignedInt | R | Time since boot in hours. This MAY reflect S.M.A.R.T. PowerOnHours. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
SMARTCapable | boolean | R | Is this physical medium capable of reporting S.M.A.R.T. statistics? | - | 1.0 |
Health | string | R | The general health of this physical storage medium. Enumeration of:
|
- | 1.0 |
HotSwappable | boolean | R | Is this physical medium capable of being removed while the device is powered up? Hot-Swappable storage does not imply Removable storage; hot-swappable is an operation taken only when the disk has failed and needs to be replaced. The data on the hot-swapped storage will not remain intact. | - | 1.0 |
StorageService.{i}.StorageArray.{i}. | object(0:) | W | This object provides information about each storage array (RAID) configured on this device. Creating an instance of this object generates a disabled StorageArray instance. Before this new StorageArray instance can be enabled (via a SetParameterValues command), it MUST have the following parameters configured: Name, RaidType, and PhysicalMediumReference. Once an instance is enabled the following parameters become immutable for the life of the instance: Name, RaidType, and PhysicalMediumReference. At most one enabled entry in this table can exist with a given value for PhysicalMediumReference. |
- | 1.0 |
Name | string(:64) | W | A user-friendly name for this Storage Array. Once this instance becomes enabled, this parameter will be immutable for the life of the instance. | <Empty> | 1.0 |
Status | string | R | The current status of this StorageArray. Enumeration of:
|
Offline | 1.0 |
Enable | boolean | W | Enables or disables this StorageArray instance. | false | 1.0 |
RaidType | string | W | The value MUST be a member of the list reported by the Capabilities.SupportedRaidTypes parameter. Note that after creation of the Storage Array, any subsequent writes to this parameter MUST be ignored as array type migration is not supported. To identify which RAID Types are supported, see Capabilities.SupportedRaidTypes. Once this instance becomes enabled, this parameter will be immutable for the life of the instance. | Linear | 1.0 |
UsableCapacity | unsignedInt | R | The total Usable Capacity of the Storage Array in MB. This is computed by the system based on PhysicalMediumReference and RaidType. Disk size is a consideration, as many RAID Types use the smallest drive in the group for calculations. | - | 1.0 |
PhysicalMediumReference | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of a row in the PhysicalMedium. table. Represents the physical medium used by this RAID. Each Physical Medium referenced by this parameter MUST exist within the same StorageService instance. A PhysicalMedium.{i}. MUST only be referenced by one StorageArray.{i}. instance. Once this instance becomes enabled, this parameter will be immutable for the life of the instance. | - | 1.0 |
StorageService.{i}.LogicalVolume.{i}. | object(0:) | 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 |
Name | string(:64) | W | The name of the partition for this logical volume. Once this instance becomes enabled, this parameter will be immutable for the life of the instance. This parameter acts as the unique identifier for the instance, thus the device MUST NOT allow multiple LogicalVolume instances to use the same Name. | <Empty> | 1.0 |
Status | string | R | The current status of this Logical Volume. Enumeration of:
|
Offline | 1.0 |
Enable | boolean | W | Enables or disables this LogicalVolume instance. | false | 1.0 |
PhysicalReference | string(:256) | W | The value MUST be the Path Name of a row in the PhysicalMedium. or StorageArray. tables. Represents the physical medium or RAID where this LogicalVolume resides. The PhysicalMedium.{i}. or StorageArray.{i}. referenced by this parameter MUST exist within the same StorageService instance. An AddObject followed by an enabling SetParameterValues on Name, PhysicalReference, and Capacity will cause the formatting of this logical partition and these parameters to become immutable for the life of this instance. | - | 1.0 |
FileSystem | string | R | The value MUST be a member of the list reported by the Capabilities.SupportedFileSystemTypes parameter. The file system for this LogicalVolume as it is currently formatted. | - | 1.0 |
Capacity | unsignedInt | W | The Capacity of the Logical Volume in MB. Once this instance becomes enabled, this parameter will be immutable for the life of the instance. | - | 1.0 |
UsedSpace | unsignedInt | R | The Amount of Used Space on the Logical Volume in MB. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
ThresholdLimit | unsignedInt | W | This value is specified in MB and controls when ThresholdReached will have its value altered. If the value of UsedSpace plus the value of ThresholdLimitr is greater than or equal to the value of Capacity then the value of ThresholdReached will be true, otherwise it will be false. Setting the value of this parameter to 0 will disable the Thresholding mechanism. | 0 | 1.0 |
ThresholdReached | boolean | R | When ThresholdLimit > 0 and UsedSpace + ThresholdLimit >= Capacity this will be true, else false. | false | 1.0 |
Encrypted | boolean | R | Is the Volume Encrypted? The type of encryption will be handled by the device internally and is not a matter for remote management. | - | 1.0 |
FolderNumberOfEntries | unsignedInt | R | The number of instances of LogicalVolume.{i}.Folder.{i}. on this LogicalVolume. | - | 1.0 |
StorageService.{i}.LogicalVolume.{i}.Folder.{i}. | object(0:) | 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 |
Name | string(:64) | W | Setting of this variable will add a new folder. The full hierarchical pathname of the folder MUST be specified. All folders created on the Logical Volume will appear here, created locally or via AddObject. The local directory name will be formatted as a UNIX-style directory name, for example: /home/ftp The presence of a trailing `/’ character is inconsequential, meaning that /home/ftp/ is the same as /home/ftp. Once this instance becomes enabled, this parameter will be immutable for the life of the instance. This parameter acts as the unique identifier for the instance, thus the device MUST NOT allow multiple Folder instances within a LogicalVolume.{i}. to use the same Name. | <Empty> | 1.0 |
Enable | boolean | W | Entry is enabled or disabled | false | 1.0 |
UserAccountAccess | unsignedInt(0:3) | W | What are the User authentication requirements of this folder? The following bitmap is used. 11 = Authenticated Access required for Network protocols (NFS/AFP/SMB) and for non Network protocols (FTP/SFTP/HTTP/HTTPS) 10 = Authenticated Access required for Network protocols (NFS/AFP/SMB) 01 = Authenticated Access Required for non Network protocols (FTP/SFTP/HTTP/HTTPS) 00 = No Authentication required |
2 | 1.0 |
UserAccessNumberOfEntries | unsignedInt | R | The number of instances of LogicalVolume.{i}.Folder.{i}.UserAccess.{i}. on this LogicalVolume.{i}.Folder.{i}.. | - | 1.0 |
GroupAccessNumberOfEntries | unsignedInt | R | The number of instances of LogicalVolume.{i}.Folder.{i}.GroupAccess.{i}. on this LogicalVolume.{i}.Folder.{i}. | - | 1.0 |
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.UserAccess.{i}. | object(0:) | 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.0 |
UserReference | string(:256) | W | The value MUST be the Path Name of a row in the UserAccount. table. Represents a user that has access to this folder. The instance of UserAccount.{i}. referenced by this parameter MUST exist within the same StorageService instance. | <Empty> | 1.0 |
Permissions | unsignedInt(0:7) | W | What permissions the user account has over this LogicalVolume.{i}.Folder.{i}.. This is an integer value like the xNIX systems use for access permissions, meaning that it is a 3-bit field with the following structure: 100 = read field 010 = write field 001 = execute field |
7 | 1.0 |
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.GroupAccess.{i}. | object(0:) | 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.0 |
GroupReference | string(:256) | W | The value MUST be the Path Name of a row in the UserGroup. table. Represents a user group that is a collection of User Accounts that have access to this folder. The UserGroup.{i}. referenced by this parameter MUST exist within the same StorageService instance. | <Empty> | 1.0 |
Permissions | unsignedInt(0:7) | W | What permissions the group members have over this LogicalVolume.{i}.Folder.{i}. instance. This is an integer value like the xNIX systems use for access permissions, meaning that it is a 3-bit field with the following structure: 100 = read field 010 = write field 001 = execute field |
7 | 1.0 |
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.Quota. | object | R | This object allows the configuration of per-folder storage quota management. | - | 1.0 |
Enable | boolean | W | Enables or disables quota management for this folder. | false | 1.0 |
Capacity | unsignedInt | W | Maximum size in MB of the quota for this folder. | - | 1.0 |
UsedSpace | unsignedInt | R | Current size in MB of this folder. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
ThresholdLimit | unsignedInt | W | This value is specified in MB and controls when ThresholdReached will have its value altered. If the value of UsedSpace plus the value of this parameter is greater than or equal to the value of Capacity then the value of ThresholdReached will be true, otherwise it will be false. Setting the value of this parameter to 0 will disable the Thresholding mechanism. | 0 | 1.0 |
ThresholdReached | boolean | R | When ThresholdLimit > 0 and UsedSpace + ThresholdLimit >= Capacity this will be true, else false. | false | 1.0 |
StorageServiceNumberOfEntries | unsignedInt | R | Number of entries in StorageService. | - | 1.0 |
Inform and Notification Requirements
Parameters for which Active Notification MAY be Denied
Parameter |
---|
StorageService.{i}.PhysicalMedium.{i}. |
Uptime |
StorageService.{i}.LogicalVolume.{i}. |
UsedSpace |
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.Quota. |
UsedSpace |
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 is REQUIRED. |
A | Creation of instances of the object is REQUIRED, but deletion is not REQUIRED. |
D | Deletion of instances of the object is REQUIRED, but creation is not REQUIRED. |
Baseline:1 Profile
This table defines the Baseline:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
UserAccess:1 Profile
This table defines the UserAccess:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
GroupAccess:1 Profile
The GroupAccess:1 profile for the StorageService:1 data model 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.0.
FTPServer:1 Profile
This table defines the FTPServer:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}.FTPServer. | P |
Enable | W |
Status | R |
MaxNumUsers | W |
IdleTime | W |
PortNumber | W |
StorageService.{i}.FTPServer.AnonymousUser. | P |
Enable | W |
StartingFolder | W |
ReadOnlyAccess | W |
SFTPServer:1 Profile
The SFTPServer:1 profile for the StorageService:1 data model is defined as the union of the FTPServer:1 and UserAccess:1 profiles and the additional requirements defined in this table. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}.UserAccount.{i}. | P |
AllowFTPAccess | W |
StorageService.{i}.SFTPServer. | P |
Enable | W |
Status | R |
MaxNumUsers | W |
IdleTime | W |
PortNumber | W |
HTTPServer:1 Profile
This table defines the HTTPServer:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}.HTTPServer. | P |
Enable | W |
Status | R |
MaxNumUsers | W |
IdleTime | W |
HTTPWritingEnabled | R |
PortNumber | W |
AuthenticationReq | W |
HTTPSServer:1 Profile
The HTTPSServer:1 profile for the StorageService:1 data model is defined as the union of the HTTPServer:1 and UserAccess:1 profiles and the additional requirements defined in this table. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}.UserAccount.{i}. | P |
AllowHTTPAccess | W |
StorageService.{i}.HTTPSServer. | P |
Enable | W |
Status | R |
MaxNumUsers | W |
IdleTime | W |
HTTPWritingEnabled | R |
PortNumber | W |
AuthenticationReq | W |
VolumeConfig:1 Profile
The VolumeConfig:1 profile for the StorageService:1 data model 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.0.
Name | Requirement |
---|---|
StorageService.{i}.PhysicalMedium.{i}. | P |
Name | W |
StorageService.{i}.LogicalVolume.{i}. | C |
Name | W |
Enable | W |
FileSystem | R |
Capacity | W |
StorageService.{i}.LogicalVolume.{i}.Folder.{i}. | C |
Name | W |
Enable | W |
UserAccountAccess | W |
RAID:1 Profile
This table defines the RAID:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}. | P |
StorageArrayNumberOfEntries | R |
StorageService.{i}.Capabilities. | P |
SupportedRaidTypes | R |
StorageService.{i}.StorageArray.{i}. | C |
Name | W |
Status | R |
Enable | W |
RaidType | W |
UsableCapacity | R |
PhysicalMediumReference | W |
FolderQuota:1 Profile
This table defines the FolderQuota:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.Quota. | P |
Enable | W |
Capacity | W |
UsedSpace | R |
ThresholdLimit | W |
ThresholdReached | R |
VolumeThresh:1 Profile
This table defines the VolumeThresh:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}.LogicalVolume.{i}. | P |
Capacity | R |
ThresholdLimit | W |
ThresholdReached | R |
NetServer:1 Profile
This table defines the NetServer:1 profile for the StorageService:1 data model. The minimum REQUIRED version for this profile is StorageService:1.0.
Name | Requirement |
---|---|
StorageService.{i}.NetworkServer. | P |
AFPEnable | W |
NFSEnable | W |
SMBEnable | W |
Baseline:2 Profile
The Baseline:2 profile for the StorageService:1 data model 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.0.
Name | Requirement |
---|---|
StorageServiceNumberOfEntries | R |
UserAccess:2 Profile
The UserAccess:2 profile for the StorageService:1 data model 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.0.
Name | Requirement |
---|---|
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.UserAccess.{i}. | C |
Enable | W |
GroupAccess:2 Profile
The GroupAccess:2 profile for the StorageService:1 data model 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.0.
Name | Requirement |
---|---|
StorageService.{i}.LogicalVolume.{i}.Folder.{i}.GroupAccess.{i}. | C |
Enable | W |
Generated by Broadband Forum bbfreport v2.2.0 (2024-07-23 version) on 2024-09-04 at 10:40:29 UTC.
report.py –output