Submitting a Nuke (loadOnce) Job

This is the name of the job of the job so it can be easily identified in the Qube! UI

Every job in Qube is assigned a numeric priority. Priority 1 is higher than priority 100. This is similar to 1st place, 2nd place, 3rd place, etc. The default priority assigned to a job is 9999.

Instances are the amount of times you would like to spawn a session of your application

Example:

On a 12 slot(core) machine running Maya if you set

"Instances" to 4

"Reservations" to "host.processors=3"

Qube! will open 4 sessions of Maya on the worker simultaneously consuming all slots/cores

if you set

"Instances" to 1

"Reservations" to "host.processors=1+"

Qube will open 1 session of Maya on the worker consuming all slots/cores ("host.processors=1+" is used for all slots/cores)

more on Instances & Reservations

Most jobs require a frame range in which to execute on the worker's you can set this range in a few different ways :

"1-100" will just render the range between 1 and 100

"1-100x3" will render the range 1 to 100 in chunks of 3

"1,3,7,10" will only render the selected frames 1,3,7,10

You can set the order in which your frames are rendered. The drop down options are:

"Ascending" this will render the frames counting upwards from your start frame

"Decending" this will render the frames counting backwards from your end frame

"Binary" Explanation needed

Enabling preview frames will create 2 jobs:

A primary dependent job with a higher priority that will render the selected frames first

and a secondary job with lower priority that will render the remaining frames

This will return the selected frames faster so that you can troubleshoot your renders

Choose the frames that you wish to render first.

If left blank "Default" is selected which renders the first frame , the last frame and the middle frame in that order.

You can select the frames by adding comma separated frame numbers e.g 1,2,10,15,75

Choose the priority for the primary job.

Choose the instances/subjobs for the primary job.

Use the spinners to enter the required version of nuke

Browse or enter manually the location of Nuke executable on the workers

Important : Always double check the location of the workers executable. Be aware that if you are submitting cross platform the path will be different.

placeholder

Browse or enter manually the location of the nuke file to be rendered. This is a required field for submission

Important: Best practise is to ensure the nuke file and all of its dependant files such as textures are on network storage accessible by the workers.

list comma seperated views to render. These are named in your nuke script

Execute on the specified node. These are named in your nuke script

Explanation and example needed

Tick box to override scene anamorphic settings

Enter the numeric value to override scene cache size settings

Tick box to override scene interactive settings

Tick box to override scene linear transfer settings

Enter the numeric value to override scene threads settings

Tick box to override scene proxy mode settings

Tick box to override scene quiet settings

explaination needed

Choose the level of detail you would like the logs to provide

see page Job Tags

Click browse to choose from a list of workers that you want to run the job on

Click browse to choose from a list of groups that you want to run the job on

Click browse to choose from a list of workers that you do NOT want to run the job on  

Click browse to choose from a list of groups that you NOT want to run the job on

Click browse to choose from a list of Priority Clusters

Clusters are a way of distributing jobs across the farm with the ability to expand and shrink based on the submitted priority cluster Example: A job submitted to /root/ will run on all machines with /root/ assigned as a cluster.  At a standard priority A job submitted to /root/a will run on all machines with /root/a assigned as a cluster At a higher priority than /root/ meaning that the job will pre-empt a job with the priority cluster

Click browse to choose from a list of Host Order Options

Host Order is a way of telling the job how to select/order workers "+host.processors.avail" means prefer workers which have more slots available "+host.memory.avail" means prefer workers which have more memory available "+host.memory.total" means prefer workers which have more total memory "+host.processor_speed" means prefer workers with higher cpu speeds "+host.cpus" means prefer workers with higher total cpu slots

Click browse to choose from a list of Host Order Options

Requirements is a way to tell the workers that this job needs specific requirements to be met in order to run drop-down menu items: "winnt" this will fill the field with "host.os=winnt" which means only run on Windows based workers "linux" this will fill the field with "host.os=linux" which means only run on Linux based workers "osx" this will fill the field with "host.os=osx" which means only run on OSX based workers The above is not the limit of what "Requirements" can do see a list below of other alterable variants: "host.processors.avail.=4" means only run this job on workers that have 4 or more slots available "host.processors.used=0" means only run this job on workers with 0 slots in use "host.memory.avail=400" means only run this job on workers that have 400 memory available

Click browse to choose from a list of Reservation Options

Reservations is a way to tell the workers that this job will reserve the specific resources for this job Menu items: "host.processors" this will fill the field with "host.processors=X" which means reserve X slots on the worker while running this job "host.memory" this will fill the field with "host.memory=X" which means only reserve X memory on the worker while running this job The above is not the limit of what "Reservations" can do see a list below of other alterable variants: "host.license.nuke=1" when a Global Resources entry has been made you can reserve any arbitrary named item. See also Job Reservations

Click browse to choose from a list of Restrictions Options

Restrictions is a way to tell the workers that this job can only run on specific clusters Example: submit a job that will run only in /farm: "qbsub -cluster /root -restriction /root" submit a job that will prefer to run in /farm/nuke, but could run in any host in /farm or in the first level below /farm "qbsub -cluster /root/a -restriction '/root or /root/*'" submit a job that will prefer to run in /farm/nuke/workstations, but could run in any host at any level at /farm or below "qbsub -cluster /root/a/workstations -restriction '/root or /root/+' hostname"

Sends mail to the designated user based on the status of the job being complete

Sends mail to the designated user based on the status of the job being failed

Enable this tickbox to ensure after submission this job is in a blocked state

Enable this if you would like to combine you logs

Legacy method of labelling jobs see Job Tags

see How to restrict a host to only one instance of a given kind of job, but still allow other jobs

see Process group labels

Set this to retry any failed frames or instances automatically

Set this to create a delay in second between the frame/instance retries

Use this if the acceptable instance/subjob spawn time is known.

Use this if the acceptable frame time is known.

Explanation needed

You can specify key/value pairs of environment variables

This is useful when you might need different settings for your render applications based on different departments or projects

You can specify which user you would like to submit the job as

This is useful for troubleshooting a job that may fail sent from a specific user

Example:

Setting "qube\josh" would attempt to submit the job with the domain "qube" and the user "josh"

Note: "impersonate user" permissions need to be set on the user submitting this job

Used to provide OS specific environment variables for Windows

Used to provide OS specific environment variables for Linux

Used to provide OS specific environment variables for OSX

Used to test the created output file to ensure that it is of minimum size specified

Used to add highlights into logs

Used to add errors for known problematic strings. If you enter for example "error: 2145" and this error was pressent in the logs the job would be marked as failed

Used to identify the output paths for the job. This is useful for returning information to the Qube GUI so they you can right click browse output.

Used to identify strings for relaying the progress of frames

Used to truncate the size of your log files

Select this option to create a secondary job that will wait for the render to complete then combine the output files into a movie

Note: For this to work correctly the "Qube (ImagesToMovie) Job..." has to be setup to use your studios transcoding application

This can be used for creating tags for your job

The created tags can be searched in the "Performance Charts" Tab

You can add entries by typing in the drop-down window or select already created accounts from the drop-down

See also "Qube Job Tags"

Add text about the job for future reference. Viewable in the Qube UI