Installing

Overview

IBM Industry Solutions Workbench runs on RedHat OpenShift.

The following picture shows exemplary the setup of IBM Industry Solutions Workbench. In this example a Dual Cluster topology is assumed. One cluster for development and testing purposes, one dedicated cluster for production workloads.


deployment

Third-party requirements

IBM Industry Solutions Workbench requires different third party components:

  • Git Provider - used as a central source code repository (currently GitLab, GitHub Enterprise and Bitbucket are supported)
  • MongoDB - used to store the design data as well as business data for the projects developed with IBM Industry Solutions Workbench
  • OpenShift Pipelines - used to build and deploy service projects
  • OpenShift GitOps - used to deploy application projects
  • Keycloak/Red Hat Single Sign-On - Open ID Connect / SSO Server for the design environment; for deployed projects the usage of a different OIDC Provider is supported
  • Apache Kafka - to support eventing for projects (optional)
  • OpenShift Service Mesh (optional)
Note:

The detailed information on supported versions are listed in the System Requirements

Instructions

In general, the process consists of these steps:

  1. Check you meet the system requirements. See System Requirements
  2. Decide which services (that you might already run) you want to use or whether you want to install all required dependencies on your cluster during installation of IBM Industry Solutions Workbench. This is suitable for small or PoC type deployments. See Install Third Party Components
  3. Gather all configuration data needed for starting the installation of IBM Industry Solutions Workbench. See Pre-installation tasks for details.
  4. Install and configure IBM Industry Solutions Workbench. See Installation Process
  5. After installation of the core product, configure the installed Solution Hub and Solution Designer, verify that you can login to Solution Designer, configure one or more OpenShift projects as k5-projects. These are used to deploy and run the projects you develop with IBM Industry Solutions Workbench. See Post-installation tasks for details.
Note:

If required - although not recommended - multiple IIBM Industry Solutions Workbench instances can be installed in the same cluster, separated by namespace. A IBM Industry Solutions Workbench installation is required for each namespace. Prior to these installations, ensure that cluster-wide custom resource definitions (CRs) of these product instances do not conflict with each other and that OpenShift routes, which can be configured during installation, are chosen differently to avoid conflicts.