Вы находитесь на странице: 1из 11

Postings may contain unverified user-created content and change frequently.

The content is provided as-is and


is not warrantied by Cisco.
1
How to dump CCM memory/IMDB diagnostic
information to traces
Background on page 1
Enable Dialing Forest Dump Service Parameter on page 1
Set the CCM Trace Level to Detailed on page 2
Enable Verbose Mode on page 5
For CUCM versions without the fix for CSCti91688 on page 5
For CUCM versions with the fix for CSCti91688 on page 5
Perform the desired data dump on page 6
For CUCM versions without the fix for CSCti91688 on page 6
For CUCM versions with the fix for CSCti91688 on page 7
Gather the CCM Traces for analysis on page 7
Disable the Dialing Forest Dump Enabled Service Parameter on page 10
Background
In troubleshooting various problems related to the Cisco CallManager (ccm) process it might
be necessary to dump information from memory. Some of this information might be dumped
from ccm In Memory Database (IMDB) or directly from the ccm process.

Note: This document specifically pertains to CUCM 6.x and higher although previous versions use similar steps.
Enable Dialing Forest Dump Service Parameter
In order to dump any diagnostic information to the Cisco CallManager traces, the Dialing
Forest Dump Service parameter must be enabled. This parameter is set to False by default
to prevent malicious users from attempting to overwhelm the system and cause a Code
Yellow or system hang.

Note: Enabling this parameter will allow a knowledgeable malicious user to force a system hang.
Use best judgement when enabling this parameter, and be sure to revert this parameter back to default when done.

1. Login to the Cisco Unified Communications Manager (CUCM) Administration Page
2. Navigate to System->Service Parameters
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
2
3. Choose any server in the cluster on which Cisco CallManager is Active from the
"Server" dropdown
4. Select the the "Cisco CallManager (Active)" service from the Service dropdwn
5. Click "Advanced"

6. When the page refreshes find the "Dialing Forest Dump Enabled" Parameter under
the Clusterwide Parameters (System - General) section, and set it to True.
Set the CCM Trace Level to Detailed
CCM dump data is written to the CCM trace files at the Detailed level. To set the traces to
Detailed, complete the following steps:
1. Login to the CUCM Serviceability page
2. Select Trace->Configuration
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
3
3. Select any server on which the phone performing the dump is located.
4. Select "CM Services"
5. Select the "Cisco CallManager (Active)" service
6. Set the "Debug Trace Level" dropdown to Detailed. "Device Named Based Trace
Monitoring" should be unchecked. The Trace configuration for the Cisco CallManager
service should look similar to the following:
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
4
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
5
7. Click "Save"
Enable Verbose Mode
In order to perform the dump of any data, Verbose mode needs to be enabled within ccm.
Depending on CUCM version, this process varies slightly. The change was introduced by
the fix for CSCti91688.

CSCti91688 was resolved in the following versions:

Version Train ES Build SU Build
6.x
6.1.5.12028+
6.1(5)Su3
7.0
7.0.2.24049+
None
7.1(3)
7.1.3.33037+
None
7.1(5)
7.1.5.32022+
7.1(5)bSu3+
8.0(2)
8.0.2.42019+
None
8.0(3) 8.0.3.21008+ 8.0(3a)Su2+
8.5(1) All All
8.6(x)+ All All

For CUCM versions without the fix for CSCti91688
1. Go offhook on an IP Phone
2. Dial **##*2
3. Wait for Reorder (fast busy) tone or "Call cannot be Completed as dialed" prompt.
For CUCM versions with the fix for CSCti91688
1. Go offhook on an IP Phone
2. Dial **##*02
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
6
3. Wait for Reorder (fast busy) tone or "Call cannot be Completed as dialed" prompt.
Perform the desired data dump
At this stage, the required data is ready to be dumped to the CCM trace file. Be careful
not to do several dumps simultaneously or in rapid concurrent fashion, as this may cause
system instability. The process is the same for all CUCM version:

1. Go offhook on an IP Phone
2. Dial <data dump code>
3. Wait for Reorder (fast busy) tone or "Call cannot be completed as dialed" prompt.

The data dump code varies between CUCM versions containing the fix for CSCti91688.
For CUCM versions without the fix for CSCti91688
This table lists the data dump codes for CUCM versions without the fix for CSCti91688.


Dump Code Information contained in the dump
**##*1 analysis trace on/off
**##*2
terse/verbose toggle
**##*3 dump digit discarding instructions
**##*4 dump patterns
**##*5 dump partitions list
**##*6 dump css list
**##*7 dump feature css content list
**##*8 dump device css context list
**##*9 dump line appearance css context list

How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
7

For CUCM versions with the fix for CSCti91688
This table lists the data dump codes for CUCM versions without the fix for CSCti91688.


Dump Code Information contained in the dump
**##*01 analysis trace on/off
**##*02
terse/verbose toggle
**##*03 dump digit discarding instructions
**##*04 dump patterns
**##*05 dump partitions list
**##*06 dump css list
**##*07 dump feature css content list
**##*08 dump device css context list
**##*09 dump line appearance css context list
**##*10 dump line css context list
**##*11 dump multiple partitions list
**##*12 dump VM Profile list
**##*13 dump VM Pilot number list
**##*14 dump regions list and in memory db
**##*15 dump learned patterns
Note: This is valid in 8.0(1) and higher only
**##*16 dump SDL Process & CUCM Table Info
Note: This is valid in 8.5(1) and 8.6(1)+ only

Gather the CCM Traces for analysis
1. Launch the Cisco Unified Real Time Monitoring Tool and connect to the CUCM
server.
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
8
2. Navigate to System->Tools->Trace and Log Central
3. Double Click on "Collect Files"
4. Check the box for "Cisco CallManager" for all nodes in the cluster.
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
9

5. Click Next. Do not selected any traces on the second menu.
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
10
6. On the final screen select the time at which the dump was created as well as a
download location on the local PC. Click "Finish."

7. The traces should download to the local PC.
Disable the Dialing Forest Dump Enabled Service Parameter
It is important to disable the Dialing Forest Dump parameter to ensure the system is not
adversely impacted by malicious user exploiting this setting.
How to dump CCM memory/IMDB diagnostic information to traces
Postings may contain unverified user-created content and change frequently. The content is provided as-is and
is not warrantied by Cisco.
11
1. Login to the Cisco Unified Communications Manager (CUCM) Administration Page
2. Navigate to System->Service Parameters
3. Choose any server in the cluster on which Cisco CallManager is Active from the
"Server" dropdown
4. Select the the "Cisco CallManager (Active)" service from the Service dropdwn
5. Click "Advanced"

6. When the page refreshes find the "Dialing Forest Dump Enabled" Parameter under
the Clusterwide Parameters (System - General) section, and set it to False.