Manual Chapter :
Overview: Troubleshooting options
Applies To:
Show Versions
Overview: Troubleshooting options
If you have trouble getting the VELOS system set up and
configured, there are some options available to help you.
You can also search the AskF5 Knowledge Center or create a service request
at support.f5.com.
Generate system reports from the webUI
If you have any concerns about your system
operation, you can use the
qkview
utility to generate a system report to collect configuration and
diagnostic information from the VELOS system. The QKView report contains
machine-readable (JSON) diagnostic data and combines the data into a single compressed
tar.gz format file. You can upload the QKView file to F5 iHealth where you can get help to verify proper
operation of the system, with troubleshooting and understanding any issues you may be
having, and ensure that the system is operating at its maximum efficiency. You can generate a system controller QKView from the system
controller webUI, and a chassis partition QKView from the chassis partition webUI.
Both reports contain diagnostic information such as configuration data, log files,
and platform information.
- Log in to the VELOS system controller webUI or the chassis partition webUI using an account with admin access.
- On the left, click.The System Reports screen displays. A list of QKView reports that were previously generated is shown along with any reports that were uploaded to iHealth.
- To generate a system report, clickGenerate QKViewin the upper right corner of the screen.The system runs many commands to collect the diagnostic information, so generating the report might affect its performance.It takes a few minutes for the system to finish creating the report and list it on the screen. The QKView Status saysFile generated successfullywhen it is done.
- If you want to upload the report to the F5 iHealth server, select the check box next to the QKView name, and clickUpload to iHealth.To do the upload, the system must have DNS configured, and have Internet access to these services using the HTTPS/443 remote service/port:
- api.f5.com
- ihealth-api.f5.com
The QKView tar file is uploaded to iHealth where you can get help to diagnose the health and proper operation of the system. - To delete a QKView report, select it and clickDelete.
Generate a tcpdump
You can use the
tcpdump
utility to capture traffic in chassis
partitions. You can then save the captured traffic as a file that can be
analyzed to help troubleshoot network issues.- Connect using SSH to the partition management IP address.
- Generate a tcpdump.system diagnostics tcpdumpThese options are available to use with this command:OptionDescriptionExample-i | interfaceSpecifies the interface on which to capture packets. Omit or specify"0/0.0"to indicate all interfaces.This example captures traffic on interface 1.0 on blade number 2:system diagnostics tcpdump interface "2/1.0"-w | outfileSpecifies the pcap file to write the captured packets.This example combines options to capture only traffic on interface 2.0 on blade 1, where the source IP address is 198.51.100.0 and the destination port is 80, and sends the output to a specified directory.system diagnostics tcpdump outfile /var/F5/partition/shared/example_file.pcapbpfSpecifies the Berkeley packet filter expression for tcpdump.This example captures traffic where the source IP address is 198.51.100.0 and the destination port is 443:system diagnostics tcpdump interface "1/2.0" bpf "src host 198.51.100.0 and dst port 80" outfile /var/F5/partition/shared/example_capture.pcap
Other file and configuration management commands
You can also use these commands to help with
troubleshooting. You can type a question mark (
?
) or press the Tab key to see
possible command completions in the CLI.Command | Description |
---|---|
system database config config-backup
config-restore | Saves the CDB configuration to an
XML file and restores CDB configuration. |
file
list path < dir-path > | Displays the contents of the
specified directory. |
file show < file-path > | Displays the contents of a specified
file. |