This technical article is made in the context of validating an ODM topology at the end of the process to deploy your Cloud Pak for Business Automation deployment Custom Resource (CR) in all of your environments.
Once you have at least one cycle of the Cloud Pak for Business Automation operator being performed, you can start to progress on the following checklist.
It completes the installation document Installing a CP4BA multi-pattern production deployment.
Check the status of your Pods.
All Pods of the targeted namespace should be up-and-running.
Check the status: if there are some Pods on error, try to resolve the issue before going further.
Check if an LDAP user can connect on each environment.
Try to log on to the Cloud Pak Dashboard (CPD) Console using a user with the Administrator role.
To access Operational Decision Manager (ODM), you must assign a user role through the Cloud Pak Platform UI (Zen) console.
To do that, you can follow the doc below:
Also try to log on to the CPD Console using a user from the LDAP and try to access to the expected ODM Consoles (Decision Center and/or Decision Server).
[Optional] Check Basic Authentication users
Check if BasicAuth users are well registered on each environment.
If you want to test the Decision Center Console REST API call, try to execute the following cURL call:
url=$(oc get routes cpd -o jsonpath={.spec.host} -n <your-authoring-namespace>)
curl -Ik -u odmAdmin:odmAdmin https://${url}/odm/decisioncenter-api/v1/repository/metrics
And check the response if:
If you want to test the Decision Server Console REST API call, try to execute the following cURL call:
url=$(oc get routes cpd -o jsonpath={.spec.host} -n <your-runtime-namespace>)
curl -Ik -u odmAdmin:odmAdmin https://${url}/odm/res/api/v1/utilities/consoleinfo
And check the response if:
Run the Diagnostic of your Decision Center Console
Run the Diagnostic of your Decision Center Console on each environment.
-
Log on to the Decision Center Console using a user that has the rtsAdministrator role.
-
Click the Administration > Diagnostics tab.
-
Click on the Run All button.
Decision Center Diagnostics report the following:
-
Manager bean access: Various checks, such as whether the DC was properly installed and database was initialized, license check, hostname, port of the host machine and checks whether a project can be created with the existing installation;
Run the Diagnostic of your Decision Server Console
Run the Diagnostic of your Decision Server Console on each environment.
-
Log on the RES Console using a user that has the resAdministrators role.
-
Click the Diagnostics tab.
-
Diagnostics are run automatically, and you can see their results directly.
All the steps in the diagnostics should have green check marks.
If you want to see more detail, you can expand the results of each step or click Expand All to view all the results for all steps.
Note: The local XU connectivity and two rule session execution entries are grayed out because the sample server uses the WebSphere Liberty application server in J2SE mode. And in J2SE mode, the eXecution Units (XUs) are embedded in the client applications, and the Rule Execution Server console does not have J2EE XUs.
If something goes wrong, please go to the troubleshooting section of the official Knowledge Center of the ODM 9.0 product.
Configure and test your environment connections
For the Silver and Gold topologies, you must validate that your Authoring environment is able to establish connections to run a "Test and Simulation" testsuite, and also to publish Decision Services to the Sandbox and Production environments.
-
Log on to the Decision Center Console using a user that has the rtsAdministrator role.
-
Click the Administration > Servers tab.
-
Click on the New Server (+) button to add your server.
-
Enter the Server name, the Server URL (i.e. RES console of the Production environment), enable the Use OpenID Connect switch.
-
Give the Username and put the Zen API key of the Production environment as a Password.
-
Before the final click on the Create button, try to connect using the Test button that will try to perform a real connection with the provided parameters.
-
Repeat the above steps to create another server configuration for Testing and simulation. This server configuration will be used later in "Ruleset Test & Simulation" section. The following parameters must be adapted to the Sandbox environment:
-
Select "Testing and simulation" for the Usage parameter.
-
Enter the Server URL with the URL of Decision Runner in the Sandbox environment.
For example: https://<cpd_sandbox>/odm/DecisionRunner
-
In this case, the Zen API key for the Password parameter will be the one generated in the Sandbox environment.
Note: if you encounter the "java.lang.RuntimeException: Unknown OIDC provider: zen" exception, then try to restart all your DecisionCenter Pods.
Check the Execution Units
To validate your installation, you can also check the Execution Units (XUs) list from the Decision Server Console from the Production Environment has a visibility to the correct number of Runtimes.
To do so:
-
Log on to the RES Console using a user that has the resAdministrators role.
-
Click the Server Info tab and select the Inspect Execution Units sub-topic.
You must be able to read the number of XUs attached to your Decision Server Console: the number of replicas you've configured + 1, attached to the Decision Server Console directly, which is not used for the production execution purpose (usually named localhost).
If it's not the case, double check your CR file. To change the number of runtime, you can either choose to change the spec.shared_configuration.sc_deployment_profile_size with [small=1, medium=3, large=6], spec.odm_configuration.deployment_profile_size with [small=1, medium=3, large=6].
Check the Licensing service
Finally, you need to check that everything is well configured on the metering service as well, to conform to the IBM pricing policy.
All services from all environments should be able to connect to the Metering service.
Verify that the Production Environment is registered as production (Operational Decision Manager Containers - CP4BA).
Verify that the Authoring and Sandbox Environment is registered as non-production (Operational Decision Manager Containers - CP4BA - Non Prod).
To do that, you must query the Licensing service.
The Licensing service exposes three REST endpoints:
Example of querying the licensing service endpoints:
url=$(oc get routes ibm-licensing-service-instance -o jsonpath={.spec.host} -n <your-namespace>)
token=$(oc get secret ibm-licensing-token -o jsonpath={.data.token} -n <your-namespace> | base64 -d)
# Endpoints with -k option in order to authorize self sign certificate (if any)
curl -k https://${url}/snapshot?token=${token} > snapshot.zip
curl -k https://${url}/products?token=${token} > products.json
curl -k https://${url}/bundled_products?token=${token} > bundled-products.json
In addition, you can connect to the human readable view available in:
https://${url}/status?token=${token}
Final System Verification Testing
Once downloaded, you must follow the steps above:
-
Go to Library > Import Decision Service (up arrow) button and load your zip file.
-
Go to your project and select the main branch.
-
Click on the Deployments and click on the Deploy button.
-
Select either the Sandbox or Production server.
-
Your report status should be green at the end of the deployment process.
Ruleset Test & Simulation
Check if you can execute simulation from Decision Center Authoring Environment to Sandbox Environment
Try to load a dummy project in your Decision Center Console, which contains Test Suites and/or Simulations.
Once downloaded, you must follow the steps above:
-
Go to Library > Import Decision Service (up arrow) button and load your zip file.
-
Go to your project and select the main branch.
-
Click on the New Test Suite (+) button and fill in your file with the Test Suite and target the Sandbox environment.