Alpha Technologies DSM3 for XM2 - Technical Manual - Manual (Page 20)

20 745-814-B8-001, Rev. C (03/2014)
3.3 The DOCSIS Configuration File, continued
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 startup 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 below for sample atidoc03.cfg entries. 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
startup and after every 24 hours of operation.
Sample atidoc03.cfg Entries:
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
3.0 Network Configuration, continued
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, but these settings can 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
Table 3-5, Default atidoc.cfg Download Settings