Message-ID: <121076685.8113.1711614715717.JavaMail.confluence@host3.pipelinefx.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_8112_1852973697.1711614715717" ------=_Part_8112_1852973697.1711614715717 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html worker_restrictions

worker_restrictions

Synopsis

worker_restrictions =3D restrictionlist

Allows the administrator to restrict/allow specific jobs to run on this = host.

Job and Worker Rest= rictions

Restrictions are used to allow or restrict where jobs run, and are appli= ed to both jobs and Workers.  Restrictions are based on cluster names.= A job has preferential priority on a Worker whose cluster matches the job'= s cluster, but the job is free to run on any Worker in any other cluster, s= ubject to the restrictions defined here.

Restrictions defi= ned for jobs 

When a job has a restriction defined, it means only run on host= s that satisfy the restriction expression. Hosts that don't satisfy th= e restriction expression won't be considered as dispatch candidates (the jo= b will never be sent to that Worker).

Restrictions d= efined for Workers

When a Worker has a restriction defined via its worker_restrictions value, it means only run jobs whose cluster value matches one of the clusters in that work= er's restriction expression.  The worker won't accept jobs whose = cluster doesn't match one of the clusters in the worker's restriction expre= ssion.

Restrictions Syntax

A restriction is really defined as a "filter" for hosts based = upon information in the queuing algorithm; the values are one or more clust= er names. In the priority/cluster queuing system, a user specifies the restrictio= ns with a directory structure format:

/[<segment>/][<segment>/][+|*]

=20
=20 Icon=20
=20

The restriction value is actually evaluated as an expression, and = multiple clusters are specified in a "this cluster OR<= /strong> that cluster OR the other c= luster" type of string, with the " || " symbol to mean OR.

=20
=20
=20

Examples

Job Restrictions

Syntax Meaning
qbsub -cl /private -restr /p= rivate <cmd> Submit a job that will have highes= t priority in /private and run only in /private
qbsub -cl /private/very -restr '/private |= | /private/*' <cmd>

Submit a job that will have highest priority = in /private/very, but could run in any host in
/private = or in the first level below /private

qbsub -cl /private/very/deep -restr '/priv= ate || /private/+' <cmd>

Submit a job that will have highest priority&= nbsp;in /private/very/deep, but could run in any
= host at any level at /private or below

Worker Restrictions

Syntax Meaning
worker_cluster =3D "/pr= ivate/very/deep"
worker_restrictions =3D "/private/very/dee= p"
Define a host that will o= nly run jobs in /private/very/deep
worker_cluster =3D "/private" worker_restrictions =3D "/private || /private/*" Define a host that will run jobs i= n any cluster at /private or 1 level below - done with the *
worker_cluster =3D "/private/very&quo= t;
worker_restrictions =3D "/private/very || /private/very/+&quo= t;
Define a host that will only run jobs in /privat= e/very or any level below - done with the +

Defaults

No restrictions

See Also

worker_cluster

------=_Part_8112_1852973697.1711614715717--