Introduction
This document describes how to collect Cisco CallManager (CCM) traces though the Command Line Interface (CLI) of the server's operating system (OS) for any Linux based system, in case you cannot access the Real-Time Monitoring Tool (RTMT) application.
Contributed by Christian Nuche (cnuche), Cisco TAC Engineer.
Also check and bookmark the main page of these how to series which is continuously updated with Unified Collaboration Resources.
cnuche's One Stop, Unified Collaboration Tech Resources - Continuously updated.
Background Information
What is it?
CCM traces are the logs that the call control process (CallManager) generates, these should be set to detail and ensure you have the appropriate checkboxes enabled to collect the information you want.
What is it helpful for?
This is helpful to troubleshoot a variety of issues on the system like, call route issues, interoperability with other systems, SIP or SCCP issues, GW related issues, these will basically show you what CUCM does internally when it receives or makes a request.
Prerequisites
Components
- CUCM's OS Administrator password
- A Secure Shell (SSH) client such as putty, (http://www.putty.org/)
- A Secure File Transfer Protocol (SFTP) server like FreeFTPd (http://www.freesshd.com/?ctt=download) for detailed instructions on how to configure and use FreeFTPd see: How to configure FreeFTPD for Unified Communications
Collect the files
Step 1. Open Putty, and log in to the CUCM CLI
Step 2. In order to verify the files you need use the file list command.
file list { activelog | inactivelog | install } file-spec [ page | detail | reverse ] [ date | size ]
* The location of the files are:
activelog cm/trace/ccm/sdl/SDL*
activelog cm/trace/ccm/calllogs/calllogs*
activelog cm/trace/ccm/sdi/ccm* (CUCM 7.x and older)
If you need to download other type of files, you can find a useful list of file locations on: Communications Manager RTMT Trace Locations in CLI
https://supportforums.cisco.com/document/65651/communications-manager-rtmt-trace-locations-cli
Example
file list activelog cm/trace/ccm/sdl/SDL* detail
This shows you the date, time, size and filename, you can download only the files you need based on this information or you can collect all the files in the folder.
Step 3. Download the files with the command file get
file get { activelog | inactivelog | install } file-spec [ reltime | abstime ] [ match regex ] [recurs] [compress]
Example
file get activelog cm/trace/ccm/calllogs/calllogs*
This command downloads all files in the folder, the system prompts you for the SFTP server details, remember that in order to use the SFTP root on windows based SFTP servers you use '\' and for Linux based SFTP servers you use '/' see below:
If you get any .gzo files those are files that were open at the time you download them, you probably wont be able to open them but the rest of the files should be .gz that you can extract with 7-zip (http://www.7-zip.org/) in case you want to open the files.
If you need to open the gzo files you can use the CLI command file view and use the entire path, and include the filename, in this case you need to copy the output and paste it on a text editor that supports Unix end of lines, like Notepad++
You can also use any linux box to get the content, in this case use the command zcat <filename>
Step 3. Once you have all the files you need, create a zip file and add all the folders that contains the files you just download, then upload them to your TAC case through the case file uploader tool: https://cway.cisco.com/csc
Step 4. Notify the TAC engineer you work with that you have uploaded the files.