SNMP Background Synchronization

The SNMP Background Synchronization features provides periodic background synchronization of DOCSIS MIB data from line card to Supervisor in order to improve the performance of the SNMP polling of these MIB tables.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http:/​/​tools.cisco.com/​ITDIT/​CFN/​. An account on http:/​/​www.cisco.com/​ is not required.

Contents

Information About SNMP Background Synchronization

To improve SNMP performance, SNMP background synchronization feature is introduced to synchronize the SNMP MIB information between the line card and the Supervisor. It is based on raw socket and uses TCP protocol. The benefits of the SNMP Background Synchronization include:

  • Bundles small packets together before sending out, increases IPC channel utilization.

  • Use pre-allocated static buffer to send/receive message, avoid buffer allocation at run time.

  • In order not to burden CPU when the system is in high load, SNMP background synchronization receive process can sleep based on CPU utilization, so it will not compete with other priority processes.

  • Significantly improve SNMP polling performance for supported MIB tables, and reduce the CPU utilization in both Supervisor and line card.

The following MIB tables are supported in SNMP background synchronization:

  • docsQosParamSetEntry

  • docsIetfQosParamSetEntry

  • docsQos3ParamSetEntry

  • docsIf3CmtsCmUsStatusEntry

  • docsIfCmtsCmStatusEntry

  • docsSubMgtCpeControlEntry

  • docsSubMgtCmFilterEntry

  • cdxCmtsCmStatusExtEntry

  • docsLoadBalCmtsCmStatusEntry

  • docsIf3CmtsCmRegStatusTable

  • docsIfSignalQualityTable

  • docsifCmtsServiceTable

  • cdxCmtsServiceExtEntry

How to Configure SNMP Background Synchronization

Enabling SNMP Background Synchronization

Before you begin

To use the cable bgsync command, you must configure the service internal command in global configuration mode.

SNMP background synchronization is enabled by default, use no cable bgsync active to disable this feature, and use cable bgsync active to enable it again. The following procedure lists detailed steps to enable SNMP background synchronization:

enable
configure terminal
cable bgsync active
exit

Setting Data Interval

Before you begin

To use the cable bgsync command, you must configure the service internal command in global configuration mode. Use the cable bgsync command carefully as it can impact the CPU utilization.

To set the data intervals for the background synchronization of SNMP MIB data on the Cisco cBR routers, use the cable bgsync {itime i-interval|ptime p-interval} command in global configuration mode. To disable background synchronization, use the no form of this command. The following procedure lists detailed steps to set data interval:

enable
configure terminal
service internal
cable bgsync itime i-interval
cable bgsync ptime p-interval
exit

itime is the interval of synchronizing all related MIB tables from line card to Supervisor. The valid range is from 5 to 31536000. The default value is 86400. ptime is the interval of synchronizing the changed MIB content from line card to Supervisor.

