Manual Chapter : Troubleshooting options

Applies To:

Show Versions Show Versions

F5OS-A

  • 1.0.1, 1.0.0
Manual Chapter

Troubleshooting options

If you have trouble getting the
rSeries
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 (QKView) 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
rSeries
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 might be having, and ensure that the system is operating at its maximum efficiency.
You can generate a QKView report from the webUI. The report contains diagnostic information, such as configuration data, log files, and platform information.
  1. Log in to the webUI using an account with admin access.
  2. On the left, click
    SYSTEM SETTINGS
    System Reports
    .
    The System Reports screen displays. A list of QKView reports that were previously generated are shown with any reports that were uploaded to iHealth.
  3. To generate a system report, click
    Generate QKView
    in the upper right corner of the screen.
    The Generate QKView box displays these additional options:
    Option
    Description
    Filename
    Specify a name for the file to which QKView data is written. The default filename is <
    system-name
    >.qkview.
    Timeout Value
    Specify the time in seconds after which to stop QKView collection. The default value is 0, which indicates no timeout.
    Max File Size
    Exclude all files greater than the specified size (in MB). The range is from 2 MB to 1000 MB. The default value is 500 MB.
    Max Core Size
    Exclude 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 Cores
    Specify whether core files should be excluded from QKView. 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 to
    File generated successfully
    when it is done.
  4. If you want to upload the report to the F5 iHealth server, select the check box next to the QKView name, and click
    Upload 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 uploads to iHealth, where you can get help to diagnose the health and proper operation of the system.
  5. To delete a QKView report, select it and click
    Delete
    .

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.
  1. Connect using SSH to the management IP address.
  2. Generate a tcpdump.
    system diagnostics tcpdump
    These options are available to use with this command:
    Option
    Description
    Example
    -i | interface
    Specifies 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 | outfile
    Specifies 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 diags/shared/<
    example-file
    >.pcap
    bpf
    Specifies 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 diags/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.
For a comprehensive list of CLI commands, see the CLI Reference for your F5OS system at clouddocs.f5.com
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.