Diagnosing errors during installation, deployment, or upgrade

Use this information to diagnose errors during installation, deployment, or upgrade by using the installation toolkit.

General troubleshooting steps

  1. Note the screen output that is indicating the error. This output helps in narrowing down the general failure.When a failure occurs, the screen output also shows the log file that contains the failure message.
  2. Open the log file in an editor such as vi.
  3. Go to the end of the log file and search upwards for the text FATAL.
  4. Find the topmost occurrence of FATAL (or first FATAL error that occurred) and look in preceding and following sections of this error message for further indications of the failure.

    For more information, see Finding deployment related error messages more easily and using them for failure analysis.

Installation or upgrade failure due to insufficient disk space

Installation or upgrade can fail with a transaction test error if the root (/) filesystem does not have sufficient free space. This issue is not specific to the installation toolkit and can occur with any RPM-based installation.

Example error message:
Transaction test error:
installing package <package-name> needs <X>MB more space on the / filesystem

Error Summary
-------------
Disk Requirements:
   At least <X>MB more space needed on the / filesystem.
Resolution:
  1. Verify the available disk space on the root (/) filesystem:
    df -h /
    Note: Ensure that sufficient free space is available to avoid unexpected issues.
  2. Clean up the root filesystem by removing unnecessary files or logs.
  3. Retry the installation or upgrade.