Click the Add pane to add a new device. The "Device Information" window has five (or six) tabs.
Describes the device Make/Model/etc.
|Vendor||Use the drop down list to filter the 'Device Type' list box by vendor or choose all vendors to show all Device Types.|
|Device Type||Use the drop down list to select the CatTools device type.|
|Group||Enter or select the name of a group you want this device to belong to. This is a free form field where you can simply create a new group by typing new text. Use group names to group your devices into logical or physical categories.|
|Name||Give the device a unique name.|
|Host Address||Enter the IP address of the new device (in standard aaa.bbb.ccc.ddd format, or use a hostname).|
|File Name||This is the base file name CatTools will use for this device's data and reports. This field reflects the device name, but transforms any characters that are not usable in a file name.|
|Model||Use the drop down list to select the device Model. This is a free form field so you can enter any text you like. This field is only for documentation and has no effect on the operation of CatTools - the Device Type determines how CatTools handles a session with a device.|
|Connect via|| |
Use the drop down list to select a device to connect via. The default is "direct connection". You only need to specify another device when direct access to the desired device is not possible. CatTools allows you to hop from one device to another using Telnet or SSH to reach your final destination. For example, if your device is behind an access list, but a Linux box has access to that device, you can connect via the Linux box first, then launch a telnet or SSH session to the destination device from there.
Note: When using a Cisco router as a jump point, it is recommended that you disable "logging synchronous" in the Line VTY section of the config. This can cause problems when trying to telnet out from the router.
By default most Cisco routers would have been configured with 5 lines (line vty 0 4). As CatTools is multi threaded and can support (depending on your edition) up to 30 client threads (connections); if you have created an activity for more than 5 devices which all connect via the router, you may end up with timeout errors or connection failures as a result of all the available router lines being used.
To prevent these errors occurring you could:
A. Increase the number of VTY lines available on your main connect via router.
B. Set the 'client threads' to use '5 threads'.
C. Use a Linux box as a connect via device instead of a router.
Use the drop down list to select connection method. The default is "telnet".
Note: that when using SSH there may well be a specific variant of it that is required to connect with the specific device. For instance, Netscreen devices supporting SSH2 require the variant SSH2-nopty to connect successfully with CatTools. More information on Session connections is available here.
|Port||Enter the port number the selected connection method is to use. The telnet default is 23, etc, and typically this does not need to be changed. SSH connections should use port 22.|
Device login/enable and other passwords.
|VTY Password||Enter the Virtual Terminal or initial login password here.|
|Enable Password||Enter the enable mode or privileged password here.|
|Privilege Level|| |
You may set the enable mode privilege level if required. This is typically not required and so is best left blank. On a Cisco router, there are 16 privilege levels (0 to 15).
Standard enable mode puts you in level 15.
This is appended to the enable command when it is sent to the device, so if it is present and not required it may cause an error when the device tries to authenticate enable mode.
|Console Password||Enter the console password if using a direct COM port connection.|
|Username||Enter the Username (e.g. AAA, TACACS, RADIUS or Local username/password, etc.)|
|Password||Enter the Password (e.g. AAA, TACACS, RADIUS or Local username/password, etc.)|
|SSH Username||Enter the SSH Username if required.|
|SSH Password||Enter the SSH Password if required.|
|SNMP Read||Enter the SNMP Read community name for your device. The SNMP Read community name default is normally "public", however it is recommended you change your SNMP Read community name to some else. This field is required for running the SNMP.System.Summary activity otherwise SNMP timeout or unknown error will occur.|
|SNMP Write||Enter the SNMP Write community name for your device. The SNMP Write community name default is normally "private", however, it is recommended you change your SNMP.|
|Initial login requires password|| |
Tick box if initial login to this device requires a password (typically the VTY or initial console password).
Initial login requires username/password: tick box if initial login to this device requires both a username and password
|Enable mode requires username/password||Tick box if login to enable mode on this device requires both a username and password. The value from the Username field is used along with the Enable password.|
Describes the command line prompts used by a device if they differ from the default. Entries are only required here where a device has non-standard prompts configured.
|VTY Prompt|| |
Enter the non-standard VTY login prompt for this device. The VTY prompt refers to the text that the device prompts you with when asking for the initial login password. For example:
|Enable Prompt|| |
Enter the non-standard Enable prompt for this device. The Enable prompt refers to the text that the device prompts you with when asking for the Enable password. For example:
"Password: " or,
"Super user login: "
|Console Prompt|| |
Enter the non-standard Console prompt for this device. The Console prompt refers to the text that the device prompts you with when asking for the initial console login password. For example:
|Username Prompt|| |
Enter the non-standard Username prompt for this device. The Username prompt refers to the text that the device prompts you with when asking for the initial login user name, normally used along with a password for AAA/TACACS/RADIUS or Local authentication. For example:
"Username: " or,
"Please enter login name: "
|Password Prompt|| |
Enter the non-standard Password prompt for this device. The Password prompt refers to the text that the device prompts you with when asking for the initial login password, normally used along with a username for AAA/TACACS/RADIUS or Local authentication. For example:
"Password: " or
"Please enter login password: "
Describes contact information of personnel responsible for a specific device.
|Address 1||Location of the device (can be seen on the Devices list if the "Location" column has been enabled)|
|Address 2||Location of the device.|
|Address 3||Location of the device.|
|Contact Name||The name of the person responsible for this device.|
|Contact Phone||How to contact the person responsible for this device.|
|Contact E-mail||How to contact the person responsible for this device.|
|Contact Other||Any additional contact info.|
|Alert e-mail||Who to notify by e-mail of any alarms or alerts for this device.|
Additional device specific information and fields. These fields are all free form and you can enter any text you wish.
|Serial number||The serial number of this device.|
|Asset Tag||Asset tag information.|
|Identification||Identification info for this device.|
|Other info||Any other serial number information.|
|Activity Specific1||Information specific to a particular activity.|
|Activity Specific2||Information specific to a particular activity.|
Only visible on supported devices. Specify user-defined device variations.
The following buttons appear at the foot of all device tabs.
"Ping device" - Sends ICMP Ping packets to the highlighted device.
"Telnet/SSH" - Uses the defined Telnet or SSH client program to start a manual session with the highlighted device. The Telnet & SSH client programs can be defined in the CatTools Setup dialogue.
"OK" - Accept the current changes and return to the main display.
"Cancel" - Cancel any changes and return to the main display.