openshift-install-power icon indicating copy to clipboard operation
openshift-install-power copied to clipboard

Published 20 hours ago • verified publisher icon ocp-power-automation

Add Troubleshooting Guide and Improve Installer Script Variable Validation

Open taliandre49 opened this issue 1 month ago • 3 comments

This PR enhances the installer script to improve usability and reduce common setup issues.

Key Updates:

  • Added clearer validation and guidance for required environment variables (IBMCLOUD_API_KEY, RELEASE_VER, etc.)
  • Introduced detailed echo messages explaining defaults and how to override them (e.g., RHCOS version).
  • Clarified the default RHCOS image version (8.3) and provided explicit guidance on changing image versions.
  • New troubleshooting.md under docs/
    • documents common OpenShift on PowerVS installation issues, their causes, and step-by-step resolutions.
    • Covers Terraform state issues, Bastion OS compatibility, reinstallation conflicts, remote-exec failures, LPAR health issues, and missing image errors.
    • References verified solutions and relevant IBM/PowerVS documentation for easier user debugging.

Testing:

  • Verified successful execution by running the installer script end-to-end after these updates.

Context:

These changes address issues observed when users and/or customers encounter missing or outdated image references during installation. The improved checks and messages help users identify configuration gaps earlier and adjust environment variables accordingly.

taliandre49 avatar Oct 15 '25 21:10 taliandre49