All MIBs › DOCS-CABLE-DEVICE-MIB › docsDevSwAdminStatus
docsDevSwAdminStatus
Module: DOCS-CABLE-DEVICE-MIB
OID (symbolic): DOCS-CABLE-DEVICE-MIB::docsDevSwAdminStatus
OID (numeric): 1.3.6.1.2.1.69.1.3.3
Node type: OBJECT-TYPE
Type: INTEGER
Access: read-write
Description: If set to upgradeFromMgt(1), the device will initiate a TFTP or HTTP software image download. After successfully receiving an image, the device will set its state to ignoreProvisioningUpgrade(3) and reboot. If the download process is interrupted (e.g., by a reset or power failure), the device will load the previous image and, after re-initialization, continue to attempt loading the image specified in docsDevSwFilename.
If set to allowProvisioningUpgrade(2), the device will use the software version information supplied by the provisioning server when next rebooting (this does not cause a reboot).
When set to ignoreProvisioningUpgrade(3), the device will disregard software image upgrade information from the provisioning server.
Note that reading this object can return upgradeFromMgt(1). This indicates that a software download is currently in progress, and that the device will reboot after successfully receiving an image.
What is docsDevSwAdminStatus?
This OID controls whether a cable modem or network device should download and install new firmware. Setting it triggers the device to fetch updated software from a server, then reboot with the new version. A technician would set this to upgrade a device's software remotely without physically visiting it.
Examples
Walk all instances (SNMPv2c):
snmpwalk -v2c -c public <target> 1.3.6.1.2.1.69.1.3.3 snmpwalk -v2c -c public <target> DOCS-CABLE-DEVICE-MIB::docsDevSwAdminStatus
Get a specific instance (index 1):
snmpget -v2c -c public <target> 1.3.6.1.2.1.69.1.3.3.1 snmpget -v2c -c public <target> DOCS-CABLE-DEVICE-MIB::docsDevSwAdminStatus.1
Set instance 1 (SNMPv2c):
snmpset -v2c -c private <target> 1.3.6.1.2.1.69.1.3.3.1 i <value>
SNMPv3 example:
snmpget -v3 -l authPriv -u snmpv3-user -a SHA -A "AuthPassword1" -x AES -X "PrivPassword1" <target> docsDevSwAdminStatus.1
Start monitoring DOCSIS cable modem/CMTS (device management, vendor-neutral IETF standard RFC 4639) with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the DOCS-CABLE-DEVICE-MIB::docsDevSwAdminStatus OID value, configure state conditions and alerts, and monitor any DOCSIS cable modem/CMTS (device management, vendor-neutral IETF standard RFC 4639) from a single console.
OID Breakdown
Upper-level ancestors (6 from the standard OID tree / other modules)
| Numeric OID | Name | Module |
|---|---|---|
| 1 | iso | LANART-AGENT |
| 1.3 | org | AirPair-MIB |
| 1.3.6 | dod | AirPair-MIB |
| 1.3.6.1 | internet | AirPair-MIB |
| 1.3.6.1.2 | mgmt | AXON-MIB |
| 1.3.6.1.2.1 | mib_2 | AXON-MIB |
| Numeric OID | Name | Module |
|---|---|---|
| 1.3.6.1.2.1.69 | docsDev | DOCS-CABLE-DEVICE-MIB |
| 1.3.6.1.2.1.69.1 | docsDevMIBObjects | DOCS-CABLE-DEVICE-MIB |
| 1.3.6.1.2.1.69.1.3 | docsDevSoftware | DOCS-CABLE-DEVICE-MIB |
| 1.3.6.1.2.1.69.1.3.3 | docsDevSwAdminStatus | DOCS-CABLE-DEVICE-MIB |