Configuring the Job Engine Manager

The Job Engine Manager runs as a service on 1 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, and performance throttling.

On this page

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 1 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. From the Plugins menu, click Job Engine Manager > Servers.

  2. In the Thread Count field, enter the maximum number of concurrent job processes allowed at 1 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 1 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. From the Plugins menu, click Job Engine Manager > Servers.

  2. Select the server that is 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 1 or more.
    3. In the Job Type field, select 1 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. From the Plugins menu, click Job Engine Manager > Servers.

  2. Click Discontinue Job Processing.

Delete decommissioned servers

Deletes servers that are no longer running a Job Engine and are not in use.

Important: If the server is deleted from the Archer Control Panel, but the server is currently running a Job Engine, the server automatically registers itself again with the Archer Configuration Service; however, any custom configurations that were on the deleted server must be re-configured.

  1. From the Plugins menu, click Job Engine Manager > Servers.

  2. Right click on a specified server and select Delete.

  3. Review the warning and confirm.