Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,10 @@ All notable changes to this project will be documented in this file.
datanodes. It was previously raised for journalnodes, even though its text refers to datanode
replicas, and never for datanodes ([#830]).

### Removed

- Remove support for HDFS `3.4.2` ([#838]).

[#801]: https://github.com/stackabletech/hdfs-operator/pull/801
[#806]: https://github.com/stackabletech/hdfs-operator/pull/806
[#810]: https://github.com/stackabletech/hdfs-operator/pull/810
Expand All @@ -69,6 +73,7 @@ All notable changes to this project will be documented in this file.
[#831]: https://github.com/stackabletech/hdfs-operator/pull/831
[#833]: https://github.com/stackabletech/hdfs-operator/pull/833
[#835]: https://github.com/stackabletech/hdfs-operator/pull/835
[#838]: https://github.com/stackabletech/hdfs-operator/pull/838
[#839]: https://github.com/stackabletech/hdfs-operator/pull/839

## [26.7.0] - 2026-07-21
Expand Down
10 changes: 5 additions & 5 deletions docs/modules/hdfs/pages/usage-guide/upgrading.adoc
Comment thread
adwk67 marked this conversation as resolved.
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@
IMPORTANT: HDFS upgrades are experimental, and details may change at any time.

HDFS currently requires a manual process to upgrade.
This guide takes you through an example case, upgrading an example cluster (from our xref:getting_started/index.adoc[Getting Started] guide) from HDFS 3.3.6 to 3.4.2.
This guide takes you through an example case, upgrading an example cluster (from our xref:getting_started/index.adoc[Getting Started] guide) from HDFS 3.4.3 to 3.5.0.

== Preparing for the worst

Upgrades can fail, and it is important to prepare for when that happens.
Apache HDFS supports https://hadoop.apache.org/docs/r3.4.2/hadoop-project-dist/hadoop-hdfs/HdfsRollingUpgrade.html#Downgrade_and_Rollback[two ways to revert an upgrade]:
Apache HDFS supports https://hadoop.apache.org/docs/r3.5.0/hadoop-project-dist/hadoop-hdfs/HdfsRollingUpgrade.html#Downgrade_and_Rollback[two ways to revert an upgrade]:

Rollback:: Reverts all user data to the pre-upgrade state. Requires taking the cluster offline.
Downgrade:: Downgrades the HDFS software but preserves all changes made by users. Can be performed as a rolling change, keeping the cluster online.
Expand All @@ -20,7 +20,7 @@ In order to downgrade, revert the `.spec.image.productVersion` field, and then p

[source,shell]
----
$ kubectl patch hdfs/simple-hdfs --patch '{"spec": {"image": {"productVersion": "3.3.6"}}}' --type=merge
$ kubectl patch hdfs/simple-hdfs --patch '{"spec": {"image": {"productVersion": "3.4.3"}}}' --type=merge
hdfscluster.hdfs.stackable.tech/simple-hdfs patched
----

Expand Down Expand Up @@ -69,7 +69,7 @@ Once HDFS is ready to upgrade, the HdfsCluster can be updated with the new produ

[source,shell]
----
$ kubectl patch hdfs/simple-hdfs --patch '{"spec": {"image": {"productVersion": "3.4.2"}}}' --type=merge
$ kubectl patch hdfs/simple-hdfs --patch '{"spec": {"image": {"productVersion": "3.5.0"}}}' --type=merge
hdfscluster.hdfs.stackable.tech/simple-hdfs patched
----

Expand Down Expand Up @@ -103,7 +103,7 @@ Finally, mark the cluster as upgraded:

[source,shell]
----
$ kubectl patch hdfs/simple-hdfs --subresource=status --patch '{"status": {"deployedProductVersion": "3.4.2"}}' --type=merge
$ kubectl patch hdfs/simple-hdfs --subresource=status --patch '{"status": {"deployedProductVersion": "3.5.0"}}' --type=merge
hdfscluster.hdfs.stackable.tech/simple-hdfs patched
----

Expand Down
1 change: 0 additions & 1 deletion docs/modules/hdfs/partials/supported-versions.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,3 @@

- 3.5.0 (LTS)
- 3.4.3
- 3.4.2 (deprecated)
1 change: 0 additions & 1 deletion tests/test-definition.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
dimensions:
- name: hadoop
values:
- 3.4.2
- 3.4.3
- 3.5.0
# To use a custom image, add a comma and the full name after the product version
Expand Down
Loading