0 0 Share PDF

Multiple DTRs shown on UCP 2.1 when only one exists

Article ID: KB000406

Issue

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.

d5358184-0e52-11e7-83bb-ea114c8e19fef.png

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

Prerequisites

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.

Resolution

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

Prerequisites

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

Resolution

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.