scylladb
doc: add the 5.4-to-6.0 upgrade guide and remove reduntant guides
This PR adds the 5.4-to-6.0 upgrade guide. The guide has references to the "Enable Consistent Topology Updates" document, as enabling consistent topology updates is a recommended step when upgrading to version 6.0.
In addition, it removes the following upgrade guides:
- 5.4 to 5.5 - We don't need it as version 5.5 was never released.
- 5.x.y - It is redundat in the docs for version 6.0.
Fixes https://github.com/scylladb/scylladb/issues/18254
Docs Preview :book:
Docs Preview for this pull request is available here
Changed Files:
- upgrade/upgrade-opensource/index.html
- upgrade/upgrade-opensource/upgrade-guide-from-5.4-to-5.5/index.html
- upgrade/upgrade-opensource/upgrade-guide-from-5.4-to-5.5/metric-update-5.4-to-5.5
- upgrade/upgrade-opensource/upgrade-guide-from-5.4-to-6.0/index.html
- upgrade/upgrade-opensource/upgrade-guide-from-5.4-to-6.0/metric-update-5.4-to-6.0
- upgrade/upgrade-opensource/upgrade-guide-from-5.4-to-6.0/upgrade-guide-from-5.4-to-6.0-generic
- upgrade/upgrade-opensource/upgrade-guide-from-5.x.y-to-5.x.z/index.html
- upgrade/upgrade-opensource/upgrade-guide-from-5.x.y-to-5.x.z/upgrade-guide-from-5.x.y-to-5.x.z-debian
- upgrade/upgrade-opensource/upgrade-guide-from-5.x.y-to-5.x.z/upgrade-guide-from-5.x.y-to-5.x.z-image
- upgrade/upgrade-opensource/upgrade-guide-from-5.x.y-to-5.x.z/upgrade-guide-from-5.x.y-to-5.x.z-rpm
- upgrade/upgrade-opensource/upgrade-guide-from-5.x.y-to-5.x.z/upgrade-guide-from-5.x.y-to-5.x.z-ubuntu
Note: This preview will be available for 30 days and will be automatically deleted after that period. You can manually trigger a new build by committing changes.
@yaronkaikov Please have a look at this PR. I've used the same upgrade procedure, but added the "EC2/GCP/Azure Ubuntu Image" tab. Please see if the instructions are correct, especially the name "scylla-machine-image" (I've documented this procedure before for Enterprise, not Open Source).
@kbr-scylla Please have a look at the references to enabling consistent topology updates. The instructions are not part of this PR (they are added with https://github.com/scylladb/scylladb/pull/17624), but check if the references are precise.
@roydahan Please assign someone to review the upgrade procedure.
@roydahan Could you assign someone to test the above upgrade procedure?
Please assign someone to review the upgrade procedure.
6.0 wasn’t branched yet and not tested yet, so we can’t provide any feedback yet on the procedure.
@scylladb/scylla-maint Please merge this PR. It has been reviewed. I want the procedure to be additionally tested after we have the first RC, but I can open a follow-up PR if necessary.
Reason: The dev team needs to update the 5.4-to-6.0 upgrade guide. They can't do it now, because the upgrade guide is only added with this PR, so it's not on master.
@kbr-scylla I've converted this PR into draft. Of course, I've messed up this PR trying to apply the changes you requested. I may need to open a new one.