Pre-installation verification

Verify the mandatory pre-installation components before you install watsonx™ Orchestrate.

Verify system requirements

Run the following script to verify all system requirements before installing watsonx Orchestrate on your Red Hat® OpenShift® Container Platform cluster. This script validates:
  • Red Hat OpenShift Container Platform cluster configuration and version
  • Required operators and services
  • Storage classes and provisioners
  • IBM® Software Hub installation status
  • Namespace configurations
  • GPU support (when use internal IFM)
  • Network and eventing components

Prerequisites

Before running the script, ensure that you must have:
  • Red Hat OpenShift Container Platform CLI (oc) installed and configured
  • Cluster administrator access to your Red Hat OpenShift Container Platform cluster
  • Active login session to your Red Hat OpenShift Container Platform cluster
  • IBM Software Hub <version for example 5.4.x> already installed
  • IBM Entitlement Key configured in appropriate namespaces

Download the script

Download the watsonx Orchestrate prerequisite check script from the following location: https://github.com/watson-developer-cloud/community/blob/master/watsonx-orchestrate/scripts/wxo-prereq-check.sh

Run the script

Run the following script:
sh wxo-prereq-check.sh --version <version> --installation-type <type> --internal-ifm <true|false>
Parameter Description Valid Values
--version watsonx Orchestrate Version 5.4.x
--installation-type Type of installation agentic`, `agentic_assistant`
--internal-ifm

Use internal IBM

Foundation models

 `true` or `false`
--operator-ns (Optional) CPD operators namespace Default: cpd-operators
--operand-ns (Optional) CPD operands namespace Default: cpd-instance-1
Environment variables
You can also configure namespaces by using environment variables:
  • `PROJECT_CPD_INST_OPERATORS` - CPD operators namespace
  • `PROJECT_CPD_INST_OPERANDS` - CPD operands namespace
  • `PROJECT_IBM_EVENTS` - IBM Events namespace (default: `ibm-knative-events`)

Examples

Example 1: Basic agentic_assistant installation with IFM enabled 
sh  \
--version 5.4.0 \
--installation-type agentic_assistant \
--internal-ifm true
Example 2: Custom namespaces
sh wxo-prereq-check.sh \
--operator-ns my-operators \
--operand-ns my-operands \
--version 5.4.0 \
--installation-type agentic \
--internal-ifm true
installation-type: agentic (default), you can change to agentic_assistant
Example 3: Using Environment variables
export PROJECT_CPD_INST_OPERATORS=my-operators
export PROJECT_CPD_INST_OPERANDS=my-operands

sh wxo-prereq-check.sh \
--version 5.4.0 \
--installation-type agentic_assistant \
--internal-ifm false

What to do next

  1. If all checks pass: Proceed with watsonx Orchestrate installation.
  2. If warnings appear: Review them, but you can proceed.
  3. If errors appear: Fix all errors and rerun the script.
  4. Troubleshoot: You might see some error messages or issues during the installation, see the System requirement issues troubleshoot.