Workers

Workers are the machines a worker manager server uses to complete imaging, and processing jobs. Workers are designed to centralize and streamline some of the jobs that used to be performed exclusively by agents. You can designate the types of jobs a worker can perform, limit a worker to only perform jobs for particular resource pools, and start or stop a worker during maintenance periods. A worker performs tasks for all resource pools associated with its worker manager server unless you opt to limit the worker to particular resource pools.

This page contains the following sections:

See these related pages:

Adding a worker

When you add a worker manager server to your Relativity environment, you specify the workers that you want that worker manager server to govern. Thus, it's impossible to add workers without adding a worker manager server. For more information, see Worker manager server installation.

Fields

Access a worker's fields by navigating to the Servers tab and clicking the name of the worker.

Worker layout fields

Each worker displays the following fields:

  • Name - displays the worker's computer name. The worker manager server reads the computer name of the worker during the installation process.
  • Type - displays the word "Worker" and populates the Type column on the Servers tab so that you can more easily sort servers and workers.
  • Worker Workstation ID - displays the ID applied to the worker by the worker manager server on installation.
  • Thread Status - displays the number of threads that are busy and available on the worker. If the thread status reads, "1 of 16 main threads busy", it means that only one of the 16 available threads on the worker is performing a task. The total number of threads a worker can have is determined by both the number of processing cores on the worker and the amount of RAM installed.
  • Worker Status - displays whether or not the worker is running or stopped. Click the Change Worker Status button to start or stop the worker.
  • Worker Manager Server - displays the name of the worker manager server managing the queue for this worker.
  • Worker is Licensed for Processing - displays whether or not the worker is licensed to perform processing jobs.
  • Worker Designated Work - displays all job types this worker is able to perform.
  • Status - displays whether or not the worker is Active or Inactive.
  • Version - displays the version of Invariant on the worker manager server managing the queue for this worker.
  • Resource Pools - displays all resource pools the worker can perform tasks for. If this list is empty, the worker can perform tasks for any resource pool associated with the worker manager server.

Editing worker designated work

The worker manager server automatically detects all potential tasks any worker is able to perform and configures each worker's Worker Designated Work fields accordingly. To improve the performance of a worker, you can select only the job types you want sent to the worker. The worker's main threads are only used to perform designated work. You must select at least one task type for each worker.

Note: By default, when you install Relativity, each worker in your environment is designated to do all available work (processing and imaging).

You can designate a worker to perform one or more of the following job types:

  • Processing - if checked, permits the worker to perform processing. If unchecked, the worker can't perform processing tasks. Processing is only available for workers licensed for processing. This option is uneditable if any of the following conditions exist:
    • The worker doesn't have the prerequisites installed to perform processing tasks.
    • Your instance of Relativity isn't licensed for processing.
    • The license status for this worker is set to Processing Disabled, see Changing the license status.
  • Save As PDF - if checked, permits the worker to save documents as PDF files through the Save As PDF mass operation. If this is unchecked, you won't have the option to Save as PDF through the mass operation drop-down menu. Specifically, the option will be available, but if you select it, the job will simply hang without showing progress and without displaying any errors. If this is unchecked, users won't have the option to Save as PDF through the mass operation drop-down menu. For more information, see Mass Save as PDF.
  • Basic Imaging / Native Imaging - permits the worker to perform imaging jobs if checked. If unchecked, the worker can't perform imaging tasks. Either Basic Imaging or Native Imaging appears as an option for the Worker Designated Work field. If you see Basic Imaging, it means that the worker doesn't have the necessary prerequisite software required to perform native imaging. If you see Native Imaging, it means that the worker has the prerequisite software installed to perform native imaging. See Required permissions for more information.

Use the following steps to edit the worker designated work field:

  1. Navigate to the Servers tab.
  2. Click the worker you want to edit.
  3. Click Edit.
  4. Modify any field according to your preference.
  5. Click Save.

Note: If you are unable to make any selections on the Worker designated work field, use the Change Worker Status button to switch the worker to Stopped, then switch the worker back to Started. See Starting and stopping workers for more information.

Starting and stopping workers

The Change Worker Status button on the Resource Server console lets you start or stop a worker. If the Worker Status field is set to Stopped, the imaging set using this server becomes suspended, and Relativity generates a notification email. In this case, you must change this status field to Started in order to run imaging jobs through that imaging set.

The following options are available from the Change Worker Status window:

Changing worker status

  • Started - worker can receive jobs sent from the worker manager server.
  • Stopped - prevents the worker from receiving jobs sent from the worker manager server.

Timeouts for stuck workers

The LongRunningJobTimeout setting enables Invariant to terminate some stuck jobs. Specifically, this value determines the amount of time (in milliseconds) that a worker will work on a job before Invariant terminates that job. The default value is 180,000 milliseconds (30 minutes).

You may want to adjust this value if you have large documents that need additional time for processing, or if you need a shorter feedback loop. If you need to adjust this value, you can manually go into the AppSettings table and increase it accordingly. Previously, Invariant workers could get into a state in which they no longer reported progress and no longer completed work, which then required manual intervention to terminate those processes. When Invariant uses the LongRunningJobTimeout setting to stop a job, Relativity provides an error message to the processing user informing them that the timeout limit was reached.

Changing the license status

Use the Change License status button to specify whether or not the worker is licensed for processing. You must have a processing license to designate a worker as licensed for processing.

Changing worker license

  • Processing Enabled - select Processing in the Worker Designated Work field enabling the worker to perform processing jobs.
  • Processing Disabled - prevents you from selecting Processing in the Worker Designated Work field and disables the worker's ability to perform processing jobs.

Limiting workers to particular resource pools

You can limit a worker to only perform jobs for particular resource pools. When you associate a worker with a resource pool, its resources are only available for jobs that originate from within that resource pool. You can limit a worker to multiple resource pools.

Limiting a worker to a resource pool

Use the following steps to limit a worker to a resource pool:

  1. Navigate to the Resource Pools tab.
  2. Click the name of the resource pool you want to limit a worker to.
  3. Click Add in the Agent and Worker Servers section.
  4. Select the checkbox next to the name of the worker you want to limit to this resource pool.
  5. Click OK.

Note: If you add a worker to one or more resource pools, it is unable to perform tasks for any other resource pool. If you don't add the worker to any resource pools, it can perform tasks that originate from any resource pool associated with the worker manager server.

Removing a worker from a resource pool

Use the following steps to remove a worker from a resource pool:

  1. Navigate to the Resource Pools tab.
  2. Click the name of the resource pool you want to remove the worker from.
  3. Select the checkbox next to the name of the worker you want to remove from this resource pool in the Agent and Worker Servers section.
  4. Click Remove.

Note: If a worker is not limited to any resource pools, it performs tasks that originate from any resource pool associated with the worker manager server.