Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.

    Step by step instructions for submitting Nuke jobs with Qube!



    Panel
    titleStep 1 (First Time Only)
    Section
    Column
    width60

    Install the Nuke submission UI:
    Run WranglerView and go to the Install App UI menu item (File -> Install App UI) as shown.

    Choose "Install Nuke (loadOnce) App UI..."

    This requires that Python be installed on any Worker that runs a Nuke job. If Python is not installed, please see Installing Python. If you can't or don't want to install Python, then choose "Install Nuke (cmdline) App UI..." instead.

    Column
    width40

    Panel
    titleStep 2

     

    Section
    Column
    width60

    Once installed you should be able to locate the "Qube!" menu in Nuke's "Render" menu.

    Column
    width40

     


    Panel
    titleStep 3
    Section
    Column
    width60

    With a script loaded in Nuke you can choose to render the entire script, or just the selected write node(s), as either "Render All...(cmdline)" or "Render All...(loadOnce)" depending on your requirements.

    Info
    titleloadOnce vs cmdline

    What's the difference?

    loadOnce will open a copy (instance) of Nuke on the Worker that picks up the job, and that instance will render frames as assigned by the Supervisor. Since the scene file is only being opened one time, this can be faster to generate the full sequence.

    cmdline will use the command line to open a new instance of the Nuke file for each frame that it renders. Although this can be slower for large scenes, it can also be more flexible in large, complex environments.

    This will present a pre filled submission UI. Ensure sections marked in red have the correct details.

    Tip
    titleUseful Settings

    While not strictly required, the following settings are useful for getting a better result. You will need to turn on "Expert Mode" (check box at the bottom of the submission UI) in order to get access to them.

    • Make sure that the Nuke version and the OS are set correctly for the Worker(s) that will execute the job.
    • Optimize the use of cores. Set the "Slots = Threads" checkbox and then set the "Specific Thread Count" to a value like 8 (assuming you have 8 cores). (If you have Designer licenses, only set the thread count. Do not check "Slots = Threads")
    • By default, Qube! will not retry failed frames. So set the "Retry frame/instance" value to 3 or 5, to get 3 or 5 retries before it gives up. Related to that, the default wait between retries is zero seconds, which is typically not useful. Set the "Retry Work Delay" to a value like 5 or 10 to allow machines time to recover from temporary problems such as network errors.
    • Because the path to the Nuke executable is part of the submission parameters, it is not possible to mix OSs with Nuke jobs - that is, although you can submit from, say, Windows to OS X, you cannot submit to both Windows and OS X at the same time.


    Column
    width40

     

     

    Panel
    titleStep 4
    Section
    Column
    width60

    Click "Submit"

    For further details on the submission UI see below.

    Column
    width40

    Panel
    titleTroubleshooting

    If you find you are getting errors here are some useful links for troubleshooting

    Troubleshooting Flowcharts 

     

    Job Submission Details

    Note

    Not all sections need to be filled in in order to render only the fields marked in red are required

     

    Include Page
    _SimpleCMD_QubeJobBasics
    _SimpleCMD_QubeJobBasics
    nopaneltrue

    Include Page
    _SimpleCMD_QubeFrameRangeNoChunk
    _SimpleCMD_QubeFrameRangeNoChunk
    nopaneltrue

    Include Page
    _SimpleCMD_PreviewFramesSubmission
    _SimpleCMD_PreviewFramesSubmission
    nopaneltrue

    Include Page
    _SimpleCMD_ParametersNuke
    _SimpleCMD_ParametersNuke
    nopaneltrue

    Include Page
    _SimpleCMD_QubeJobTags
    _SimpleCMD_QubeJobTags
    nopaneltrue

    Include Page
    _SimpleCMD_QubeWorkerSelection
    _SimpleCMD_QubeWorkerSelection
    nopaneltrue

    Include Page
    _SimpleCmd_AdvancedJobControl
    _SimpleCmd_AdvancedJobControl
    nopaneltrue

    Include Page
    _SimpleCMD_QubeJobEnvironment
    _SimpleCMD_QubeJobEnvironment
    nopaneltrue

    Include Page
    _simplecmd_QubeRuntimeenv
    _simplecmd_QubeRuntimeenv
    nopaneltrue

    Include Page
    _SimpleCmd_jobValidation
    _SimpleCmd_jobValidation
    nopaneltrue

    Include Page
    _SimpleCMD_QubeActions
    _SimpleCMD_QubeActions
    nopaneltrue

    Include Page
    _simplecmd_qubenotes
    _simplecmd_qubenotes
    nopaneltrue