Chapter 10. Managing upgrades
10.1. Upgrading OpenShift Serverless Logic Operator from version 1.34.0 to 1.35.0 Copy linkLink copied to clipboard!
This section provides step-by-step instructions to upgrade the OpenShift Serverless Logic Operator from version 1.34.0 to 1.35.0. The upgrade process involves preparing the existing workflows and services, updating the Operator, and restoring the workflows after the upgrade.
Different workflow profiles require different upgrade steps. Carefully follow the instructions for each profile.
10.1.1. Preparing for the upgrade Copy linkLink copied to clipboard!
Before starting the upgrade process, you need to prepare your OpenShift Serverless Logic environment. This section outlines the necessary steps to ensure a upgrade from version 1.34.0 to 1.35.0.
The preparation process includes:
- Deleting or scaling workflows based on their profiles.
- Backing up all necessary databases and resources.
- Ensuring you have a record of all custom configurations.
- Running required database migration scripts for workflows using persistence.
Prerequisites
-
You have access to the cluster with
cluster-admin
privileges. - You have OpenShift Serverless Logic Operator installed on your cluster.
- You have access to a OpenShift Serverless Logic project with the appropriate roles and permissions to create applications and other workloads in OpenShift Container Platform.
- You have access to the OpenShift Management Console for Operator upgrades.
-
You have installed the OpenShift CLI (
oc
).
10.1.1.1. Deleting workflows with dev profile Copy linkLink copied to clipboard!
Before upgrading the Operator, you must delete workflows running with the dev
profile and redeploy them after the upgrade is completed.
Procedure
-
Ensure you have a backup of all necessary Kubernetes resources, including
SonataFlow
custom resource definitions (CRDs),ConfigMaps
, or any other related custom configurations. Delete the workflow by executing the following command:
oc delete -f <my-workflow.yaml> -n <target_namespace>
$ oc delete -f <my-workflow.yaml> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.1.2. Deleting and migrating workflows with the preview profile Copy linkLink copied to clipboard!
Before upgrading the Operator, you must delete workflows running with the Preview
profile, and migrate any data that is persisted. When the upgrade is completed, you must redeploy the workflows.
Procedure
- If you are using persistence, back up the workflow database and ensure the backup includes both database objects and table data.
-
Ensure you have a backup of all necessary Kubernetes resources, including
SonataFlow
CRDs,ConfigMaps
, or any other related custom configurations. Delete the workflow by executing the following command:
oc delete -f <my-workflow.yaml> -n <target_namespace>
$ oc delete -f <my-workflow.yaml> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow If you are using persistence, you must execute the following database migration script:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.1.3. Scaling down workflows with the gitops profile Copy linkLink copied to clipboard!
Before upgrading the Operator, you must scale down workflows running with the gitops
profile, and scale them up again after the upgrade is completed.
Procedure
Modify the
my-workflow.yaml
CRD and scale down each workflow tozero
before upgrading as shown in the following example:spec: podTemplate: replicas: 0
spec: podTemplate: replicas: 0
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Apply the updated CRD by running the following command:
oc apply -f <my-workflow.yaml> -n <target_namespace>
$ oc apply -f <my-workflow.yaml> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow (Optional) Scale the workflow to
0
by running the following command:oc patch sonataflow <my-workflow> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 0}}}'
$ oc patch sonataflow <my-workflow> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 0}}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.1.4. Backing up the Data Index database Copy linkLink copied to clipboard!
You must back up the Data Index database before upgrading to prevent data loss.
Procedure
Take a full backup of the Data Index database, ensuring:
- The backup includes all database objects and not just table data.
- The backup is stored in a secure location.
10.1.1.5. Backing up the Jobs Service database Copy linkLink copied to clipboard!
You must back up the Jobs Service database before upgrading to maintain job scheduling data.
Procedure
Take a full backup of the Jobs Service database, ensuring:
- The backup includes all database objects and not just table data.
- The backup is stored in a secure location.
10.1.2. Upgrading the OpenShift Serverless Logic Operator Copy linkLink copied to clipboard!
To transition from OpenShift Serverless Logic Operator (OSL) version 1.34.0 to 1.35.0, you must upgrade the OSL using the Red Hat OpenShift Serverless web console. This upgrade ensures compatibility with newer features and proper functioning of your workflows.
Prerequisites
-
You have access to the cluster with
cluster-admin
privileges. - You have OpenShift Serverless Logic Operator installed on your cluster.
- You have access to a OpenShift Serverless Logic project with the appropriate roles and permissions to create applications and other workloads in OpenShift Container Platform.
- You have access to the OpenShift Management Console for Operator upgrades.
-
You have installed the OpenShift CLI (
oc
).
Procedure
-
In the web console, navigate to the Operators
OperatorHub Installed Operator page. -
Select the
openshift-serverless-logic
namespace from the Installed Namespace. - In the list of installed operators, find and click the OpenShift Serverless Logic Operator.
- In the Operator details page, click on the Subscription tab. Click Edit Subscription.
- In the Upgrade status, click the Upgrade available link.
- Click the Preview install plan and Approve to start the update.
To monitor the upgrade process, run the following command:
oc get subscription logic-operator-rhel8 -n openshift-serverless-logic -o jsonpath='{.status.installedCSV}'
$ oc get subscription logic-operator-rhel8 -n openshift-serverless-logic -o jsonpath='{.status.installedCSV}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Expected output
logic-operator-rhel8.v1.35.0
$ logic-operator-rhel8.v1.35.0
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Verification
To verify the new Operator version is installed, run the following command:
oc get clusterserviceversion logic-operator-rhel8.v1.35.0 -n openshift-serverless-logic
$ oc get clusterserviceversion logic-operator-rhel8.v1.35.0 -n openshift-serverless-logic
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Expected output
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.35.0 OpenShift Serverless Logic Operator 1.35.0 logic-operator-rhel8.v1.34.0 Succeeded
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.35.0 OpenShift Serverless Logic Operator 1.35.0 logic-operator-rhel8.v1.34.0 Succeeded
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.3. Finalizing the upgrade Copy linkLink copied to clipboard!
After upgrading the OpenShift Serverless Logic Operator to version 1.35.0, you must finalize the upgrade process by restoring or scaling workflows and cleaning up old services. This ensures that your system runs cleanly on the new version and that all dependent components are configured correctly.
Follow the appropriate steps below based on the profile of your workflows and services.
Prerequisites
-
You have access to the cluster with
cluster-admin
privileges. - You have OpenShift Serverless Logic Operator installed on your cluster.
- You have access to a OpenShift Serverless Logic project with the appropriate roles and permissions to create applications and other workloads in OpenShift Container Platform.
- You have access to the OpenShift Management Console for Operator upgrades.
-
You have installed the OpenShift CLI (
oc
).
10.1.3.1. Finalizing the Data Index upgrade Copy linkLink copied to clipboard!
After the Operator upgrade, a new ReplicaSet is automatically created for Data Index 1.35.0. You must delete the old one manually.
Procedure
Verify the new ReplicaSet exists by listing all ReplicaSets by running the following command:
oc get replicasets -n <target_namespace> -o custom-columns=Name:metadata.name,Image:spec.template.spec.containers[*].image
$ oc get replicasets -n <target_namespace> -o custom-columns=Name:metadata.name,Image:spec.template.spec.containers[*].image
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Identify the old Data Index ReplicaSet (with version 1.34.0) and delete it:
oc delete replicaset <old_replicaset_name> -n <target_namespace>
$ oc delete replicaset <old_replicaset_name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.3.2. Finalizing the Job Service upgrade Copy linkLink copied to clipboard!
You must manually clean up the Jobs Service components from the older version to trigger deployment of version 1.35.0 components.
Procedure
Delete the old Jobs Service deployment by running the following command:
oc delete deployment <jobs-service-deployment-name> -n <target_namespace>
$ oc delete deployment <jobs-service-deployment-name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This will trigger automatic cleanup of the older Pods and ReplicaSets and initiate a fresh deployment using version 1.35.0.
10.1.3.3. Redeploying workflows with the dev profile Copy linkLink copied to clipboard!
After the upgrade, you must redeploy workflows that use the dev
profile and any associated Kubernetes resources.
Procedure
-
Ensure all required resources are restored, including
SonataFlow
CRDs,ConfigMaps
, or any other related custom configurations. Redeploy the workflow by running the following command:
oc apply -f <my-workflow.yaml> -n <target_namespace>
$ oc apply -f <my-workflow.yaml> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.3.4. Restoring workflows with the preview profile Copy linkLink copied to clipboard!
Workflows with the preview
profile require an additional configuration step before being redeployed.
Procedure
If the workflow uses persistence, add the following property to the
ConfigMap
associated with the workflow:Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
Ensure all required resources are recreated, including
SonataFlow
CRDs,ConfigMaps
, or any other related custom configurations. Redeploy the workflow by running the following command:
oc apply -f <my-workflow.yaml> -n <target_namespace>
$ oc apply -f <my-workflow.yaml> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.3.5. Scaling up workflows with the gitops profile Copy linkLink copied to clipboard!
Workflows with the gitops
profile that were previously scaled down must be scaled back up to continue operation.
Procedure
Modify the
my-workflow.yaml
CRD and scale up each workflow toone
before upgrading as shown in the following example:spec: podTemplate: replicas: 1
spec: podTemplate: replicas: 1
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Apply the updated CRD by running the following command:
oc apply -f <my-workflow.yaml> -n <target_namespace>
$ oc apply -f <my-workflow.yaml> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow (Optional) Scale the workflow back to
1
by running the following command:oc patch sonataflow <my-workflow> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 1}}}'
$ oc patch sonataflow <my-workflow> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 1}}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.3.6. Verifying the upgrade Copy linkLink copied to clipboard!
After restoring workflows and services, it is essential to verify that the upgrade was successful and that all components are functioning as expected.
Procedure
Check if all workflows and services are running by entering the following command:
oc get pods -n <target_namespace>
$ oc get pods -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Ensure that all pods related to workflows, Data Index, and Jobs Service are in a
Running
orCompleted
state.Verify that the OpenShift Serverless Logic Operator is running correctly by entering the following command:
oc get clusterserviceversion logic-operator-rhel8.v1.35.0 -n openshift-serverless-logic
$ oc get clusterserviceversion logic-operator-rhel8.v1.35.0 -n openshift-serverless-logic
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Expected output
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.35.0 OpenShift Serverless Logic Operator 1.35.0 logic-operator-rhel8.v1.34.0 Succeeded
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.35.0 OpenShift Serverless Logic Operator 1.35.0 logic-operator-rhel8.v1.34.0 Succeeded
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Check Operator logs for any errors by entering the following command:
oc logs -l control-plane=sonataflow-operator -n openshift-serverless-logic
$ oc logs -l control-plane=sonataflow-operator -n openshift-serverless-logic
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2. Upgrading OpenShift Serverless Logic Operator from version 1.35.0 to 1.36.0 Copy linkLink copied to clipboard!
You can upgrade the OpenShift Serverless Logic Operator from version 1.35.0 to 1.36.0. The upgrade process involves preparing the existing workflows and services, updating the Operator, and restoring the workflows after the upgrade.
Different workflow profiles require different upgrade steps. Follow the instructions for each profile carefully.
10.2.1. Preparing for the upgrade Copy linkLink copied to clipboard!
Before starting the upgrade process, you need to prepare your OpenShift Serverless Logic environment to upgrade from version 1.35.0 to 1.36.0.
The preparation process is as follows:
- Deleting or scaling workflows based on their profiles.
- Backing up all necessary databases and resources.
- Ensuring you have a record of all custom configurations.
Prerequisites
-
You have access to the cluster with
cluster-admin
privileges. - You have OpenShift Serverless Logic Operator installed on your cluster.
- You have access to a OpenShift Serverless Logic project with the appropriate roles and permissions to create applications and other workloads in OpenShift Container Platform.
- You have access to the OpenShift Management Console for Operator upgrades.
-
You have installed the OpenShift CLI (
oc
).
10.2.1.1. Deleting workflows with the dev profile Copy linkLink copied to clipboard!
Before upgrading the Operator, you must delete workflows running with the dev
profile and redeploy them after the upgrade is complete.
Procedure
-
Ensure you have a backup of all necessary Kubernetes resources, including
SonataFlow
custom resources (CRs),ConfigMap
resources, or any other related custom configurations. Delete the workflow by executing the following command:
oc delete workflow <workflow_name> -n <target_namespace>
$ oc delete workflow <workflow_name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.1.2. Deleting workflows with the preview profile Copy linkLink copied to clipboard!
Before upgrading the Operator, you must delete workflows running with the preview
profile. When the upgrade is complete, you must redeploy the workflows.
Procedure
- If you are using persistence, back up the workflow database and ensure the backup includes both database objects and table data.
-
Ensure you have a backup of all necessary Kubernetes resources, including
SonataFlow
custom resources (CRs),ConfigMap
resources, or any other related custom configurations. Delete the workflow by executing the following command:
oc delete workflow <workflow_name> -n <target_namespace>
$ oc delete workflow <workflow_name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.1.3. Scaling down workflows with the gitops profile Copy linkLink copied to clipboard!
Before upgrading the Operator, you must scale down workflows running with the gitops
profile, and scale them up again after the upgrade is complete.
Procedure
Modify the
my-workflow.yaml
custom resources (CR) and scale down each workflow to0
before upgrading as shown in the following example:spec: podTemplate: replicas: 0 # ...
spec: podTemplate: replicas: 0 # ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Apply the updated
my-workflow.yaml
CR by running the following command:oc apply -f my-workflow.yaml -n <target_namespace>
$ oc apply -f my-workflow.yaml -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Optional: Scale the workflow to
0
by running the following command:oc patch workflow <workflow_name> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 0}}}'
$ oc patch workflow <workflow_name> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 0}}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.1.4. Backing up the Data Index database Copy linkLink copied to clipboard!
You must back up the Data Index database before upgrading to prevent data loss.
Procedure
Take a full backup of the Data Index database, ensuring:
- The backup includes all database objects and not just table data.
- The backup is stored in a secure location.
10.2.1.5. Backing up the Jobs Service database Copy linkLink copied to clipboard!
You must back up the Jobs Service database before upgrading to maintain job scheduling data.
Procedure
Take a full backup of the Jobs Service database, ensuring:
- The backup includes all database objects and not just table data.
- The backup is stored in a secure location.
10.2.2. Upgrading the OpenShift Serverless Logic Operator to 1.36.0 Copy linkLink copied to clipboard!
You can upgrade the OpenShift Serverless Logic Operator from version 1.35.0 to 1.36.0 by performing the following steps.
Prerequisites
-
You have access to the cluster with
cluster-admin
privileges. - You have OpenShift Serverless Logic Operator installed on your cluster.
- You have access to a OpenShift Serverless Logic project with the appropriate roles and permissions to create applications and other workloads in OpenShift Container Platform.
- You have access to the OpenShift Management Console for Operator upgrades.
-
You have installed the OpenShift CLI (
oc
). - You have version 1.35.0 of OpenShift Serverless Logic Operator installed.
Procedure
Patch the
ClusterServiceVersion
(CSV) for the 1.35.0 OpenShift Serverless Logic Operator to update the deployment labels by running the following command:Copy to Clipboard Copied! Toggle word wrap Toggle overflow Delete the current Operator deployment by running the following command:
oc delete deployment logic-operator-rhel8-controller-manager -n openshift-serverless-logic
$ oc delete deployment logic-operator-rhel8-controller-manager -n openshift-serverless-logic
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
In the web console, navigate to the Operators
OperatorHub Installed Operators page. - In the list of installed Operators, find and click the Operator named OpenShift Serverless Logic Operator.
- Initiate the OpenShift Serverless Logic Operator upgrade to version 1.36.0.
Verification
After applying the upgrade, verify that the Operator is running and in the
Succeeded
phase, by running the following command:oc get clusterserviceversion logic-operator-rhel8.v1.36.0
$ oc get clusterserviceversion logic-operator-rhel8.v1.36.0
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example output
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.36.0 OpenShift Serverless Logic Operator 1.36.0 logic-operator-rhel8.v1.35.0 Succeeded
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.36.0 OpenShift Serverless Logic Operator 1.36.0 logic-operator-rhel8.v1.35.0 Succeeded
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.3. Finalizing the upgrade Copy linkLink copied to clipboard!
After upgrading the OpenShift Serverless Logic Operator to version 1.36.0, you must finalize the upgrade process by restoring or scaling workflows and cleaning up old services. This ensures that your system runs cleanly on the new version and that all dependent components are configured correctly.
Follow the appropriate steps below based on the profile of your workflows and services.
Prerequisites
-
You have access to the cluster with
cluster-admin
privileges. - You have OpenShift Serverless Logic Operator installed on your cluster.
- You have access to a OpenShift Serverless Logic project with the appropriate roles and permissions to create applications and other workloads in OpenShift Container Platform.
- You have access to the OpenShift Management Console for Operator upgrades.
-
You have installed the OpenShift CLI (
oc
).
10.2.3.1. Finalizing the Data Index upgrade Copy linkLink copied to clipboard!
After the Operator upgrade, if your deployment is configured to use a Knative Eventing Kafka Broker, you must delete the old data-index-process-definition
trigger that was created in the OpenShift Serverless Logic 1.35.0 version. Optionally, you can delete the old ReplicaSet
resource as well.
Procedure
List all the triggers by running the following command:
oc get triggers -n <target_namespace>
$ oc get triggers -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example output
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Based on the generated example output, delete the old
data-index-process-definition
trigger by running the following command:oc delete trigger data-index-process-definition-473e1ddbb3ca1d62768187eb80de99bca -n <target_namespace>
$ oc delete trigger data-index-process-definition-473e1ddbb3ca1d62768187eb80de99bca -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow After deletion, a new trigger compatible with OpenShift Serverless Logic 1.36.0 is automatically created.
Optional: Identify the old
ReplicaSet
resource by running the following command:oc get replicasets -o custom-columns=Name:metadata.name,Image:spec.template.spec.containers[*].image -n <target_namespace>
$ oc get replicasets -o custom-columns=Name:metadata.name,Image:spec.template.spec.containers[*].image -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example output
Name Image sonataflow-platform-data-index-service-1111111111 registry.redhat.io/openshift-serverless-1/logic-data-index-postgresql-rhel8:1.35.0 sonataflow-platform-data-index-service-2222222222 registry.redhat.io/openshift-serverless-1/logic-data-index-postgresql-rhel8:1.36.0
Name Image sonataflow-platform-data-index-service-1111111111 registry.redhat.io/openshift-serverless-1/logic-data-index-postgresql-rhel8:1.35.0 sonataflow-platform-data-index-service-2222222222 registry.redhat.io/openshift-serverless-1/logic-data-index-postgresql-rhel8:1.36.0
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Optional: Delete your old
ReplicaSet
resource by running the following command:oc delete replicaset <old_replicaset_name> -n <target_namespace>
$ oc delete replicaset <old_replicaset_name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example command based on the example output
oc delete replicaset sonataflow-platform-data-index-service-1111111111 -n <target_namespace>
$ oc delete replicaset sonataflow-platform-data-index-service-1111111111 -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.3.2. Finalizing the Job Service upgrade Copy linkLink copied to clipboard!
After the OpenShift Serverless Operator is upgraded to version 1.36.0 you can optionally delete the old ReplicaSet
resource.
Procedure
Identify the old
ReplicaSet
resource by running the following command:oc get replicasets -o custom-columns=Name:metadata.name,Image:spec.template.spec.containers[*].image -n <target_namespace>
$ oc get replicasets -o custom-columns=Name:metadata.name,Image:spec.template.spec.containers[*].image -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example output
Name Image sonataflow-platform-jobs-service-1111111111 registry.redhat.io/openshift-serverless-1/logic-jobs-service-postgresql-rhel8:1.35.0 sonataflow-platform-jobs-service-2222222222 registry.redhat.io/openshift-serverless-1/logic-jobs-service-postgresql-rhel8:1.36.0
Name Image sonataflow-platform-jobs-service-1111111111 registry.redhat.io/openshift-serverless-1/logic-jobs-service-postgresql-rhel8:1.35.0 sonataflow-platform-jobs-service-2222222222 registry.redhat.io/openshift-serverless-1/logic-jobs-service-postgresql-rhel8:1.36.0
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Delete your old
ReplicaSet
resource by running the following command:oc delete replicaset <old_replicaset_name> -n <target_namespace>
$ oc delete replicaset <old_replicaset_name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example command based on the example output
oc delete replicaset sonataflow-platform-jobs-service-1111111111 -n <target_namespace>
$ oc delete replicaset sonataflow-platform-jobs-service-1111111111 -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.3.3. Redeploying workflows with the dev profile Copy linkLink copied to clipboard!
After the upgrade, you must redeploy workflows that use the dev
profile and any associated Kubernetes resources.
Procedure
-
Ensure that all required Kubernetes resources, including the
ConfigMap
with theapplication.properties
field, are restored before redeploying the workflow. Redeploy the workflow by running the following command:
oc apply -f <workflow_name> -n <target_namespace>
$ oc apply -f <workflow_name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.3.4. Restoring workflows with the preview profile Copy linkLink copied to clipboard!
After the upgrade, you must redeploy workflows that use the preview
profile and any associated Kubernetes resources.
Procedure
-
Ensure that all required Kubernetes resources, including the
ConfigMap
with theapplication.properties
field, are restored before redeploying the workflow. Redeploy the workflow by running the following command:
oc apply -f <workflow_name> -n <target_namespace>
$ oc apply -f <workflow_name> -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.3.5. Scaling up workflows with the gitops profile Copy linkLink copied to clipboard!
To continue operation, you must scale up workflows that you previously scaled down with the gitops
profile.
Procedure
Modify the
my-workflow.yaml
custom resources (CR) and scale up each workflow to1
as shown in the following example:spec: podTemplate: replicas: 1 # ...
spec: podTemplate: replicas: 1 # ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Apply the updated CR by running the following command:
oc apply -f my-workflow.yaml -n <target_namespace>
$ oc apply -f my-workflow.yaml -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Optional: Scale the workflow back to
1
by running the following command:oc patch workflow <workflow_name> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 1}}}'
$ oc patch workflow <workflow_name> -n <target_namespace> --type=merge -p '{"spec": {"podTemplate": {"replicas": 1}}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2.4. Verifying the 1.36.0 upgrade Copy linkLink copied to clipboard!
After restoring workflows and services, verify that the upgrade was successful and all components are functioning as expected.
Procedure
Check if all workflows and services are running by entering the following command:
oc get pods -n <target_namespace>
$ oc get pods -n <target_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Ensure that all pods related to workflows, Data Index, and Jobs Service are in a
Running
orCompleted
state.Verify that the OpenShift Serverless Logic Operator is running correctly by entering the following command:
oc get clusterserviceversion logic-operator-rhel8.v1.36.0 -n openshift-serverless-logic
$ oc get clusterserviceversion logic-operator-rhel8.v1.36.0 -n openshift-serverless-logic
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example output
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.36.0 OpenShift Serverless Logic Operator 1.36.0 logic-operator-rhel8.v1.35.0 Succeeded
NAME DISPLAY VERSION REPLACES PHASE logic-operator-rhel8.v1.36.0 OpenShift Serverless Logic Operator 1.36.0 logic-operator-rhel8.v1.35.0 Succeeded
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Check Operator logs for any errors by entering the following command:
oc logs -l control-plane=sonataflow-operator -n openshift-serverless-logic
$ oc logs -l control-plane=sonataflow-operator -n openshift-serverless-logic
Copy to Clipboard Copied! Toggle word wrap Toggle overflow