DPC: Fixing DPC IAM Service Failure Due to Docker Port Configuration Issue

Summary: This Knowledge Article provides a solution for the issue where the DPC dp-iam service fails to start. When this is due to a port configuration problem in the docker-compose.yml file. The root cause is an invalid IPv6 address with too many colons, causing misinterpretation during container build. The resolution is to edit the docker-compose.yml file, enclosing the IPv6 address in square brackets, and restarting the docker compose service. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

  • DPC's dp-iam service is down.
  • When you try to start the service, it fails.
  • In the /var/log/dpc/iam/dp_iam.log, you see the following error:
error decoding 'ports': Invalid ip address ::1: address ::1:: too many colons in address
  • The above error may also be seen in the /var/log/dpc/install/intstall.log as well. 
This can be seen in version 19.10 and above.

Cause

This issue is caused by a configuration issue in the docker-compose.yml file. The IPv6 address has "::" in it, which causes the system to misinterpret the ports for the container build.

The error message in the /var/log/dpc/iam/dp_iam.log file indicates that the system is unable to correctly parse the IPv6 address.

Resolution

NOTE: A fix for this issue has been added to the goidpa tool, follow the below KB to install goidpa:
PowerProtect Data Protection Appliance: GoIDPA tool
Then run the following command on the ACM: 
./goidpa dpc yml-port-fix

 

Note: If the issue persists, contact Dell Support for further assistance.


 

Additional Information

If the goidpa automated process fails, below are the manual steps for this issue:

  • Log in to the DPC UI using PUTTY/SSH as admin and su - to root user.
  • Navigate to the directory with the docker compose file in it with the following:
cd /usr/local/dpc/lib/iam/bin
  • Edit the "docker-compose.yml" file with the following command:
vi docker-compose.yml
  • Under the services section, in the iam-provider section edit the ports as follows:
ports:
            - "127.0.0.1:8143:8443"
            - "::1:8143:8443"

Change this by putting square brackets around the IPv6 address, "::1" as follows:

ports:
            - "127.0.0.1:8143:8443"
            - "[::1]:8143:8443"
  • Under the services section, in the iam-service section edit the ports as follows:
ports:
            - "127.0.0.1:8870:8870"
            - "::1:8870:8870"

Change this by putting square brackets around the IPv6 address, "::1" as follows:

ports:
            - "127.0.0.1:8870:8870"
            - "[::1]:8870:8870"
  • Exit the vi editor by clicking the "ESC" key and then typing the following:
:x
  • Restart the docker compose service with the following commands:
docker-compose down
docker-compose up -d
  •  Restart the msm-elg service with the following command:
service msm-elg restart

 

Affected Products

Data Protection Central
Article Properties
Article Number: 000228776
Article Type: Solution
Last Modified: 24 Apr 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.