Cisco Systems OL-27172-01 Mobility Aid User Manual


 
8-5
Cisco Broadband Access Center 3.8 Administrator Guide
OL-27172-01
Chapter 8 CPE History and Troubleshooting
Device History
Configuring Device History Size
To configure the maximum number of device history entries from the administrator user interface,
choose Configuration > Defaults > System Defaults. Enter a value in the field corresponding to
Maximum Device History Entries. The default number of entries is 40.
To configure this number from the API, set the
SERVER_MAX_DEVICE_HISTORY_SIZE property.
If you reduce the value of the Maximum Device History Entries, the existing records which exceed the
limit do not get purged until a new device history is recorded. At that point, the device's history is
updated according to the limit on maximum device history entries that the administrator sets.
If the maximum number has been increased, the older entries are retained. If the maximum number has
been decreased, the oldest entries are deleted.
Device History Records
The device history records are logged in a rolling list. When the list reaches the limit that the
administrator specifies, the oldest entry is removed. However, the following records are never deleted:
AddedViaAPI (in the case of preregistered devices)
AddedAutomatically (in the case of unregistered devices)
FirstContact
To optimize Cisco BAC performance that extensive recording of device activity might impact, you can
enable or disable specific event types with the following system properties from the API:
Note These properties are, by default, disabled. These options impact device history only if you have
enabled the Device History feature.
SERVER_DEVICE_HISTORY_IMMEDIATE_OP_ENABLE_KEY
Records OperationExecuted history for immediate operations.
SERVER_DEVICE_HISTORY_PROXY_OP_ENABLE_KEY
Records the NewOperationQueued, OperationRemoved, and OperationExecuted history for
on-connect device operations.
Note If you disable the SERVER_DEVICE_HISTORY_IMMEDIATE_OP_ENABLE_KEY property and enable the
SERVER_DEVICE_HISTORY_PROXY_OP_ENABLE_KEY property, the immediate operation is disabled
and the on-connect operation is enabled.
SERVER_DEVICE_HISTORY_GEN_CONFIG_ENABLE_KEY
Records ConfigGenRequested history.
To enable or disable these properties from the administrator user interface:
Step 1 Choose the Configuration > Defaults page.
Step 2 Click the System Defaults link on the left corner of the screen.