{"action":"closed","issue":{"url":"https://api.github.com/repos/coreos/etcd/issues/3476","labels_url":"https://api.github.com/repos/coreos/etcd/issues/3476/labels{/name}","comments_url":"https://api.github.com/repos/coreos/etcd/issues/3476/comments","events_url":"https://api.github.com/repos/coreos/etcd/issues/3476/events","html_url":"https://github.com/coreos/etcd/issues/3476","id":105726467,"number":3476,"title":"docs: expand member update reconfiguration section","user":{"login":"robszumski","id":755540,"avatar_url":"https://avatars.githubusercontent.com/u/755540?v=3","gravatar_id":"","url":"https://api.github.com/users/robszumski","html_url":"https://github.com/robszumski","followers_url":"https://api.github.com/users/robszumski/followers","following_url":"https://api.github.com/users/robszumski/following{/other_user}","gists_url":"https://api.github.com/users/robszumski/gists{/gist_id}","starred_url":"https://api.github.com/users/robszumski/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/robszumski/subscriptions","organizations_url":"https://api.github.com/users/robszumski/orgs","repos_url":"https://api.github.com/users/robszumski/repos","events_url":"https://api.github.com/users/robszumski/events{/privacy}","received_events_url":"https://api.github.com/users/robszumski/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/coreos/etcd/labels/kind/documentation","name":"kind/documentation","color":"c7def8"}],"state":"closed","locked":false,"assignee":{"login":"xiang90","id":4479947,"avatar_url":"https://avatars.githubusercontent.com/u/4479947?v=3","gravatar_id":"","url":"https://api.github.com/users/xiang90","html_url":"https://github.com/xiang90","followers_url":"https://api.github.com/users/xiang90/followers","following_url":"https://api.github.com/users/xiang90/following{/other_user}","gists_url":"https://api.github.com/users/xiang90/gists{/gist_id}","starred_url":"https://api.github.com/users/xiang90/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xiang90/subscriptions","organizations_url":"https://api.github.com/users/xiang90/orgs","repos_url":"https://api.github.com/users/xiang90/repos","events_url":"https://api.github.com/users/xiang90/events{/privacy}","received_events_url":"https://api.github.com/users/xiang90/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/coreos/etcd/milestones/25","html_url":"https://github.com/coreos/etcd/milestones/v2.3.0-alpha1","labels_url":"https://api.github.com/repos/coreos/etcd/milestones/25/labels","id":1306963,"number":25,"title":"v2.3.0-alpha1","description":"","creator":{"login":"xiang90","id":4479947,"avatar_url":"https://avatars.githubusercontent.com/u/4479947?v=3","gravatar_id":"","url":"https://api.github.com/users/xiang90","html_url":"https://github.com/xiang90","followers_url":"https://api.github.com/users/xiang90/followers","following_url":"https://api.github.com/users/xiang90/following{/other_user}","gists_url":"https://api.github.com/users/xiang90/gists{/gist_id}","starred_url":"https://api.github.com/users/xiang90/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xiang90/subscriptions","organizations_url":"https://api.github.com/users/xiang90/orgs","repos_url":"https://api.github.com/users/xiang90/repos","events_url":"https://api.github.com/users/xiang90/events{/privacy}","received_events_url":"https://api.github.com/users/xiang90/received_events","type":"User","site_admin":false},"open_issues":5,"closed_issues":19,"state":"open","created_at":"2015-09-15T18:22:49Z","updated_at":"2015-11-23T23:32:32Z","due_on":"2015-11-27T08:00:00Z","closed_at":null},"comments":0,"created_at":"2015-09-10T03:46:01Z","updated_at":"2015-11-23T23:32:32Z","closed_at":"2015-11-23T23:32:32Z","body":"The [existing reconfig docs](https://github.com/coreos/etcd/blob/master/Documentation/runtime-configuration.md#update-a-member) don't mention the different between cluster-level settings like peerURL and local settings like clientURL.\r\n\r\nI would have expected this to be different. Instead of:\r\n\r\n```\r\n$ etcdctl member update b4db3bf5e495e255 http://10.0.1.10:2380\r\n```\r\n\r\nAdd `peerURLs=` so you know what IP address you are updating:\r\n```\r\n$ etcdctl member update b4db3bf5e495e255 peerURLs=http://10.0.1.10:2380\r\n```\r\n\r\nNext issue: what if I wanted to change the clientURLs list? The doc doesn't cover this at all. But you'd have to tweak the env var for the client-side setting, then restart etcd.\r\n\r\nRecommendations:\r\n - list out all of the client and cluster level settings, so I know which type of update to do\r\n - have a section explaining both types of changes\r\n - add a sentence about how cluster settings go through consensus, which is why they act differently, and how this protects you as a user\r\n"}}