Document URL: https://docs.openshift.com/container-platform/3.9/install_config/install/host_preparation.html#install-config-install-host-preparation Section Number and Name: Missing (Ansible Section) Describe the issue: We define that: > This includes verifying system and environment requirements per component type and properly installing and configuring Docker. It also includes installing Ansible version 2.4 or later, as the advanced installation method is based on Ansible playbooks and as such requires directly invoking Ansible. https://docs.openshift.com/container-platform/3.9/install_config/install/advanced_install.html#advanced-before-you-begin However the denoted section: https://docs.openshift.com/container-platform/3.9/install_config/install/host_preparation.html#install-config-install-host-preparation has not Ansible Install or Verification steps. Suggestions for improvement: Add an ansible install/verification section to the host preparation documents. Additional information:
Not having this will result in customers not having ansible installed on the nodes! Leading to install errors like: https://github.com/openshift/openshift-ansible-contrib/issues/941 Failure summary: TASK [Gather Cluster facts] **************************************************************************************************************** fatal: [grumpy.dwarf.mine]: FAILED! => {"changed": false, "module_stderr": "Shared connection to host.domain closed.\r\n", "module_stdout": "Traceback (most recent call last):\r\n File \"/tmp/ansible_MqiPXn/ansible_module_openshift_facts.py\", line 18, in <module>\r\n import ipaddress\r\nImportError: No module named ipaddress\r\n", "msg": "MODULE FAILURE", "rc": 0} ... 1. Hosts: host.domain Play: Initialize cluster facts Task: Gather Cluster facts Message: MODULE FAILURE
We don't need ansible installed on all nodes. python-ipaddress is required on all nodes and the prerequisites playbook should install that before it's required. Eric, can you confirm whether or not playbooks/prerequisites.yml was called and provide complete reproducer steps?
(In reply to Scott Dodson from comment #4) > We don't need ansible installed on all nodes. python-ipaddress is required > on all nodes and the prerequisites playbook should install that before it's > required. > > Eric, can you confirm whether or not playbooks/prerequisites.yml was called > and provide complete reproducer steps? Our docs, don't explain to run the pre-requisites.yml playbook - I was not even aware that it existed! It's not listed as a playbook in https://docs.openshift.com/container-platform/3.9/install_config/install/advanced_install.html#running-the-advanced-installation-individual-components Do we should we have/call out in https://docs.openshift.com/container-platform/3.9/install_config/install/host_preparation.html that we have this playbook and that it should be run? Is this called by default with other playbooks? If so I don't believe it ran (I did not call it nor do I see it get called, in my latest run of ansible).
I'm adding it.
Adding as part of https://github.com/openshift/openshift-docs/pull/8205. E.g.: http://file.rdu.redhat.com/~adellape/031918/ocp39installupgrade4/install_config/install/advanced_install.html#running-the-advanced-installation-rpm
LGTM.