Skip to main content

QubeLocker

QubeLocker lets you control how much of your workstation's configured Qube! job-slot capacity is offered to the render farm. It operates on your local Qube! worker.

image

Before you start​

Install the Qube! worker and the QubeLocker package supplied for your platform. Your workstation must be able to communicate with the Supervisor, and your account must have permission to change its worker locks.

QubeLocker reads the worker's configured job slots, offered processor capacity, running jobs and instances. If it cannot read the worker, use Refresh or Retry and check the worker service, network connection and Qube! permissions with your administrator.

Choose the capacity to offer​

  1. Open QubeLocker and check the displayed hostname and worker status.
  2. Review Configured job slots, current jobs and active instances.
  3. Use the segmented capacity selector or an available preset to choose how many slots to offer to the farm.
  4. Review Allocation impact and the selected fraction and percentage.
  5. Choose whether to purge running work when reducing capacity, then select Apply allocation.
  6. Wait for the worker state to refresh and confirm the allocation.

For example, selecting three slots on an eight-slot worker offers 3/8, displayed as 37.5%, of its configured capacity. This percentage describes Qube! slot allocation. It does not measure CPU utilization or guarantee that applications will use an exact percentage of the physical CPU, memory or GPU.

The selector uses the worker's configured slot count. It does not change that maximum; ask your administrator if the configured capacity is incorrect.

Reducing capacity and running work​

The Purge running work when reducing capacity checkbox controls how existing work is handled:

  • Selected: QubeLocker uses aggressive worker locking to reclaim capacity immediately. Affected running Qube! work can be interrupted and migrated or retried according to Qube! job behavior.
  • Cleared: QubeLocker applies a non-aggressive lock. Running work can finish; the selected capacity limits additional dispatch as work completes.

Check this option before applying a reduction. QubeLocker remembers the setting, and a new settings profile initially enables it.

Lock or restore the workstation​

Select Lock workstation to offer zero slots to the farm. This button applies the zero-slot allocation immediately and uses the current purge setting. It locks Qube! capacity; it does not lock your operating-system session or shut down the computer.

To offer capacity again, select the desired number of slots and choose Apply allocation.

Refresh, appearance and system tray​

  • Refresh reads the worker state again.
  • Light mode / Dark mode changes QubeLocker's appearance.
  • When a system tray is available, closing the window hides it to the tray. Use Show QubeLocker to reopen it, Refresh worker to update it, or Quit to exit.
  • Where no system tray is available, closing the window closes the application.

Quitting QubeLocker does not send an unlock command. Check the applied worker allocation before exiting if you want to restore farm capacity.