[SPM v8] March Release 2022

v22.3.0

Changed

• The following helm-charts have been updated to chart version 22.3.0: apps, batch, mqserver, spm, uawebapp, web, `xmlserver
• The optional, sample XML server monitoring sidecar, xmlserver-metrics, has been modified to:
  • Upgrade the Prometheus client_java to release 0.15.0
  • Modify the Prometheus namespace from xmlserver_ to curam_xmlserver and restructure the counters, using a single jobs_total with labels:
    • type = PDF|HTML|TEXT|RTF
    • status = fail|success
  • The Monitoring XML servers section of the Runbook has been modified to reflect the above changes.

[SPM v8] February Release 2022

v22.2.0

Fixed

• Fixed issue where Prometheus metrics were not being gathered for UAWebApp,Web and XMLServer applications on non-OpenShift environments

Changed

• The following helm-charts have been updated to chart version 22.2.0: apps, batch, mqserver, spm, uawebapp, web, `xmlserver

[SPM v8] January Release 2022

v22.1.0

Breaking Changes

• Gatsby v4.5.2 introduced a breaking changes, when developing documentation locally.
  • The following gatsby target fail, gatsby develop, due to DeprecationWarning.

Added

• Added the ability to tune the Apache HTTP server of the UAWebApp and Web components.
  • Updated sample override files to include example settings
• Introduced Gatsby v4 library
• Introduced node_js v16

Changed

• The following helm-charts have been updated to chart version 22.1.0: apps, batch, mqserver, spm, uawebapp, web, xmlserver
• Changed the liveness and readiness probes on producer and consumer pods to use the WebSphere Liberty health check feature. For more information, see here
• Updated IBM MQ Resource Adapter to 9.2.4.0
• Updated the Runbook Minikube deployment steps for Windows, mainly around specifying the Minikube driver (changing to use hyperv) and insecure registry (adopting the steps in the Minikube Handbook))
• Changes to the xmlserver-metrics image:
  • The log4j in xmlserver_prometheus.jar has been updated to 2.17.1
  • The com.ibm.spm.xmlserver.StatsForPrometheus class has been modified to wait until the XML server stats/ThreadPoolWorker-* files are created
• Updated npm packages to resolve security vulnerability

Removed

• Removed Gatsby v3 library
• Removed node_js v12

[SPM v8] December Release 2021

v21.12.0

This release introduces support for SPM 8.0.1.0 and contains changes for deployment of SPM 8.0.1.0
If you are deploying SPM 8.0.0.0, please see tag 21.10.0

Added

• Ability to specify XML server startup options via startOptions: in xmlserver/values.yaml
• Sample XML server sidecar deployment artifacts provided for making XML server statistics available to Prometheus
• Added the ability to generate Prometheus Apache HTTP metrics for the uawebapp and web applications

Changed

• The following helm-charts have been updated to chart version 21.12.0: apps, batch, mqserver, spm, uawebapp, web, xmlserver
• appVersion for all helm-charts updated to 8.0.1.0
• Updated the timeout of the linkchecker from 60 to 120
• Clarified prerequisite software statements
• Clarified statement for wlp_psw

Fixed

