Bug 1300881

Summary: ETCD installation validation is misleading
Product: OpenShift Container Platform Reporter: James Radtke <jradtke>
Component: DocumentationAssignee: Alex Dellapenta <adellape>
Status: CLOSED CURRENTRELEASE QA Contact: Vikram Goyal <vigoyal>
Severity: low Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 3.1.0CC: aos-bugs, jokerman, mmccomas, plarsen
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-12-31 02:48:28 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description James Radtke 2016-01-22 00:41:44 UTC
Document URL: https://docs.openshift.com/enterprise/3.1/install_config/install/advanced_install.html

Section Number and Name: 
Verifying the Installation

Describe the issue: 
If you install etcd that are not cohabiting with the master, etcdctl is not available on the master node.  

Suggestions for improvement: 
There either needs to explain how to install etcdcl on the master (probably not the best options), or, how to reference the right keys from one of the etcd hosts.

Connect to one of your etcd nodes and run
etcdctl -C \
https://osetcd01.example.lab:2379,https://osetcd02.example.lab:2379,https://osetcd03.example.lab:2379 \
--ca-file=/etc/etcd/generated_certs/openshift-master-semst01.example.lab/master.etcd-ca.crt \
--cert-file=/etc/etcd/generated_certs/openshift-master-osemst01.example.lab/master.etcd-client.crt \
--key-file=/etc/etcd/generated_certs/openshift-master-osemst01.example.lab//master.etcd-client.key cluster-health


Additional information:

Comment 1 Vikram Goyal 2017-12-31 02:48:28 UTC
This was updated: https://docs.openshift.com/enterprise/3.1/install_config/install/advanced_install.html#configuring-fencing.

Closing this bug.