Installing the CP4BA ODM bronze topology
This article is part of an article series around Operational Decision Manager (ODM) topologies in context of Cloud Pak for Business Automation (CP4BA). For more information about ODM environments and the topologies, see CP4BA ODM topologies on OpenShift
This article describes how to create an ODM bronze topology deployment from CP4BA 21.0.3 on the OpenShift Container Platform (OCP). The ODM Bronze topology is a production deployment of ODM in a single namespace on a single OCP cluster. It corresponds to the default production pattern deployment.
The Bronze topology is best suited for prototypes or applications with low production constraints (small, no HA). It can also be seen as the baseline
for the Silver and Gold topologies.
Deploying an ODM production pattern comes with some choices that can lead to different installation instructions. However, an installation guide builder
exists for CP4BA 21.0.3 that can help you to create a tailored installation playbook on the required steps just for ODM from the CP4BA installation documentation.
The article shows you exactly how to use the installation guide builder and work with the generated playbook to create an ODM bronze topology.
Installation guide builder
The installation guide builder for production patterns in CP4BA 21.0.3 can be accessed here: https://www.ibm.com/docs/guide/viewer/public/cloud-paks/cp-biz-automation/21.0.3?interact=custom-installation-guide-for-production-deployments
The guide builder consists of a form that you use to select the steps for your installation playbook.
The installation guide builder enables you to choose options and to select relevant commands for your specific deployment. Sometimes corporate preferences force you to choose a specific option, like installing an offline deployment, and these options can sometimes be hard to find amongst all the steps for all the other options. The guide builder extracts the steps for your option and puts them altogether in a custom playbook.
The installation instructions can be split into three parts: "preparation steps", "deployment steps" and "validation steps". The following example shows a specific set of installation options that can be chosen to create a bronze topology playbook.
Example preparation steps
1. Configure Storage: "Red Hat OpenShift Container Platform (OCP)"
2. Apply entitlement key: "The IBM Entitled Registry"
3. Install Cloud Pak operators: "By running a script"
4. Prepare the capabilities: "Business Automation Navigator (Foundation)" , "Operational Decision Manager". In the context of CP4BA, the foundation capabilities always include Business Automation Navigator.
Example deployment steps
1. Create a Cloud Pak deployment: "By running the deployment script"
2. Check and complete the generated custom resource and deploy the instance: "Cluster configuration", Business Automation Navigator (Foundation)" , "Operational Decision Manager", "Validate the YAML in your custom resource file", "Deploy the custom resource"
Example validation steps
1. Verify deployment: Business Automation Navigator (Foundation) and Operational Decision Manager.
Now you are ready to display the installation playbook. The playbook displays one web page at a time, which can be saved as a PDF. Note, each page must be downloaded as a separate PDF.
Following the generated playbook
The guide builder asked several questions so that you could make a few choices about your deployment. Each section of the form that you completed generates a separate web page.
· Cloud Pak storage configuration
· Cloud Pak entitlement key
· Cloud Pak operator installation
· Cloud Pak deployment
· Cloud Pak deployment verification
Each section has some choices to make about which instructions to include. The installation playbook includes all the steps that you chose in each section of the guide builder.
The following tables summarize the steps and the results of each step.
At this stage, you should have your target cluster ready to be used with the Cloud Pak operators up and running. The next stage is to create and validate an ODM bronze topology deployment.
The following CR YAML file is an example that describes an ODM bronze topology with a Db2 external database with SSL enabled, and Active Directory LDAP:
All the parameters that need to be edited are described in the generated installation guide. However, additional modifications can be made to prune your custom resource YAML file. Use the following table to help you identify the customizable parameters.
At this stage, the ICP4Cluster instance that you named odmbronze is created. After a couple of reconcile loops of the CP4BA operator you can verify the deployment.
The deployment verification is described in the last page of the installation playbook. Further validations can be made at the ODM level, see Validate your ODM topology.