The Device.Backup.TFTP activity makes a backup of the specified file and optionally compare it to the current file on disk. If there are differences, the current file is moved to the "Dated Configs" folder and the filename is appended with the current date. The newly downloaded file then becomes the current file. A HTML differences report is created in the "Reports" folder and a copy is emailed to a specified email address.
SolarWinds recommends using the Device.Backup.Running config activity to backup your config files. However, the Device.Backup.TFTP activity serves as a useful alternative in certain circumstances.
Although this activity is designed to replicate the Device.Backup.Running config activity using Trivial File Transfer Protocols (TFTP), it is not limited to device configurations. You can specify other files, such as
VLAN.dat. You also have the option to generate a comparison report. Some files may be in binary format and therefore cannot be compared using Kiwi CatTools. Finally you can also specify custom commands to send to TFTP the file.
The Device.Backup.TFTP activity completes the following tasks:
- A connection is made via SSH or telnet to the device.
- Commands to use TFTP against the specified file is issued.
- The file is collected and stored in the TFTP folder.
- A check is made to see if there is an existing file on disk for this device.
- If a current TFTP file exists, it is compared to the newly downloaded file.
- A text and HTML report is made of any differences and stored in the "Reports" folder. A copy of the difference report is sent to a specified recipient via e-mail.
- The current file is moved to the "Dated configs" folder and appended with the current date.
- The newly downloaded file is put in the TFTP folder and becomes the current file backup.
- If a current TFTP file does not exist, the newly downloaded file is placed in the TFTP folder as the current file backup.
Setting up the activity for Device.Backup.TFTP
For information on setting up activities, see Add / Edit scheduled activity details.
This activity is available in the following device scripts:
Configure the options specific to the Device.Backup.TFTP activity in the Options tab.
|Optional alternate list of commands||
Removes the selection from the 'File to write to TFTP Server' checkbox. Some device scripts include a default set of commands that can be used to generate and TFTP the config for this activity. However, should there be no default commands for your device you can use this box to enter your own.
For example, you may enter the command:
copy running-config tftp:
When specifying the name of the file to be written, the name must include the
|Enter commands in enable mode||
CatTools enters enable mode before issuing any commands to a device.
|Answer [yes] to any confirmation prompts||
Some issued commands have confirmation prompts, such as:
If this option is unchecked, then the activity will enter
|File to write to TFTP server||
Use the default list of commands, where available, to TFTP the file.
Enter the name of the file you want to TFTP in the text box, for example,
Specifies the folder and file name of where to store the current file. By default this is in the configs folder and uses
The default location is
This value is where any new configuration files are stored. If an existing file exists a comparison is done against the newly downloaded file. If there are no changes, no files are modified.
|Compare, move to dated file||
Runs a comparison between the file downloaded and an existing file, as specified by the current file. You can specify the folder and the file name of the stored dated files. The current file is moved to the dated config folder if changes are detected.
The default location is
See the section Filename Variables for a list of variables you can use.
If you expect a new file to repeatedly contain lines of text that are different from the original file every time the comparison is run, such as a timestamp, you can add the lines to disregard in Ignore Text. More information is available on the Ignore Text field.
To ignore "certificate self-signed" changes on Cisco routers, see the block text ignore example.
|Only notify by e-mail if configs have changed||Run configuration backups as often as you want, but only receive an e-mail notification when changes are detected.|
|Attach reports to e-mail||
Choose what level of diff reports you are sent via e-mail:
If you want full comparison reports with highlighting, use the HTML compare report. If you just want the changes, use the text report.
If you are sending the reports via an insecure medium, such as a corporate network or internet, be aware that the HTML reports contain your full device configuration. SolarWinds recommends that you send password protected HTML reports over an insecure medium.
|Zip attachments||To reduce network traffic and allow for password protection, you can choose to zip the attachments. This is the recommended and default option. It keeps the e-mail smaller and places all the files in a single attachment, which can be beneficial when you have, for example, 400 devices.|