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

Bug 1265520

Summary: [docs] IP Failover configuration step for HA is wrong
Product: OpenShift Container Platform Reporter: Evgheni Dereveanchin <ederevea>
Component: DocumentationAssignee: Alex Dellapenta <adellape>
Status: CLOSED CURRENTRELEASE QA Contact: Vikram Goyal <vigoyal>
Severity: high Docs Contact: Vikram Goyal <vigoyal>
Priority: urgent    
Version: 3.0.0CC: aos-bugs, ederevea, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
URL: https://access.redhat.com/documentation/en/openshift-enterprise/version-3.0/openshift-enterprise-30-administrator-guide/chapter-14-high-availability
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-10-09 17:44:48 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:

Description Evgheni Dereveanchin 2015-09-23 06:44:28 UTC 
Document URL: 
https://access.redhat.com/documentation/en/openshift-enterprise/version-3.0/openshift-enterprise-30-administrator-guide/chapter-14-high-availability

Section Number and Name: 
section 14.2.1 step 3

Describe the issue: 
the configuration line is missing an "--service-account=router" which causes this step to fail with errors like these:

$ oadm ipfailover ha-router-us-west --replicas=2 --selector="ha-router=geo-us-west" --virtual-ips="10.245.2.101-105" --watch-port=80 --credentials="$KUBECONFIG" --create

# oc logs ha-router-us-west-1-deploy
I0911 10:51:45.972497       1 deployer.go:195] Deploying default/ha-router-us-west-1 for the first time (replicas: 2)
I0911 10:51:46.071996       1 recreate.go:125] Scaling default/ha-router-us-west-1 to 2
F0911 10:53:47.833271       1 deployer.go:64] couldn't scale default/ha-router-us-west-1 to 2: timed out waiting for the condition


Suggestions for improvement: 

add "--service-account=router" to the docs:

$ oadm ipfailover ha-router-us-west --replicas=2 --selector="ha-router=geo-us-west" --virtual-ips="10.245.2.101-105" --watch-port=80 --credentials="$KUBECONFIG" --service-account=router --create

Additional information: 

Adding "--service-account=ipfailover" seems to also make this work
Comment 2 Alex Dellapenta 2015-09-23 19:09:18 UTC 
The Customer Portal build publish is still incoming, but the docs.openshift.com build was updated this morning, which includes adding the --service-account flag in the relevant missing spots:

https://docs.openshift.com/enterprise/3.0/admin_guide/high_availability.html#configuring-a-highly-available-routing-service

PTAL and let me know if this satisfies this BZ for you. Thanks.