Unable to start Docker after platform update

Products

• CA API Developer Portal

Issue/Introduction

After updating the hardened CentOS image platform with the yum command, the Docker service failed to start with this error message:

Job for docker.service failed because the control process exited with error code. See "systemctl status docker.service" and "journalctl -xe" for details.

 

The Docker service status command shows:

apim-ssg.example.com dockerd[1841]: failed to start daemon: error initializing graphdriver: overlay2: unknown option overlay2.override_kernel_check: overlay2
apim-ssg.example.com systemd[1]: Failed to start Docker Application Container Engine.

Environment

Product: API Portal

Release: 5.1

Component: Hardened CentOS image

Cause

Support for the overlay2.override_kernel_check storage option is removed from Docker

Resolution

As part of the platform upgrade, the Docker was also upgraded to v24. In this version of Docker the support for the overlay2.override_kernel_check storage option was removed as noted in Docker documentation.

This storage option must be removed from the Docker daemon configuration in /etc/docker/daemon.json file.

The current file content:

{
        "storage-driver": "overlay2",
        "storage-opts": [
                "overlay2.override_kernel_check=true"
        ],
        "log-driver": "journald",
        "selinux-enabled": true
}

 

After removing the storage option:

{
        "storage-driver": "overlay2",
        "log-driver": "journald",
        "selinux-enabled": true
}

Additional Information

Support for the overlay2.override_kernel_check storage option was deprecated in Docker v19.03 and removed in v24.0