Manual Chapter :
Troubleshooting using iHealth
Applies To:
Show VersionsBIG-IQ Centralized Management
- 7.0.0, 6.1.0
Troubleshooting using iHealth
What is iHealth?
The F5
iHealth® server 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 server. 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.
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.
- At the top of the screen, clickMonitoring.
- On the left, click.
- Click theAddbutton.
- In theNamefield, type a name to identify this user.
- In theUsernameandPasswordfields, type this user's F5 Support SSO user name and password.
- In theDescriptionfield, type an optional description for this user.
- Click theTestbutton to verify you can reach the iHealth diagnostics site.
- Click theSave & Closebutton.
You can now upload QKView files to
the F5 iHealth server to get iHealth reports for your managed devices.
Limit the number of simultaneous
iHealth-related file transfers to and from BIG-IQ for my managed devices
If you want to limit how much
traffic is dedicated to file activity related to iHealth for your
managed devices, you can specify the of simultaneous QKView file transfers to and from
F5
BIG-IQ Centralized Management.
- At the top of the screen, clickMonitoring.
- On the left, click.
- For theQKView Transfer Limitsetting, click theEditbutton.
- In theQKView Transfer Limitfield, type the greatest number of QKView files you want transferred to and from BIG-IQ at one time, per upload task.
- Click theSave & Closebutton.
Upload a QKView file to the F5 iHealth
server to troubleshoot potential issues
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 potential issues with a managed device.
- At the top of the screen, clickMonitoring.
- On the left, click.
- Click theQKView Uploadbutton.
- In theNamefield, type a name to identify this report, and type an optional identifier in theDescriptionfield.
- If you have (and want to associate) a support case number with this QKView file, type that into theF5 Support Case Numberfield.This step is not required.
- From theCredentiallist, select the credentials to log in to the iHealth diagnostic site.
- From theAvailablelist, click the device you want to upload a QKView file for.
- Click theSave & Closebutton.
When BIG-IQ finishes uploading the
QKView file(s) to F5, it displays a status icon next to it on the Tasks 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. To view this report, go to the Device Reports screen.Troubleshoot potential issues by viewing
an iHealth device report
After you upload a QKView file for
one or more BIG-IP devices, the F5
iHealth server returns a device report.
Review the device report so you can
address any potential issues or vulnerabilities. From the report, you can access and
sort heuristics associated with a device.
- At the top of the screen, clickMonitoring.
- On the left, click.
- Click theOpenlink next to the report you want to view.
- To sort the heuristics for a report you've opened, select an option from theAll Importanceand/or theAll Flagslist.
- You can add a flag to a specific heuristic by selecting the check box next to it, and selecting a flag from theAll Flagslist.
- To view more details about a specific heuristic, click on its link.
- To view an article on the AskF5 Knowledge Center database to get more information about this heuristic, click the solution link.
Create a schedule to upload QKView files
to the iHealth server
After you specify the credentials for
a user to access the F5
iHealth diagnostic server, you can create a QKView upload
schedule.
Configuring BIG-IQ Centralized Management to upload QKView files to the F5 iHealth
diagnostic server on a regular basis means you'll get iHealth device diagnostics reports
sent automatically to BIG-IQ for your BIG-IP devices. This information makes it easy for
you to troubleshoot potential issues, and keeps you up-to-date about vulnerabilities
that could cause security issues for your devices.
- At the top of the screen, clickMonitoring.
- On the left, click.
- Near the top of the screen, click theCreatebutton.
- In theNamefield, type a name to identify this report, and type an optional identifier in theDescriptionfield.
- From theCredentiallist, select the credentials to log in to the iHealth diagnostic site.
- From theUpload Frequencylist, select how frequently you want to upload QKView files to the F5 iHealth server, and then select the day of the week or month.
- Select a start date and time for this schedule.
- Select an end date for this schedule, or select theNo End Datecheck box.
- From theAvailablelist, select the device(s) you want to add to this schedule.
- Click theSave & Closebutton.
Now BIG-IQ will upload QKView files
for the selected device on the schedule you specified.
Go to the Device Reports screen to
view reports sent from the F5 iHealth server.
Create an upgrade advisor report before
you upgrade BIG-IP system
Before you create an upgrade advisor
report for a BIG-IP system, you must specify the credentials for a
user to access the F5
iHealth diagnostic server, and upload the QKView file for that
device to the F5 iHealth server.
Before upgrading, you create an
upgrade advisor report so that you can prepare for any potential issues you might need
to address.
- At the top of the screen, clickMonitoring.
- On the left, click.
- Near the top of the screen, click theCreatebutton.
- From theDevicelist, select the device you want to run a report for.
- From theTarget Versionlist, select the version to which you are going to be upgrading this device.
- In theNameandDescriptionfields, type a name and an optional description for this task.
- Click theSave & Closebutton.
View the report on the Upgrade
Advisor Reports screen and address any potential issues before you upgrade this BIG-IP
device.