7.10 Resource [software]
The Resource [software] is a multi-instance Resource where each instance of the Resource maps directly to an instance of Device.SoftwareModules.DeploymentUnit.{i} object for the deployment aspects (install, uninstall) of the Resource [software]. The install and uninstall operation of the Resource [software] is performed using a combination of the ChangeDUState and ChangeDUStateComplete RPCs.
Once a Resource [software] has been installed, the Resource shall be mapped to the associated Device.SoftwareModules.ExecutionUnit.{i} objects in order to activate and deactivate the associated execution unit.
The Resource [software] version and name shall be retrieved using the GetParameterValues RPC of TR-069 [4].
The activate and deactivate operations of the Resource [software] shall be performed by manipulating the Device.SoftwareModules.ExecutionUnit.{i}.RequestedState parameter using the SetParameterValues RPC.
Note
The Resource [software] provides support for only 1 Execution Unit per Deployment Unit. If a Deployment Unit is discovered by the M2M Service Layer that contains multiple Execution Units for a Deployment Unit; only 1 Execution Unit is exposed. The selection of which Execution Unit is implementation specific.
Table 7.10-1: Resource [software]
| Attribute Name of [software] | Description |
|---|---|
| version | Device.SoftwareModules.DeploymentUnit.{i}.Version |
| name | Device.SoftwareModules.DeploymentUnit.{i}.Name |
| URL | Device.SoftwareModules.DeploymentUnit.{i}.URL |
| install | Use the ChangeDUState:InstallOpStruct |
| installStatus | Status is defined as: Success if the ChangeDUStateComplete RPC indicates that the operation was successful. Failure if the response to the ChangeDUState or ChangeDUStateComplete RPCs indicates that the operation failed. In process if the ChangeDUState RPC is initiated but the ChangeDUStateComplete RPC has not been received. |
| Activate | The action that activates software previously installed. |
| Deactivate | The action that deactivates software. |
| activeStatus | Status is defined as: Success if the SetParameterValues RPC indicates that the operation was successful. Failure if the response to the SetParameterValues RPCs indicates that the operation failed. In process if the SetParameterValues RPC is initiated but the response to the SetParameterValues RPC has not been received. |
Table 7.10-2: RPC ChangeDUState:InstallOpStruct Arguments
| RPC ChangeDUState:InstallOpStruct Argument |
|---|
| URL: URL of the Server that M2M Node uses to download the DU. |
| Username: Username credential of Server that the CPE uses to download the DU - Supplied by the CSE. |
| Password: Password credential of Server that the CPE uses to download the DU - Supplied by the CSE. |
| UUID: Supplied by the CSE and used to correlate the DU for the uninstall operation. |
| ExecurtionEnvRef: <empty> not used |
Table 7.10-3: RPC ChangeDUState:UninstallOpStruct Arguments
| RPC ChangeDUState:Uninstall OpStruct Argument |
|---|
| UUID: UUID of the DU that was installed - Maintained by the CSE. |
| ExecutionEnvRef: <empty> not used |