Alpha Technologies DSM3 for XM3 - Technical Manual - Manual (Page 19)

19 745-814-B11-001, Rev. C (03/2014)
3.3 The DOCSIS Configuration File
3.3.7 Proprietary Configuration File ‘atidoc03.cfg’
The DSM3 Series will attempt to download a TLV-formatted file ‘atidoc03.cfg’ from the modem’s
provisioning TFTP server at start up and every 24 hours thereafter. The atidoc03.cfg proprietary
configuration file is optional and provides an alternative method to the modem’s DOCSIS
configuration file for deploying Alpha proprietary SNMP MIB parameters to field-installed DSM3 Series
Communications Modules.
The atidoc03.cfg file should be used if the following conditions are true:
1. Non-default settings, such as SNMP Trap Destination Addresses need to be distributed to all
DSM3 Series Communications Modules.
2. The operator does not desire to place Alpha-proprietary parameters into the modem’s DOCSIS
configuration file.
To build the atidoc03.cfg file, enter the desired SNMP OIDs and values from the Alpha MIB into a
TLV file as TLV type-11 entries using a TLV editor (Refer to sample entries below). The DSM3 Series
proprietary configuration Setup file must be named “atidoc03.cfg” and placed in the root directory of
the TFTP server. DSM3 settings are updated according to values defined in this file at start up and
after every 24 hours of operation.
Sample atidoc03.cfg Entries:
Network Access Control (3) [Len - 1]: 1
SNMP MIB Object (11) [Len = 24]: atiMgmtSnmpTrapAddress.1 / 10.20.30.40
SNMP MIB Object (11) [Len = 24]: atiMgmtSnmpTrapAddress.2 / 10.20.30.50
SNMP MIB Object (11) [Len = 23]: atiMgmtSysTamperPolarity.0 / 1
The recommended method for setting the SNMP trap address(es) is through the modem DOCSIS configuration file
(See Section 3.3, The DOCSIS Configuration File). Alpha-proprietary parameters may also be set through the
modem’s DOCSIS configuration file, eliminating the need for the atidoc03.cfg proprietary configuration file.
NOTE:
3.3.8 Changing Default atidoc03.cfg Download Settings
By default the DSM3 Series will download the atidoc03.cfg file from the provisioning TFTP server
every 24 hours. However, these settings may be adjusted per the tables below by placing the
respective SNMP varbinds into the modem’s DOCSIS configuration file.
Parameter Type Description Value
atiMgmtSysDownloadConfigName
1.3.6.1.4.1.926.1.3.2.1.9.0 Alphanumeric
String
Name of proprietary
configuration file
"atidoc03.cfg"
(Default)
atiMgmtSysDownloadReCfgTime
1.3.6.1.4.1.926.1.3.2.1.13.0
Integer
Download interval for
atidoc03.cfg (hours)
24 (Default)
Search
Order
Parameter Type Description Value
1
atiMgmtSysDownloadConfigAddress
OID 1.3.6.1.4.1.926.1.3.2.1.10.0
IP Address
Overrides default
location
0.0.0.0 (Default)
2
docsDevServerConfigTftpAddress
1.3.6.1.2.1.69.1.4.11.0
IP Address
Default location (no
change necessary)
CM's TFTP
Server Address
3
docsDevSwServerAddress
1.3.6.1.2.1.69.1.3.7.0
IP Address
Set via DOCSIS
configuration file
Configurable
4 Software Upgrade Server IP Address
Set via DOCSIS
configuration file
Configurable
3.0 Network Configuration
Table 3-5, Default atidoc.cfg Download Settings