0 0 Share PDF

Multiple DTRs shown on UCP 2.1 when only one exists

Article ID: KB000406


When changing the name of DTR through the reconfigure command, a stale DTR entry may be found in the UCP UI under Admin Settings > DTR. The stale entry in the following image has been highlighted.


This behavior has been reported to Docker Engineering under issue id dhe-deploy/4918.


This solution has been tested on UCP 2.1.5. It may or may not work on versions of UCP other than 2.1.

If you are using Universal Control Plane 2.2.x, then your should refer to the article titled Multiple DTRs shown on UCP 2.2 when only one or none exists.


Perform the following steps using etcdctl to remove the stale entry.


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

  • UCP version 2.0 or 2.1

For UCP versions 2.2 or 3, please see Multiple DTRs Shown on UCP 2.2 when only one or none exists


On one manager node:

  1. Define a temporary alias that can be used to run etcdctl for convenience:

    alias etcdctl="docker exec -it ucp-kv /bin/etcdctl --ca-file /etc/docker/ssl/ca.pem --cert-file /etc/docker/ssl/cert.pem --key-file /etc/docker/ssl/key.pem --endpoints https://localhost:2379"
  2. List all known DTR entries in etcd:

    etcdctl ls /orca/v1/config/ |grep trustedregistry
  3. Remove the defunct entry:

    etcdctl rm /orca/v1/config/trustedregistry_name.of.dtr.from.step.2
  4. Confirm the entry has been removed:

    etcdctl ls /orca/v1/config/ |grep trustedregistry

On each manager, one at a time:

  1. Restart the ucp-controller container:

    docker restart ucp-controller

Related Article

If you are on UCP 2.2 or 3.0 you may refer to the article Multiple DTRs Shown on UCP 2.2 when only one or none exists.