Step 2 Troubleshooting

This article contains instructions that may help you if you run into problems during installation via the command line. To troubleshoot errors:

  1. Open the installer log file (see Installer Logs) and begin reading it from top to bottom. You may also view the summary and details that appear during installation (see Platform Controller Setup).
  2. Stop at the first ERROR you find. The first error can often cause further problems downstream, and taking a start-to-finish approach (instead of working your way back from the tail end of the log file) may help you solve one error that in turn resolves a series of cascading errors.
  3. If the problem is obvious (such as a typo while setting options), then correct the problem and re-run the installer.
  4. If you are unable to resolve the problem(s) on your own, then contact Hewlett Packard Enterprise for support. You may be asked to provide the installer log and xtrace files.

Installer Logs

The installer generates the following files:

  • Installer Log: This log contains high-level information based on the options supplied when you ran the installer and the error(s) encountered during installation. This file will be stored in /var/log/bluedata/install/install.out_<timestamp>.log, where <timestamp> is the time the installer was run in year-month-day-hour-minute-second format (such as install.out_2017-04-02-01-33-21.log. HPE may request this file if you contact us for support.
  • Xtrace: This file is a verbose, line-by-line description of the exact commands used by the script to both get data and determine the outcome of each test. This file will be stored in /var/log/bluedata/install/install.out_<timestamp>.log.xtrace, where <timestamp> is the time the installer was run in year-month-day-hour-minute-second format, such as bds_2017-04-02-01-33-21.log.xtrace. Hewlett Packard Enterprise may request this file if you contact us for support.
NOTE
Neither the .log nor .xtrace files will pass any data or other sensitive information to Hewlett Packard Enterprise.