Upgrade your IBM Event Streams operator and operand instances as follows.
The following upgrade paths are available:
- You can upgrade the Event Streams operator to version 2.5.2 directly from version 2.5.x, 2.4.x, 2.3.x, and 2.2.x.
- You can upgrade the Event Streams operand to version 10.5.0 directly from version 10.4.x, 10.3.x, 10.2.x, 10.1.x, and 10.0.x.
- If you have an earlier version than 10.0.0, you must first upgrade your Event Streams version to 10.0.0, before upgrading to 10.5.0.
- Ensure you have followed the upgrade steps for IBM Cloud Pak for Integration before upgrading Event Streams.
The images for Event Streams release 10.5.0 are available in the IBM Cloud Container Registry. Ensure you redirect your catalog source to use
icr.io/cpopenas described in Implementing ImageContentSourcePolicy to redirect to the IBM Container Registry.
- To upgrade successfully, your Event Streams instance must have more than one ZooKeeper node or have persistent storage enabled. If you upgrade an Event Streams instance with a single ZooKeeper node that has ephemeral storage, all messages and all topics will be lost and both ZooKeeper and Kafka pods will move to an error state. To avoid this issue, increase the number of ZooKeeper nodes before upgrading as follows:
apiVersion: eventstreams.ibm.com/v1beta1 kind: EventStreams metadata: name: example-pre-upgrade namespace: myproject spec: strimziOverrides: zookeeper: replicas: 3
The upgrade process requires the upgrade of the Event Streams operator, and then the upgrade of your Event Streams instances. Complete the steps in the following sections to upgrade your Event Streams installation.
Upgrade the Event Streams operator
- Log in to the OpenShift Container Platform web console using your login credentials.
- Expand Operators in the navigation on the left, and click Installed Operators.
- Locate the operator that manages your Event Streams instance in the namespace. It is called IBM Event Streams in the Name column.
- Click the IBM Event Streams link in the row and then click the Subscription tab. This shows the Subscription details for the Event Streams operator.
- Click the version number link in the Update channel section (for example, v2.4). The Change Subscription update channel dialog is displayed, showing the channels that are available to upgrade to.
- Select v2.5 and click the Save button on the Change Subscription Update Channel dialog.
All Event Streams pods that need to be updated as part of the upgrade will be gracefully rolled. Where required ZooKeeper pods will roll one at a time, followed by Kafka brokers rolling one at a time.
Note: The number of containers in each Kafka broker will reduce from 2 to 1 as the TLS-sidecar container will be removed from each broker during the upgrade process.
Upgrade the Event Streams operand (instance)
- Click Installed Operators from the navigation on the left to show the list of installed operators that includes the upgraded IBM Event Streams operator.
- Select the IBM Event Streams operator from the list of Installed Operators.
- Click the Event Streams tab. This lists the Event Streams operands.
- Find your instance in the Name column and click the link for the instance.
- Click the YAML tab. The Event Streams instance custom resource is shown.
- In the YAML, change the version field to the required version, for example, 10.5.0.
- Click the Save button.
All Event Streams pods will gracefully roll again.
Verify the upgrade
- Wait for all Event Streams pods to complete the upgrade process. This is indicated by the
- Log in to your Red Hat OpenShift Container Platform as a cluster administrator by using the
- To retrieve a list of Event Streams instances, run the following command:
oc get eventstreams -n <namespace>
- For the instance of Event Streams that you upgraded, check that the status returned by the command in the previous step is
Enable metrics for monitoring
To display metrics in the monitoring dashboards of the Event Streams UI, ensure you enable the OpenShift Container Platform monitoring stack.
Retrieve the new URL for the UI
When upgrading from an earlier version than 10.4.x, the previous URL for accessing the Event Streams UI is deprecated, and will redirect to the 10.5.0 URL after upgrading.
You can also retrieve the URL for your Event Streams UI by following the steps in logging in.
eventstreams-cluster-operator operand request
When upgrading from an earlier version than 10.2.x, delete the previous
eventstreams-cluster-operator operand request for the earlier operator version.
Event Streams uses operand request resources to declare the required IBM Cloud Pak foundational services components. In Event Streams version 10.2.0 and later, operand request resources are only created for individual instances of Event Streams. In versions 10.0.0 and 10.1.0, the operator also had an operand request created when installed. After upgrading to version 10.2.0 or later, you can delete the previous operand request for the earlier operator version as follows:
oc delete operandrequest -n <operator_namespace> eventstreams-cluster-operator
<operator_namespace> is either the specific namespace where the operator was deployed to manage instances of Event Streams in that namespace only, or it is
openshift-operators if the operator was deployed to manage instances of Event Streams in any namespace..
Upgrade the Kafka broker protocol version
Note: Only applicable when upgrading from an earlier version than 10.4.x.
After successfully upgrading to Event Streams 10.5.0 by completing all previous steps and verifying the cluster’s behavior and performance, change the following values in order to upgrade the Kafka brokers to version
- Change the
inter.broker.protocol.versionvalue in the EventStreams custom resource to
- Wait for the Kafka pods to roll.
- After the pods have rolled, change the
log.message.format.versionvalue in the EventStreams custom resource to
- Wait for the pods to roll again.
Upgrade to use the Apicurio Registry
The previous schema registry in Event Streams was deprecated in version 10.1.0 and is not an available option for schemas in Event Streams version 10.5.0 and later.
If you are upgrading to Event Streams version 10.5.0 from an earlier version and you are using the deprecated registry option previously used for schemas, you will need to move your schemas to use the Apicurio Registry and reconfigure any applications that use those schemas to connect to the new registry, as described in migrating.