Manual Chapter :
Troubleshooting options
Applies To:
Show VersionsF5OS-A
- 1.7.0, 1.5.0, 1.3.0, 1.2.0
Troubleshooting options
If you have trouble getting the
rSeries
system set up and configured, there are some options available to help you.Many functions in the system will log events to the
velos.log
file. In the CLI, you can use the file list path
command to view the files in the log/controller
directory.You can also search the knowledge articles on my.f5.com.
Generate system reports (QKView) from the webUI
You can generate a QKView file from the webUI. The report contains diagnostic information, such as configuration data, log files, and platform information.
- Log in to the webUI using an account with admin access.
- On the left, click.The System Reports screen displays. A list of QKView files that were previously generated are shown with any reports that were uploaded to iHealth.
- To generate a system report, clickGenerate QKViewin the upper right corner of the screen.The Generate QKView box displays these additional options:OptionDescriptionFilenameSpecify a name for the file to which QKView file data is written. The default filename is<.system-name>.qkviewTimeout ValueSpecify the time in seconds after which to stop QKView file data collection. The default value is 0, which indicates no timeout.Max File SizeExclude all files greater than the specified size (in MB). The range is from 2 MB to 1000 MB. The default value for maximum file size is 500 MB.Max Core SizeExclude core files greater than this size (in MB). The range is from 2 MB to 1000 MB. The default value for maximum core size is 25 MB.Exclude CoresSpecify whether core files should be excluded from the QKView file. The default is to include core files.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 changes toFile generated successfullywhen it is done.
- To upload the report to the F5 iHealth server:
- Select the check box next to the QKView to be uploaded.
- ClickUpload to iHealth.
- In the Upload to iHealth popup, enter your iHealth credentials.Optionally, you can include your F5 Support case number and a brief description.
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 uploads to iHealth, where you can get help to diagnose the health and proper operation of the system. - To delete a QKView file, select it and clickDelete.
Generate a tcpdump
You can use the
tcpdump
utility to capture traffic
on your system. You can then save the captured traffic as a file that can be analyzed to
help troubleshoot network issues.Generating a tcpdump is only supported on the F5
r5000/r10000 platforms.
- Connect using SSH to the 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 specify0.0to indicate all interfaces.This example captures traffic on interface 1.0:system diagnostics tcpdump interface 1.0-w | outfileSpecifies the pcap file to write the captured packets.This example sends the output to a specified directory:system diagnostics tcpdump outfile <example-file>.pcapbpfSpecifies the Berkeley packet filter (BPF) expression for tcpdump. This option uses standard BPF syntax.This example captures traffic where the source IP address is 192.0.2.0 and the destination port is 80:system diagnostics tcpdump bpf "src host 192.0.2.0 and dst port 80"
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.For a comprehensive list of CLI commands, see the CLI Reference
for your
F5OS
system at clouddocs.f5.comCommand |
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. |