Create and collect a (v)SZ & (v)SCG Snapshot Diagnostics File

Summary

Create and collect SZ & SCG diagnostic snapshot file. Snapshots contain recent logs from various system components that provide engineering with a single file for initial diagnostics.

Question

How to create SZ & SCG diagnostics snapshot file

Customer Environment

SZ, SZ100, SZ104, SZ124, SZ300, vSZ-E, vSZ-H managed wireless network.

Root Cause

Snapshots contain recent logs from various system components that provide Support and engineering with a single file for initial diagnostics.

Resolution

via WebUI

Go to Diagnostics >>>> Application logs

Note : Select the appropriate control-plane from the drop down menu you are investigating or complete for all control-planes / nodes if unsure.

Select "Download Snapshot log" - collecting logs and generating a single download may take several minutes. The browser status bar will show "waiting for <SZ ip.addr>"

You will be prompted to download the file directly. Snapshots are also stored under the log file group "Diagnostics"

- To show file names select the number link, in this case 1.

- The file can be downloaded by selecting the file name link.

- If the number is 0 no files are available for collection.

via CLI

From the CLI, Enter the diagnostic mode and run execute all command. This command should be executed on each SZ/ vSZ node in the cluster

vSZ-H-35# diagnostic

vSZ-H-35(diagnostic)# execute all

The concern SZ/ vSZ will respond with a message similar to the following

Loading common/_DEFAULT.conf ...
Log file archive in snapshot_20200326012248_vSZ-H-35_CLI-admin_701456.tgz

When the above process is completed the file can be retrieved from the WebUI under Diagnostics >>>> Application logs. Files can be found in the group called 'Diagnostics' for SZ/ vSZ version from 2.5 and later.

Alternatively, the snapshot can be copied to an FTP server using the following CLI command.

vSZ-H-35(diagnostic)# copy snapshot <ftp-url>
<ftp-url> FTP directory URL, Format: ftp://<username>:<password>@<ftp-host>[/<dir-path>]

Managing snapshot files

When generated from the WebUI it is important to ensure these files are downloaded immediately, so they are not overwritten with new data
In the event a snapshot is overwritten, the full logs for specific modules are kept under. Ask support which specific files may be relevant to your issue.
From the CLI files, we can deleted the snapshot file using 'delete snapshot <cr>' command or using the specific file name 'delete snapshot <snapshot_name>''.

To view a list of snapshots use 'show snapshot'

vSZ-H-35(diagnostic)# show snapshot
snapshot_20200326012248_vSZ-H-35_CLI-admin_701456.tgz
snapshot_20200326015118_vSZ-H-35_CLI-admin_701456.tgz

vSZ-H-35(diagnostic)# delete snapshot snapshot_20200326012248_vSZ-H-35_CLI-admin_701456.tgz
Do you want to continue to delete (or input 'no' to cancel)? [yes/no] yes
vSZ-H-35(diagnostic)# show snapshot
snapshot_20200326015118_vSZ-H-35_CLI-admin_701456.tgz

Article Number:
000003252

Updated:
March 26, 2020 01:33 AM (over 4 years ago)

Tags:
System Network Management, SmartCell Gateway, virtual SmartCell Gateway

Votes:
12

This article is:
helpful
not helpful