Generate Healthcheck Reports in HTML with CVU 12.2

With the release of Oracle 12c Release 2, the Cluster Verification Utility (CVU) was included with an updated version. Beside new checks and enhanced functionality, the possibility of generating HTML reports was added.

In this blog post I will show you how to generate such HTML reports.

Get CVU 12.2

Until December 2017 the latest CVU version was only available within the installation media of the Oracle Grid Infrastructure 12c Release 2. Starting with December 2017, Oracle updated the Oracle Technology Network (OTN) page of the Cluster Verification Utility with the latest releases for all supported platforms.

Generate HTML Reports

With the current release of CVU, the HTML option is available for the following checks only.

  • cluvfy comp healthcheck
# Complete Healthcheck
$> ./cluvfy comp healthcheck -html
# Healthcheck for the Cluster Components
$> ./cluvfy comp healthcheck -collect cluster -html
# Healtcheck for ASM Components
$> ./cluvfy comp healthcheck -collect asm -html
# Healtcheck for Database Components 
$> ./cluvfy comp healthcheck -collect database -html
# Healtcheck for Mandtory Requirements only
$> ./cluvfy comp healthcheck -mandatory -html
# Healtcheck for Best Practices only
$> ./cluvfy comp healthcheck -bestpractices -html 

When the option -html is used, Oracle will generate a HTML version of the report and open it after the generation finished.

Oracle will search for a browser binary in the following order.

  1. firefox
  2. mozilla
  3. opera
  4. konqueror
  5. epiphany

If no browser is available, you will see no error, but if no X11 support is available, you will see the following error.

ERROR:
PRVG-0221 : Cannot launch browser to display the report. Check if the DISPLAY variable is set.

To open the report anyway, you have three options.

  1. Install a supported browser, like Mozilla Firefox
  2. Download the report, located at $ORACLE_BASE/crsdadat/@global/cvu/report/html, to your client
    You can override the default path by adding the parameters -save and -savedir to your CVU command

    $> ./cluvfy comp healthcheck -html -save -savedir /tmp
  3. Set the path to your preferred browser binary in cv/admin/cvu_config
    $> # CVU was unzipped to /tmp/cvu
    $> /tmp/cvu/cv/admin/cvu_config
    $> chmod u+w cvu_config
    $> vi cvu_config
    ...
    # Set CV_DEFAULT_BROWSER_LOCATION to full binary path
    CV_DEFAULT_BROWSER_LOCATION=/usr/bin/firefox
    ...

Example

The report starts with a short overview about the tested system and the main navigation bar to jump quickly to the desired area.

For every check you have the possibility to open a second window with details about the check by clicking on the Verification Result link.

Conclusion

Generating Healthchecks in HTML is a nice and easy to use feature. The format of the report and the possibilities of interaction makes the reading of such reports more convenient.

Unfortunately this option is only available for a very limited subset of checks. Maybe the next versions will include more checks with HTML support.

References

Leave a Reply

Your email address will not be published. Required fields are marked *