Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Major corrections completed

...

They are to be found  the ./bin folder of the JUA installation.

The JUA start script starts the Agent with the new -kill-script parameter as follows:

  • by default the -kill-script is parameterized with the path to the kill script for Windows/Unix as appropriate,
  • the SCHEDULER_KILL_SCRIPT environment variable can be used to set a different kill script.

option can be  used to specify a different kill script if necessary. See the Command Line Options section in JobScheduler Universal Agent - Installation & Operation for more information.

See also See  JS-1468 & JS-1495 for more detailed information about the implementation.

Delimitation

  • This feature is intended for Unix platforms that implement the SIGTERM and SIGKILL signals. It is not intended for Windows platforms for which exclusively the Kill kill Immediately command applies.
  • When using traps then please consider that the process created by the <shell> the <script ... language="shell"/> element receives the signal. Subsequent scripts that are called within the <shell> <script ... language="shell"/> element will not receive the signal. You could therefore:
    • configure traps directly within the <shell> <script ... language="shell"/> element. The shell process will then receive and handle the signal.
    • configure traps in a shell script that is added by an <include> element instead of being stated within the <shell> the <script ... language="shell"/> element. The included shell script will receive and handle the signal.
    • forward signals to subsequent shell scripts that are called within a <shell> <script ... language="shell"/> element.
  • This feature has been fully implemented on for the Universal Agent and It has been implemented for classic for the Classic JobScheduler Agents (JS-1420).

...

  • Terminate: <kill_task immediately="true" timeout="...">
  • Kill: <kill_task immediately="true">
  • Timeout: a job with the timeout attribute. Status
    colourYellow
    titleVerify
 Windows
Standalone
Linux
Standalone
Windows
Classic Agent
Linux
Classic Agent
Windows
Universal Agent
Linux
Universal Agent
Shell job      
Terminatenot supported(tick)not supported

(error) 2)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1420

not supported(tick)
Kill(tick)(tick)(tick)

(tick)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1421

(tick)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1468

(tick)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1468

Timeout

(tick)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1463

(tick)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1463

(tick)(tick) 

(tick)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1468

Shell job with monitor      
Terminatenot supported(tick)not supported(tick)not supported

(error) 3)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1468

Kill(tick)(tick)(tick)(tick)

(tick)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1382

(error) 1)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1468

Timeout(tick)(tick)   

(error) 1)

Jira
serverJIRA Extern
serverId6dc67751-9d67-34cd-985b-194a8cdc9602
keyJS-1382

API job      
Terminatenot supported(tick)not supported(tick)not supported(tick)
Kill(tick)(tick)(tick)(tick)(tick)(tick)
Timeout(tick)(tick)    

...

Examples

...

Using a SIGTERM trap to show the difference between the

...

kill and terminate commands

Download the Example

job_trap_sigterm.job.xml.zip

...