Collecting debugs from 6900 Series IP Phones


Wed, 01/07/2015 - 07:42
Feb 29th, 2012


In order to debug problems with Cisco Unified IP Phones 6900 series it may be  necessary to collect the phone console logs from the phone itself.  This document covers how to collect debugs to troubleshoot issues with the Cisco 6900 Series IP Phones.   In troubleshooting most issues, it is also extremely important to gather a packet capture from the IP Phone as well.   The packet capture procedure is covered in this document.


In order to gather debugs from the 6900 series IP Phones, the following is required:

  • Access to the Cisco Unified Communications Manager (CUCM) Administration interface
  • A secure shell client which supports logging

Enable Secure Shell Access

Enable Secure Shell Access on an individual phone

Debugs are collected by use of a secure shell session to the IP Phone.  To enable debugs on a particular phone, login to the CUCM Administration interface,  navigate to Device->Phone, and locate the phone in question.


Enable Secure Shell access on a group of phones

If the issue is intermittent and not isolated to any particular phone, it may be required to enable Secure Shell access on a group of phones as defined by a Common Phone Profile.  In this case navigate to Device->Device Settings->Common Phone Profile, and locate the common phone profile assigned to the desired subset of devices.


Specify a Secure Shell Username and Password

Either on the phone configuration page, or on the Common Phone Profile Configuration, locate the "Secure Shell Information" section.


Specify a username and password to be used for Secure Shell access.

Enable Secure Shell Access

Again, either on the phone configuration or on the Common Phone Profile Configuration, locate the "SSH Access" setting and set it to "Enabled."


Reset the phones

The phones must be reset in order to take the updated configuration file.


Gathering the debugs

At this stage, Secure Shell access should be enabled on the phone and it is now possible to login to view and collect the debugs.

Login using SSH

Launch the Secure Shell client and connect to the IP address of the phone of the phone using SSHv2 on TCP port 22.


Login using the credentials specified in the previous step Specify a Secure Shell Username and Password.

Access admin prompt through VxWorks login

A VxWorks prompt will be provided.  The default credentials are

     username/password : admin/<empty>

Enable Required Debugs

Cisco TAC may require certain specific debugs to be enabled.


Enable logging on SSH Client

Each SSH Client has a different method for logging the session, this screenshot illustrates how to enable logging of printable output on a putty session.


Reproduce the problem symptom

Once the required debugs are enabled and logging is enabled on the SSH Client, take action if needed to reproduce the problem symptom or condition.

Save the debugs

Stop logging on the SSH Client and copy the previously created file off for analysis.

Jason Burns Tue, 04/10/2012 - 19:22

Great document! I really liked all of the pictures. I wish more Cisco documentation was like this.

Jonathan Schulenberg Wed, 01/07/2015 - 07:42

I believe the VxWorks login credentials are actually username 'debug' and password of 'debug', or at least they are on the 8841 I am working with today.


This Document