Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1589952

Summary: [DOCS] Ensuring Host Access has error in example loop
Product: OpenShift Container Platform Reporter: Kaitlyn Carcia Poulin <kcarcia>
Component: DocumentationAssignee: Kathryn Alexander <kalexand>
Status: CLOSED CURRENTRELEASE QA Contact: Johnny Liu <jialiu>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.9.0CC: aos-bugs, jokerman, mmccomas, mowens, tcarlin
Target Milestone: ---   
Target Release: 3.11.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-08-27 20:00:51 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:
Embargoed:
Bug Depends On:    
Bug Blocks: 1724792    

Description Kaitlyn Carcia Poulin 2018-06-11 17:31:27 UTC
Document URL: 
https://access.redhat.com/documentation/en-us/openshift_container_platform/3.9/html-single/installation_and_configuration/#ensuring-host-access

Section Number and Name: 
2.3.7. Ensuring Host Access

Describe the issue: 
The section on ensuring host access has an error in its code.

The following loop copies the ssh key for each node. However, the ssh key must also be copied on the master, otherwise, the prereq playbook fails.

# for host in master.example.com \
    node1.example.com \
    node2.example.com; \
    do ssh-copy-id -i ~/.ssh/id_rsa.pub $host; \
    done

Instead, master should be added.

# for host in master.example.com \
    master.example.com \
    node1.example.com \
    node2.example.com; \
    do ssh-copy-id -i ~/.ssh/id_rsa.pub $host; \
    done


Suggestions for improvement: 
As mentioned above, I would correct the example. I also would suggest that we should also recommend users verify that they can ssh into their hosts AND master (seems weird but yes, you must be able to ssh into your master from your master) after completion. This would ensure the process was successful.


Additional information:

Comment 1 Kathryn Alexander 2018-08-22 14:24:50 UTC
PR's here: https://github.com/openshift/openshift-docs/pull/11695

@Johnny, will you PTAL?

Comment 2 Johnny Liu 2018-08-23 02:04:02 UTC
LGTM.

Comment 3 Kathryn Alexander 2018-08-23 13:23:05 UTC
Thank you! I'll merge after peer review.