:_mod-docs-content-type: ASSEMBLY

// This assembly is included in the following assemblies:
//
// deploying/deploying.adoc

[id='assembly-upgrade-{context}']
= Upgrading Strimzi

[role="_abstract"]
Download the latest Strimzi xref:downloads-{context}[deployment files] and upgrade your Strimzi installation to version {ProductVersion} to benefit from new features, performance improvements, and enhanced security options.
During the upgrade, Kafka is also updated to the latest supported version, introducing additional features and bug fixes to your Strimzi deployment.

Use the same method to upgrade the Cluster Operator as the initial method of deployment.
For example, if you used the Strimzi installation files, modify those files to perform the upgrade.
After you have upgraded your Cluster Operator to {ProductVersion}, the next step is to upgrade all Kafka nodes to the latest supported version of Kafka. 
Kafka upgrades are performed by the Cluster Operator through rolling updates of the Kafka nodes.

If you encounter any issues with the new version, Strimzi can be xref:assembly-downgrade-{context}[downgraded] to the previous version.

For topics configured with high availability (replication factor of at least 3 and evenly distributed partitions), the upgrade process should not cause any downtime for consumers and producers.

The upgrade triggers rolling updates, where brokers are restarted one by one at different stages of the process. 
During this time, overall cluster availability is temporarily reduced, which may increase the risk of message loss in the event of a broker failure.

//sequence
include::../../modules/upgrading/con-upgrade-sequence.adoc[leveloffset=+1]

//upgrading kubernetes
include::../../modules/upgrading/con-upgrade-cluster.adoc[leveloffset=+1]

//upgrade considerations for pre-0.39 upgrades (non-KRaft)
include::../../modules/upgrading/con-migrate-kraft-pre-0.39.adoc[leveloffset=+1]

//upgrade considerations for v1 conversion
include::../../modules/upgrading/con-api-conversion-v1.adoc[leveloffset=+1]

//upgrading cluster operator
include::assembly-upgrade-cluster-operator.adoc[leveloffset=+1]

//upgrading kafka
include::../../modules/upgrading/proc-upgrade-kafka-kraft.adoc[leveloffset=+1]

//checking the status of an upgrade
include::../../modules/upgrading/con-upgrade-status.adoc[leveloffset=+1]

//kafka upgrade concepts
include::../../modules/upgrading/con-upgrade-paths.adoc[leveloffset=+1]
include::../../modules/upgrading/con-upgrade-versions-and-images.adoc[leveloffset=+2]

//client upgrade concepts
include::../../modules/upgrading/con-upgrade-strategies-for-upgrading-clients.adoc[leveloffset=+1]
