Document URL: In https://docs.openshift.com/container-platform/3.9/install_config/install/advanced_install.html#installer-known-issues we state: ~~~~ On failure of the Ansible installer, you must start from a clean operating system installation. If you are using virtual machines, start from a fresh image. If you are using bare metal machines, see Uninstalling OpenShift Container Platform for instructions. ~~~~ while we state here: https://docs.openshift.com/container-platform/3.9/install_config/install/advanced_install.html#running-the-advanced-installation-rpm ~~~~ Running Individual Component Playbooks The main installation playbook /usr/share/ansible/openshift-ansible/playbooks/deploy_cluster.yml runs a set of individual component playbooks in a specific order, and the installer reports back at the end what phases you have gone through. If the installation fails during a phase, you are notified on the screen along with the errors from the Ansible run. ~~~~ which is actually contradicting and hard to understand exactly when rerunning a playbook is appropriate and when one needs to uninstall first after intsall fails Section Number and Name: Describe the issue: Documentation ambiguous about when to run uninstall playbook or a subset of the playbooks to make the install successful Suggestions for improvement: clearly state when rerunning a individual component playbook is appropriate vs when uninstall playbook is needed first Additional information:
Scott and I had a good discussion about this issue today. I've opened a PR here: https://github.com/openshift/openshift-docs/pull/11044 It's filed against 3.9, but parts of it are also valid in 3.7. (I'll be sure to not introduce unnecessary changes or incorrect file names.) @Johnny, will you PTAL or assign a different reviewer?
Add two comments in the PR-11044.
I reveiw the PR-11044 is good.
Thank you Sheng Lao! I'll merge it after peer review. :)
Commits pushed to master at https://github.com/openshift/openshift-docs https://github.com/openshift/openshift-docs/commit/d2d0b5f57f1111fb44bf03df16234addfdf74dd0 bug 1592772 clarifying when to uninstall instead of redeploy https://github.com/openshift/openshift-docs/commit/1c0880c65229c7d4fc2e81d81c811dcc053a2a69 Merge pull request #11044 from kalexand-rh/BZ1592772 bug 1592772 clarifying when to uninstall instead of redeploy
This change is live on docs.openshift, eg https://docs.openshift.com/container-platform/3.9/install_config/install/advanced_install.html#installer-known-issues and on the portal, eg https://access.redhat.com/documentation/en-us/openshift_container_platform/3.9/html-single/installation_and_configuration/index#installer-known-issues