Bug 1265520 - [docs] IP Failover configuration step for HA is wrong
[docs] IP Failover configuration step for HA is wrong
Status: CLOSED CURRENTRELEASE
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation (Show other bugs)
3.0.0
Unspecified Unspecified
urgent Severity high
: ---
: ---
Assigned To: Alex Dellapenta
Vikram Goyal
Vikram Goyal
https://access.redhat.com/documentati...
:
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2015-09-23 02:44 EDT by Evgheni Dereveanchin
Modified: 2015-10-09 13:44 EDT (History)
4 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2015-10-09 13:44:48 EDT
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description Evgheni Dereveanchin 2015-09-23 02:44:28 EDT
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 15:09:18 EDT
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.

Note You need to log in before you can comment on or make changes to this bug.