Administration Tasks : Managing Debug Files

Managing Debug Files
This section describes how to manage the system files – log files, debug dump files, stat reports, and tcpdump results. It also describes how to archive them by saving them to an SCP (Secure Copy) or FTP (File Transfer Protocol) Server.
n
n
n
Types of Debug Files
The appliance automatically creates and stores a number of non-configuration data files as a result of normal events, traffic monitoring, system crashes, and testing.
The Appliance Manager’s Administration - Debug Files page lists these files and provides a way for you to save them to another location for storage or additional handling.
With the exception of the [Log] files, you cannot view these files on the Appliance Manager.
Specifically, these five file types are as follows:
The raw event log data, viewable on the Administration - Event Log Viewer page. This includes historical alarms, not current ones. To access this page, select Administration > Logging > Event Log Viewer.
By default, a new file begins when the file reaches 50 MB. However, you can change the rotation criteria on the Administration - Log Settings page. To access this page, select Administration > Logging > Log Settings.
Can also be created on demand by clicking the Generate button next to the System & Debug Information File field.
Can also be created on demand by clicking the Generate button next to the Tech Support File field.
Saving Files to a Remote Server
The Application Manager lets you copy non-configuration files from the appliance to a remote server.
When you click to select the method, you can only edit the required fields.
The fields and options have the following definitions:
Local File
SCP (Secure Copy)
FTP (File Transfer Protocol)
Remote Full Path
Remote Relative Path
If using the SCP server, enter the full path to the server.
(Optional) If using the FTP server, enter the relative path to the server.
(Optional) If you want to rename the file, you can do so here.
If the read-only value is Ready, you may proceed with transferring the file to a remote server.
w
To save a log file to an SCP Server
1
Go to the Administration - Debug Files page.
2
In the File Management area, click the type of log you want to save: Log, Debug Dump, Snapshot, Stat Report, or TCP Dump Result.
3
The Administration - Debug Files - Save File page appears.
4
Click SCP (Secure Copy).
5
Here, we’ll use the example of saving the file, alerts, to the following location:
scp <UserName>@170.2.2.65:/home/<UserName>/work/logs/alerts
a
For the Remote Server Address field, enter either:
b
Enter the Remote User Name and Remote Password for the Secure Copy (SCP) server.
c
For the Remote Full Path field, enter the full path.
A full pathname includes the drive (if required), starting or root directory, all attached subdirectories and ends with the file or object name. Begin the path with a forward slash (/).
d
If you want to rename the file, enter the new file name in the Destination File Name field. If you leave the field blank, the Appliance Manager saves the file with its existing file name.
6
Click Save. The Appliance Manager displays the progress.
w
To save a log file to an FTP Server
1
Go to the Administration - Debug Files page.
2
In the File Management area, click the type of log you want to save: Log, Debug Dump, Snapshot, Stat Report, or TCP Dump Result.
3
In the table, click on the file name of the file you want to save. The Administration - File System - Save File page appears.
4
Click File Transfer to Protocol (FTP).
5
Here, we’ll use the example of saving the file, alerts, to Andrew’s directories on an FTP server. In the process, we’ll rename the file to alerts_SP41-NX-8600:
a
For the Remote Server Address field, enter either:
b
Enter the Remote User Name and Remote Password for the FTP server.
c
For the Remote Relative Path field, enter the relative path.
A relative path is a path relative to the current working directory. Its first character can be anything but the pathname separator (here, a forward slash).
For example, if the ftp login directory is /home/<UserName>/, then the relative path would begin at the next subdirectory, as in, work/logs. It is not necessary to begin or end the relative path with a forward slash (/).
d
If you want to rename the file, enter the new file name in the Destination File Name field. If you leave the field blank, the Appliance Manager saves the file with its existing file name.
6
Click Save. The Appliance Manager displays the progress.
Deleting Log Files
All logs files are removed the same way.

Please send comments or suggestions regarding user documentation to techpubs@silver-peak.com.