Submit a ticketCall us

Announcing NPM 12.2
With NPM 12.2 you can monitor your Cisco ASA firewalls, to monitor VPN tunnels for basic visibility and troubleshooting tunnels. NPM 12.2 also uses the SolarWinds Orion Installer so you can easily install and upgrade one or more Orion Platform products simultaneously.
See new features and improvements.

Home > Success Center > Kiwi CatTools > Kiwi CatTools 3.11 Administrator Guide > Devices > Creating a custom device > How to create a custom device

How to create a custom device

Table of contents
No headers
Created by Caroline Juszczak, last modified by Caroline Juszczak on Jun 28, 2016

Views: 140 Votes: 0 Revisions: 1

Quick reference guide to creating a custom device in CatTools

 

This is a simple step-by-step guide on creating a new custom device in CatTools.

It contains brief instructions on how to add a custom device type to the CatTools GUI, and how to create a custom device script file.

 

The custom device templates files provided by CatTools and referenced in this guide, are based on a Cisco Router device.

It is likely that further modification will be required to the device script (.txt) file once you have created it, in order to get the script to work successfully with your specific device.

 

Further information regarding the custom device type file (.ini), custom device script file (.txt) and code examples of how to use the CatTools internal functions in your device script, can be found in the other sub pages of this chapter.

 

STEPS TO CREATE A CUSTOM DEVICE:

 

1. Create a custom device type file (.ini)

Take a COPY of the Custom.Device.Template.ini in the \Templates sub folder of the CatTools root directory and save to the \Devices sub folder, giving it a new file name using the syntax: Custom.Manufacturer.Type (e.g. Custom.Cisco.FirewallPIX).

 

2. Edit the .ini file

Using a text file editor (such as Notepad), open the .ini file created in step 1). You must change the following items in the .ini file from the template default values:

[device]

name=Custom.Manufacturer.Type 

id=4000

Change 'name' item to a UNIQUE device name. ??Example: Custom.Cisco.Router Note: do not use spaces, use a 'period' mark (.) instead.

Change 'id' item to a UNIQUE number (i.e. one not used in any other device .ini file). Number must be within the range of 4000 to 4999.

[item_Name]

default=Unique device name

Change the 'default' item to a UNIQUE device name.

 

3. Save & restart

Once you have made your changes to the .ini file, save it back to the \Devices sub folder and close.

Restart CatTools to populate the 'Device type' drop-down field in the device setup screen with your new custom device type.

 

4. Create a custom device script file (.txt)

Take a COPY of the Custom.Device.Template.txt in the \Templates sub folder of the CatTools root directory and save to the \Scripts sub folder.

Save it with a file name using the value entered for the [device] section 'name' item in step 2) above. Ensure you retain the .txt file type suffix.

Example:

(device .ini file settings)

[device]

name=Custom.Cisco.FirewallPIX

Script file name must therefore be: Custom.Cisco.FirewallPIX.txt

 

5. Edit the .txt file

Using a text file editor*, open the .txt file created in step 4). Follow the instructions in the SCRIPT NOTES section of the .txt file to begin customizing the script for your device.

(*note: although the .txt files can be opened and edited using 'NotePad', a syntax highlighting script editor may make reading and editing the .txt file much easier)

 

6. Save & test

Once you have made your initial changes to the .txt file, save it back to the \Scripts sub folder and close.

To test your custom device, create an activity that is supported by your custom device script and run it manually using the 'Run Now' button. (Device.ConnectivityTest.Login is a good starting point activity as every device must be able to log in successfully in order to perform any of the other more complex activities).

Check the Info Log pane for errors and edit your .txt file as necessary.

 

See Testing your custom device for more information and tips.

 

Creating custom device checklist:

  • Create device type file (.ini)  ___
  • Create device script file (.txt) ___
 
Last modified
07:18, 28 Jun 2016

Tags

Classifications

Public