add proxy known issue (#734)

migtools · Aug 17, 2021 · c912f6e · c912f6e
1 parent 615b26b
commit c912f6e
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/docs/usage/DVMProxyConfiguration.md b/docs/usage/DVMProxyConfiguration.md
@@ -44,3 +44,10 @@ ssl_bump splice dvmRoute
 
 The above configuration allows forwarding the traffic destined to the target cluster's Rsync Route transparently.
 
+### Known Issues
+
+#### Migration fails with error `Upgrade request required` 
+
+The migration Controller uses SPDY protocol to execute commands within remote Pods. If the remote cluster is behind a proxy/firewall which does not support SPDY protocol, the migration controller will fail to execute remote commands. The migration will fail with error message `Upgrade request required`. To solve the issue, the proxy must allow SPDY protocol.
+
+In addition to supporting SPDY protocol, the proxy/firewall also needs to pass `Upgrade` HTTP header to the API server. This header is used by the client to open a websocket connection with the API server. If the `Upgrade` header is blocked by the proxy/firewall, the migration will still fail with the same error message. To solve this issue, the proxy simply needs to forward `Upgrade` header.