Icon

This is the documentation for an older version of Qube. The latest version of the documentation can be found here: Qube

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: fixed spacing bolded headings

Anchor_Toc112822431_Toc112822431Restrictions
A restriction is really defined as a "filter" for hosts based upon information in the queuing algorithm. In the priority/cluster queuing system, one specifies their restrictions by directory structure format:
/[<segment>/][<segment>/][+|*]

...

Allows hosts in /hello or /goodbye:

  • /hello || /goodbye


Anchor_TOC26074_TOC26074 AnchorTOC10217TOC10217 Anchor_Toc112822432_Toc112822432Hosts
Qube allows users to specify a list of hosts, for the job to run on. This is a comma-delimited list of hostnames.

Example
% qbsub --hosts "qb001,qb002" command Anchor_TOC26240_TOC26240 AnchorTOC10358TOC10358 Anchor_Toc112822433_Toc112822433

Omit Hosts
Qube allows users to specify a list of hosts on which the job is restricted from running. This is a comma-delimited list of hostnames. This blacklists the hosts from running on these hosts.

Example
% qbsub --omithosts "qb001,qb002" command Anchor_TOC26491_TOC26491 Anchor_Toc112822434_Toc112822434


Host Groups
Qube allows the administrator to organize the farm into clusters or host groups. These groups have no hierarchy, and hosts are allowed membership in multiple groups. In order to restrict a job to a specific set of hosts, the user may specify in the 'group' field of the job, which groups they want the job restricted to.

Example
% qbsub --groups "vfx,character" Render my/file.ma

Anchor_TOC26883_TOC26883 Anchor_Toc112822435_Toc112822435 

Omit Groups
This is the opposite of the Host Groups option, where the job will restrict itself from running upon any hosts which are contained by the specified groups.

Example
% qbsub --omitgroups "vfx,character" command

Anchor_TOC27104_TOC27104 Anchor_Toc112822436_Toc112822436 

Host Order
By default Qube chooses any host in the list of hosts which qualify. If given a choice, a job is allowed to prefer a particular host based upon its attributes. This is established using the Qube resources and priorities defined earlier in the Requirements section of this document.
Syntax:

signhost.property
signhost.resource.[total|used|avail]

The sign in the expression is used to determine if the job would prefer the smallest or the largest value possible. If not specified, sign is equal to . The possible values for sign are "" or "". The "+" is used to specify using the highest value first, and the "" is to use the lowest value. These can be combined and will be used in order specified.

Example
Choose the fastest host:
% qbsub --hostorder "host.processor_speed" Render myscene.ma

Choose the host with the least processors:
% qbsub --hostorder "-host.processors.total" Render myscene.ma

Choose the fastest host with the least processors:
% qbsub --hostorder "host.processor_speed,-host.processors.total" Render myscene.ma