Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# Q100446: Render hangs or never starts on Linux

Warning: This article contains links to external websites

####

#### SYMPTOM S

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 is the following:

    [Katana Procedural] Info: Rendering...

####
CAUSE

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.

#### RESOLUTION

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:
   `hostname`
   This will print the host name to the command line window, for example:

       myPC

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:
      `myPC 192.0.000.000`
      You may need to run a text editor as the superuser to be able to edit the file.

#### FURTHER HELP

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