If you decrease the number of a licenses available, make sure the new amount is not less than the number of licenses currently in use.

1. On the Resource page, click Manage Resources.

2. Set the maximum number of Houdini, Render and Karma licenses HQueue can use, then click Save.

1. On the Resources page, click Manage Resources.

2. Under Custom Resources, click Add.

3. Set the resource name and the maximum number of resources. If the resource is per-machine, turn on Per machine resource.

4. Click Save.

For example, you might have a set of jobs that connect to a database and want to limit the number of concurrent connections. Create a custom per job resource to represent the connections, name it db_connection, and give it a limit amount, say 5.

Then when you submit jobs requiring the connection, add a "resources": {"db_connection": 1} property in the job specification to tell HQueue that the job will consume one db_connection resource.

1. On the Resources page, click Manage Resources.

2. Under custom resources, do one of the following:

   • Edit the resource name text box.

   • Change the maximum number of available resources. (Do not make this less than the number of resources of this type currently in use.)

   • Change whether the resource is per-machine. (None of the resources of this type may be in use.)

   • Click Delete to delete the resource.

3. Click Save.

When you submit custom jobs using the XML/RPC interface, you can specify that the job requires custom resources.

In the job specification, add a resources key. The value is a dictionary mapping custom resource names to the number of that resource needed by the job.

job_spec = { 
    "name": "Hello World",
    "shell": "bash",
    "command": 'echo "Hello World"'
    "resources": {"db_connection": 1}
}

See job properties for more information about the job specification.