IBM Support

Docker install fails on step enable_start_docker

Troubleshooting


Problem

In an attempt to install DSXL 1.2.0.3

Receive the following error installing docker

./docker_redhat_install.sh /dev/vdd /installer 25G – Fails on the the following step:
 enable_start_docker
Created symlink from /etc/systemd/system/multi-user.target.wants/docker.service to /usr/lib/systemd/system/docker.service.
Successfully created a symlink for docker startup.
Job for docker.service failed because the control process exited with error code. See "systemctl status docker.service" and "journalctl -xe" for details.
ERROR: Unable to start the docker service..

Symptom

Docker failed to start

Cause

The problem is that the docker package from RedHat is automatically inputting overlay2 as the storage driver inside one of these files, causing a conflict with /etc/docker/daemon.json.

Environment

Open another terminal on the same VM while your installation is running on another terminal and perform the following.
Docker installation script sets up docker configuration in /etc/docker/daemon.json.
However, docker also allows the same options to be specified to the docker binary as a flag under the files /etc/sysconfig/docker, /etc/sysconfig/docker-storage, /etc/sysconfig/docker-storage-setup, etc.
The problem is that the docker package from RedHat is automatically inputting overlay2 as the storage driver inside one of these files, causing a conflict with /etc/docker/daemon.json. So the fix would be:
1. Remove `--storage-driver=overlay2` in whichever file it exists in: /etc/sysconfig/docker, /etc/sysconfig/docker-storage, /etc/sysconfig/docker-storage-setup
2. Go to the terminal that has installation running and enter R for retry which will complete your docker installation.
Bear in mind that the overlay2 docker storage driver was supported with the release of RedHat 7.6, but they released its support for earlier versions as well, which explains why we didn't see this error at the time of our testing of v1.2.0.3.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSHGWL","label":"IBM Watson Studio Local"},"Component":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
30 December 2019

UID

ibm10730919