System requirements

Ready to install IBM Industry Solutions Workbench? Before you get started, use the information in this document to determine whether you have sufficient resources to install the service and the required software dependencies for the service.

Hardware resources


Hardware	Number of Servers	Available VPCs	Memory
x86-64	3+ worker nodes. The nodes must be able to schedule pods	16 virtual processor cores (VPCs)	64 GB

A dynamic storage provisioner is required to be present on the cluster. The core product has only modest requirements in terms of PVC storage access modes - only ReadWriteOnce (RWO) is required. If you are installing other pre-requirements software onto the same cluster, i.e. MongoDB, kafka, Keycloak, additional access modes might be required.

Note: Use a storage provider with 500 GB or more of available space for your cluster. Tested providers include AWS EBS volumes, NFS, Portworx and OpenShift Container Storage. Squash must not be enabled on the NFS server, and all nodes in the cluster must have access to mount the NFS server and read/write access.

OpenShift setup

Please make sure you are running one of the following versions:

OpenShift (version 4.12)

To set up OpenShift please follow the instructions in the OpenShift documentation.

Attention: For some preparatory steps a user with the cluster admin role is required. These steps are clearly marked. Once the product is installed this role is no longer required for the users working with IBM Industry Solutions Workbench.

Required third-party components

The IBM Industry Solutions Workbench requires the following third-party components with the specified versions. These can be either deployed into the cluster or be deployed separately.


Component	Required version	Minimum specifications for worker nodes	Minimum storage requirements
MongoDB	Version 3.6	Cores: 2, Memory: 4 GB	20 GB
Red Hat - AMQ Streams	Version 2.2
Red Hat Integration - Service Registry Operator	Version 2.1
Red Hat OpenShift Cluster Logging
Red Hat OpenShift GitOps	Version 1.7
Red Hat OpenShift Pipelines	Version 1.9
Red Hat Single Sign-On Operator	Version 7.6

Attention: Keycloak is only supported with HTTPS mode enabled. It needs proper certificate and hostname setup.

Supported Git providers

Currently, the following Git providers are supported:

GitLab self-managed
Bitbucket Server
GitHub Enterprise

Note: Of course it is not needed to create a new git provider instance, you can use your existing one. Also, it is not needed that the used git providers run inside the OpenShift cluster, but they can.

Supported Helm chart repositories

A Helm chart repository is required to release your service projects' Helm charts in order to create components, which must meet the following requirements:

The chart repository must not be helm-oci based
The chart repository must contain an index.yaml file, see Helm Chart Repository.
The chart repository must be available from the cluster via HTTPS and has a proper certificate (not self-signed)

Examples for supported Helm Chart Repositories are:

ChartMuseum Repository Server
GitLab Package Registry
Sonatype Nexus Helm Chart Repository - limited support!

Attention: Please note, that using Sonatype Nexus as Helm chart repository doesn't support descriptions and icons used in Solution Designer to display components.