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.
There are several way to control which hosts the supervisor will select when deciding where to start job instances on the farm.

Hosts - send only to an explicit set of workers

Send only to an explicit pre-defined group of workers

Select hosts in a certain preferential order

...

Anchor
Restrictions
Restrictions
Restrictions

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>/][+|*]

...

The restriction value is actually evaluated as an expression, and is specified in a "this cluster or that cluster or the other cluster" type of string, with the "||" symbol to mean "or"

Example

Allows hosts/jobs in /hello/world, but do not include lower levels:

...

Allows hosts in /hello or /goodbye:

  • /hello || /goodbye

...

Anchor
Hosts
Hosts
Hosts

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 --omithosts "qb001,qb002" command

Anchor
HostGroups
HostGroups
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
OmitGroups
OmitGroups
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
HostOrder
HostOrder
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:

...