1. Qube
2. qbwrk.conf File Format

qbwrk.conf File Format

Comments are preceded by the "#" character; everything after the character is ignored by the parser.

Example

key = value #and then the comment

#comment key is equal to value

When defining configuration for a range of hosts which are numbered, it is simpler to group them in numeric range definitions. This is accomplished in the header of the configuration:

[pfx[000-100]]

Example

[pfx[000-100]]

worker_cluster = /project

• Here we define the configurations for all named Workers pfx000 through pfx100. If you don't want to pad out the numeric portion of the host name, simply leave out the initial "0" characters:

[fast[1-100]]

worker_cluster = /other

• Ranged host name entries will accept templates, just like individual host entries.

[group]

worker_groups = "mygroup"

[sqb[10-20]] : group

To simplify definition of templates as well as Worker configurations, the qbwrk.conf also supports the use of macro variables. These are in the format:

• $template.name
• "${template.name}"

The template names self and this are reserved words and can be used to reference local settings. The variable $_ is also reserved for the local template's name as well as to represent child templates which inherit the template.

Format

[template]key = value[host]otherkey = ${template.key}
evaluates to:
[template]key = value[host]otherkey = value

Example

[ref]
worker_cluster = /project[logs]
worker_logfile = "/logdir/${_}.workerlog"

[qb001] : template

• inherit template

worker_cluster = "${ref.worker_cluster}/vfx"

• For Worker qb001, worker_cluster will evaluate to "/project/vfx".

[qb002] : template

• inherit template

worker_cluster = $ref.worker_cluster

• In the case of Worker qb002, worker_cluster is defined to be the worker_cluster entry from template ref: "/project".

The qbwrk.conf file is broken up into sections containing key/value pair settings. Each section is described by a header between brackets "[" and "]". Section names may only consist of the characters a-z, A-Z, 0-9 and "_". As for the key/value pair format, the key's name is always represented first, followed by an "=" sign and finally the value. While whitespace such as spaces or tabs don't matter, it is important that the key/value pair remain on a single line unless curly braces are used to describe the value.

Format

[section]
key = valuekey = "value1 value2"
key = { value1 value2 }

Example

[qb001]

•  hostname

worker_cluster = /projects/movie

• config entry

There are a few "special" section names that can be used for the different platforms. These will be associated with the Workers using the respective platform.

• [winnt]
• [osx]
• [linux]

Example

[linux]
worker_cluster = /mylinuxboxes