Verifying SNMP Background Synchronization

  • To display the current status of the SNMP background synchronization, use the show cable bgsync command as shown in the example below:

    Router#show cable bgsync
    Background Sync is active, uptime is 5 minutes, 14 seconds.
    Background Sync last active time is 5 minutes, 14 seconds. ago.
    I-packet interval time is 1 day,  P-packet interval time is 5 senconds.
    Line Card with bg-sync: 3/0 
    Line Card working on I syncing: 
    Last clear cable bg sync counters Time: 
    Total bytes: 85864
    Total background sync packets: 2109
      Ack packets: 0
      Run Ctrl Msg packets: 2
      Data packets: 0
    Interval packets: 2002
      I Type packets: 230
      P Type packets: 1772
    Bg sync data IPC lost packets: 0
    
    Background Sync statistics for the last 00:07:34
    ===============================================================
     ipc packets 0-30k:      105
     ipc packets 30-60k:     0
     ipc packets 60-100k:    0
     msg per packet average: 20
     msg per packet max:     113
     msg per packet min:     1
     msg per packet under 3: 60
    ===============================================================
    type       packets        cpu-total(ms)    avg(us)   max(us)
    serv flow  904            3                3         1000     
    sflog      0              0                0         0        
    cm         17             0                0         0        
    cmtx       296            0                0         0        
    paramset   112            0                0         0        
    DXIF       298            0                0         0        
    sid        208            0                0         0        
    uschan     167            1                5         1000     
    ---------------------------------------------------------------
    IPC PKTs   105            4                0      ms 1      ms
    =====================================================================================
    slot type       packets        bytes            pps        Bps        wrong_len_pkts
    0    serv flow  0              0                0.0        0.0        0                    
    0    sflog      0              0                0.0        0.0        0                    
    0    cm         0              0                0.0        0.0        0                    
    0    cmtx       0              0                0.0        0.0        0                    
    0    paramset   0              0                0.0        0.0        0                    
    0    DXIF       0              0                0.0        0.0        0                    
    0    sid        0              0                0.0        0.0        0                    
    0    uschan     0              0                0.0        0.0        0                    
    1    serv flow  0              0                0.0        0.0        0                    
    1    sflog      0              0                0.0        0.0        0                    
    1    cm         0              0                0.0        0.0        0                    
    1    cmtx       0              0                0.0        0.0        0                    
    1    paramset   0              0                0.0        0.0        0                    
    1    DXIF       0              0                0.0        0.0        0                    
    1    sid        0              0                0.0        0.0        0                    
    1    uschan     0              0                0.0        0.0        0                    
    2    serv flow  0              0                0.0        0.0        0                    
    2    sflog      0              0                0.0        0.0        0                    
    2    cm         0              0                0.0        0.0        0                    
    2    cmtx       0              0                0.0        0.0        0                    
    2    paramset   48             7680             0.0        0.0        0                    
    2    DXIF       0              0                0.0        0.0        0                    
    2    sid        16             512              0.0        0.0        0                    
    2    uschan     0              0                0.0        0.0        0                    
    3    serv flow  904            25104            4.4        115.4      0                    
    3    sflog      0              0                0.0        0.0        0                    
    3    cm         17             981              0.0        2.0        0                    
    3    cmtx       296            8607             0.7        20.6       0                    
    3    paramset   64             8368             0.0        0.0        0                    
    3    DXIF       298            21876            0.9        74.3       0                    
    3    sid        192            4756             0.1        6.8        0                    
    3    uschan     167            5832             0.3        10.7       0                    
    6    serv flow  0              0                0.0        0.0        0                    
    6    sflog      0              0                0.0        0.0        0                    
    6    cm         0              0                0.0        0.0        0                    
    6    cmtx       0              0                0.0        0.0        0                    
    6    paramset   0              0                0.0        0.0        0                    
    6    DXIF       0              0                0.0        0.0        0                    
    6    sid        0              0                0.0        0.0        0                    
    6    uschan     0              0                0.0        0.0        0                    
    7    serv flow  0              0                0.0        0.0        0                    
    7    sflog      0              0                0.0        0.0        0                    
    7    cm         0              0                0.0        0.0        0                    
    7    cmtx       0              0                0.0        0.0        0                    
    7    paramset   0              0                0.0        0.0        0                    
    7    DXIF       0              0                0.0        0.0        0                    
    7    sid        0              0                0.0        0.0        0                    
    7    uschan     0              0                0.0        0.0        0                    
    8    serv flow  0              0                0.0        0.0        0                    
    8    sflog      0              0                0.0        0.0        0                    
    8    cm         0              0                0.0        0.0        0                    
    8    cmtx       0              0                0.0        0.0        0                    
    8    paramset   0              0                0.0        0.0        0                    
    8    DXIF       0              0                0.0        0.0        0                    
    8    sid        0              0                0.0        0.0        0                    
    8    uschan     0              0                0.0        0.0        0                    
    9    serv flow  0              0                0.0        0.0        0                    
    9    sflog      0              0                0.0        0.0        0                    
    9    cm         0              0                0.0        0.0        0                    
    9    cmtx       0              0                0.0        0.0        0                    
    9    paramset   0              0                0.0        0.0        0                    
    9    DXIF       0              0                0.0        0.0        0                    
    9    sid        0              0                0.0        0.0        0                    
    9    uschan     0              0                0.0        0.0        0                    
    
  • To display all the SNMP background sync data on Supervisor side or line card side, use the show cable bgsync sync-info cable command as shown in the example below:

    Router#show cable bgsync sync-info cable 9/0/1
     part1 for srv template:
    srv_tmp_id   min_rate    max_rate    max_burst
    0           0           0           0
    1           0           64000       0
    2           0           1000000     0
    3           0           1000000     3044
    4           0           0           3044
    5           0           110000000   30000
    6           0           0           3044
    7           0           2000000000  5000000
    8           0           0           3044
     part2 for srv flow:
    sfid     prov_qos   adm_qos    act_qos    wb_mode    octets    pkts    delay_pkts    drop_pkts    gate_id    create_time    total_active_time
    1        0          0          0          0          0          0          0          0          0              0              0
    2        0          0          0          0          0          0          0          0          0              0              0
    3        0          0          0          0          0          0          0          0          0              0              0
    4        0          0          0          0          0          0          0          0          0              0              0
    5        0          0          0          0          0          0          0          0          0              0              0
    6        0          0          0          0          0          0          0          0          0              0              0
    7        0          0          0          0          0          0          0          0          0              0              0
    8        0          0          0          0          0          0          0          0          0              0              0
    9        0          0          0          0          0          0          0          0          0              0              0
    10       0          0          0          0          0          0          0          0          0              0              0
    11       0          0          0          0          0          0          0          0          0              0              0
    12       0          0          0          0          0          0          0          0          0              0              0
    13       0          0          0          0          0          0          0          0          0              0              0
    14       0          0          0          0          0          0          0          0          0              0              0
    15       3          3          3          0          0          0          0          0          0              3600           179
    16       3          3          3          0          0          0          0          0          0              3600           179
    17       3          3          3          0          0          0          0          0          0              3600           179
    18       3          3          3          0          0          0          0          0          0              3600           179
    19       3          3          3          0          0          0          0          0          0              3600           179
    20       3          3          3          0          0          0          0          0          0              3600           179
    21       3          3          3          0          0          0          0          0          0              3600           179
    22       3          3          3          0          0          0          0          0          0              3600           179
    23       3          3          3          0          0          0          0          0          0              3600           179
    24       3          3          3          0          0          0          0          0          0              3600           179
    25       3          3          3          0          0          0          0          0          0              3600           179
    26       3          3          3          0          0          0          0          0          0              3600           179
    27       4          5          5          0          8925       42         0          0          0              12700          88
    28       6          7          7          3          0          0          0          0          0              12700          88
    29       4          5          5          3          3855       21         0          0          0              11500          100
    30       6          7          7          3          0          0          0          0          0              11500          100
    31       8          8          8          3          222        3          0          0          0              11500          100
    32       4          5          5          3          1277       11         0          0          0              12100          94
    33       6          7          7          0          0          0          0          0          0              12100          94
    34       4          5          5          0          3851       21         0          0          0              12300          92
    35       6          7          7          3          0          0          0          0          0              12300          92
    36       8          8          8          0          148        2          0          0          0              12100          94
    37       4          5          5          0          3855       21         0          0          0              12700          88
    38       6          7          7          3          0          0          0          0          0              12700          88
    39       8          8          8          3          222        3          0          0          0              12300          92
    40       4          5          5          3          3281       20         0          0          0              13100          84
    41       6          7          7          3          0          0          0          0          0              13100          84
    42       8          8          8          3          222        3          0          0          0              12700          88
    43       8          8          8          3          222        3          0          0          0              12700          88
    44       4          5          5          3          3308       21         0          0          0              13100          84
    45       6          7          7          3          0          0          0          0          0              13100          84
    46       8          8          8          3          296        4          0          0          0              13100          84
    47       8          8          8          3          296        4          0          0          0              13100          84
    48       4          5          5          3          73         2          0          0          0              14500          70
    49       6          7          7          3          0          0          0          0          0              14500          70
    50       8          8          8          3          74         1          0          0          0              14500          70
     part3 for sid
     sid_entry[1] sid 1 service_class 2 create_time 127 total_octets 8925
     sid_entry[2] sid 2 service_class 2 create_time 115 total_octets 3855
     sid_entry[3] sid 3 service_class 2 create_time 121 total_octets 1277
     sid_entry[4] sid 4 service_class 2 create_time 123 total_octets 3851
     sid_entry[5] sid 5 service_class 2 create_time 127 total_octets 3855
     sid_entry[6] sid 6 service_class 2 create_time 131 total_octets 3281
     sid_entry[7] sid 7 service_class 2 create_time 131 total_octets 3308
     sid_entry[8] sid 8 service_class 2 create_time 145 total_octets 73
     part4 for cm and cmtx
     cm_mac: 68ee.9633.0699, tcsbmp: 0x1, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x4, rcs_id 0x1520005, tcs_id 0x1 last_reg_time 1444372688, RCP ID:00 10 00 00 10
     usch 1, modulation_type 2, rx_power -5, signal_noise 390, time_offset 2085
     cm_mac: e448.c70c.96e7, tcsbmp: 0x4, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x4, rcs_id 0x1520005, tcs_id 0x3 last_reg_time 1444372678, RCP ID:00 10 00 00 08
     usch 3, modulation_type 2, rx_power -15, signal_noise 381, time_offset 1785
     cm_mac: 0019.474a.c126, tcsbmp: 0x1, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x0, rcs_id 0x22, tcs_id 0x1 last_reg_time 1444372682, RCP ID:00 00 00 00 00
     usch 1, modulation_type 2, rx_power -15, signal_noise 390, time_offset 1792
     cm_mac: e448.c70c.982b, tcsbmp: 0x1, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x4, rcs_id 0x1520005, tcs_id 0x1 last_reg_time 1444372685, RCP ID:00 10 00 00 08
     usch 1, modulation_type 2, rx_power -10, signal_noise 390, time_offset 1786
     cm_mac: e448.c70c.96d5, tcsbmp: 0x2, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x4, rcs_id 0x1520005, tcs_id 0x2 last_reg_time 1444372688, RCP ID:00 10 00 00 08
     usch 2, modulation_type 2, rx_power -15, signal_noise 381, time_offset 1786
     cm_mac: e448.c70c.9819, tcsbmp: 0x1, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x4, rcs_id 0x1520005, tcs_id 0x1 last_reg_time 1444372692, RCP ID:00 10 00 00 08
     usch 1, modulation_type 2, rx_power -10, signal_noise 390, time_offset 1789
     cm_mac: e448.c70c.980d, tcsbmp: 0x4, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x4, rcs_id 0x1520005, tcs_id 0x3 last_reg_time 1444372695, RCP ID:00 10 00 00 08
     usch 3, modulation_type 2, rx_power -10, signal_noise 390, time_offset 1783
     cm_mac: e448.c70c.96f3, tcsbmp: 0x1, admin_status 1, md_sg_id 0x1510505, rcc_status_id 0x4, rcs_id 0x1520005, tcs_id 0x1 last_reg_time 1444372723, RCP ID:00 10 00 00 04
     usch 1, modulation_type 2, rx_power 0, signal_noise 420, time_offset 1798
     part5 for dxif info ifnum 1
     basedata[1][1]: cmstatusindex 2375681, cm_mac 68ee.9633.0699, cm_ip 0x5011961F, cm_ds_if 59881, cm_us_if 204952
     cmregmode 2, cmmodultype 2, cmdocmode 2
     basedata[1][2]: cmstatusindex 2375682, cm_mac e448.c70c.96e7, cm_ip 0x5011961D, cm_ds_if 59882, cm_us_if 204954
     cmregmode 2, cmmodultype 2, cmdocmode 2
     basedata[1][3]: cmstatusindex 2375683, cm_mac 0019.474a.c126, cm_ip 0x50119602, cm_ds_if 59914, cm_us_if 204952
     cmregmode 2, cmmodultype 2, cmdocmode 2
     basedata[1][4]: cmstatusindex 2375684, cm_mac e448.c70c.982b, cm_ip 0x50119612, cm_ds_if 59881, cm_us_if 204952
     cmregmode 2, cmmodultype 2, cmdocmode 2
     basedata[1][5]: cmstatusindex 2375685, cm_mac e448.c70c.96d5, cm_ip 0x5011960D, cm_ds_if 59881, cm_us_if 204953
     cmregmode 2, cmmodultype 2, cmdocmode 2
     basedata[1][6]: cmstatusindex 2375686, cm_mac e448.c70c.9819, cm_ip 0x5011961E, cm_ds_if 59881, cm_us_if 204952
     cmregmode 2, cmmodultype 2, cmdocmode 2
     basedata[1][7]: cmstatusindex 2375687, cm_mac e448.c70c.980d, cm_ip 0x5011961A, cm_ds_if 59882, cm_us_if 204954
     cmregmode 2, cmmodultype 2, cmdocmode 2
     basedata[1][8]: cmstatusindex 2375688, cm_mac e448.c70c.96f3, cm_ip 0x5011960E, cm_ds_if 59882, cm_us_if 204952
     cmregmode 2, cmmodultype 2, cmdocmode 2
     part6 uschan for ifnum 1
    usport 1 micro_reflections 0 us_snr 390 snmp_sigq_unerroreds 0 snmp_sigq_correcteds 0  snmp_sigq_uncorrectables 0
    usport 2 micro_reflections 0 us_snr 381 snmp_sigq_unerroreds 0 snmp_sigq_correcteds 0  snmp_sigq_uncorrectables 0
    usport 3 micro_reflections 0 us_snr 390 snmp_sigq_unerroreds 0 snmp_sigq_correcteds 0  snmp_sigq_uncorrectables 0
    usport 4 micro_reflections 0 us_snr 0 snmp_sigq_unerroreds 0 snmp_sigq_correcteds 0  snmp_sigq_uncorrectables 0
    
  • To display raw socket interprocess communication (IPC) infrastructure statistics for specified field replaceable unit (FRU), use the show platform software ios slot-id socket statistics command as shown in the example below:

    Router#show platform software ios R0 socket statistics 0
    ---------------------------------------------
    
    Session Slot             : 2
    Socket FD                : 93
    Client ID                : 0
    Message Receive Count    : 0
    Message Receive Bytes    : 0
    
    ---------------------------------------------
    
    Session Slot             : 2
    Socket FD                : 93
    Client ID                : 1
    Message Receive Count    : 30155
    Message Receive Bytes    : 1326820
    
    ---------------------------------------------
    
    Session Slot             : 3
    Socket FD                : 86
    Client ID                : 0
    Message Receive Count    : 0
    Message Receive Bytes    : 0
    
    ---------------------------------------------
    
    Session Slot             : 3
    Socket FD                : 86
    Client ID                : 1
    Message Receive Count    : 29611
    Message Receive Bytes    : 69782901
    

Configuring Example for SNMP Background Synchronization

The following example shows how to configure SNMP background synchronization:

enable
configure terminal
cable bgsync active
service internal
cable bgsync itime 200
cable bgsync ptime 500
exit

Feature Information for SNMP Background Synchronization

Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http:/​/​tools.cisco.com/​ITDIT/​CFN/​. An account on http:/​/​www.cisco.com/​ is not required.


Note


The below table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.


Table 1 Feature Information for SNMP Background Synchronization

Feature Name

Releases

Feature Information

SNMP Background Synchronization

Cisco IOS-XE Release 3.18.0S

This feature was introduced on the Cisco cBR Series Converged Broadband Routers.