Manual Chapter : Troubleshooting using iHealth

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 5.2.0
Manual Chapter

What is iHealth?

iHealth® is a tool that helps you troubleshoot potential issues. It does this by analyzing configuration, logs, command output, password security, license compliance, and so on.

From F5® BIG-IQ® Centralized Management, you can create a snapshot of a configuration in the form of a QKView file and then upload it to the F5® iHealth service. The file is compared to the iHealth database, which contains known issues, common configuration errors, and F5 published best practices. F5 returns an iHealth report you can use to identify any potential issues that you need to attend to.

Limit the number of simultaneous iHealth related file transfers to and from BIG-IQ

If you want to save system resources, you can easily limit how much traffic is dedicated to file activity related to iHealth® if you need to. You do this by specifying a limit of simultaneous file transfers to and from BIG-IQ® Centralized Management.
  1. At the top of the screen, click System.
  2. On the left, click BIG-IQ iHealth > Configuration .
  3. Click the Edit button near the top of the screen.
  4. In the QKView Transfer Limit field, type the greatest number of QKView files you want to occur on BIG-IQ at one time.
  5. Click the Save & Close button at the bottom of the screen.

How do I get access to send QKView files for my managed devices to the F5 iHealth diagnostics server?

You'll need a single sign on (SSO) to the F5® Support site to access the F5 iHealth® diagnostics server. If you don't have one yet, register at https://login.f5.com/resource/login.jsp
With access to the F5 iHealth diagnostics server you can upload QKView files and download iHealth reports for your managed devices.
  1. At the top of the screen, click Monitoring.
  2. On the left, click REPORTS > Device > iHealth > Configuration .
  3. Click the Add button.
  4. In the Name field, type a name to identify this user.
  5. In the Username and Password fields, type this user's F5 Support SSO user name and password.
  6. In the Description field, type an optional description for this user.
  7. Click the Test button to verify you can reach the iHealth diagnostics site.
  8. Click the Save & Close button at the bottom of the screen.
You can now upload QKView files to the F5 iHealth server to get iHealth reports for your managed devices.

Troubleshoot issues for a managed device by uploading a QKView file to the F5 iHealth server

To upload a QKView file, you must have access to the F5® iHealth® server configured on BIG-IQ® Centralized Management.
You upload a QKView file to F5 Networks to create an iHealth diagnostics report. You can use that report to troubleshoot any potential issues with a managed device.
  1. At the top of the screen, click Monitoring.
  2. On the left, click REPORTS > Device > iHealth > Uploads .
  3. Click the Upload button.
  4. In the Name field, type a name to identify this report, and type an optional identifier in the Description field.
  5. If you have (and want to associate) a support case number with this QKView file, type that into the F5 Support Case Number field.
    This step is not required.
  6. From the Credential list, select the credentials to log in to the iHealth diagnostic site.
  7. From the Available list, click the device you want to upload a QKView file for, and click -> to move it to the Selected list.
  8. Click the Upload button at the bottom of the screen.
When BIG-IQ finishes uploading the QKView file(s) to F5, it displays a status icon next to it on the Uploads screen.
If the upload fails, click the report's Name link and view the error message for more information. After F5 successfully receives the QKView file, it creates an iHealth report, which you can download from the Reports screen.

Download an iHealth diagnostics report for a managed device

F5® creates an iHealth® diagnostics report after you upload a managed device's QKView file to F5.
Downloading and reviewing an iHealth report helps you troubleshoot any potential issues with your managed devices.
Note: The Reports screen displays a link only to the most recently created iHealth reports. The F5 iHealth server retains the report for approximately 30 days, after which it deletes the report, and the link from BIG-IQ® becomes invalid. This date is shown as the expiration date.
  1. At the top of the screen, click Monitoring.
  2. On the left, click REPORTS > Device > iHealth > Reports .
  3. In the Report column, click the Download PDF file link for the report you want.
BIG-IQ downloads the report you selected in the form of a PDF.
You can now open and review the iHealth diagnostics report for your managed device.

How do I get access to send QKView files for the BIG-IQ system to the F5 iHealth diagnostics server?

You'll need a single sign on (SSO) to the F5® Support site to access the F5 iHealth® diagnostics server. If you don't have one yet, register at https://login.f5.com/resource/login.jsp
With access to the F5 iHealth diagnostics server you can upload QKView files and download iHealth reports for your BIG-IQ® Centralized Management system.
  1. At the top of the screen, click System.
  2. On the left, click BIG-IQ iHealth > Configuration .
  3. Click the Add button.
  4. In the Name field, type a name to identify this user.
  5. In the Username and Password fields, type this user's F5 Support SSO user name and password.
  6. In the Description field, type an optional description for this user.
  7. Click the Test button to verify you can reach the iHealth diagnostics site.
  8. Click the Save & Close button at the bottom of the screen.
You can now upload QKView files to the F5 iHealth server to get iHealth reports for your BIG-IQ system.

Troubleshoot issues for the BIG-IQ system by uploading a QKView file to the F5 iHealth server

To upload a QKView file, you must have access to the F5® iHealth® server configured on BIG-IQ® Centralized Management.
You upload a QKView file to F5 Networks to create an iHealth diagnostics report. You can use that report to troubleshoot any potential issues with the BIG-IQ system.
  1. At the top of the screen, click System.
  2. On the left, click BIG-IQ iHealth > Uploads .
  3. Click the Upload button.
  4. In the Name field, type a name to identify this report, and type an optional identifier in the Description field.
  5. If you have (and want to associate) a support case number with this QKView file, type that into the F5 Support Case Number field.
    This step is not required.
  6. From the Credential list, select the credentials to log in to the iHealth diagnostic site.
  7. From the Available list, click the device you want to upload a QKView file for, and click -> to move it to the Selected list.
  8. Click the Upload button at the bottom of the screen.
When BIG-IQ finishes uploading the QKView file(s) to F5, it displays a status icon next to it on the Uploads screen.
If the upload fails, click the report's Name link and view the error message for more information. After F5 successfully receives the QKView file, it creates an iHealth report, which you can download from the Reports screen.

Download an iHealth diagnostics report for the BIG-IQ system

F5® creates an iHealth® diagnostics report after you upload a BIG-IQ® Centralized Management QKView file to F5.
Downloading and reviewing an iHealth report for BIG-IQ helps you troubleshoot any potential issues for your BIG-IQ system.
Note: The Reports screen displays a link only to the most recent BIG-IQ iHealth report created. The F5 iHealth server retains the report for approximately 5 days, after which it deletes the report, and the link from BIG-IQ becomes invalid. This date is shown as the expiration date.
  1. At the top of the screen, click System.
  2. On the left, click BIG-IQ iHealth > Reports .
  3. In the Report column, click the Download PDF file link for the report you want.
BIG-IQ downloads the report you selected in the form of a PDF.
You can now open and review the iHealth diagnostics report for the BIG-IQ system.