IBM Event Automation One-Shot Deployment

This project provides an automated installation script for IBM Cloud Pak for Integration (CP4I) components on OpenShift. It’s designed for development and lab environments—do not use in production.

The script installs Event Streams, Event Processing, Event Endpoint Management, and optionally IBM MQ, AppConnect Enterprise, and API Connect.

Quick Start

Prerequisites

OpenShift cluster with cluster-admin access
oc CLI installed and logged in
IBM Entitlement key (Get it here)

Installation

# Install all Event Automation components (Event Streams, Event Processing, Event Endpoint Management)
./ibm_event_automation_oneshot_deployment.sh

# Install with additional components (MQ, ACE, APIC)
./ibm_event_automation_oneshot_deployment.sh --install-mq --install-ace --install-apic

# Custom namespace
./ibm_event_automation_oneshot_deployment.sh -n my-namespace

# With storage class
./ibm_event_automation_oneshot_deployment.sh -s ocs-storagecluster-cephfs

The script will:

Install IBM Operator Catalog
Install component operators (Event Streams, Event Processing, Event Endpoint Management, etc.)
Create component instances
Configure authentication credentials
Display access URLs and credentials

Installation time: ~30–45 minutes

What Gets Installed

By Default

Component	Purpose
Platform Navigator	Unified console for CP4I components
Event Streams	Kafka cluster with 3 nodes
Event Processing	Stream processing authoring UI
Event Endpoint Management	API catalog and gateway
Apache Flink	Stream processing engine (required for Event Processing)

Optional (with flags)

IBM MQ — Message queue manager (--install-mq)
AppConnect Enterprise — Integration dashboard (--install-ace)
API Connect — API management platform (--install-apic)

Access Information

Platform Navigator

oc get route cp4i-navigator-pn -n tools -o jsonpath='{.spec.host}'
oc get secret integration-admin-initial-temporary-credentials -n ibm-common-services -o jsonpath='{.data.username}' | base64 -d && echo
oc get secret integration-admin-initial-temporary-credentials -n ibm-common-services -o jsonpath='{.data.password}' | base64 -d && echo

Event Streams

# Get UI URL
oc get route es-demo-ibm-es-ui -n tools -o jsonpath='{.spec.host}'

# Get SCRAM password for es-admin
oc get secret es-admin -n tools -o jsonpath='{.data.password}' | base64 -d && echo
# Username: es-admin

Event Processing

oc get route ep-demo-ibm-ep-rt -n tools -o jsonpath='{.spec.host}'
oc get secret ep-demo-ibm-ep-user-credentials -n tools -o jsonpath='{.data.user-credentials\.json}' | base64 -d | jq -r '.users[] | select(.username=="ep-admin") | .password'
# Username: ep-admin

Script Options

./ibm_event_automation_oneshot_deployment.sh [options]

Options:
  -n, --namespace NAME       Target namespace (default: tools)
  -e, --entitlement-key KEY  IBM Entitlement key
  -s, --storage-class NAME   StorageClass for persistent storage
  -v, --cp4i-version VER     CP4I version: CD or SC2 (default: CD)
      --no-eem              Do not install Event Endpoint Management
      --no-ep               Do not install Event Processing
      --no-es               Do not install Event Streams
      --no-flink            Do not install Flink
      --no-nav              Do not install Platform Navigator
      --install-mq          Install IBM MQ
      --install-ace         Install AppConnect Enterprise
      --install-apic        Install API Connect
  -h, --help                Show help

Troubleshooting

Check Installation Status

# Check component status
oc get eventstreams,eventprocessing,eventendpointmanagement,eventgateway,flinkdeployment -n tools

# Check pods
oc get pods -n tools

# Check operator subscriptions
oc get subscription -n openshift-operators | grep -E "eventstreams|eventprocessing|eventendpointmanagement"

Common Issues

Components not ready: Wait longer (30–45 min). Check pod logs: oc logs <pod-name> -n tools
Image pull errors: Verify entitlement key. Check: oc get secret ibm-entitlement-key -n tools
Storage issues: Specify a storage class for production: -s <storage-class-name>