Diagnostic Tools#
There is an extensive list of diagnostic tools available under the diag menu.
For example output of diag commands, see: diag Command Examples.
platform@VOSS:~$ diag
USAGE:
------
diag config [<config-item>] - Display configuration, optionally specifying the configuration prefix, diag
config /platform/network/name
diag config app <app-config> [<config-item>] - Display application configuration, optionally specifying the configuration
prefix, eg diag config app snmp /community
diag date <epoch timestamp> - Convert epoch timestamp to datetime
diag disk - Display diagnostics for disk usage
diag epoch <yyyy-mm-dd hh:mm> - Convert datetime to epoch timestamp
diag filehash - Display the file system hash integrity check
diag filehash init - Initialise the file system hash integrity check
diag free - Display diagnostics relating to free memory
diag health - Display a health report
diag health report - Save a health report as a logfile
diag iostat - IO subsystem statistics
diag largefiles - Find the largest files on your system no more than the top 10 items are display
diag mem - Display memory diagnostics
diag monitor - Display the system resource analysis
diag monitor list - Display the long-term average and maximum system resource usage
diag nicstat - Network interface statistics
diag ntp - Display ntp status
diag ping <host> - Ping a remote host to test network reachability
diag proc - Display a list of system processes
diag resolve <host> - Resolve a hostname to IP address
diag stats - Display the container statistics
diag tasks - Display constant task listing
diag test_connection <host> <port> - Test if system can open a connection to a remote port
diag top - Process resource statistics
diag traceroute <host> - Discover the network path to <host>
diag vmstat - Virtual memory subsystem statistics
Command Descriptions
Some of the commands are provided with details below:
Command |
Description |
|---|---|
diag ping <host> |
Test network reachability to a network host. |
diag resolve <hostname> |
Test DNS resolution of a hostname. |
diag test_connection <host> <port> |
Given a host IP and port number, return a message: “Successfully connected to <host>:<port>” or “Failed to connect to <host>:<port>”. |
diag free |
Display the memory usage. |
diag disk |
Display the disk usage. Logical volumes for the database have the format |
diag largefiles |
Display up to 10 largest files on the system over 1GB in size, else no files are shown. |
diag mem |
Display a more detailed memory usage by process. |
diag ntp |
Display details of ntp server, including peers and host addresses. Equivalent to the |
diag health |
Display a comprehensive health summary. This includes status on the following: CPU, Memory, Disk, Security Update, Application, Cluster, Cluster Failover and Health email scheduling. Logical volumes used by the database have the format: |
diag top |
Display a single Unix top summary. |
diag unittests |
Utility for developers only. Note that services will be restarted by this utility. |
diag filehash |
Although a checksum of system and configuration files is carried out regularly, a manual check for changes since the previous check can be carried out. If any files have changed, these will be listed in the command output. Run diag filehash init before running the command manually to initialise the filehashing database. Note that this process may take some time. If any files have changed, these will be listed in the command output. |
For diag health, see also Diagnostic Troubleshooting.