Run the preflight check to validate your environment before installation. The preflight check is read‑only and makes no changes to the cluster. When you provide a configuration file, the installer reads all settings automatically and runs without prompting for input.
- Run the installer script with the --preflight-check option from the directory where the script is located.
./iqstudio-installer.sh --preflight-check --config-file=iqstudio-install.conf
The script runs the following checks in sequence:Check Description Cluster connectivity Verifies that the current node can reach the Kubernetes cluster. Namespace permissions Confirms that the installer has permission to create namespaces. Bundle files Verifies that the required bundle files are present in the parent directory. Kubernetes context and nodes Displays the active kubeconfig context and lists all nodes. CoreDNS Confirms that CoreDNS is running in the cluster. GPU operator Validates that the GPU operator is installed and detects GPU-enabled nodes. GPU resource advertisement Confirms that GPU resources are being advertised to the scheduler. MIG configuration Reports the Multi-Instance GPU (MIG) strategy on the specified node. Default storage class Identifies the current default storage class. RWX storage class validation Creates two temporary pods sharing a PVC and verifies read/write operations. Note: If the check for the RWX storage class validation is running, the script creates two temporary pods. This step may take a few minutes to complete.
Load balancer Creates a temporary LoadBalancer service and confirms that an external IP is assigned. - Review the preflight check results and make sure each item reports SUCCESS before you continue the installation.
The following example shows a successful preflight check result:
[INFO] 2026-05-25 10:08:17 - Available storage classes: 1. local-path 2. nfs-client (default) 3. nfs-client-retain [INFO] 2026-05-25 10:08:17 - 10) Validating RWX storage (optional) [INFO] 2026-05-25 10:08:17 - Config: Enter RWX StorageClass name (or press Enter to skip) -> <empty> [INFO] 2026-05-25 10:08:17 - User input - rwx_sc: [INFO] 2026-05-25 10:08:17 - RWX validation skipped [INFO] 2026-05-25 10:08:17 - 11) Validating LoadBalancer functionality... [INFO] 2026-05-25 10:08:18 - Waiting for external IP allocation (up to 120s)... [SUCCESS] 2026-05-25 10:08:18 - LoadBalancer external IP allocated: 192.168.23.41 [INFO] 2026-05-25 10:08:18 - Cleaning up LoadBalancer test resources... [INFO] 2026-05-25 10:08:18 - ====================================================== [SUCCESS] 2026-05-25 10:08:18 - ALL CRITICAL CHECKS PASSED [INFO] 2026-05-25 10:08:18 - ====================================================== [SUCCESS] 2026-05-25 10:08:18 - Preflight result saved to state file — you can now run --install without the interactive confirmation
Important: Do not continue with the installation if any critical check reports a failure. Resolve all failures before you proceed.After the preflight check completes successfully, the environment is ready for installation.