Submit a ticketCall us

whitepaperYour VM Perplexities Called, and They Need You to Read This.

Virtualization can give you enormous flexibility with future workloads and can be a key enabler for other areas, like cloud computing and disaster recovery. So, how can you get a handle on the performance challenges in your virtual environment and manage deployments without erasing the potential upside? Learn the four key areas you need to be focusing on to help deliver a healthy and well-performing data center.

Get your free white paper.

Home > Success Center > Kiwi CatTools > Kiwi CatTools Documentation > Kiwi CatTools 3.11 Administrator Guide > Activities > Activities list > Device.CLI.Send commands > Setting up a Device.CLI.Send commands activity

Setting up a Device.CLI.Send commands activity

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

Views: 753 Votes: 0 Revisions: 1


Activity tab:

Create a new Activity and select Device.CLI.Send commands as the Activity Type:

Leave the other options on this tab at their defaults.


Time tab:

Select, for instance, "At Midnight" as the Recurring option in the Times box to run the activity every night at midnight.

Leave all other options on this tab at their defaults.


Devices tab:

Select the Devices you want to configure from your CatTools Host.


E-mail tab:

Set preferences for reporting on this Activity.


Options tab:


List of commands to be entered into the device (Max 10,000 chrs):


This field is where you enter the specific commands to be sent to the selected device(s).


Examples of some CLI commands that can be entered:

(On a Cisco router)

Clear counters

Clear interface


(On a Cisco Catalyst CatOS switch)

Set Port 1/1 disable

Set Port 2/12-24 enable


Each command must be entered on a separate line. If you enter a blank line between commands then this will be sent just as if you pressed enter in a telnet session.


There is a limit on the size of this field, which is 10,000 characters. This gives you considerable room for putting together quite sophisticated configuration changes.


Or, read commands from file:


This option is preceded by a check-box and is followed by a normal path/filename entry field.


(This option and the one above it are mutually exclusive. If you check the box then the commands field is deactivated, and the commands are only read from the text file you specify here.)


The rules for entering commands in the text file are the same as they are for entering them in the commands list. Every line is read as a command to be entered in the devices config mode. A blank line between commands is read as an <Enter>.


The major difference between the two methods is that the text file doesn't have a limit on the number of characters like the command list does.


Within the commands, you can use a number of variables that are replaced by actual values when the commands are presented to the device. See the section Command Variables for a list of variables you can use.


Enter commands in enable mode:

Selecting this check box tells CatTools to enter enable mode bfore entering any of the commands to the device.


Save device output to file:

Selecting this check box tells CatTools to write file of all output from the device to the file specified in the filename field. It is checked by default, and the default filename is based on the device name and the date.


This is basically a device-specific record of each time the activity runs. All output from the device is recorded in the text file, exactly as it would appear in a telnet session.


Each device selected creates its own unique output file based on the %DeviceName% and %DateISO% variables.


See the section Filename Variables for a list of variables you can use.


The following options are all check boxes and all are checked by default.


Overwrite existing capture file:

Overwrites the file created by the output from the last run of this Activity. If unchecked, the file is appended, but a new file is created each time the date changes.


Answer [yes] to any confirmation prompts:

Some commands have confirmations prompts ("are you sure? Y or N") so the program will automatically answer them in the affirmative, on the assumption that if you entered the commands you actually want them to be executed. If this option is unchecked, then the activity will enter an "n" in response to any confirmation requests.


Stop on error:

Stops the activity immediately if any error occurs when a command is sent to the device.

Last modified