Skip to main content

Docker Success Center

The Docker enterprise customer portal.

Docker, Inc.

How do I create a support dump?

Issue

Docker Technical Support has asked me to create and upload a "Support Dump." What is that, and how do I create one?

Prerequisites

Before performing these steps, you must meet the following requirements:

  • Docker Enterprise Edition - Standard or Advanced
  • Also known as EE Standard or EE Advanced

Steps

A Docker Support Dump helps speed the troubleshooting process by gathering information about your Docker configuration and host environment. For Docker EE - Standard or Advanced, this can be done by using a UCP support dump, which creates an archive containing UCP system logs and diagnostic information.

To obtain a support dump on UCP 2.1:

  1. Log into the UCP UI with an administrator account.
  2. On the top-right menu, click your username, and choose Support Dump. An archive will be downloaded via your browser after a brief time interval.

To obtain a support dump on UCP 2.2:

  1. Log into the UCP UI with an administrator account.
  2. On top left corner, click on Support Dump.

supportdump2.2.png

   *Support dump collects log files and runs various commands on all accessible nodes; consequently, it can take few minutes.

If the user interface is not accessible, you may perform the following steps instead to obtain a single-node version of the UCP support dump:

  1. Obtain direct CLI access to the Docker daemon on a UCP manager node.
  2. Run the CLI support tool with the following command. Be sure to replace HOSTNAME with the canonical hostname of the system where you are running the command, and replace the version number after docker/ucp with the version of UCP you are running.
    docker run --rm \
      --name ucp \
      -v /var/run/docker.sock:/var/run/docker.sock \
      docker/ucp:2.1.6 \
      support > docker-support-HOSTNAME.tgz
  • Was this article helpful?