Image Artist: The Harmony IP address has changed and now data transfers to ImA are stuck with a status of "converting" or "registering" when viewed in the ImA job status page

ImA version 1.1 or below:

For enabling direct connection from the Harmony Software that runs on a host that is not present in the Domain Name System, it is necessary for the Image Artist server to be able to identify and resolve the IP address of the Harmony PC. This is done by editing the relevant section in the docker-compose.yml file which is found in the ImA installation directory.

As part of the ImA installation and setup process it is a requirement for the Harmony PC hostname and IP address to be added to the x-registrator-worker section within the docker-compose.yml file.

The Harmony PC hostname and IP should be added as extra_hosts in the format "hostname:ip_address":

If the IP address of the Harmony PC changes again you will need to edit the extra_hosts in both x-registrator-worker and acapella sections of docker-compose.yml. If you solely change the extra_hosts in the x-registrator-worker section omitting the latter the acapella image/container will still attempt to communicate with the original hostname/IP address. This will result in jobs that are unable to complete and which will remain stuck ''converting'' in the ImA job status page.

To resolve this problem edit the docker-compose.yml file and add the new Harmony PC hostname and IP address as extra_hosts to the acapella section of the docker-compose.yml:

After making the change, redeploy the ImA stack:

I'm using ImA 1.0, what is the recommended method to undeploy and redeploy the ImA stack?

For ImA 1.2 and above:

It is sufficient just to add the Harmony hostname and IP as an "EXTRA_HOST" to the .env file which can be found in the ImA installation directory e.g.

EXTRA_HOST1=harmony51:10.11.12.51
EXTRA_HOST2=harmony52:10.11.12.52
EXTRA_HOST3=placeholder2:192.0.2.2
EXTRA_HOST4=placeholder3:192.0.2.3
EXTRA_HOST5=placeholder4:192.0.2.4