• Fixed the issue where xmlserver pod termination overwrote the verbosegc.log written to by the main Ant task.
• Clarified statement for wlp_psw in values.yaml and yaml examples (#92)
• Corrected kubeVersion (#94)

[SPM v8] October Release 2021

v21.10.0

Breaking Changes

• Helm v3.7.0 introduced a number of breaking changes, which required modifications of the tooling used in this runbook..
  • SPM requires chartmuseum/helm-push. Due to the changes introduced as part of Helm v3.7.0 and Chart museum v0.10.0, Chartmuseum has change helm push to helm cm-push.
    For more information see chartmuseum/helm-push v0.10.0 release notes.

Changed

• The following helm-charts have been updated to chart version 21.10.0: apps, batch, mqserver, spm, uawebapp, web, xmlserver
• Updated support statement for Helm v3 in prerequisite
  • IBM Cúram Social Program Management now supports Helm v3.7.0 or greater
• kubeVersion for all helm-charts updated to ">=1.20"
• Updated the minimum supported version of Kubernetes to 1.20

Removed

• Removed support for Kubernetes 1.19

[SPM v7] October Release 2021

v21.6.4

Breaking Changes

• Helm v3.7.0 introduced a number of breaking changes, that required changes to some tooling SPM is using in the Runbook.
  • SPM requires chartmuseum/helm-push. Due to the changes introduced as part of Helm v3.7.0, Chartmuseum has change helm push to helm cm-push.
    For more information see chartmuseum/helm-push v0.10.0 release notes.

Changed

• The following helm-charts have been updated to chart version 21.6.4: apps, batch, mqserver, spm, uawebapp, web, xmlserver.
• Updated support statement for Helm v3 in prerequisite
  • IBM Cúram Social Program Management now supports Helm v3.7.0 or greater
• kubeVersion for all helm-charts updated to ">=1.20"
• Updated the minimum supported version of Kubernetes to 1.20

Removed

• Removed support for Kubernetes 1.19

[SPM v8] September Release 2021

v21.9.0

Added

• Add a startup probe to the apps producer and consumers pods

Changed

• Updated WebSphere Liberty version to include 21.0.0.9
• Updated support statement for Helm v3 in prerequisite
  • Due to breaking changes in Helm release v3.7.0, IBM Cúram Social Program Management only supports up to Helm v3.6.3
• The following helm-charts have been updated to chart version 21.9.0: apps, batch, mqserver, spm, uawebapp, web, xmlserver
• Timeout for linkchecker updated from 60 to 120
• Clarified prerequisite software statements
• Update the readiness probe of the apps producer and consumers pods, consider a pod ready if curl to application link gives successful response or if codes CWWKZ0001I & CWWKF0011I are found in message logs
• Updated the liveness probe to check only the last 1000 lines of the logs file

Fixed

[SPM v7] September Release 2021

v21.6.3

Added

• Add a startup probe to the apps producer and consumers pods

Changed

• Updated WebSphere Liberty version to include 21.0.0.9
• The following helm-charts have been updated to chart version 21.6.3: apps, batch, mqserver, spm, uawebapp, web, xmlserver.
• Timeout for linkchecker updated from 60 to 120
• Update the readiness probe of the apps producer and consumers pods, consider a pod ready if curl to application link gives successful response or if codes 'CWWKZ0001I & CWWKF0011I' are found in message logs.
• Updated the liveness probe to check only the last 1000 lines of the logs file
• Updated support statement for Helm v3 in prerequisite
  • Due to breaking changes in Helm release v3.7.0, IBM Cúram Social Program Management only supports up to Helm v3.6.3

Fixed

• Restore setting of environment variable POD_HOSTNAME in Liberty server.xml for the apps producer and consumers pods

[SPM v8] August Release 2021 fix drop 1

v21.8.1

Fixed

• Fixed broken link for jmx monitoring
• Fixed github pages generation to build from main instead of master

[SPM v8] August Release 2021

v21.8.0

Breaking Changes

• Ingress and IngressClass resources have graduated to networking.k8s.io/v1, see Ingress graduates to General Availability
  • Due to ingress graduating to networking.k8s.io/v1 spm ingress.yaml has been updated to check networking.k8s.io version
  • Definition of the ingress path has been moved to the spm.ingress.item template
• SPM-Kubernetes default branch has been renamed from master to main

Added

• Configure PodMonitor resources for the apps producer and consumers pods and for the mqserver metrics pods to integrate with OpenShift's built-in Prometheus or Prometheus Operator

Changed

• The following helm-charts have been updated to chart version 21.8.0: apps, batch, mqserver, spm, uawebapp, web, xmlserver
• Changed DB2 datasources isolation level for the apps producer and consumers pods. See Transaction control/Underlying design/DB2/Repeatable Read
• Updated IBM Documentation link to SPM V8
• Clarified prerequisite software statements (#83)

Fixed

• Update Oracle Database driver name to ojdbc8.jar (#84)
• Fixed issue where MQ pods deployed by MQ Operator on Openshift were not respecting tuning params