TranslatorX - Quick & Easy Call Manager Trace Analysis Tool

TranslatorX is an extremely powerful tool for Windows, Linux and Mac that allows for rapid parsing of Call Manager traces.  Just point it to the root directory used by RTMT to pull traces and TranslatorX will search all traces in the folder.

You won't have access to this tool (or any others like it) on the CCIE Voice lab or during any other certification exams, but I like to review the traces when doing lab testing in preparation for the CCIE Voice or CCNP Voice certifications.  It goes a long way to help understand how a protocol works - as well as help troubleshoot something that you just swear should be working, but isn't.

TranslatorX - Call Manager Trace Tool

TranslatorX allows you to quickly parse through Cisco CallManager trace files and search for Q.931, H.225, SCCP (Skinny), MGCP, or SIP messages.

Download TranslatorX Now


Functionality

Version History

Version 10.0(2) - Released May 8, 2014

• Fixed a bug where CUBE debugs were not read in properly if Timezone was enabled for the timestamps
• Beta support for VCS H.323 Signaling. Note that filtering for VCS H.323 messages is still not available.

Version 10.0(1) - Released April 16, 2014

• On call flow diagram, you can click on an IP address in the header and add a description to help you better remember what that column represents
• Improved handling of various line ending formats that may have resulted in TranslatorX being unable to find messages in a file on Windows
• Improved support for VCS and Expressway trace files
• Added checkboxes to filter out SUBSCRIBE / NOTIFY / PUBLISH events
• Various Miscellaneous Bug Fixes

9.1(2)

• Added ability to correlate H.245 messages to H.225 when Fast Start is enabled
• Auto-generated filters for H.225 will also include H.245 messages in the filter
• Fixed problem where CUBE IP address shows up with ;user=phone
• Removed menu for Connect to Server... that did not do anything. This is for a future feature that is not done and was inadvertently included in the 9.1(1) release.
• Fixed a problem with the Q.Sig translator module did not work on Windows XP and Windows 2003 leading to an error about txmt.exe not being a valid Win32 application.

9.1(1)

• Fixed bug where H.245 messages were not being properly correlated with H.225 messages
• Fixed problem where searching was case-sensitive. Searches are now case-insensitive
• Fixed problem with display of SIP disconnect cause codes in CDR details
• Fixed problem with filtering messages from Microsoft Lync (because Lync uses all capital letters for message header names)
• Added Beta support for CUSP logs
• Miscellaneous Bug Fixes

9.0(3)

• Embedded Q.Sig Decoder will automatically decode FACILITY IE's.
• Added ability to decode Redirecting Number IE for Q.931/H.225 Messages
• Added Export of Summary List to text file.
• Added Export of Detailed Decoded Messages to text file.
• Added CDR Export to text file.
• Trace viewer window (when you double-click a message to take you to the raw trace file) allows multi-line selection and Copy to clipboard.
• Miscellaneous Bug Fixes

9.0(2)

• Fixed detection of MGCP keepalives.
• Added Clear Filters button to main translator window.
• Message Sequence Diagrams are color-coded with different background for each SIP Call ID or Q.931/H.225 Call Reference.
• Fixed a Crash when using Drag and Drop and selecting "Append to Existing" if traces contain H.225 messages and the traces are pre-9.0.
• Fixed a problem where opening files on Japanese (and perhaps other double-byte language) versions of Windows takes a very long time (minutes for 1 file).
• Fixed a bug on the Mac version where it stops updating the message decode while scrolling through the list box when you encounter a message that has certain non-ASCII characters.
• Double-clicking a message that was originally contained in a .gz file would result in a blank window. This is fixed.
• Fixed a bug that cause IOS CUBE SIP Debug parsing to show only one message if time zone is included in service timestamps or msec is not enabled.
• When manually checking for updates on the Windows version would say "You already have the newest version of %." It now says TranslatorX.

9.0(1)

• Support for parsing data from SDL traces (for Unified CM 9.0 and later)
• Significantly rewritten to increase performance
• Supports natively reading .gz compressed files automatically.
• Drag and Drop Support. Just drag files or folders into the translator window.
• Automatic Updates for Mac OS X and Windows
• Improved support for CUBE debugs
• Much better handling of H.225 and H.245 ASN.1 messages (for 9.0 SDL traces only)
• The Mac version is now a Cocoa App. Please be on the lookout for UI issues on the Mac.
• Switched to Inno Setup for Windows installation. You must manually uninstall previous versions of TranslatorX.
• Numerous Bug Fixes

8.6(3)

• Fixed intermittent issue on Windows where loading files window does not disappear after loading files from folder
• Fixed bug in timestamp calculations for SIP call flows that resulted in improper filters when using the "Generate Filters" button
• Fixed problem where app would not close on Windows even though all the windows are closed. Workaround is to kill the app from Task Manager
• Numerous Bug Fixes

8.6(2)

• Fixed several severe bugs with H.225/H.245 message processing. This may have caused a wide variety of problems for any trace that contained H.225/H.245 messages.
• BETA: Added capability to read in IOS debugs that contain output from 'debug ccsip messages'. Please report issues. To use this feature, just save the debug output from IOS/CUBE to a text file and import it into TranslatorX. You should see the Call List feature work for these traces as well as the Filtering and Graphing features.
• Ability to automatically filter out OPTIONS and REGISTER messages from traces (checkbox)
• Call Graphs will now show Re-INVITE instead of INVITE for Re-INVITEs.
• Call Graphs will show (inactive) if SDP contains an inactive a line.
• Mac version is now packaged in a DMG. Fancy background with an arrow coming in future versions.
• Windows Version now has a proper installer
• Windows Version appears in a single window like other platforms.
• Some UI improvements to pave the way for a Cocoa-based version for Mac. Current builds are Carbon-based. I'm still working out some minor lingering issues with the Cocoa build before releasing it.
• Numerous Bug Fixes

8.6(1)

• Support for CUCM 8.6 trace files
• Numerous Bug Fixes

8.5(1)

• Support for CUCM 8.5 trace files
• *NEW* Message Sequence Diagram generation
• Support for H.245 messages
• Support for H.225 ASN.1 output
• Support for Correlating H.245 messages to the associated H.225 messages
• Various bug fixes
• Better SCCP to IP Address correlation
• Call List support. There is a separate window that shows you a call list derived from CDR data printed in the CCM traces. CDR must be enabled for this to work.
• If you double-click on a call in the call list, you will get the full CDR data dump for the call (todo: include CMR data) with many fields decoded for you
• Generate Filter based on Call. From the call list you can click a call and select Generate Filter. This will automatically generate a filter for the two call legs of the call listed in the CDR for the timeframe listed in the CDR.

Comparison to Triple Combo

Triple Combo is no longer available. TranslatorX is being actively supported and upgraded - no contest!

Additional Information

TranslatorX Official Website