Validation checks

As part of theIBM® Sovereign Core installation and upgrade processes, a validation script is run to check for tools and utilities. These tools are required for the system to run. In some cases you will be notified of a missing tool; in other cases the missing tool is installed during the validation process.

The installation and upgrade validation script that checks system prerequisites as part of the install or upgrade process, installs missing tools, and validates configuration before IBM Sovereign Core is deployed.

The script automatically checks for these tools and auto-installs them if they are missing:
  • OpenShift CLI client (oc v4.20.21)
  • Kubernetes package manager (helm v3.19.4)
  • YAML processor (yq v4.48.2)
  • JSON processor (jq)
  • OCI registry as storage tool (oras v1.3.0)
  • Tekton CLI (tkn v0.43.0)
  • Cryptographic toolkit (openssl)
  • Base64 encoding utility (base64)
  • File downloader (wget)
Required tools that must be pre-installed:
  • Version control system (git)
  • HTTP client (curl)
  • DNS lookup tool (dig)
  • Container engine (podman)
  • Standard UNIX utilities (bash, sed, awk, grep, and others)
Configuration validation for required environment variables:
  • IVIA credentials (LDAP, SCIM, and administrator passwords)
  • SMTP server configuration (host, port, SSL/TLS, and authentication settings)
  • DNS configuration (domains, IP addresses, and hostnames)
  • Storage settings (block storage class)
  • Registry credentials (ICR and SaaS platform)
  • Backup configuration using OADP or Velero
Prerequisites checks validate that the following are true:
  • Root or sudo access required for tool installation.
  • Write access to ROOT_DIR.
  • Configured environment variables that are defined in a .env file.
  • RHEL- or CentOS-based Linux system (uses the dnf package manager).
Exit codes are as follows:
  • 0: All validations passed.
  • 1: Validation failures or missing prerequisites.