Create a ticket

Q100446: Render hangs or never starts on Linux



When rendering a Katana project on Linux machines, the render may hang for a long time before starting without any errors being displayed, or the render may not start at all.

The last message printed to the Render Log may be similar to the following:

[Katana Procedural] Info: Rendering...


This behaviour can appear when the host name of a machine cannot be resolved.
A bug has been logged under TP 285102 - Render hangs if hostname is not resolved on Linux.


This issue can be resolved by editing /etc/hosts to resolve the host name with the local IP address. Please read on for more detailed instructions on how to do this.

  1. Find the machine’s host name by opening a command line and typing the following:

    This will print the host name to the command line window, for example:
  2. Try to ping this host name from another machine on the same network. To do this, open a command line on another machine and enter ping <hostname> with the host name found in step 1, for example:
    ping myPC

  3. If this is successful, output similar to the following will be printed to the command line:

    Pinging myPC [xx00::00xx:000x:0x0x:x000%0] with 32 bytes of data:
    Reply from xx00::00xx:000x:0x0x:x000%0: time=9ms

    Reply from xx00::00xx:000x:0x0x:x000%0: time=6ms
    Reply from xx00::00xx:000x:0x0x:x000%0: time=5ms
    Reply from xx00::00xx:000x:0x0x:x000%0: time=10ms

    Ping statistics for xx00::00xx:000x:0x0x:x000%0:
        Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
    Approximate round trip times in milli-seconds:
        Minimum = 5ms, Maximum = 10ms, Average = 7ms

    If the output is different, then this may mean that the machine’s host name cannot be resolved. The printed message may look like the following:
    Ping request could not find host myPC. Please check the name and try again.

    If this is the case, please move on to the next steps to troubleshoot.

  4. Find the local IP address by following the steps below:

    1. In a terminal window, type ifconfig
    2. In the resulting information that is printed to the command line, the computer’s local IP address should be found to the right of the “inet” tag.


  5. Edit the hosts file to resolve the host name with the local IP address.

    1. Open the file called hosts in a text editor. This file can be found in the /etc folder.
    2. Add the following line, substituting <host_name> and <local_IP> with the data found in steps 1 and 4:
      <host_name> <local_IP>

      For example:

      You may need to run a text editor as the superuser to be able to edit the file.



If this doesn’t resolve the issue, please raise a Support ticket and let us know more about the problem you are encountering and the troubleshooting steps you have taken so far.

For more information on how to open a Support ticket, please refer to this article: Q100064: How to raise a support ticket



Was this article helpful?

We're sorry to hear that

Please tell us why
0 out of 0 found this helpful