The is_script_stuck Script
Valid for versions 82 through the latest version
Last modified: May 13, 2020
Overview
In some rare cases, a long process may hang indefinitely and be difficult for system administrators to detect. The /usr/local/cpanel/bin/is_script_stuck
script checks how long a scripts current PID has run, and can notify a WHM user or kill the process.
For example, if you experience problems with hung backup processes, you could use this script in a cron job to monitor backup processes.
Run the script
To run this script on the command line, use the following format:
/usr/local/cpanel/bin/is_script_stuck [options]
Options
You can use the following options with this script:
-
--script
The absolute path to the script that you wish to check.Note:This option is required, unless you instead use the help option. -
time
The amount of time that the specified script can run before the/usr/local/cpanel/bin/is_script_stuck
script determines that it is stuck.
You can append one of the following units of measure:d
Days.h
Hours.m
Minutes.s
Seconds.
If you do not append a unit of measure, the script treats this value as a number of seconds. For example, specify
--time=60
for 60 seconds, or--time=4d
for four days.Note:This option is required, unless you instead use the help option. -
--notify
The WHM username to which you wish to send a notification of the scripts results. -
--kill
Use this option if you want the script to stop (kill) the specified script if it runs longer than the specified time. -
--help
Print help information for this script.