Description of problem: "yum update" installs unsupported docker-1.9 on OSE 3.1. In 3.1.1.6-4 we introduced dependency to keep docker-1.8.2 but it's removed in 3.1.1.6-6 for the other issue and reveals "yum update" issue. Version-Release number of selected component (if applicable): OSE 3.1 How reproducible: Always Steps to Reproduce: 1. yum update 2. 3. Actual results: "yum update" installs unsupported docker-1.9 on OSE 3.1 Expected results: "yum update" should not make the system an unsupported status and it would be great if we have a protection Additional info: Are OpenShift Enterprise 3.1 and Docker 1.9 compatible? https://access.redhat.com/solutions/2214221 Workaround is described in the article: OpenShift 3.1 Error docker conflicts with atomic-openshift-3.1.1.6-4 https://access.redhat.com/solutions/2217391
Created separated "downgrade" workaround article since the previous one depends on a particular docker version: How to downgrade docker-1.9.1 to docker-1.8.2 https://access.redhat.com/solutions/2347521
The OSE 3.1 Installation and Configuration guide was updated. In the System Requirements section of the Prerequisites topic, there is a Note about the 1.8.2 / 1.9 issue and a link to a KBase which was updated to handle the downgrade steps if needed: https://docs.openshift.com/enterprise/3.1/install_config/install/prerequisites.html#system-requirements https://access.redhat.com/solutions/2214221 The "Installing Docker" subsection in the same topic got a similar Note added as well, with the same KBase link: https://docs.openshift.com/enterprise/3.1/install_config/install/prerequisites.html#installing-docker
Could you clarify this issue is actually fixed or not. It sounds like "Won't fix but doc improved". Is OSE 3.1 customers safe to perform yum update? Did we add any caution about "yum update" in the doc? > Description of problem: > > "yum update" installs unsupported docker-1.9 on OSE 3.1. > > In 3.1.1.6-4 we introduced dependency to keep docker-1.8.2 but it's removed in 3.1.1.6-6 for the other issue and reveals "yum update" issue. > > Expected results: > > "yum update" should not make the system an unsupported status and it would be great if we have a protection
In the "Installing Docker" section: https://docs.openshift.com/enterprise/3.1/install_config/install/prerequisites.html#installing-docker There is an "Important" box that warns about Docker 1.9 support and links to the KBase. The KBase provides content that as long as you're on the latest atomic-openshift-utils package (which the reader should already be by that point in the Prerequisites doc), the installer will not automatically install Docker 1.9, and will print an error message. The KBase also provides instructions on setting an exclude in yum.conf, preventing manual yum updates to 1.9. And in the System Requirements topic, the "Important" box also includes: "See the Red Hat Knowledgebase for details. Follow this topic to ensure you have the correct version of Docker installed on your hosts before installing or upgrading to OSE 3.1." Do you feel that satisfies the BZ? Or do you feel the "Important" box in "Installing Docker" should more obviously state that the KBase provides these instructions?
I would clearly state that the "yum update" makes the system unsupported status in addition to the knowledge article link. In general users assume "yum update" is safe thing. The key thing of this issue is "yum update", not the installation phase issue but maintenance.
(In reply to Takayoshi Kimura from comment #7) > I would clearly state that the "yum update" makes the system unsupported > status in addition to the knowledge article link. In general users assume > "yum update" is safe thing. > > The key thing of this issue is "yum update", not the installation phase > issue but maintenance. Thanks, I'm re-opening this to add some clarity. I will keep you updated.
Takayoshi, I've made changes here: https://github.com/openshift/openshift-docs/pull/2612 Please review and let me know what you think. Rendered build here: http://file.rdu.redhat.com/~adellape/080516/enterprise/3.1/install_config/install/prerequisites.html#system-requirements and http://file.rdu.redhat.com/~adellape/080516/enterprise/3.1/install_config/install/prerequisites.html#installing-docker Thanks.
Looks good to me.
Changes were published last week. See Revision History here: https://docs.openshift.com/enterprise/3.1/welcome/revhistory_full.html#mon-aug-08-2016