From d69e5c0324d4cfeca291766fd68691348e4b4094 Mon Sep 17 00:00:00 2001 From: Nick Beaumont Date: Mon, 12 Jan 2026 10:28:44 -0800 Subject: [PATCH 1/2] Add version-specific self-hosted-to-cloud instructions for v1.22 and v1.23 There's a special-case for v1.22 and v1.23 that should be included in the doc. For now, we aren't aware of enough special-cases that we'd need a dedicated section or page for them. --- .../cloud/migrate/automated.mdx | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/production-deployment/cloud/migrate/automated.mdx b/docs/production-deployment/cloud/migrate/automated.mdx index 54e6c40e5f..732c664cad 100644 --- a/docs/production-deployment/cloud/migrate/automated.mdx +++ b/docs/production-deployment/cloud/migrate/automated.mdx @@ -217,8 +217,18 @@ Before failing over your namespace to Temporal Cloud, review the following produ ### Additional Notes +#### Special dynamic configuration for Version 1.22.x-1.23.x +Temporal versions 1.22.x and 1.23.x support stream-based replication, but it was disabled by default. Since those versions were released, stream-based replication has been tested as more reliable than the poll-based replication that was the default in 1.22 and 1.23. When preparing for an S2C migration on these versions, please add the following dynamic configuration to enable stream-based replication: + +```yaml +history.enableReplicationStream: + - value: true +``` + +Enabling this configuration will require a restart of your history pods. + #### Alternative Commands for Versions 1.28.1 and Prior -Version 1.28.1 and older do not provide the details necessary for setting up migration. If you are running an older version of Temporal, then substitute the below +The `temporal` command is missing some details needed for migration when run against Version 1.28.1. If you are running that version of Temporal or older, then substitute the below commands for the "temporal operator cluster describe" command cited in this document. If you are using tctl, then substitute the following command: `tctl --address admin cluster describe` From 9f25806e3c82306b44b153b7efa8f1f1a2a2fb20 Mon Sep 17 00:00:00 2001 From: Nick Beaumont Date: Mon, 12 Jan 2026 10:34:52 -0800 Subject: [PATCH 2/2] Clarify wording --- docs/production-deployment/cloud/migrate/automated.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/production-deployment/cloud/migrate/automated.mdx b/docs/production-deployment/cloud/migrate/automated.mdx index 732c664cad..d8c849c081 100644 --- a/docs/production-deployment/cloud/migrate/automated.mdx +++ b/docs/production-deployment/cloud/migrate/automated.mdx @@ -228,7 +228,7 @@ history.enableReplicationStream: Enabling this configuration will require a restart of your history pods. #### Alternative Commands for Versions 1.28.1 and Prior -The `temporal` command is missing some details needed for migration when run against Version 1.28.1. If you are running that version of Temporal or older, then substitute the below +The `temporal` command is missing some details needed for migration when run against Version 1.28.1 or older. If you are running that version of Temporal or older, then substitute the below commands for the "temporal operator cluster describe" command cited in this document. If you are using tctl, then substitute the following command: `tctl --address admin cluster describe`