Submit a ticketCall us

Cloud Workloads: Meet Your New Hybrid IT Reality
Have you found yourself in that evolving, hybrid IT grey area and wondering if cloud workloads are now part of your purview? And if so, will monitoring cloud workloads require a new set of dedicated cloud monitoring tools? Your answers: yes, they should be, and no, they don’t.

Find out how SolarWinds® Server & Application Monitor (SAM) can help you monitor your cloud workloads side by side with your on-premises workloads. Register Now.

Home > Success Center > Kiwi CatTools > Read Kiwi CatTools debugging files

Read Kiwi CatTools debugging files

Table of contents
Created by Chris Foley, last modified by MindTouch on Jun 23, 2016

Views: 117 Votes: 0 Revisions: 5

Overview

The CatTools Debug file provides details regarding the communication transactions between CatTools and the target system.  This can be helpful when CatTools is returning errors.

Environment

  • All CatTools versions 
  • All Windows versions 

Steps

  1. From within the CatTools Manager, click File > Enable Capture Mode.
  2. Run the Activity that appears to be failing.
  3. Open the device debug file within the following directory:

\Program Files (x86)\CatTools\Debug\

 

The debug file contains the following:

  • The CatTools version being used.
  • The Protocol used to connect to the device.
  • The Device Type assigned to the Device in CatTools.
  • The Activity Type being run.

 

Example: 

 

The DebugLog file also contains within it, the commands and control characters sent to and received from the device.

 

  • Commands sent are preceded with a <W-…> time-stamped tag.
  • The responses from the device are preceded with a <R-…> time-stamped tag.

 

Below is an extract from a debug log (header and footer removed) showing a simple password only authentication to arrive at the device non-privileged prompt and then logout:

 

<C OK 4:06:53 PM>

<R-4:06:53 PM>[13][10][13][10]User Access Verification [13][10][13][10]Password:

<W-4:06:53 PM>MyPassword[13]

<R-4:06:53 PM>MyPas

<R-4:06:53 PM>sword

<R-4:06:53 PM>[13][10][13][10]EW1_Server_Switch>

<W-4:06:54 PM>logout[13]

<D 4:06:54 PM>

 

  • The <C …> tag shows the connection being made to the device.
  • The <D …> tag is the disconnect.
  • The [13] and [10] signify a CR and a LF control character respectively.

 

For SSH protocol connections, unless the device is setup with 2 factor authentication (e.g. connection over SSH and local device authentication), you will normally only see the connection <C …>tag and then most likely the device hostname prompt.  The authentication for SSH connections is handled internally by the WODSSH connection client, so it is not written to the CatTools device debug file.

 

Once CatTools is connected and logged in, it will expect one of three things:

 

  • A user prompt (such as EW1_Server_Switch>)
  • An additional username prompt (such as username:)
  • An additional password prompt (such as password:)

 

If it does not receive either one of these, it will report something like this:

 

<R-4:06:53 PM>Last login: Fri Dec 18 09:14:56 2008 from 10.0.0.0[13][13][10]
<R-4:06:53 PM>Press enter to continue... 

================================================================================
WFMDRetVal=1 Waiting for: "EW1_Server_Switch> "
WFMDRetVal=2 Waiting for: "EW1_Server_Switch#"
WFMDRetVal=3 Waiting for: "Username:"
WFMDRetVal=4 Waiting for: "Password:"
WFMDBuffer="Last login: Fri Dec 18 09:14:56 2008 from 10.0.0.0[13][13][10]Press enter to continue..."

================================================================================

 

To resolve this, you will need to set the Device's Variations to compensate for the unexpected responses from the device.  More on Variations is found here:

 

http://www.kiwisyslog.com/help/catto...variations.htm

 

To resolve the above issue, you would set the Post-Login Variations as follows:

1. Post-Login Keystroke: CR

2. Post-Login Message: Press enter to continue

 

 

Last modified

Tags

Classifications

Public