Submit a ticketCall us

Systems Monitoring for Dummies
Our new eBook will teach you the fundamentals and help you create monitors and alerts that are effective, meaningful, and actionable. Monitoring is more than a checkbox on your to-do list. This free eBook will give you practical advice to help you succeed in all aspects of monitoring – discovery, alerting, remediation, and troubleshooting. Don’t miss out on this indispensable resource for newbies, experienced IT pros, and everyone in between. Register Now.

Home > Success Center > Kiwi CatTools > Kiwi CatTools 3.11 Administrator Guide > Devices > Creating a custom device > Testing your custom device

Testing your custom device

Table of contents
No headers
Created by Caroline Juszczak, last modified by Caroline Juszczak on Oct 02, 2017

Views: 50 Votes: 0 Revisions: 2

Testing your custom device scripts is relatively straight forward.

 

Once you have the device type .ini file and the device script .txt file set up, you can test the new device with CatTools by setting up activities using the new device type.

 

The most basic activity to start testing with is the Device.ConnectivityTest.Login activity to ensure you can access the device.

Nearly all of the activities that run on a device require logging in to the device, therefore if the Device.ConnectivityTest.Login activity fails, it is likely the other activities will also fail.

 

There are several testing aids available in CatTools.

 

 

1. Info Log messages

 

Within the Info Log pane you see messages appear while an activity is running. The level of messages that appear can be filtered by the drop-down list near the bottom of the Info Log window. By selecting level "4) Show Debug events and above" you get to see all the cl.log messages being displayed during the running of an activity.

 

You should be aware that all the Info Log messages are logged to a file called InfoLog.txt in the root CatTools folder. This file can get very large very quickly, so can be purged by selecting the File | Delete | Delete lnfolog.txt file menu item from the CatTools File menu.

 

The client script function cl.Log 4,"message" is found throughout device scripts to display level 4 messages which help assist in troubleshooting device specific issues.

 

2. Debug log

 

Under the File menu of CatTools there is an entry Enable Capture Mode.  This turns on the logging of the conversation between CatTools and the end device and creates a disk file in the \Debug sub folder of the communications. This can be extremely useful when the script does not appear to be communicating correctly with the device after entering a command. The scripting mechanism waits for known prompts when issuing a command to the device, but eventually times out if an expected prompt does not appear. The debug log capture mode file shows what the device actually sent to CatTools, and you can adjust your code accordingly.

 

Last modified

Tags

Classifications

Public