1. Knowledge Base
  2. CloudFS Maintenance

Diagnostic Tool Commands

Only pertains to Panzura CloudFS7

The following table lists the diagnostic tool commands.

Command Description
diag-ad-history Displays results of the authentication check that is done every 10 minutes. The results are a condensed and analyzed version of the Active Directory history log file.
cdiag-report Displays a data dump. Example: cdiag-report tail
cdiag-switch Turns cloud diagnostics on or off. Enter on or off. Diagnostics must be on to use the cloud metrics tools. This setting does not survive a reboot. Example: cdiag-switch on
cloud-connect-test Displays license and connection information based on the cloud license that is loaded, including success, failure, and what ports are open or closed. If the cloud connect is successful, you can perform cloud-upload-test.
cloud-runtime-stat Displays runtime statistics. Useful mainly for uploads. The statistics for download are not as useful because pre-fetch is used. For download, you may see failures occur even if status is OK, because the system is looking for future snapshots that do not exist.
cloud-upload-test Tests the connection to the cloud.
diag-ad-config Displays the status of the Active Directory connection (joined or not).
layer-four-traceroute

Sends a Layer 4 traceroute command to the specified IP address and optional port number.

Example: layer-four-traceroute-gb2 10.3.3.3:443

layer-four-traceroute-gb2

Sends a Layer 4 traceroute command to the specified IP address and optional port over the GB2 interface (cloud facing).

Example: layer-four-traceroute 10.3.3.3:443

mark-remote-disable Disables remote file marking.
mark-remote-display Displays the current setting for remote file marking.
mark-remote-enable Enables remote file marking.
nslookup Obtains information about a host. Example: nslookup host5
pchar Displays information on bandwidth latency and loss between the filer and the specified system. Example: pchar 10.3.4.5
ping Sends an ICMP ping command to the specified IP address. Example: ping 10.3.4.5
ping-gb2 Sends an ICMP ping command to the specified IP address over the GB2 interface (cloud facing). Example: ping-gb2 10.3.4.5
repair-ad-config Reinitialize the SMB/CIFS services. Note that issuing this command results in connection loss. This command does not provide any output.
restart-smb-service Restarts the SMB/CIFS service.
restart-grw Used by Panzura Support.
run-cmd

Executes a CLI support-level command.

Caution: These commands should be executed only under the direction of Panzura support. Any misuse could void your warranty.

search-log Allows you to search the system log for the specified keyword. Example: search-log AUDIT
show-cfg-error Displays configuration errors.
show-dp-data Used by Panzura Support.
show-dp-list Used by Panzura Support.
show-dp-stats Used by Panzura Support.
show-fs-list Lists all of the local and remote CloudFS file systems.
show-fs-snapshot Lists information about current snapshots.
show-interface Displays interface information.
show-inventory Displays the current PFOS version and the hardware configuration that was originally shipped.
show-log-config Displays information about config changes.
show-log-tail

Displays contents of system message logs.

If you are using the EAP capability, you can display the logs by using the command: show-log-tail /var/log/avquarantine

show-malloc-stats Displays virtual memory allocation.
show-pktcap-list Displays results of any previous packet capture.
show-pktcap Displays the contents of pcap file for the most recent packet capture.
show-pktcap-hex Displays the hex dump of the pcap files for the most recent packet capture.
show-pktcap-host Displays the host information for the most recent packet capture.
show-pktcap-icmp Displays the ICMP information for the most recent packet capture.
show-pktcap-list Displays the list of existing packet captures.
show-pktcap-tcp Displays the TCP information for the most recent packet capture.
show-pktcap-udp Displays the UDP information for the most recent packet capture.
show-pool-iostat Shows current file system stats for read and write IO operations and bandwidth usage.
show-pool-list Displays information about used and free space. Information is the same as in the Dashboard, but in raw form.
show-pool-status Displays information about drive availability and cloud license.
show-route Displays route table information.
show-system Displays system and file information.
show-vm-stats Displays virtual memory status.
show-zfs-properties Used by Panzura Support.
show-zone-stats Used by Panzura Support.
show-system Shows a snapshot of the system resources, including load, CPU, and memory usage and the top running processes.
smb-add-gcfg

Use this command with the options indicated in this example to allow browsing of snapshots.

Example: smb-add-gcfg pz_allow browse snapshots=yes

After running the command, you can browse to the ~snapshot directory for each share.

smb-clr-gcfg Used by Panzura Support.
smb-debug Used by Panzura Support.
smb-dsp-gcfg Used by Panzura Support.
smb-regen-machine-secret Used by Panzura Support.
traceroute Sends a traceroute command to the specified IP address. Example: traceroute 10.3.3.3

traceroute-gb2

Sends a traceroute command to the specified IP address over the GB2 interface (cloud facing).

Example: traceroute-gb2 10.3.3.3

run-cmd with parameter fs_ddcopy -h

The fs_ddcopy command is available from the Diagnostic Tools section of the WebUI. Navigate to Maintenance > Diagnostic Tools. Then select run-cmd in Command Type, then in Parameters, enter the fs_ddcopy command. (See Diagnostic Tools.)

This command helps to create a copy. Here are the actions that users can take:

Usage: fs_ddcopy [-s <nNsStT>] [-NL] [-g fileglob] [-S srcpath] [-D dstpath] [-t num_threads] [-T timeout_secs] [-R retries] [-fhnvV] [-d serialize_fmt] [-m log_mask] [-o option_file]

-g, Include all files that match glob.

-D, Write files to this path.

-S, Read files from this path.

-N, No work performed.

-L, list attrs/xattrs

-r, Do not recursively walk the file system

-s, Sort by:

n - name

N - name reversed

s - size

S - size reversed

t - time

T - time reversed

-t, For recursive walks, use multiple threads

-T, Set individual timeout (Default=0 is no timeout).

-R, Set retries per attempt (Default=2 is two retries).

-d, Dump internal state of the system on completion.

decimal value or:

Format: J - JSON. X - XML. B - BEF. T - Text. C - CSV.

Quantity: r - recurse, a - about (more detail), p - Pretty, d - Debug

Examples: Jra - JSON, recurse, about

X - XML, top level only

-f, force overwrite of all existing files (Default behavior does not overwrite existing files.)

-h, Display this help summary.

-n, Print information on what would have been done, but do not execute.

-m, Set logging mask.

-o, Take options from file [option_file].

-v, Enable verbosity. Add more 'v's to increase verbosity.

-V, Print version information.