From b5b7c78f1b86b656cb2fda118d75925a18714bc2 Mon Sep 17 00:00:00 2001 From: Yicheng Qin Date: Wed, 29 Apr 2015 14:54:03 -0700 Subject: [PATCH] docs: proxy needs accessible advertise client urls Users cannot use proxy if -advertise-client-urls is set correctly. Especially mention this in the doc to help them bypass the wrong settings. --- Documentation/proxy.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/proxy.md b/Documentation/proxy.md index 7e2e8b4da..a9522d749 100644 --- a/Documentation/proxy.md +++ b/Documentation/proxy.md @@ -6,6 +6,8 @@ etcd currently supports two proxy modes: `readwrite` and `readonly`. The default The proxy will shuffle the list of cluster members periodically to avoid sending all connections to a single member. +The member list used by proxy consists of all client URLs advertised within the cluster, as specified in each members' `-advertise-client-urls` flag. If this flag is set incorrectly, requests sent to the proxy are forwarded to wrong addresses and then fail. The fix for this problem is to restart etcd member with correct `-advertise-client-urls` flag. After client URLs list in proxy is recalculated, which happens every 30 seconds, requests will be forwarded correctly. + ### Using an etcd proxy To start etcd in proxy mode, you need to provide three flags: `proxy`, `listen-client-urls`, and `initial-cluster` (or `discovery`).