Configuring the Job Engine Manager

The Job Engine Manger runs as a service on one or more designated services servers. You must configure the Job Engine Manager on each services server where it runs.

Caution: Change the default settings only if necessary. Applying different settings may negatively impact the configuration of the Job Engine Manager. You should not change these settings unless a valid reason exists.

Configuring this service includes setting:

  • Preferences related to thread count
  • Priority processing
  • Performance throttling

Configuration options

The following table describes the Job Engine Manager Configuration options.

Option

Description

Thread Count

The maximum number of concurrent job processes allowed at one time for the server.

Red text indicates the default thread count is displayed. The default value is 10.

Max Thread Per Job Type

The maximum number of simultaneous job processes running for each job type per job engine.

To increase the performance of job processing, you can set the maximum number of jobs allowed per job type. Red text indicates that the Max Thread Per Job Type value exceeds the maximum value.

Poll Size

The maximum number of jobs, usually less than the thread count, that the engine can select to run each time it polls the job queue. The engine selects the jobs based on their priority and on the length of time in the queue.

Process Priority

The default Windows process priority assigned to new job processes.

  • Normal (default value)
  • Idle
  • High
  • RealTime
  • BelowNormal
  • AboveNormal

Equal Instance Processing

Gives each instance the same opportunity to run a job, regardless of the priority levels assigned to jobs from instance to instance.

This option does not allow higher-priority jobs from other instances to take precedence.

Discontinue Job Processing

Stops processing of new jobs while allowing currently running jobs to process. Jobs in progress and their associated child jobs can finish processing.

This option is required when upgrading from earlier versions of Archer.

Performance Throttling

Determines the processing thresholds for CPU and RAM resources.

Max CPU (%): The maximum CPU resources the system can consume while still allowing jobs to process. This limit is compared against a rolling average on the server and will not be triggered by temporary spikes in usage.

Max RAM (%): The maximum RAM resources the system can consume while still allowing jobs to process.

Use the following tasks to configure and manage jobs in the Job Engine Manager:

Configure Job Engine Manager

  1. Go to the Servers tab.

    1. From the Plugins menu, click Job Engine Manager.
    2. Click Servers.
  2. In the Thread Count field, enter the maximum number of concurrent job processes allowed at one time for the server.
  3. In the Max Thread Per Job Type field, enter the maximum number of job processes allowed for each job type per server.
  4. In Poll Size, enter the maximum number of jobs, usually less than the thread count, that the engine can select to run each time it polls the job queue. The engine selects the jobs based on their priority and on the length of time in the queue.
  5. In the Process Priority list, select the applicable priority.

  6. (Optional) In the Equal Priority field, do one of the following:
    • To ensure that each instance processes with equal priority, click Equal Instance Processing.
    • To process without equal priority, leave blank.
  7. (Optional) In the Performance Throttling field, enter the following:
    • Max CPU (%)
    • Max RAM (%)
  8. (Optional) In Filters, check the box for each kind of job you want the engine to run. The engine runs only those kinds of jobs you select.

    Note: If you make no selections, the engine runs all jobs.

Set job processing priority

  1. Go to the Servers tab.

    1. From the Plugins menu, click Job Engine Manager.
    2. Click Servers.
  2. Select the server that processing the jobs.
  3. In the Filters field, do the following:
    1. In the Instances field, select the applicable instance.
    2. In the Priorities field, select one or more.
    3. In the Job Type field, select one or more.
  4. Do the following to add or remove a filter:
    • To add another filter, click +.
    • To remove a filter, click -.
  5. Repeat steps 3 and 4 for each filter that you want to set.
  6. Set the processing priority:
    • To set a higher processing priority, select the filter and click Move Up.
    • To set a lower processing priority, select the filter and click Move Down.
  7. Click Update.

Stop job processing

Stops processing of new jobs while allowing currently running jobs to process. Jobs in progress and their associated child jobs can finish processing.

Important: You must stop job processing before installing the Archer upgrade.

  1. Go to the Servers tab.

    1. From the Plugins menu, click Job Engine Manager.
    2. Click Servers.
  2. Click Discontinue Job Processing.