Page tree
Skip to end of metadata
Go to start of metadata

Summary: this page describes how to configure the maximum number of parallel job executions that AIP Console can perform per AIP Node.

Introduction

By default, AIP Console will be configured (using the jobs.threadPoolSize parameter) to run a maximum of two (2) jobs in parallel on each AIP Node. A job is any type of execution using AIP Console, for example:

  • run analysis
  • generate snapshot
  • source code delivery
  • etc.

Executions that are not deemed as jobs and which are therefore not covered by the jobs.threadPoolSize parameter are:

If the maximum number of parallel job executions is reached, the next job will wait in a queue and the following will be displayed in AIP Console until a slot is free:

The number of parallel executions can be increased if required (configuration steps are described below), but caution must be taken since performing parallel executions can cause the AIP Node to be overloaded, which in turn can cause performance reductions, timeouts and other errors. Increasing the value too much can also cause jobs to crash entirely. A reasonable value to use depends entirely on the specification/hardware on which the AIP Node is running and therefore CAST strongly recommends only increasing the number of jobs by one and to then perform tests to see if the new value is appropriate before any further increase in the number of jobs is configured.

Above all, if you require additional processing power for your Application analyses, the best practice is to add additional AIP Nodes to balance the load, rather than increasing the number of parallel jobs on a single AIP Node.

Step 1 - Edit the configuration file

A configuration file (aip-node-app.properties) contains a section specifically to make this change. This file is available on EACH AIP Node, therefore if you have more than one AIP Node, you will need to make this change on all AIP Nodes where you would like to increase the number of parallel executions.

To do so, first locate this file:

%PROGRAMDATA%\CAST\AipConsole\AipNode\aip-node-app.properties

Edit the file with a text editor and locate the following line:

# Maximum number of parallel job executions
# If maximum number of parallel job executions is reached, the job will wait in queue
jobs.threadPoolSize=2

Define the custom number of parallel job executions you require. For example:

# Maximum number of parallel job executions
# If maximum number of parallel job executions is reached, the job will wait in queue
jobs.threadPoolSize=3

Save the file when the changes are complete.

Step 2 - Apply configuration changes

Restart the AIP Console and AIP Nodes to ensure all changes are taken into account:

  • If the AIP Console / AIP Nodes are installed as Windows Services, restart the services
  • If the AIP Console / AIP Nodes are running only using the batch files, close the CMD windows to stop the processes, then restart then using the following file:
%PROGRAMFILES%\CAST\AipConsole\AipConsole\tools\runAIPConsole.bat
%PROGRAMFILES%\CAST\AipConsole\AipNode\tools\runAipNode.bat
  • No labels