Q100074: Nuke/NukeX/NukeStudio User Troubleshooting Guide

Follow

SUMMARY

This article will advise you of certain steps you can take to self diagnose your issue or narrow down potential causes.
 
If you are still seeing any issues after performing the steps outlined in this article, then please open a Support ticket and let us know the issue 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 the 'Using the Support Portal' article.

INITIAL STEPS

Check for known issues in our Knowledge Base Articles
First we would recommend that you check the other product knowledge base articles for known issues. If you do not see an article relating to the issue you are seeing, then please do the following:
 
Isolate customizations/third party plug-ins by running Nuke/NukeStudio in safe mode
Launching Nuke/NukeX/NukeStudio in safe mode will make Nuke/NukeX/NukeStudio temporarily ignore any customisations or plug-ins and help you to understand if the issue is to do with Nukes core functionality, or possibly something external. Please reference the 'Launching Nuke/NukeStudio in safe mode' article for instructions.

Test with alternative footage/default settings
Testing with different footage/settings to your original reproduction case will help you understand if the issue is isolated to specific footage or settings.
  • Try replacing the footage in your script with checkerboards (using the CheckerBoard node) or with 10-bit DPX files and testing to see if the issue still occurs.
  • Try using alternative settings where available to see if the issue is isolated to one particular variable setting. i.e if you are experiencing issues when writing out using a codec with the mov32 encoder, you might try changing the codec and testing with mov64 instead.
NUKE
 
Simplify the script file
Often issues in large scripts can be isolated to a small collection of nodes and simplifying the project to these nodes will give a better insight as to what the possible cause is.
To simplify a project we recommend that you:

1. Remove a large selection of branching nodes
2. Test the script to see if the issue still appears
  • if it does: repeat step 1, and start to remove nodes from all areas of the node network
  • if it doesn't: undo the action of deleting the nodes and repeat step 1, but select a smaller selection of nodes
3. Repeat steps 1-2 until you have simplified the script as much as possible while being still able to reproduce the issue
 
NUKESTUDIO
 
Simplify the project file
Often issues in large projects can be isolated to a small collection of clips/tracks and simplifying the project to these elements will give a better insight as to what the possible cause is.
To simplify a project we recommend that you:

1. Remove a track at a time
2. Test the script to see if the issue still appears
  • if it does: repeat step 1, if you are down to 1 track and can still see the issue, then we would recommend to repeat the process but with clip items on the track
  • if it doesn't: undo the action of deleting the track and repeat step 1, but select a different track, or start removing clip items instead
3. Repeat steps 1-2 until you have simplified the project as much as possible while still able to see the issue
 
 
ADDITIONAL TESTS
 
Depending on the type of issue you're experiencing the following suggestions might prove useful for additional troubleshooting. Including these test results in the support request you send us would be extremely useful during our internal investigation.

Test with the project and footage on a local drive
To remove the possibility of the issue being network related we would recommend that you try to reproduce the issue with all files stored on a local drive.
For example:
  • slow playback. Trying to use local footage or making sure everything is localised should help speed up the playback process
  • rendering a script on the farm. Trying to render in batch mode on a local machine instead of using the farm, would confirm whether the problem is related to Nuke or the third party renderfarm software vendor.
Close all background processes and test again while checking memory usage
If you are noticing a high memory usage when running Nuke it would be good to get an understanding of what effect Nuke/NukeX/NukeStudio is having on your machine. Take a note of the high memory consumption then close all other applications and test Nuke/NukeX/NukeStudio again while checking what the memory usage of the machine is (CPU/RAM) compared to the previous one.

Ensure there are no foreign characters or uncommon symbols used in paths
Read, Export and render errors can sometimes be caused by Nuke/NukeX/NukeStudio not recognizing foreign characters or uncommon symbols. If this is the issue you're seeing the please ensure the paths used in your script do not contain any of these.

Clear cache
Clearing your cache can help with performance issues and unexpected behaviours. Please references the 'How to clear your Nuke cache' article for instructions.
 
NUKESTUDIO
 
Clear tags
Sometimes export errors can occur when tags have been applied to a clip and there is a conflict between these tags and the export process.
To clear tags please do the following:

1. Select all clips on the timeline
2. Right click > Tags > Clear Tags
3. Retry export



Keywords: user, troubleshooting, Nuke, NukeX, NukeStudio, safe mode, diagnose




Was this article helpful?
0 out of 0 found this helpful