OpenShift 3.1 Error docker conflicts with atomic-openshift-3.1.1.6

Solution Verified - Updated -

Environment

  • OpenShift Enterprise
    • 3.1.1.6-4

Issue

  • Getting Error: docker conflicts with atomic-openshift-3.1.1.6-4.git.32.adf8ec9.el7aos.x86_64
  • Trying to update but getting error with docker 1.9

Resolution

Docker 1.9 should not be installed on any new or existing OSE 3.1 or 3.0 hosts, as the combination has proven to have performance issues. For more information see the knowledge article for more information: Are OpenShift Enterprise 3.1 and Docker 1.9 compatible?

  • If docker 1.9 is installed already then it must be removed and docker 1.8 will need to be installed instead.

    # yum swap docker-* docker-*1.8.2
    # sed -i 's/--storage-opt dm.use_deferred_deletion=true//' /etc/sysconfig/docker-storage
    # systemctl restart docker 
    

To move forward with a yum update or yum install, docker-1.9 and docker-selinux-1.9 rpms need to be excluded. See knowledge article for details on how to exclude packages from getting updated in Red Hat Enterprise Linux while updating system via yum?

  • Temporary solution via Command line:

    # yum update --exclude="docker-1.9* docker-selinux-1.9*"
    
  • To make a persistent change, edit the /etc/yum.conf adding the following to the file:

    exclude=docker-1.9* docker-selinux-1.9*

    • Example file would look like:
    # cat /etc/yum.conf 
    [main]
    exclude=docker-1.9* docker-selinux-1.9*
    cachedir=/var/cache/yum/$basearch/$releasever
    keepcache=0
    debuglevel=2
    logfile=/var/log/yum.log
    exactarch=1
    obsoletes=1
    gpgcheck=1
    plugins=1
    installonly_limit=3
    
  • To accomplish this with an Ansible ad-hoc command, running on all hosts in your Ansible Hosts file, run the following:

# ansible all -a "sed -i  '/\[main\]/a exclude=docker-1.9* docker-selinux-1.9*' /etc/yum.conf"

Root Cause

Currently there are 3 bugs open on this issue.
BZ#1304038 - Docker-1.9 is unstable when used with openshift-3.1.
Bug 1320695 - For 3.1 and 3.0 installs prevent the installer from installing docker-1.9
Bug 1323238 - OSE 3.1 RPM should require docker >= 1.8.2 and < 1.9

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.

Comments