Skip to content
Open
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
44 changes: 38 additions & 6 deletions docs/cloud/migrate/automated.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -182,6 +182,27 @@ Proceed only when your request has been approved by Temporal.

:::

### Plan migration endpoints

A migration endpoint is a cloud-side resource that connects one of your self-hosted servers to Temporal Cloud. Temporal
creates the endpoints and provides the `endpoint-id` values used with the `tcld migration` commands in later phases.

Each self-hosted server you migrate from needs its own S2S Proxy deployment and its own migration endpoint. You can
migrate from more than one self-hosted server at the same time, such as separate development and production servers,
provided each self-hosted server has a unique cluster name and Initial Failover Version. Temporal uses `active` as the
default cluster name, so servers that still use the default will collide. See
[Modify cluster configuration](#modify-cluster-configuration) for setting these values.

If your self-hosted servers cannot use unique cluster names, migrate one server at a time, or contact Temporal to
discuss the available options.

Namespaces migrating from the same self-hosted server share that server's proxy and endpoint. You can migrate more than
one Namespace from a server at the same time, provided each source Namespace and its cloud-side target are listed in
the `namespaceTranslation` mappings of that server's proxy configuration. See
[S2S Proxy configuration](#s2s-proxy-configuration).

Tell Temporal how many self-hosted servers you plan to migrate from, and whether you intend to migrate from them in
parallel, so that the required cloud-side resources are in place.

### S2S Proxy configuration

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

馃摑 [vale] reported by reviewdog 馃惗
[Temporal.Headings] 'S2S Proxy configuration' should use sentence-style capitalization.


Expand Down Expand Up @@ -222,6 +243,9 @@ namespaceTranslation:
```
5. Test access using the command below. It should display the information of the migration server.

The address is your own proxy's external address, not a cloud-side address. It's the same value you set as
`replicationEndpoint` under `clusterConnections` in your proxy configuration file.

```
temporal operator cluster describe --address {the-outbound-external-address-of-your-proxy}
```
Expand Down Expand Up @@ -452,12 +476,9 @@ The following are known limitations.
- OSS server versions 1.22 or newer are required. Refer to the
[upgrade](/self-hosted-guide/upgrade-server#upgrade-server) procedure as needed.
- History shard counts must be a power of two (eg. 512, 1024, etc...).
- If you have multiple self-hosted servers and they are all configured with the same cluster name (by default Temporal
uses 'active' as cluster name), they cannot be connected to a single migration server simultaneously due to cluster
name collision. There are 2 available options:
1. Migrate one server at a time using a single migration server.
2. Create multiple migration servers (one for each self-hosted server) if you need to migrate all servers
simultaneously.
- Self-hosted servers that are migrated at the same time must each have a unique cluster name and Initial Failover
Version. Servers that share a cluster name, such as the default `active`, collide. See
[Plan migration endpoints](#plan-migration-endpoints).
- If you are using multi-cluster replication in your self-hosted setup and have previously failed over Namespaces, then
this may impact your eligibility for automated migration. Specifically, whenever Global Namespace has been previously
enabled the following restrictions apply:
Expand Down Expand Up @@ -502,6 +523,17 @@ The answer depends on your specific situation. However, automated migration is m

In contrast, automated migration may not be the best solution if your self-hosted clusters do not meet the [minimum requirements](#limitations).

### Can I migrate from multiple self-hosted servers at the same time?

Yes. Each self-hosted server needs its own S2S Proxy deployment and its own migration endpoint, and each must have a
unique cluster name and Initial Failover Version. See [Plan migration endpoints](#plan-migration-endpoints).

### Can I migrate multiple Namespaces from the same self-hosted server at the same time?

Yes. Those Namespaces share the server's proxy and endpoint, so no additional cloud-side resources are needed. Include
each source Namespace and its cloud-side target in the `namespaceTranslation` mappings of that server's proxy
configuration. See [S2S Proxy configuration](#s2s-proxy-configuration).

### Can I split Workflows from a single source Namespace into multiple cloud-side Namespaces?
No. All Workflows will be migrated.

Expand Down
Loading